Skip to content

Troubleshooting

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:

  1. Delete the ~/.mcp-auth folder
  2. 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.

If you make any changes to the MCP configuration, be sure to restart the AI so that the MCP restarts correctly.