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.

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.

1. Run this command

Remember to replace the URL with your own.

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:

{
  "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:

{
  "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.