Hosted HTTP endpoint

POST /api/mcp speaks the MCP Streamable-HTTP protocol. No local process, no Node install — your client just needs the URL and a workspace key.

URL: https://notes.iri-ai.com/api/mcp (prod) or http://localhost:4321/api/mcp (dev)
Auth: x-write-key: iri_ws_… header (or Authorization: Bearer iri_ws_…)
Mode: stateless — each JSON-RPC request re-authenticates. Good for Vercel serverless.

Claude Code

Recommended — one command at user scope (works across every project, no approval prompt):

claude mcp add --scope user --transport http iri-notes https://notes.iri-ai.com/api/mcp --header "x-write-key: iri_ws_paste_your_key_here"

Paste it as a single line. Then verify:

claude mcp list   # should show: iri-notes - ✓ Connected

Inside Claude Code, /mcp shows iri-notes. Ask:

Use iri-notes MCP to run whoami.

Alternative — project-scoped `.mcp.json`

Use this if you want the config checked into the repo so teammates share it. Create .mcp.json at the project root:

{
  "mcpServers": {
    "iri-notes": {
      "url": "https://notes.iri-ai.com/api/mcp",
      "headers": {
        "x-write-key": "iri_ws_paste_your_key_here"
      }
    }
  }
}

Important: project-scoped servers require approval before Claude Code loads them. On your next launch inside the project, you'll get a trust dialog — click Approve (don't dismiss). Then /mcp will list iri-notes.

If the prompt never appeared or you dismissed it, see Troubleshooting → "iri-notes doesn't appear in /mcp".

Claude Desktop

Add the same mcpServers block to:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Fully quit and relaunch the app (there is no hot-reload). Tools appear under the 🔌 icon.

Other clients

Any client that speaks MCP's Streamable-HTTP transport works. Point them at the URL and send the key as x-write-key (or Authorization: Bearer).

Raw test

curl -s -X POST https://notes.iri-ai.com/api/mcp \
  -H "content-type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-write-key: iri_ws_…" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

Success returns an SSE frame with the server's protocol version and capabilities.