Connect Grok to Crane Ledger

Grok supports Bring Your Own MCP custom connectors on web (and mobile where available). Point Grok at Crane Ledger’s hosted MCP server.

Prerequisites

  1. A paid Grok plan that includes custom connectors.
  2. A Crane Ledger account (OAuth or API key, depending on what Grok’s custom connector UI offers).
  3. On Grok Business / Enterprise, a team admin may need to provision the connector in the xAI console first.

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.

Add a custom MCP connector

  1. Go to grok.com/connectors.
  2. Click New Connector → Custom (or Other in the admin console).
  3. Enter the MCP server URL: https://api.craneledger.ai/mcp.
  4. Complete authentication (OAuth consent at Crane Ledger, or API key if the UI asks for it).
  5. Enable the connector and start a conversation.

Business/Enterprise admins: console.x.ai → team → Grok Business → Connectors → add custom MCP with the same URL.

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
Cannot add connectorConfirm paid plan; ask admin to provision on Business/Enterprise
Server unreachableCrane Ledger is public HTTPS — do not use a local-only URL
401Re-authenticate OAuth or update the API key

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.