Claude Desktop

Claude Desktop supports both OAuth and API key authentication for the Ada MCP server.

Requirements

• Claude Desktop installed.
• Node.js LTS installed locally (see recommendation).
• An Agent, Admin, or Owner role in your Ada dashboard.

Option 1: OAuth (recommended)

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.

Next steps

• Try a prompt from the prompt library.
• Review data privacy settings.
• Connect additional AI Agents: see Connecting multiple Agents.