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.
{
"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.
{
"mcpServers": {
"my-api-docs": {
"command": "npx",
"args": ["@octri/mcp"],
"env": {
"OCTRI_PROJECT_ID": "YOUR_PROJECT_ID"
}
}
}
}VS Code
Add to .vscode/mcp.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.
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.