> For the complete documentation index, see [llms.txt](https://docs.erathos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.erathos.com/platform/mcp/how-to-connect.md).

# How to Connect

Add the Erathos MCP server to your AI client.

The Erathos MCP server is available at:

```
https://mcp.erathos.com/mcp
```

It's a standard remote MCP server authenticated with OAuth against your own Erathos account — any MCP client that supports remote servers will prompt you to sign in via your browser the first time you connect. You never need to generate or paste an API key or token yourself.

{% hint style="info" %}
Once connected, ask the agent to list your workspaces first (or just start asking it something — most tools resolve this for you). Every tool is scoped to one workspace at a time, and the agent only ever sees the workspaces your own Erathos account already has access to.
{% endhint %}

## Add it to your client

{% tabs %}
{% tab title="Claude Code" %}
From your terminal:

```bash
claude mcp add --transport http erathos https://mcp.erathos.com/mcp
```

This saves the server but doesn't sign you in yet. Complete authentication with either:

```bash
claude mcp login erathos
```

or by running `/mcp` inside a Claude Code session and picking **erathos** — either way opens your browser to sign in to Erathos.

Check the connection any time with `claude mcp get erathos` (or `/mcp` in a session), which reports `✔ Connected`, `! Needs authentication`, or `✘ Failed to connect`.
{% endtab %}

{% tab title="Claude Desktop" %}

1. Open **Settings** (`Ctrl`/`Cmd` + `,`, or the menu → **File** → **Settings**) → **Connectors**.
2. Click **Add** (top right) → **Add custom connector**.
3. Paste in the server URL: `https://mcp.erathos.com/mcp`.
4. Leave **Advanced settings** blank unless you're prompted otherwise, and follow the browser prompt to sign in to your Erathos account.

Available on free, Pro, Max, Team, and Enterprise plans (free is limited to one custom connector). Since Claude connects to this server from Anthropic's cloud rather than your device, the URL above must stay reachable over the public internet — which it is.
{% endtab %}

{% tab title="Claude.ai" %}
**Pro/Max:** **Customize** → **Connectors** → **+** → **Add custom connector** → paste `https://mcp.erathos.com/mcp` → leave **Advanced settings** blank unless prompted otherwise → follow the browser sign-in prompt.

**Team/Enterprise:** an owner first adds it once via **Organization settings** → **Connectors** → **Add** → **Custom** → **Web**, using the same URL. Members then go to **Customize** → **Connectors** and click **Connect** on it — no need to re-enter the URL themselves.
{% endtab %}

{% tab title="Codex" %}
Add it to your `~/.codex/config.toml`:

```toml
[mcp_servers.erathos]
url = "https://mcp.erathos.com/mcp"
auth = "oauth"
```

Then sign in with:

```bash
codex mcp login erathos
```

{% endtab %}

{% tab title="Cursor" %}
Add it to your `~/.cursor/mcp.json` (or a project-level `.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "erathos": {
      "url": "https://mcp.erathos.com/mcp"
    }
  }
}
```

Cursor should prompt you to sign in to Erathos the first time it's used. If it doesn't, check Cursor's own MCP documentation for its `auth` config block — some OAuth servers need one specified explicitly rather than being detected automatically.
{% endtab %}

{% tab title="Other clients" %}
Any MCP client that supports remote (HTTP) servers with OAuth can connect the same way: give it the URL `https://mcp.erathos.com/mcp` and follow its own prompt to sign in. No manual token or API key is needed.
{% endtab %}

{% tab title="VS Code" %}
Open the Command Palette and run **MCP: Add Server**, choose **HTTP**, and paste in `https://mcp.erathos.com/mcp` — or add it directly to your `mcp.json`:

```json
{
  "servers": {
    "erathos": {
      "type": "http",
      "url": "https://mcp.erathos.com/mcp"
    }
  }
}
```

VS Code will prompt you to sign in to Erathos the first time it's used.
{% endtab %}
{% endtabs %}

## See also

* [**Overview**](/platform/mcp.md) — what the MCP server is for.
* [**Available Tools**](/platform/mcp/available-tools.md) — the full reference for everything it exposes.