Skip to content

MCP Installation

Prerequisites

  • Node.js 18+
  • A Cyborg publishable key (get one from the dashboard)
  • Claude Code or Cursor IDE

Claude Code Setup

Add to ~/.claude/mcp.json:

json
{
  "mcpServers": {
    "cyborg": {
      "command": "npx",
      "args": ["@cyborg-sdk/mcp"],
      "env": {
        "CYBORG_PUBLISHABLE_KEY": "cpk_live_xxx"
      }
    }
  }
}

Cursor Setup

Add to your Cursor MCP configuration:

json
{
  "cyborg": {
    "command": "npx",
    "args": ["@cyborg-sdk/mcp"],
    "env": {
      "CYBORG_PUBLISHABLE_KEY": "cpk_live_xxx"
    }
  }
}

Environment Variables

VariableRequiredDefaultDescription
CYBORG_PUBLISHABLE_KEYYes*-Your Cyborg publishable key
CYBORG_API_URLNohttps://api.cyborgsdk.dev/api/v1Custom API endpoint

*Can also be passed directly to tool calls via the publishableKey parameter.

Verify Installation

After configuration, restart your IDE and try:

  1. Ask Claude to "list my documentation files"
  2. You should see the docs://files resource available

Troubleshooting

"MCP server not found"

Make sure:

  • Node.js 18+ is installed
  • npx is in your PATH
  • The MCP configuration file is in the correct location

"Authentication failed"

Check that:

  • Your API key is correct
  • The API key has the necessary permissions
  • The environment variable is set correctly

"Connection refused"

Verify:

  • Your network allows outgoing HTTPS connections
  • The API URL is correct (default: https://api.cyborgsdk.dev/api/v1)

Next Steps

Built with VitePress