MCP Setup

Connect Claude Code, Cursor, Codex, or any MCP client to your Cygent agent.

Overview

Connect Claude Code, Cursor, Codex, or any MCP-compatible client to your Cygent agent. This gives your IDE direct access to CARA's security analysis, findings, and project management tools.

Step 1 — Generate an MCP API key

Open agent Settings

Go to your agent's Settings tab.

Generate an MCP API key

Under MCP API Key, click Generate Key.

Copy the key

Copy the key — you'll need it for the config below. Replace YOUR_MCP_URL with your orchestrator's MCP endpoint and YOUR_API_KEY with the generated key.

💡

The Settings tab also has a "Need help setting up?" button that generates ready-to-copy config with your URL and key pre-filled.

Step 2 — Configure your client

Choose your path

Run from terminal:

claude mcp add --transport http cygent YOUR_MCP_URL -H "Authorization: Bearer YOUR_API_KEY"

Then run /mcp in a Claude Code session to verify the connection.

Or add manually to ~/.claude/mcp_servers.json (global) or .claude/mcp_servers.json (project-scoped):

{
  "cygent": {
    "type": "streamable-http",
    "url": "YOUR_MCP_URL",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

Once your client is configured, you'll see cygent_* tools appear in the client's MCP tool list. Ask your IDE "list my open findings" to smoke-test the connection.