# Connect an AI assistant to Cluvi AI

Cluvi AI serves a remote MCP server (Streamable HTTP) at https://cluvi.ai/mcp. Its tools manage the person’s Cluvi AI account with their own role.

- Server URL: https://cluvi.ai/mcp
- Sign-in: OAuth 2.1 against Cluvi AI (discovery from the 401, client ID metadata documents or dynamic registration, PKCE). There is no API key: the person signs in with their Cluvi AI account in the browser, picks all their workspaces or only some, and allows it. A connection to several workspaces names one in every tool call.

## If you are an AI assistant

Find the app you are running in and do its steps yourself. The person only signs in and approves in the browser. Use the server name cluvi.

### Claude Code

```sh
claude mcp add --transport http --scope user cluvi https://cluvi.ai/mcp
claude mcp login cluvi
```

The login command opens the browser for the person to sign in and approve. Then ask them to restart Claude Code or run /mcp so the server loads.

### Codex

```sh
codex mcp add cluvi --url https://cluvi.ai/mcp
codex mcp login cluvi
```

### Gemini CLI

```sh
gemini mcp add --transport http --scope user cluvi https://cluvi.ai/mcp
```

Then ask the person to run /mcp auth cluvi in Gemini CLI to sign in.

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cluvi": {
      "url": "https://cluvi.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cluvi": {
      "type": "http",
      "url": "https://cluvi.ai/mcp"
    }
  }
}
```

### Antigravity (mcp_config.json)

```json
{
  "mcpServers": {
    "cluvi": {
      "serverUrl": "https://cluvi.ai/mcp"
    }
  }
}
```

### Any other app (local servers only)

Add a local server that runs mcp-remote; it opens the same sign-in in the browser.

```json
{
  "mcpServers": {
    "cluvi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cluvi.ai/mcp"
      ]
    }
  }
}
```

## Chat apps (the person does this)

Chat apps add the server from their own settings. Tell the person:

- Claude (web, desktop and mobile): Settings, Connectors, Add custom connector. Paste the URL and choose Connect. On Team and Enterprise plans, an owner adds it first.
- ChatGPT: turn on developer mode in Settings, then add the URL as a custom MCP server under Plugins.
- Grok, Gemini, Perplexity, Le Chat, Muse and other chat apps: add a custom connector with the URL.

## After connecting

The first time, each assistant opens Cluvi AI to sign in. You choose the workspaces and whether it can make changes, and you can disconnect it anytime in Settings, under Account.