Integrations
MCP
Connect Claude Desktop, Cursor, claude.ai, and other MCP clients to TripleBooks.
Overview
TripleBooks exposes the workspace JSON API through MCP:
| Client | How |
|---|---|
| claude.ai | Hosted remote MCP + OAuth — Custom Connector URL {app}/api/mcp |
| Claude Desktop / Cursor | Local stdio via npx -y @triplebooks/mcp@latest + personal API key |
MCP credentials are user-owned and entity-pinned (same model as Settings → API Keys), not a shared Admin → Integrations connection.
Unlike Luca (in-app AI), hosted MCP mutations default to propose → approve (approve in Settings → MCP). OAuth consent can opt into direct mutations.
Hosted remote MCP (claude.ai)
- Open Settings → MCP (
/settings/mcp). - Copy the MCP server URL (e.g.
https://app.triplebooks.com/api/mcp). - In Claude → Settings → Connectors → Add custom connector, paste that URL.
- Complete OAuth: pick entity, access level, and mutation mode (propose recommended).
- Approve staged writes under Pending MCP proposals on the same Settings page.
Credits: each tool call that hits the workspace API meters api_calls (same as API keys). Exhausted credits return 402 — no silent fallback.
Local stdio (Claude Desktop / Cursor)
- Open Settings → MCP.
- Create an MCP API key (read only or read + write).
- Leave Install mode on npx (recommended).
- Copy the generated client config into Claude Desktop or Cursor.
- Fully quit and reopen Claude Desktop, or reload the Cursor window.
Local path (developers)
Switch Install mode to Local path, build with pnpm --filter @triplebooks/mcp build, and paste the absolute path to apps/mcp/dist/cli.js.
What you need
| Item | Where |
|---|---|
| Hosted URL | Settings → MCP |
API key (ak_…) | Settings → MCP (stdio only) |
| Entity | Chosen at OAuth consent, or shown on the MCP setup page for stdio |
| Node.js | 20+ for Desktop / Cursor npx |
Roadmap
- Listing in Anthropic’s Connectors Directory
- Additional cloud clients (ChatGPT Apps, etc.)
Related
- Luca AI — in-app assistant with approval guardrails
- API keys — programmatic auth
- Integrations — bank and accounting connectors