Skip to main content
Connect your AI client to Decimal to investigate support tickets, read knowledge, and review knowledge gaps. To give Decimal access to another service’s tools instead, see MCP servers.

Before you connect

You need an admin or member role in the Decimal workspace you want to use. Playground users cannot connect with OAuth. Your AI client’s account and workspace policies must also allow custom MCP connections.
OAuth gives both admins and members access to create tickets and approve or reject gaps. For a read-only connection, use a client that supports an API key and ask your Decimal admin for a key with only the read scopes you need.
Use this server URL with the Streamable HTTP transport:
An admin can also open Settings → API keys in Decimal and find MCP server. Choose a client under Setup to copy its Sign in or API key configuration. Decimal's MCP setup shows separate sign-in and API-key commands for Claude Code, with Cursor and VS Code options beside it.

Choose your client

  1. Open Customize → Connectors in Claude, then + Add → Add custom connector.
  2. Name the connector Decimal and enter https://api.getdecimal.ai/mcp.
  3. Continue to the authentication settings. Use browser sign-in and Use Claude’s published identity (Recommended) for the OAuth client.
  4. Finish adding the connector. Sign in to Decimal and choose your workspace when prompted.
  5. Return to Claude, connect Decimal, and enable it for your conversation.
On Team or Enterprise, an authorized owner or administrator must first add it under Organization settings → Connectors → Add → Custom → Web. Members then connect individually.Claude’s connector guide covers account-specific setup. These steps use OAuth. Do not put a Decimal API key in a client-ID field or in a chat message.

Limit an API key’s access

Ask a Decimal admin to open Settings → API keys → New API key. Give the key a name that identifies its client and choose only the scopes it needs. The Read only shortcut selects read scopes; review that selection before creating the key. All also includes write and delete permissions for the public API. The New API key dialog has individual scope checkboxes and Read only and All shortcuts. No key has been created. For example, tickets:read and knowledge:read let a client investigate tickets and knowledge without changing them. Add gaps:read to inspect proposed changes or pull_requests:read to inspect pull requests. Write permissions are separate: Copy a newly created key into secure storage when Decimal shows it. It is displayed only once. Keep it out of chat messages, screenshots, URLs, and source control.

Check your workspace and tools

Check the workspace selected on the Decimal sign-in screen before authorizing the connection. Then ask:
“List the Decimal tools I can use. Don’t retrieve records or change anything.”
With OAuth, members can read tickets and files, knowledge articles, gaps, and pull requests. They can also create tickets and approve or reject gaps. Admins additionally have access to API-created conversations, automations and runs, and audit logs. Internal-note creation through create_ticket_note requires an API key with tickets:notes; current OAuth role grants don’t include that scope. Decimal checks current workspace membership and role on each OAuth request. Don’t assume an older OAuth connection stays read-only. API keys use their assigned scopes. Tools also depend on workspace features. A tool can appear in the client and still return forbidden if the feature is unavailable. Try a read-only question next:
  • “Find tickets about a password reset loop. Open the relevant tickets and summarize the replies and internal notes.”
  • “Find published knowledge articles about password resets and cite the steps.”
  • “Show an in-review knowledge gap and explain its diff without applying it.”
Ticket search results show the original post. Ask the client to open a ticket when you need its replies and internal notes.

Review changes before running them

Tell your client to show the proposed change and ask for confirmation before calling a write tool. Don’t assume every client will ask automatically.
Creating a ticket can lead to email replies to the requester. Approving a knowledge gap can publish a live help-center change. Check the recipient or destination before confirming.
  • Create a ticket: Review the requester email, title, and body before confirming create_ticket. Your workspace needs a connected mailbox; with multiple mailboxes, choose the intended one.
  • Add an internal note: Review the ticket, originating helpdesk, and Markdown body before confirming create_ticket_note. The note is sent to the helpdesk and attributed to the API key’s name. The helpdesk must support this action.
  • Approve a gap: Inspect the diff and destination before confirming approve_gap. It applies an in-review knowledge change to an internal article or a connected Zendesk or Intercom help center. It doesn’t approve code gaps.
  • Reject a gap: Confirm the proposed change you want to discard before calling reject_gap. It rejects an in-review gap; it doesn’t undo an applied change.
For example: “Prepare a ticket for [requester email]. Show me the mailbox, address, title, and body, then ask before creating it.”

Fix a connection problem

If the error says Reconnect and choose a workspace, repeat sign-in and select the workspace. If it says This connection was revoked, email support rather than assuming reconnecting will restore it.

Disconnect when you’re finished

Remove or disconnect Decimal in your AI client’s settings. For API keys, a Decimal admin can open Settings → API keys, open the key’s options, and choose Revoke API key. Update every client using that key if you replace it. For OAuth, Connected teammates shows active connections but has no self-service grant-revocation control. Email support for help revoking access. Removing workspace membership blocks that user’s OAuth access. Downgrading an admin to a member still allows ticket creation and gap approval or rejection.

Know what your client receives

Tool results can include requester contact details, replies and internal notes, ticket files, knowledge drafts, gap diffs, and pull-request content. Admin tools can also return automation, API-conversation, and audit data. Check your organization’s data-sharing rules and your AI client’s privacy settings before connecting. Review Decimal’s privacy policy. Disconnecting doesn’t erase content already returned to the client.