Kemon Docs

MCP Setup

Connect your AI coding tool to Kemon's MCP server in under a minute.

Kemon's MCP server works with any client that supports Streamable HTTP transport. Below are setup instructions for popular AI coding tools.

Prerequisites

Before you start

You need a private API key with the scopes you want to use. Create one in Developer Settings.

Client setup

Replace YOUR_API_KEY with your private API key.

Run this command in your terminal:

claude mcp add --transport http kemon https://mcp.kemon.io \
  --header "Authorization: Bearer YOUR_API_KEY"

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "kemon": {
      "url": "https://mcp.kemon.io",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Add to .github/copilot/mcp.json in your project root:

{
  "servers": [
    {
      "type": "http",
      "url": "https://mcp.kemon.io",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  ]
}

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "kemon": {
      "serverUrl": "https://mcp.kemon.io",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf uses serverUrl instead of url.

Run this command in your terminal:

codex mcp add --transport http kemon https://mcp.kemon.io \
  --header "Authorization: Bearer YOUR_API_KEY"

Add to opencode.json in your project root:

{
  "mcpServers": {
    "kemon": {
      "url": "https://mcp.kemon.io",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Verifying the connection

After setup, ask your AI assistant something like "List my Kemon teams". If the connection is working, it will call the list_teams tool and return your workspace's teams.

Troubleshooting

ErrorCauseFix
401 UnauthorizedInvalid or expired API keyCheck that your key is correct, active, and not expired
403 ForbiddenMissing required scopeYour API key doesn't have the scope needed for the tool being called. Create a new key with the right scopes
429 Too Many RequestsRate limit exceededRequests are limited to 120 per 60 seconds. Wait and retry
Connection errorIncorrect URLVerify the origin URL is correct and accessible from your machine

On this page