> ## Documentation Index
> Fetch the complete documentation index at: https://octolens.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup Guides

> Step-by-step guides to connect the Octolens MCP server to Claude Desktop, ChatGPT, Cursor, Cline, and other tools that support Model Context Protocol.

## Claude Code

Add the Octolens MCP server using the CLI command.

<Warning>
  **Treat this URL like a password.** Your MCP URL contains your API token in the query string. Don't share it, commit it to version control, or paste it in screenshots.
</Warning>

#### 1. Run this command

Remember to replace the URL with your own.

```bash theme={null}
claude mcp add octolens \
  --transport sse \
  "https://app.octolens.com/api/mcp?token=YOUR_API_KEY"
```

#### 2. Verify the connection

Inside Claude Code, run the `/mcp` command to check the server status:

```
/mcp
⎿ MCP Server Status
  • octolens: connected
```

Scope options: Add `--scope user` to make it available across all projects, or `--scope project` to share with your team via `.mcp.json`.

***

## Claude Desktop / Web

Add the Octolens MCP server to Claude Desktop or Claude Web.

#### 1. Using Connectors (Pro, Max, Team & Enterprise)

Go to `Settings → Connectors → Add Custom Connector` and add the server URL:

```
https://app.octolens.com/api/mcp?token=YOUR_API_KEY
```

#### 2. Alternative: use mcp-remote

Edit your config file:

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

Replace `YOUR_API_KEY` with your API key:

```json theme={null}
{
  "mcpServers": {
    "octolens": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.octolens.com/api/mcp?token=YOUR_API_KEY"
      ]
    }
  }
}
```

#### 3. Restart Claude Desktop

After saving, restart Claude Desktop to connect.

***

## ChatGPT

Add the Octolens MCP server to ChatGPT.

#### 1. Enable Developer Mode

Go to `Settings → Apps` and turn on Developer Mode.

#### 2. Create the app

Create a new app with no authentication, using just the server URL:

```
https://app.octolens.com/api/mcp?token=YOUR_API_KEY
```

#### 3. Use in chat

In the chat, click the `+` button and select the Octolens MCP.

***

## Cursor

Add the Octolens MCP server to your Cursor IDE.

#### 1. Open MCP settings

Open the Command Palette (`⌘ + Shift + P` on Mac, `Ctrl + Shift + P` on Windows), search for "MCP" and select "Add new global MCP server".

Or edit the config file directly:

* **macOS/Linux:** `~/.cursor/mcp.json`
* **Windows:** `%USERPROFILE%\.cursor\mcp.json`

#### 2. Add this configuration

Replace `YOUR_API_KEY` with your API key:

```json theme={null}
{
  "mcpServers": {
    "octolens": {
      "url": "https://app.octolens.com/api/mcp?token=YOUR_API_KEY"
    }
  }
}
```

#### 3. Reload Cursor

After saving, reload Cursor to connect. Use MCP tools in Agent mode.