Connect AI assistants (MCP)
Add XODASH as a connector in Claude, Codex and other AI apps so they can work with your workspace using your own permissions.
XODASH has its own MCP (Model Context Protocol) server. Add it as a connector in Claude, Claude Code, Codex or another AI app that supports remote MCP connectors, sign in, and the app can search your workspace, read your records and make a limited set of changes, all with your XODASH permissions.
The connector URL
https://mcp.xodash.io/mcpYou'll also find it, with a Copy button, at Settings → AI Apps under Connect Claude, Codex and other AI apps. The URL is the same for every workspace; you choose your workspace when you sign in.
Add XODASH to your AI app
In Claude, go to Settings → Connectors → Add custom connector, paste the connector URL and select Connect.
Sign in and approve access
Choose your workspace
Your app opens Connect an AI app in the browser. Enter your workspace, or select Continue with the workspace you used last. If you don't know it, enter your email and select Email my workspace links.
Sign in to XODASH
Sign in as you normally do, if you aren't already.
Review what the app can do
The consent screen shows the app's name, your workspace and your email, and lists what the app will be able to do. Leave Allow it to make changes on to let it create and update records, or turn it off to connect read only.
Select Allow access
You're sent back to your app. Select Cancel instead to refuse.
Apps that run on your computer
For an app such as Claude Code or Codex, the consent screen warns that the app runs on your computer. Only approve if you just started this connection yourself.
What the app can do
The app gets the same access as your XODASH role, and nothing you can't see in XODASH. Private records stay visible only to their owner, notes and reminders only to their author, and email, calendar, tickets and tasks come only from integrations you connected yourself.
Reading (always included):
- Search people, companies, deals, notes and knowledge-base articles, and open a person or company.
- Tickets, tasks, email, calendar and inbox from integrations you connected.
- Meetings, expirations, and your own reminders and notes.
- Deals, pipelines, the service catalog, quotes, contracts, contract revisions and templates.
Changes (only when Allow it to make changes was on):
- Create contacts and companies, and set a contact's buying role.
- Create notes and reminders, and complete reminders.
- Add comments to tickets.
- Create and update deals.
- Create draft quotes and add or update their line items.
- Create draft contracts and revise drafts.
What an AI app can never do
No AI app can send email or delete anything. Quotes and contracts stay drafts: an app can't send a quote, activate a contract, amend an active contract or cancel one. Those stay with a person in XODASH. To avoid duplicates, creating a contact or company is refused when one with the same email, name or domain already exists.
Roles
- What each tool can read or change follows your XODASH role's permissions.
- CRM tools need a CRM role. Changes to deals, quotes and contracts need CRM Editor or CRM Admin.
- A CRM Viewer, or a connection approved read only, gets only the read tools. Contract billing totals, invoices and prepaid balances are for CRM Editors and Admins only.
- Role changes and deactivated accounts take effect within about a minute.
Manage connected apps
At Settings → AI Apps, Your connected apps lists each app with when you connected it and when it was last used. A read-only connection is marked read-only. Select Disconnect to revoke an app at once.
For workspace admins
Admins can select Show everyone to see every connected app in the workspace and disconnect any of them. Turning off Allow AI app connections blocks every connected AI app in the workspace immediately. While it's off, anyone who tries to connect sees "AI connectors are off."
Good to know
- Each connection can make up to 240 requests a minute.
- A connection stays signed in as long as the app uses it. If it goes unused for about 30 days, you sign in again.
- Email bodies, ticket text and notes reach the app as information, not as instructions.