Connect Claude to Crane Ledger

Use Claude (claude.ai custom connector or Claude Desktop) as the generative UI for Crane Ledger.

Prerequisites

  1. A Crane Ledger account at craneledger.ai — GitHub, Google, Apple, or email magic link.
  2. Claude.ai and/or Claude Desktop.
  3. Optional: credits (new orgs get 500 free credits).

MCP endpoint

SettingValue
URLhttps://api.craneledger.ai/mcp
TransportStreamable HTTP
Auth (OAuth)Sign in at consent UI — no key in the client
Auth (API key)Authorization: Bearer ha_live_…
Consenthttps://craneledger.ai/oauth/consent

Organization scope comes from your OAuth token or API key — you do not pass organization_id separately.

Scopes: ledger:read, ledger:write, and optionally ledger:admin.

See Authentication and MCP tools.

Claude.ai custom connector (recommended)

  1. In Claude, add a custom connector with URL https://api.craneledger.ai/mcp.
  2. Claude discovers OAuth via WWW-Authenticate and registers via dynamic client registration.
  3. Complete consent at https://craneledger.ai/oauth/consent (GitHub, Google, Apple, or email).
  4. Select your organization and approve scopes.
  5. Tools load with org scope from your token — no API key pasted into Claude.

Claude Desktop (remote HTTP + API key)

claude mcp add --transport http crane-ledger https://api.craneledger.ai/mcp \
  --header "Authorization: Bearer ha_live_your_key_here"

Or configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS) with a remote/HTTP MCP entry pointing at the same URL and Bearer header. Prefer the hosted Streamable HTTP endpoint over a local stdio binary.

Local stdio binary (optional)

For local development only:

{
  "mcpServers": {
    "crane-ledger": {
      "command": "/path/to/mcp-server",
      "env": {
        "API_BASE_URL": "https://api.craneledger.ai",
        "API_KEY": "ha_live_your_key_here",
        "ORGANIZATION_ID": "org_your_org_id"
      }
    }
  }
}

Example prompts

Once connected, try:

  • "Set up a basic chart of accounts for a small service business"
  • "Create an invoice for $2,500 to Acme Corp for consulting"
  • "What's our cash position right now?"
  • "Show me profit and loss for last quarter"
  • "How many credits do I have left?"

Troubleshooting

IssueWhat to try
401Finish OAuth consent or fix the Bearer key
Wrong orgRe-consent and pick the right organization
Writes blockedCheck draft approval if require_draft_approval is enabled
CreditsPurchase credits or enable auto-recharge

Related

Need help?

Create a free account (GitHub, Google, Apple, or email) to access our support portal. Once signed in, use the Support tab in your dashboard to submit a support ticket — no GitHub account required. Our team typically responds within 24 hours.