Troubleshooting
Authentication problems
If you’re experiencing issues connecting to the MCP server, try these debugging steps.
1. Kill existing MCP connections
2. Clear the MCP auth cache
After running these commands, restart your MCP client (Claude Desktop or ChatGPT) and try connecting again.
If a tool returns a permission error, your dashboard role may not allow that tool. See Permissions for the role-to-tool mapping.
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.