Skip to content

Commit d3cafa5

Browse files
docs: Add troubleshooting section for Zed ACP MCP issues (#140)
* docs: Add troubleshooting section for Zed ACP MCP issues Add troubleshooting guidance for debugging MCP recognition issues in Zed IDE. Users can now use 'acp debug log' command to diagnose MCP configuration problems. Co-authored-by: openhands <openhands@all-hands.dev> * docs: Make troubleshooting section more general Update troubleshooting to focus on accessing debug logs for any issues, rather than specifically MCP recognition problems. Co-authored-by: openhands <openhands@all-hands.dev> --------- Co-authored-by: openhands <openhands@all-hands.dev>
1 parent df7af26 commit d3cafa5

File tree

1 file changed

+15
-0
lines changed
  • openhands/usage/run-openhands

1 file changed

+15
-0
lines changed

openhands/usage/run-openhands/acp.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,6 +91,21 @@ To configure OpenHands CLI with Zed:
9191

9292
![Zed Use OpenHands Agent](/openhands/static/img/acp-zed-use-openhands.png)
9393

94+
### Troubleshooting
95+
96+
If you encounter issues while using OpenHands in Zed with the ACP plugin, you can access detailed debug logs:
97+
98+
1. Open the command palette with `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows/Linux)
99+
2. Type and select `acp debug log` to view detailed debug information
100+
3. Review the logs for any errors or warnings
101+
4. Restart a new conversation to reload connections after making configuration changes
102+
103+
The debug logs can help you identify configuration issues, connection problems, or errors in your setup.
104+
105+
<Note>
106+
If you encounter persistent issues, verify that OpenHands CLI is properly configured (see [Prerequisites](#prerequisites)) and that all server commands are executable from your system PATH.
107+
</Note>
108+
94109

95110
## See Also
96111

0 commit comments

Comments
 (0)