CodeAtlas
Autonomous

AI agents

Live architecture workflows executing against canonical graph versions.

Connect an MCP coding agent

Cursor, Claude Desktop, Claude Code, and OpenClaw can use the local CodeAtlas stdio bridge to read architecture graphs and create approval-gated plans. The bridge authenticates with a long-lived personal access token that you can revoke at any time — session sign-out will not affect it.

get_architecture_graph · create_implementation_plan
Run from the CodeAtlas checkout: uv run python -m app.mcp_server
Personal access tokens
No tokens yet. Generate one to configure your MCP-capable agent.

Tokens carry your workspace role — treat them like a password. See the full walkthrough in docs/07-mcp/client-setup.md.

Set up your MCP client

The remote HTTP transport is the recommended setup: no Python, no repo clone, just a URL and your cak_… PAT. Local stdio (requires cloning this repo) is still available in the Advanced section below each tab.

Remote HTTP:No local install·Endpoint: https://codeatlas-api-r0e9.onrender.com/api/v1/mcp·Auth: Authorization: Bearer cak_…
Remote HTTP (recommended)
Config location
~/.cursor/mcp.json (user) —or— .cursor/mcp.json (project, do not commit the token)

No install required. Point Cursor at the hosted MCP endpoint and pass your PAT as an Authorization header.

Config JSON
{
  "mcpServers": {
    "codeatlas": {
      "url": "https://codeatlas-api-r0e9.onrender.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <PASTE-cak-TOKEN-HERE>"
      }
    }
  }
}
Verify — Remote HTTP
Restart Cursor. Ask the AI chat 'list your MCP tools' — you should see get_architecture_graph and create_implementation_plan.

Cursor official MCP docs
Troubleshooting
  • Personal access token is invalid or revoked — regenerate on this page and update your client config.
  • Unable to reach CodeAtlas API — the free-tier backend spins down after inactivity; first request wakes it (30–60s). Retry.
  • Tools don't appear — restart the client after editing config. Verify the --directory value points at a real CodeAtlas checkout.
  • 403 on a repository — connect the repository under Settings → Integrations first.
Full setup guide with troubleshooting
Architecture projector
idle

Turns parsed source facts into immutable graph versions.

0
Completed
—
State
Last work: awaiting work
Documentation generator
idle

Renders Markdown, Mermaid, Draw.io, and C4 directly from graph versions.

0
Completed
—
State
Last work: awaiting work
Implementation planner
idle

Builds graph-bound plans that require approval before PR creation.

0
Completed
—
State
Last work: awaiting work
MCP coding bridge
idle

Supplies graph and approved plan context to a coding agent without source-file access.

0
Completed
—
State
Last work: awaiting work