Octri

MCP Server

Install

The server ships as @octri/mcp and runs through npx, so there is nothing to install ahead of time. You need your project id, which you'll find in the dashboard.

Claude Desktop

Add to claude_desktop_config.json. On macOS that lives at ~/Library/Application Support/Claude/claude_desktop_config.json, on Windows at %APPDATA%\Claude\claude_desktop_config.json.

json
{
  "mcpServers": {
    "my-api-docs": {
      "command": "npx",
      "args": ["@octri/mcp", "--project-id", "YOUR_PROJECT_ID"]
    }
  }
}

Restart Claude Desktop after editing the file. The config is only read at startup.

Cursor

Add to .cursor/mcp.json in your project root, or ~/.cursor/mcp.json to enable it everywhere.

json
{
  "mcpServers": {
    "my-api-docs": {
      "command": "npx",
      "args": ["@octri/mcp"],
      "env": {
        "OCTRI_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json.

json
{
  "servers": {
    "my-api-docs": {
      "command": "npx",
      "args": ["@octri/mcp"],
      "env": {
        "OCTRI_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Flag or environment variable

--project-id and OCTRI_PROJECT_ID do the same thing. The flag wins if both are set.

Prefer the env var for a shared config

A .cursor/mcp.json committed to your repo gives every contributor the server without each one editing their own config. The env form keeps that file free of anything machine-specific.

Verifying it works

Ask the assistant something only your docs can answer, e.g. "search my API docs for pagination". If it answers from your content, the server is connected.

If nothing shows up, see Troubleshooting.

Next