For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Login
HomeDocsAPI ReferenceMCP ServerChat SDKsRelease Notes
HomeDocsAPI ReferenceMCP ServerChat SDKsRelease Notes
  • Introduction
    • Overview
    • Getting started
    • Authentication
    • Data privacy
    • Built-in prompts
    • FAQ
    • Troubleshooting
  • Tools
    • Overview
    • get_ada_configuration
    • get_ada_metric
    • get_available_filters
    • get_conversations
    • get_conversation
    • search_knowledge
    • search_coaching
    • get_improvement_guide
    • list_entities
    • propose_change
    • get_test_cases
    • get_test_runs
    • get_test_run_quota
    • send_feedback
  • Prompt library
    • Overview
    • Improvement recommendations
    • Quick health checks
    • Create visualizations
    • Diagnose performance issues
    • Identify optimization opportunities
    • Review configuration
    • Search knowledge and coaching
    • Test agent responses
    • Deep-dive analysis
Login
LogoLogo
On this page
  • Authentication problems
  • 1. Kill existing MCP connections
  • 2. Clear the MCP auth cache
  • ADK-specific issues
Introduction

Troubleshooting

Was this page helpful?
Previous

Tools overview

Next
Built with

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.