Skip to content
AADM
MCP

AADM + Claude MCP · Streamable HTTP

Standard in the cloud.
Claude Code in your repo.

The wire

Point Claude Desktop or Claude Code at the hosted MCP the same way you wire any HTTP MCP. Subscriber token, stable tools, your codebase still owns proof.

Briefs and doctrine come from MCP. Tests, CI, and traces stay in your repo. The result · Claude runs Navigator, Investigator, and Sentinel workflows with the same discipline a senior reviewer would demand.

▸ Step 0 · npx aadm-init-repo --full · init guide · the discipline

Connection steps & copy-paste MCP overview & pricing Read the standard

Connect AADM MCP to Claude.

One subscriber token, one MCP endpoint. Paste an aadm_… dashboard token or Bearer ak_… account API key from your AADM dashboard. Never commit real secrets.

Steps

  1. 01 Create an AADM account or sign in, subscribe, then copy your OAuth client ID from Member area → MCP OAuth (or create an ak_… key in Member area → API keys).
  2. 02 Merge the JSON below into your Claude config's mcpServers object (see paths for Desktop vs Claude Code).
  3. 03 Use the raw token in Authorization, or Bearer ak_… if your build expects that prefix.
  4. 04 Fully quit and reopen Claude Desktop, or start a new Claude Code session in the terminal after saving — hosts do not always hot-reload MCP definitions.
  5. 05 In chat, ask Claude to use AADM tools — standard_brief, debug_defect, fetch_auth. Confirm tools/list shows aadm.

Where to paste

Claude Desktop
macOS · ~/Library/Application Support/Claude/claude_desktop_config.json
Windows · %APPDATA%\Claude\claude_desktop_config.json
Linux · ~/.config/Claude/claude_desktop_config.json
Claude Code (CLI / IDE)
User scope · ~/.claude.json — merge mcpServers. Optional project file · .mcp.json in the repo root for teams that version a shared template (keep secrets out of git).

Anthropic's filenames and reload rules can change by release — double-check current Claude docs if something doesn't register. Try claude mcp --help on recent CLI builds.

mcpServers.aadm · copy ready 
{
  "mcpServers": {
    "aadm": {
      "type": "http",
      "url": "https://mcp.aadm.io/mcp",
      "headers": {
        "Authorization": "<your token here>"
      }
    }
  }
}

url must be https://mcp.aadm.io/mcp (include /mcp).
Service discovery · https://mcp.aadm.io/

Desktop vs terminal. Same wire.

Both attach to the same HTTP MCP. The difference is where your files and shell session live — not what AADM ships over the wire.

D

Claude Desktop

GUI app, broad integrations, good for docs-centric sessions and walking stakeholders through standard_brief outputs. Paste logs and HAR excerpts into chat; pair with local repos manually when you need file paths.

T

Claude Code · terminal

Runs against a working tree · read, search, diff, test commands, and multi-step refactors in one thread. Ideal for Investigator loops — MCP supplies gates and doctrine; the CLI supplies evidence from your machine.

What Claude Code can do with AADM MCP.

The MCP does not edit your repo. Claude Code does. Together they keep turns structured · orchestrator metadata, AUTH text on demand, and troubleshooting rails that resist premature fixes.

  • A

    Navigator-style delivery

    Pull plan_delivery, doctrine slices, and AUTH cites while shaping a feature across layers.

    runs · plan_delivery

  • B

    Investigator defects

    Use debug_defect for gated recon and classification. Append evidence across turns without rewriting the brief.

    runs · debug_defect

  • C

    Sentinel assurance

    Run audit_run / audit_outline for seam language. Bind horizontal boundaries while Claude traces files locally.

    runs · audit_run · audit_outline

  • D

    AUTH literacy

    fetch_auth returns the real markdown for AUTH-XX so reviews cite governance text — not memory.

    runs · fetch_auth

  • E

    Orchestrator hooks

    route_lane, orchestrator_anchor, and standard_brief give deterministic branching for long sessions.

    runs · route_lane · orchestrator_anchor

  • F

    Proof stays local

    MCP never replaces CI. Claude runs tests you invoke; pass/fail remains authoritative in your pipeline.

    runs · your CI

~2h seam hunt (fictional).

Timestamps show how MCP calls and local investigation interleave during a horizontal seam bug · gateway ↔ worker ↔ idempotency. Not captured from a live recording.

payments-worker · claude · zsh

[09:14]

you — Duplicate charges after retries. Gateway logs show 202 + worker shows single consume. Suspect seam between API idempotency key and queue dedupe. Wired AADM MCP — want Investigator framing + AUTH cites for idempotency + jobs.

[09:16]

claude — I'll take a structured lane first, then we'll anchor evidence before touching code.

MCP route_lane intent · defect 
→ routing_basis: EXPLICIT_WORKFLOW_INTENT
→ primary_tool: debug_defect
→ recommended_next_tools: [ "debug_defect", "fetch_auth", "standard_brief" ]

[09:21]

MCP fetch_auth AUTH-25 · AUTH-28

→ Loaded markdown for duplicate / idempotent handling themes (illustrative) — we'll map claims to gateway vs worker code paths next.

[09:35]

MCP debug_defect Path A · UNCLASSIFIED 
WHAT THIS MEANS · Single next action:
Run one replay: POST /pay with same Idempotency-Key + body hash,
capture gateway response headers AND worker dequeue span id.

Forbidden right now: patch mapper + broaden retries in same turn.

claude — Running curl replay against staging with your .env.staging headers…

[10:02]

you — Pasted HAR row + worker trace · dequeue twice same payload id, gateway still returned cached 202 body from first attempt.

MCP debug_defect append_evidence

→ Still UNCLASSIFIED until we tie duplicate dequeue to idempotency scope (per-key vs per-route vs worker lease).

[10:48]

claude — Grepped repo · idempotency middleware stores key in Redis with TTL. Worker consumer builds dedupe key from message body only — omits tenant id when queue fan-out expands.

[11:30]

MCP standard_brief

→ Pulled orchestrator_contract reminder · don't Navigator away a classified defect. Stay Investigator until remediation pack is justified.

[11:44]

MCP debug_defect CLASSIFIED · Path B 
rootCauseClassificationStatus: CLASSIFIED
horizontal seam: gateway cache layer ↔ worker dedupe key construction
haltBeforeFix: satisfied for scoped patch proposal

[11:58]

claude — Proposing minimal change · include tenant + idempotency key in worker dedupe hash. Adding integration test matching gateway middleware contract. Running existing suite…

[12:06]

you — Green on payments-worker + gateway contract tests. Ship with guardrail note in changelog.

Narrative compressed for the page; real threads mix more file reads, failing runs, and MCP JSON. Your hosted server's tools/list remains authoritative.

Illustration only · not a recording of Claude Code or the AADM MCP service

Connect once. Wire everywhere.

AADM MCP works with every MCP-capable IDE. Set it up in Claude — then take the same config to Cursor, Windsurf, and anything else that speaks the protocol.

Hosted MCP · access AADM + Cursor → Why AADM, vs raw loops