Install

Every MCP-aware client needs the same two values: the server URL and a Bearer token.

Server URL: https://mcp.amba.dev/mcp
Auth:       Authorization: Bearer <your-developer-token>

Mint a token at app.amba.dev/settings/api-keys, or via the CLI:

pnpm amba login
# token is written to ~/.amba/credentials.json

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "amba": {
      "url": "https://mcp.amba.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Restart Claude Desktop. The Amba tools appear in the tool picker on next chat.

Cursor

Edit .cursor/mcp.json in your project (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "amba": {
      "url": "https://mcp.amba.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Reload the Cursor window. Confirm the server shows up under Settings → MCP.

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "amba": {
      "serverUrl": "https://mcp.amba.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Restart Windsurf.

Claude.ai (web)

OAuth-based connectors for Claude.ai are coming soon. In the meantime, use Claude Desktop with the config above.

Verifying

After restart, ask your agent:

List all my Amba projects.

If the agent calls amba_list_projects and returns your projects, you're connected. A 401 means the token is wrong or expired; a MISSING_AUTHORIZATION means the header isn't being sent.