Claude Code
Claude Code is Anthropic's CLI agent. It supports MCP natively and is ideal when you want the assistant inside the same terminal as your editor.
Prerequisites
- Claude Code installed (
npm install -g @anthropic-ai/claude-codeor official installer) - A Transactional API token (
tk_live_…)
Add the server (one-liner)
Paste this single line in your terminal, with your token substituted in:
claude mcp add --transport http transactional https://mcp.transactional.dev --header "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
That's it. The config is written to ~/.claude.json and the server is connected on the next session.
Project-scoped variant (optional)
If multiple teammates work on the same repo and you want to share the connector config (without sharing the token), scope it to the project — it writes .mcp.json in the current directory:
claude mcp add --transport http --scope project transactional https://mcp.transactional.dev --header "Authorization: Bearer $TRANSACTIONAL_API_TOKEN"
Don't commit the token. Read it from an environment variable as shown above.
Verify
Start a session:
claude
Inside the REPL, run:
/mcp
You should see transactional listed as connected with five tools.
Use it
From the REPL:
List my Transactional templates.
Claude will call list_documents. Approve the tool call, and you'll see your templates. Same pattern for generating:
Generate the welcome PDF for customer 'Acme Corp' using template
.
Removing or re-keying
# Remove the connector entirely
claude mcp remove transactional
# Replace the token (remove + re-add, one-liner each)
claude mcp remove transactional
claude mcp add --transport http transactional https://mcp.transactional.dev --header "Authorization: Bearer tk_live_NEW"
Troubleshooting
MCP server transactional failed to connect — Token is wrong or the Authorization header isn't escaped properly in your shell. Wrap the value in single quotes if your token contains characters your shell interprets.
Tools call but return empty results — The token belongs to an account with no documents. Create one in the dashboard first.