Skip to main content

Behavry Integration — Cursor

Cursor speaks MCP over Streamable HTTP via .cursor/mcp.json. It connects to Behavry's unified MCP gateway (/mcp/v1) with the agent's client credentials as an HTTP Basic header. The config shape is the same as Claude Desktop.

Prerequisites​

  • A running Behavry instance (your control-plane URL, or http://localhost:8000 for a local stack)
  • Cursor installed
  • An enrolled agent (gives you the client_id / client_secret)

1. Enroll the agent​

In the dashboard: Agents → Enroll Agent → Cursor. Behavry provisions the agent and gives you a one-line installer command (curl … | sh) that patches .cursor/mcp.json for you, plus the raw config block if you prefer to edit it by hand.

2. Config file location​

.cursor/mcp.json   (in your project root)

3. Config block​

Merge under the mcpServers key:

{
  "mcpServers": {
    "behavry": {
      "url": "https://<your-behavry-host>/mcp/v1",
      "headers": {
        "Authorization": "Basic <base64(client_id:client_secret)>"
      }
    }
  }
}

Activate in Cursor​

  1. Open Settings → Cursor Settings → MCP
  2. behavry should appear with a green status indicator
  3. If not visible, click Refresh or restart Cursor

Verify​

Open a project and ask: "List the files in this directory." The tool call appears in the dashboard → Live Activity.

Troubleshooting​

Server shows as disconnected — Check the backend is reachable: curl https://<your-behavry-host>/health, and that the url ends in /mcp/v1.

401 Unauthorized — Credentials wrong or agent revoked. Re-enroll and paste the fresh block.

Existing .cursor/mcp.json — The installer merges under the mcpServers key and preserves existing entries; it does not overwrite the file.