> ## 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 v2 server to Claude Code, Claude Desktop/Web, ChatGPT, Cursor, and other tools that support Model Context Protocol.

All v2 connections use the same server URL and OAuth — there's no API key to paste.

```
https://app.octolens.com/api/mcp/v2
```

On first use, your client opens a browser tab where you sign in to Octolens and approve the connection.

<Tip>
  You can launch any of these flows from inside the app under **Settings → MCP → Setup Octolens MCP**, which walks you through the same steps per tool.
</Tip>

<Frame>
  <img src="https://mintcdn.com/octolens/hfuquXwRhG6svnqV/images/mcp-v2-setup-modal.png?fit=max&auto=format&n=hfuquXwRhG6svnqV&q=85&s=a30af078d41b695a30ba98125c44db30" alt="Setup MCP modal — choose the tool to connect Octolens to" width="1060" height="614" data-path="images/mcp-v2-setup-modal.png" />
</Frame>

***

## Claude Code

Add the Octolens MCP server using the CLI command.

#### 1. Add the server

No API key needed.

```bash theme={null}
claude mcp add --transport http octolens \
  "https://app.octolens.com/api/mcp/v2"
```

Right after running this, the server shows as `needs authentication` — that's expected. The next step signs you in.

#### 2. Authenticate

Run `/mcp` inside Claude Code and pick **octolens → Authenticate**. A browser tab opens — sign in to Octolens and approve. The server then shows as connected:

```
/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`.

<Frame>
  <img src="https://mintcdn.com/octolens/hfuquXwRhG6svnqV/images/mcp-v2-claude-code.png?fit=max&auto=format&n=hfuquXwRhG6svnqV&q=85&s=3ea17f1f5b73ca6916fc14c0b532591f" alt="Claude Code setup steps for Octolens MCP v2" width="1546" height="998" data-path="images/mcp-v2-claude-code.png" />
</Frame>

***

## 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/v2
```

Claude opens a browser tab to sign in with your Octolens account — no client ID or secret to enter.

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

Edit your config file:

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

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

#### 3. Restart Claude Desktop

After saving, restart Claude Desktop to connect.

<Frame>
  <img src="https://mintcdn.com/octolens/hfuquXwRhG6svnqV/images/mcp-v2-claude-desktop.png?fit=max&auto=format&n=hfuquXwRhG6svnqV&q=85&s=29705c3c11cc5ec1f180c80e87c57314" alt="Claude Desktop / Web setup steps for Octolens MCP v2" width="1644" height="1308" data-path="images/mcp-v2-claude-desktop.png" />
</Frame>

***

## 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 **OAuth authentication**, using just the server URL:

```
https://app.octolens.com/api/mcp/v2
```

ChatGPT discovers the OAuth configuration automatically — no client ID or secret to enter. You'll be prompted to sign in to Octolens.

#### 3. Disable OpenID Connect

Expand `Advanced Settings` and uncheck **OIDC enabled**. Leaving it on causes the sign-in to fail.

#### 4. Use in chat

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

<Frame>
  <img src="https://mintcdn.com/octolens/hfuquXwRhG6svnqV/images/mcp-v2-chatgpt.png?fit=max&auto=format&n=hfuquXwRhG6svnqV&q=85&s=ca80671994ecd10216624dc78a871fdc" alt="ChatGPT setup steps for Octolens MCP v2" width="1608" height="926" data-path="images/mcp-v2-chatgpt.png" />
</Frame>

***

## 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

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

#### 3. Authenticate

After saving the config, go back to `Cursor Settings → MCP`, click refresh, then click **Authenticate** on the Octolens entry. A browser tab opens to sign in with your Octolens account. Once connected, use the MCP tools in Agent mode.

<Frame>
  <img src="https://mintcdn.com/octolens/hfuquXwRhG6svnqV/images/mcp-v2-cursor.png?fit=max&auto=format&n=hfuquXwRhG6svnqV&q=85&s=730fed3ea5390e0d2cad2159cdaf6807" alt="Cursor setup steps for Octolens MCP v2" width="1266" height="1166" data-path="images/mcp-v2-cursor.png" />
</Frame>