IntroductionGetting started

Claude

Claude connects to the MCP server through two clients:

Both support OAuth and API key authentication and require an Ada dashboard account. Available tools depend on your role — see Permissions.

Claude Desktop

Requirements

OAuth uses browser-based login with your Ada credentials. No API key is required.

  1. Open Claude Desktop.

  2. Go to Settings → Developer → Edit Config.

  3. Add the following to your claude_desktop_config.json:

    1{
    2  "mcpServers": {
    3    "ada": {
    4      "command": "npx",
    5      "args": ["mcp-remote", "https://acme-corp.ada.support/api/mcp/oauth"]
    6    }
    7  }
    8}

  4. Replace acme-corp.ada.support with your Ada instance domain (see Authentication).

  5. Restart Claude Desktop.

  6. When prompted, authorize the connection with your Ada credentials.

Option 2: API key

API key authentication uses a token generated from your Ada dashboard. This is useful for automated setups or when browser-based login is not available.

  1. Generate an API key from Config > PLATFORM > API keys in your Ada dashboard.

  2. Open Claude Desktop and go to Settings → Developer → Edit Config.

  3. Add the following to your claude_desktop_config.json:

    1{
    2  "mcpServers": {
    3    "ada": {
    4      "command": "npx",
    5      "args": [
    6        "mcp-remote",
    7        "https://acme-corp.ada.support/api/mcp",
    8        "--header",
    9        "Authorization:${AUTH_HEADER}"
    10      ],
    11      "env": {
    12        "AUTH_HEADER": "Bearer YOUR_API_KEY"
    13      }
    14    }
    15  }
    16}

  4. Replace acme-corp.ada.support with your Ada instance domain.

  5. Replace YOUR_API_KEY with your API key.

  6. Restart Claude Desktop.

Claude Code

Requirements

Run this command, replacing acme-corp.ada.support with your Ada instance domain:

$claude mcp add --transport http ada https://acme-corp.ada.support/api/mcp/oauth

Then run /mcp inside Claude Code to authenticate in the browser.

Option 2: API key

Generate an API key from Config > PLATFORM > API keys in your Ada dashboard, then run this command, replacing the domain and key:

$claude mcp add --transport http ada https://acme-corp.ada.support/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Run /mcp to confirm ada shows connected. Note that Claude Code stores the key in plaintext in ~/.claude.json, scoped to the directory you ran the command in — add -s user to make it available everywhere.

Next steps