Troubleshooting
Authentication problem
Section titled “Authentication problem”For clients that connect through the mcp-remote bridge (such as Claude Desktop, Windsurf, or Zed), authentication credentials are stored in ~/.mcp-auth. If authentication problems persist, please follow these two steps:
- Delete the
~/.mcp-authfolder - Start a new conversation or restart the AI
Clients that speak HTTP to the MCP server natively (Claude Code, Cursor, Gemini CLI, Visual Studio Code, and others) store credentials in their own location. Refer to your client’s documentation to clear the cached MCP credentials.
Restart the AI
Section titled “Restart the AI”If you make any changes to the MCP configuration, be sure to restart the AI so that the MCP restarts correctly.
Other issue
Section titled “Other issue”- Restart the AI to see if the mcp restarts correctly.
- Check the mcp-remote documentation