Octri CLI — Claude Code MCP server: what it does, how to install
Exposes Octri OpenAPI workflows to AI agents for SDK generation across ten languages, API documentation publishing, and production error monitoring.
claude mcp add --env OCTRI_API_KEY=<OCTRI_API_KEY> --env OCTRI_PROJECT_ID=<OCTRI_PROJECT_ID> --env OCTRI_PROFILE=<OCTRI_PROFILE> --env HTTPS_PROXY=<HTTPS_PROXY> --env NO_PROXY=<NO_PROXY> --transport stdio octri-cli -- npx -y @octri/cliWhat Octri CLI does
The server runs via octri mcp serve through standard I/O. It supplies typed tools covering the Octri API. Agents can submit OpenAPI schema files, inspect audit findings, preview generated code, and trigger SDK compilation for target languages.
Documentation lifecycle and runtime telemetry connect directly to the session. You can publish release versions or view production issue traces with mapped frames. For source mapping to succeed, uploaded symbol releases must match runtime SDK identifiers. Running the tool requires Node 20 or newer.
What it helps with
- Upload OpenAPI specs to trigger documentation and SDK builds
- Compile client SDK libraries across multiple languages
- Publish hosted API reference pages with custom domains
- Triage runtime errors reported by client SDKs in production
Example prompts for the agent
- Push openapi.yaml to the project and check build status
- Run an audit on the OpenAPI schema and preview the Go SDK output
- List unresolved production issues from client SDK monitoring
How to install Octri CLI
Platform CLI
claude mcp add --env OCTRI_API_KEY=<OCTRI_API_KEY> --env OCTRI_PROJECT_ID=<OCTRI_PROJECT_ID> --env OCTRI_PROFILE=<OCTRI_PROFILE> --env HTTPS_PROXY=<HTTPS_PROXY> --env NO_PROXY=<NO_PROXY> --transport stdio octri-cli -- npx -y @octri/cliReplace <…> with your own values
Platform CLI
codex mcp add octri-cli --env OCTRI_API_KEY=<OCTRI_API_KEY> --env OCTRI_PROJECT_ID=<OCTRI_PROJECT_ID> --env OCTRI_PROFILE=<OCTRI_PROFILE> --env HTTPS_PROXY=<HTTPS_PROXY> --env NO_PROXY=<NO_PROXY> -- npx -y @octri/cliReplace <…> with your own values
Config file
{
"mcpServers": {
"octri-cli": {
"command": "npx",
"args": [
"-y",
"@octri/cli"
],
"env": {
"OCTRI_API_KEY": "<OCTRI_API_KEY>",
"OCTRI_PROJECT_ID": "<OCTRI_PROJECT_ID>",
"OCTRI_PROFILE": "<OCTRI_PROFILE>",
"HTTPS_PROXY": "<HTTPS_PROXY>",
"NO_PROXY": "<NO_PROXY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"octri-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@octri/cli"
],
"env": {
"OCTRI_API_KEY": "<OCTRI_API_KEY>",
"OCTRI_PROJECT_ID": "<OCTRI_PROJECT_ID>",
"OCTRI_PROFILE": "<OCTRI_PROFILE>",
"HTTPS_PROXY": "<HTTPS_PROXY>",
"NO_PROXY": "<NO_PROXY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e OCTRI_API_KEY=<OCTRI_API_KEY> -e OCTRI_PROJECT_ID=<OCTRI_PROJECT_ID> -e OCTRI_PROFILE=<OCTRI_PROFILE> -e HTTPS_PROXY=<HTTPS_PROXY> -e NO_PROXY=<NO_PROXY> octri-cli npx -y @octri/cliReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Octri CLI
How to install Octri CLI in Claude Code?
Run claude mcp add cli -e OCTRI_API_KEY=<OCTRI_API_KEY> -e HTTPS_PROXY=<HTTPS_PROXY> -- npx -y @octri/cli in your terminal, replacing the placeholder with your Octri key.
What does the Octri CLI MCP server do?
It exposes command-line actions for OpenAPI ingestion, multi-language SDK compilation, documentation releases, and telemetry triage to coding assistants.
What prerequisites are needed to run Octri CLI?
You need Node.js version 20 or later. When operating behind an inspecting proxy, configure standard HTTPS_PROXY and NODE_EXTRA_CA_CERTS environment variables.
