Troubleshooting

Authentication problems

If you’re experiencing issues connecting to the MCP server, try these debugging steps.

1. Kill existing MCP connections

$ pkill -f mcp-remote

2. Clear the MCP auth cache

$ rm -rf ~/.mcp-auth

After running these commands, restart your MCP client (Claude Desktop or ChatGPT) and try connecting again.

If authentication issues persist after clearing the cache, verify that your user role has the required permissions. Read Only users cannot connect to the MCP server—an Admin or Owner needs to upgrade your role.

ADK-specific issues

401 Unauthorized

Ensure your API key is valid.
Verify the Authorization header is formatted as Bearer <key>.

405 Method Not Allowed

Ensure you are sending POST requests to /mcp.
SSE (GET streaming) is not supported.

See the Google ADK setup page for the expected configuration.