# Connect a client

> Set up Claude Desktop, Claude Code, Cursor, VS Code, n8n or any MCP client.

Every client needs the URL `https://api.bymundi.com/mcp` and a key sent as `Authorization: Bearer bym_live_…`.

## Claude Desktop

The simplest way, no configuration file:

1. Download the [bymundi extension](https://api.bymundi.com/downloads/bymundi.mcpb).
2. Double-click it; Claude Desktop opens its install screen.
3. Paste your key when asked. Done — ask Claude "what trips do I have?".

The extension also adds `upload_file` and `download_file`, which read and write files on your computer.

## Claude Code

```bash
claude mcp add --transport http bymundi https://api.bymundi.com/mcp --header "Authorization: Bearer $BYMUNDI_KEY"
```

## Cursor

`~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "bymundi": {
      "url": "https://api.bymundi.com/mcp",
      "headers": { "Authorization": "Bearer bym_live_..." }
    }
  }
}
```

## VS Code

`.vscode/mcp.json` — the key is asked once and stored by VS Code:

```json
{
  "inputs": [{ "type": "promptString", "id": "bymundi-key", "description": "bymundi API key", "password": true }],
  "servers": {
    "bymundi": {
      "type": "http",
      "url": "https://api.bymundi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:bymundi-key}" }
    }
  }
}
```

## n8n

Add an **MCP Client Tool** to an AI Agent node: endpoint `https://api.bymundi.com/mcp`, transport **HTTP Streamable**, authentication **Bearer Auth** with your key.

## Any other client

Streamable HTTP, stateless: `POST` JSON-RPC to `/mcp` with the `Authorization` header. Browser origins are refused.

## Not yet

**claude.ai (web and mobile) custom connectors** and **ChatGPT connectors** connect through OAuth, which bymundi does not offer yet. Use Claude Desktop or one of the clients above.