# Connect a client

Add `https://mcp.cademi.dev/mcp` to your MCP client as a remote server and authorize it by signing in to Cademí. You never paste an API key or a token.

## Any MCP client

Your client needs to support remote MCP servers over the Streamable HTTP transport, with OAuth authorization.

| Setting | Value |
|---|---|
| Server URL | `https://mcp.cademi.dev/mcp` |
| Transport | Streamable HTTP |
| Authentication | OAuth. Leave any API key or header field empty. |

The server is an OAuth protected resource. The first request without an authorization returns `401` with a `WWW-Authenticate` header that points to the server's protected resource metadata, and that document names the Cademí authorization server. A client that implements MCP authorization follows this chain on its own and opens the Cademí authorization page in your browser. What happens on that page is described in [Authorization and permissions](https://cademi.dev/mcp/authorization.md#authorizing-a-connection).

The server keeps no session between requests, and each connection works on one account.

## Claude

In Claude on the web or in the desktop app:

1. Open **Settings**, then **Connectors**.
2. Choose **Add custom connector**.
3. Paste `https://mcp.cademi.dev/mcp` as the URL and add the connector.
4. Choose **Connect**. The Cademí authorization page opens.
5. Choose your account, sign in as an administrator of that account, and approve the connection.

Back in Claude, the connector shows as connected and its tools are available in your conversations.

## Claude Code

Add the server:

```sh
claude mcp add --transport http cademi https://mcp.cademi.dev/mcp
```

Then, inside Claude Code, run:

```text
/mcp
```

Select `cademi` and authenticate. The Cademí authorization page opens in your browser: choose your account, sign in as an administrator, and approve the connection.

## Check the connection

Ask the assistant which account it is connected to:

```text
Which Cademí account am I connected to?
```

The assistant answers with the `instance_overview` tool, which returns the account, its environment (production or sandbox), and the administrator the connection acts as. The same data is available as the `cademi://instance/current` resource ([Resources](https://cademi.dev/mcp/resources-and-prompts.md#resources)).

If a tool returns `AUTHENTICATION_REQUIRED`, the authorization is no longer valid. Connect again from your client: **Connect** on the connector in Claude, or `/mcp` in Claude Code. See [Errors and limits](https://cademi.dev/mcp/errors-and-limits.md).