# MCP Setup

Step-by-step setup for connecting your AI assistant to the [Aigon MCP server](/docs/mcp/).

**Endpoint:** `https://mcp.aigon.ai/sse`

Authentication is handled automatically via [OAuth](/docs/auth/#oauth) — a browser window opens for login and consent on first use.

---

## Claude Code {#claude-code}

Claude Code supports SSE transport natively:

```bash
claude mcp add --transport sse aigon-mcp-server https://mcp.aigon.ai/sse
```

Verify with `/mcp` — it should show `aigon-mcp-server` as connected.

---

## Claude Desktop {#claude-desktop}

Claude Desktop does not support SSE transport directly. Use `mcp-remote` as a bridge.

**1. Install Node.js** if you don't have it — `mcp-remote` requires it.

**2. Add to `claude_desktop_config.json`:**

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

**File location:**
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

**3. Restart Claude Desktop.**

**If Claude Desktop cannot find `npx`**, use the absolute path to your Node.js installation:

```json
{
  "mcpServers": {
    "aigon-mcp-server": {
      "command": "/path/to/npx",
      "args": ["mcp-remote", "https://mcp.aigon.ai/sse"],
      "env": {
        "PATH": "/path/to/node:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}
```

Find your npx path with `which npx` in your terminal.

---

## Cursor {#cursor}

Add to `.cursor/mcp.json` in your project root, or `~/.cursor/mcp.json` for global access:

```json
{
  "mcpServers": {
    "aigon-mcp-server": {
      "url": "https://mcp.aigon.ai/sse"
    }
  }
}
```

Cursor supports SSE transport and OAuth natively.

---

## Gemini CLI {#gemini-cli}

Add to `~/.gemini/settings.json`:

```json
{
  "mcpServers": {
    "aigon-mcp-server": {
      "url": "https://mcp.aigon.ai/sse"
    }
  }
}
```

---

## ChatGPT {#chatgpt}

ChatGPT supports remote MCP servers for Pro, Team, and Enterprise users:

1. Go to **Settings → Apps & Connectors**
2. Enable **Developer Mode**
3. Click **Add connector**
4. Enter the server URL: `https://mcp.aigon.ai/sse`
5. Select **OAuth** for authentication
6. Click **I trust this application**

Once added, enable it in a chat via the **+** icon → **Developer Mode** → **Add sources**.

---

## Other Clients {#other-clients}

Any client that supports SSE transport can connect to:

```
https://mcp.aigon.ai/sse
```

The server advertises OAuth metadata at `/.well-known/oauth-protected-resource`. Clients that support OAuth 2.1 will handle authentication automatically. See [Authentication](/docs/auth/#oauth) for the full flow.

---

## Troubleshooting

**Browser doesn't open for login**
The OAuth flow requires a browser. Make sure your MCP client supports OAuth 2.1 with PKCE, or use `mcp-remote` which handles it.

**"aigon-mcp-server" not showing as connected**
Check that the endpoint URL is exactly `https://mcp.aigon.ai/sse` (with `/sse` at the end).

**Claude Desktop: "npx not found"**
Claude Desktop runs in a sandboxed environment and may not see your shell PATH. Use the absolute path to `npx` as shown above.