Skip to content

Connect an agent

Use the hosted endpoint https://codeintent-api-ded80aad7f4b.herokuapp.com/mcp, or your own deployment's URL. Keep the token in an environment variable, not in a committed file:

export CODEINTENT_MCP_TOKEN="ci_mcp_…"

Claude Code

claude mcp add --transport http codeintent https://YOUR-HOST/mcp \
  --header "Authorization: Bearer ${CODEINTENT_MCP_TOKEN}"

Or commit a project .mcp.json. Claude Code expands ${VAR} when it connects, so the token stays out of the file:

{
  "mcpServers": {
    "codeintent": {
      "type": "http",
      "url": "https://YOUR-HOST/mcp",
      "headers": { "Authorization": "Bearer ${CODEINTENT_MCP_TOKEN}" }
    }
  }
}

A first-time upgrade_brief can take longer than a minute. If Claude Code times out, raise its limit with MCP_TOOL_TIMEOUT=300000 (milliseconds).

Cursor

.cursor/mcp.json in the project, or ~/.cursor/mcp.json:

{
  "mcpServers": {
    "codeintent": {
      "url": "https://YOUR-HOST/mcp",
      "headers": { "Authorization": "Bearer ${env:CODEINTENT_MCP_TOKEN}" }
    }
  }
}

Some Cursor builds do not interpolate ${env:...} in remote headers. If the server answers 401, put the literal token in your global ~/.cursor/mcp.json instead of a committed file.

Codex

~/.codex/config.toml, or .codex/config.toml in a trusted project:

[mcp_servers.codeintent]
url = "https://YOUR-HOST/mcp"
bearer_token_env_var = "CODEINTENT_MCP_TOKEN"
tool_timeout_sec = 300

The CLI equivalent:

codex mcp add codeintent --url https://YOUR-HOST/mcp --bearer-token-env-var CODEINTENT_MCP_TOKEN

Devin and other clients

Add a custom MCP server with transport streamable HTTP (sometimes labelled "HTTP"), URL https://YOUR-HOST/mcp, and the header Authorization: Bearer <token>.

Python (MCP SDK)

import httpx2
from mcp import Client
from mcp.client.streamable_http import streamable_http_client

async with httpx2.AsyncClient(headers={"Authorization": f"Bearer {token}"}, timeout=httpx2.Timeout(30, read=600)) as http:
    async with Client(streamable_http_client("https://YOUR-HOST/mcp", http_client=http)) as client:
        brief = await client.call_tool("upgrade_brief", {"repo": "pallets/flask@1.1.4", "package": "itsdangerous", "to_version": "2.1.0", "from_version": "1.1.0"})
        print(brief.structured_content["steps"])