Connect an MCP client

Connect your MCP client to the hosted Adam server:

https://adam.new/mcp

The recommended setup uses OAuth. You do not need to create an API key or register an OAuth application first.

Claude
Claude Code
Codex
Cursor
Other clients

Add a custom connector

Open Settings → Connectors, choose Add custom connector, and enter https://adam.new/mcp as the server URL.

Leave the client ID empty

Adam supports automatic client registration. Do not add a manual OAuth Client ID.

Connect Adam

Start the connection, sign in to Adam, choose the workspace Claude may access, and approve the permissions.

Add Adam for your user account:

claude mcp add --transport http --scope user adam https://adam.new/mcp

Start Claude Code, enter /mcp, select adam, and authenticate. Sign in to Adam, choose a workspace, and approve the permissions.

Add the remote server, then start the OAuth connection:

codex mcp add adam --url https://adam.new/mcp
codex mcp login adam

Add Adam to your Cursor MCP configuration:

{
  "mcpServers": {
    "adam": {
      "url": "https://adam.new/mcp"
    }
  }
}

Enable the server in Cursor, then complete the Adam sign-in, workspace selection, and permission screens.

Use these connection settings:

Setting	Value
Transport	Streamable HTTP
Server URL	`https://adam.new/mcp`
Authentication	OAuth 2.1 with PKCE
Client registration	Automatic registration supported

Adam publishes the discovery metadata the client needs. If your client cannot use OAuth but supports custom HTTP headers, you can instead send a personal API key as Authorization: Bearer <key>.

What you approve

During OAuth, Adam asks you to choose one workspace. The permission screen may include access to models, projects, tasks, and files. Tools that are not covered by the granted permissions do not appear to the client. To remove access, open Settings → Developer → Connected apps in Adam and revoke the client, or disconnect Adam in the client itself. Connect it again to choose a different workspace or set of permissions.

Only connect clients you trust. An approved client can read or change data in the selected workspace within the permissions shown by Adam.

Troubleshooting

The client asks for an OAuth Client ID

Adam supports automatic client registration, so a Client ID is not needed. Remove the existing Adam connector, add it again with the exact server URL https://adam.new/mcp, and retry the connection. Also update the MCP client if it is not using a current version.

The wrong workspace is connected

Disconnect Adam in the MCP client and reconnect it. Choose the intended workspace on the Adam authorization screen.

A tool is missing

Adam only advertises tools allowed by the connection’s granted permissions. Reconnect and approve the required project, task, model, or file access.

A task has not finished

Task creation and messages start asynchronous work. Ask the client to call adam_get_task until the task completes, fails, is cancelled, or requests input.

The client receives a rate-limit error

Adam currently allows 120 requests per minute per credential. Wait for the retry interval before continuing, and avoid polling a task continuously.

If the connection still fails, check Adam status or contact hello@adam.new.

Getting started

Work in Adam

CAD and integrations

Teams and billing

MCP

API reference

Help

Connect an MCP client

What you approve

Troubleshooting

​What you approve

​Troubleshooting

What you approve

Troubleshooting