Claude Code

How it works

MCP config is files or CLI (claude mcp add) — not pasted into chat.

Architecture

Repo + Claude Code → MCP (stdio) → Apender API → plan back to the agent.

Configuration

Use claude mcp add (see below) or add the apender block from MCP configure to .mcp.json at the repo root.

Option A — Claude Code CLI (terminal)

From the repo root. Use absolute paths on Windows. Everything after -- is the MCP server process.

# macOS / Linux — set values from Dashboard → API keys
export APD_API_KEY="apd_live_your_key"
export APD_API_URL="<API base URL from keys page>"
claude mcp add apender --scope project \
  --env APD_API_URL=$APD_API_URL \
  --env APD_API_KEY=$APD_API_KEY \
  --env APD_WORKSPACE_ROOT=$PWD \
  -- node "/absolute/path/to/apender-mcp-server"

# Windows PowerShell
$env:APD_API_KEY = "apd_live_your_key"
$env:APD_API_URL = "<API base URL from keys page>"
claude mcp add apender --scope project `
  --env APD_API_URL=$env:APD_API_URL `
  --env APD_API_KEY=$env:APD_API_KEY `
  --env APD_WORKSPACE_ROOT=$PWD `
  -- node "C:\absolute\path\to\apender-mcp-server"

Inside a session, run /mcp to confirm Apender is connected. Restart Claude Code after changes.

Option B — project file

Add the apender block from MCP configure to .mcp.json at the repo root. Set APD_API_KEY in the shell (Claude expands ${APD_API_KEY}). Commit .mcp.json without secrets.

Example server block — adjust paths as needed. Full reference: MCP configure.

{
  "mcpServers": {
    "apender": {
      "command": "node",
      "args": ["/absolute/path/to/apender-mcp-server"],
      "env": {
        "APD_API_URL": "<API base URL from Dashboard → API keys>",
        "APD_API_KEY": "apd_live_your_key",
        "APD_WORKSPACE_ROOT": "/absolute/path/to/git/repo"
      }
    }
  }
}

Authentication

APD_API_KEY and APD_API_URL from Dashboard → API keys.

Create keys in Dashboard → API keys.

Workspace root

APD_WORKSPACE_ROOT must be the repo where claude runs (git root).

Example

Run claude from the repo root, describe the feature — the agent calls Apender before editing files.

Troubleshooting

Wrong project context

Set APD_WORKSPACE_ROOT to the git root, not a subfolder.