@corti/mcp

MCP proxy for Claude Desktop — bridges stdio ↔ Corti's Streamable HTTP API.

Claude Desktop (stdio) ↔ @corti/mcp ↔ Corti API (HTTPS)

Quick Start

No installation needed — run directly with npx:

npx @corti/mcp --key crt_your_api_key_here

Get your API key from app.corti.wiki → Settings → MCP Keys.

Claude Desktop Setup

Add the following to your Claude Desktop config file:

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

{
  "mcpServers": {
    "corti": {
      "command": "npx",
      "args": ["-y", "@corti/mcp", "--key", "crt_your_api_key_here"]
    }
  }
}

Tip: The -y flag skips the npx install prompt so Claude Desktop doesn't hang.

Restart Claude Desktop after saving the config. You should see Corti appear in the MCP servers list.

Options

| Flag | Required | Default | Description | |------|----------|---------|-------------| | --key / -k | ✅ | — | Corti MCP API key (crt_…) | | --endpoint / -e | ❌ | https://api.corti.wiki/mcp/ | Upstream MCP endpoint |

Custom endpoint (self-hosted)

{
  "mcpServers": {
    "corti": {
      "command": "npx",
      "args": [
        "-y", "@corti/mcp",
        "--key", "crt_your_key",
        "--endpoint", "https://your.corti.instance/mcp/"
      ]
    }
  }
}

Claude Code / Windsurf / Cursor

Any MCP-compatible client that supports stdio servers works the same way.

Claude Code:

claude mcp add corti -- npx -y @corti/mcp --key crt_your_key

Windsurf / Cursor — use the same JSON block in their respective MCP config files.

How It Works

@corti/mcp is a transparent proxy:

1. Receives MCP JSON-RPC messages from Claude Desktop via stdin
2. Forwards each request to the Corti API at https://api.corti.wiki/mcp/ over HTTPS, injecting Authorization: Bearer <key>
3. Streams responses back to Claude Desktop via stdout

No data is stored locally. All processing happens in the Corti cloud.

Security

• Your API key is passed via CLI args and stored only in Claude Desktop's config.
• The proxy adds the key as an HTTP Authorization: Bearer header on every upstream request.
• Use workspace-scoped MCP keys — never your account password.

Troubleshooting

Claude Desktop shows "Server failed to start":

• Make sure node ≥ 18 is on your PATH
• Run npx @corti/mcp --key crt_xxx manually in a terminal to see error output

"Missing required option '--key'":

• Your config is missing the --key arg. Double-check your JSON config.

Tools not showing up:

• Your API key may not have access to any workspace. Log in to app.corti.wiki and create a workspace first.

Development

git clone https://github.com/heavaa/corti.git
cd corti/packages/mcp-proxy
npm install
npm run build
npm test

# Run locally
node dist/index.js --key crt_xxx

License

MIT © Heavaa