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
  • Ada instance domain
  • OAuth
  • API key
Introduction

Authentication

Was this page helpful?
Previous

Data privacy

Next
Built with

The MCP server supports two authentication methods. Choose the one that fits your workflow.

MethodMCP Server URLBest for
OAuth (recommended)https://<your-ada-instance-domain>/api/mcp/oauthInteractive use with browser-based login
API Keyhttps://<your-ada-instance-domain>/api/mcpAutomated setups or programmatic access

Ada instance domain

Your Ada instance domain is the URL you use to log in to your Ada dashboard (for example, acme-corp.ada.support, acme-corp.eu.ada.support, or acme-corp.maple.ada.support).

If you log in at https://acme-corp.eu.ada.support, your MCP Server URL is https://acme-corp.eu.ada.support/api/mcp/oauth for OAuth or https://acme-corp.eu.ada.support/api/mcp for API key.

OAuth

OAuth uses browser-based login with your Ada credentials. No API key is required, and no secrets are stored in configuration files.

Use OAuth when:

  • Connecting an interactive AI assistant (Claude Desktop, ChatGPT, Gemini CLI).
  • You want access tied to an individual user account.
  • You want to avoid distributing long-lived credentials.

API key

API keys are generated from Config > PLATFORM > API Keys in your Ada dashboard. See Authentication for details on key management.

Use an API key when:

  • Running MCP clients in non-interactive environments (CI pipelines, scheduled jobs, backends).
  • Integrating programmatically with the Google Agent Development Kit (ADK).
  • Browser-based login is not available.
For security, store the API key as an environment variable rather than pasting it into configuration files.