Connect any MCP client to Crane Ledger

If your tool speaks Model Context Protocol, it can use Crane Ledger. Dedicated guides exist for major products; this page covers everything else (Cline, Continue, Zed, Warp, Open WebUI, custom hosts, and more).

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.

What every client needs

  1. URL: https://api.craneledger.ai/mcp
  2. Transport: Streamable HTTP (prefer over legacy SSE when both are offered)
  3. Auth: either
    • OAuth 2.1 via Crane Ledger’s authorization server (https://auth.craneledger.ai), or
    • Authorization: Bearer ha_live_…

Do not require sticky sessions. Org scope comes from the token/key.

Config patterns

Header-based API key (most IDEs):

{
  "mcpServers": {
    "crane-ledger": {
      "url": "https://api.craneledger.ai/mcp",
      "headers": {
        "Authorization": "Bearer ha_live_your_key_here"
      }
    }
  }
}

VS Code-style uses "servers" and "type": "http" — see GitHub Copilot.

Windsurf-style often uses "serverUrl" — see Windsurf.

Long-tail clients

ClientTip
Cline / ContinueAdd remote MCP with URL + headers in extension settings
ZedUse Zed’s MCP settings with HTTP transport if available
WarpAdd MCP server in Warp AI / agent settings
OthersPoint at the same URL; fall back to REST if MCP is unsupported

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?"

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.