AI tools (MCP)

Beta

Use adrlog from Claude Code, Cursor, or Codex — log and query decisions without leaving your editor.

Prerequisites

Generate an API key

Go to Account → API Keys and create a new key. The key is scoped to the workspace you are currently in — switch workspaces before generating if needed.

Tip: Treat API keys like passwords. Never commit them to source control.

Setup

Add to your Claude Code settings. Use the global settings file for all projects, or a project-level file to scope it to one repo.

Global: ~/.claude/settings.json · Project: .claude/settings.json

{
  "mcpServers": {
    "adrlog": {
      "command": "npx",
      "args": ["adrlog-mcp"],
      "env": { "ADRLOG_API_KEY": "dlk_your_key_here" }
    }
  }
}

Restart Claude Code after saving.

Available tools

Once connected, your AI tool has access to these adrlog operations:

Tool	Description
list_decisions	List decisions — optional status and limit filters
get_decision	Fetch a single decision by ID
create_decision	Create a decision — title, problem, and options required
update_decision	Update any fields on an existing decision
delete_decision	Soft-delete — sets status to superseded (recoverable)

Troubleshooting

"ADRLOG_API_KEY not set" or authentication error

The env block is missing or the key was not saved correctly. Regenerate a key at Account → API Keys and paste it into the config.

Decision not found / seeing the wrong workspace

API keys are scoped to one workspace. Switch to the correct workspace in adrlog, then generate a new key and update your config.

"npx: command not found"

Replace "command": "npx" with the full path, e.g. /usr/local/bin/npx. Run which npx in your terminal to find it.

Ready to connect your AI tool?

← User Guide Generate API key →