FAQs¶
Can the AI change my data?¶
Not through the built-in tools, which are all read-only. The extension also drops any tool that is not declared read-only, but that declaration is made by each tool's author, so review any extension that adds tools. See Security and permissions.
Can the AI see more than I can?¶
No. Every tool runs as you, with your CiviCRM permissions, and a permission profile can only take tools away. The one exception is CiviCRM's own: a SearchKit display an administrator set to bypass ACLs, which another extension has published as a tool, and which you could already run in your browser. See The one deliberate exception.
Does this send my data to an AI company?¶
The results of each question go to the AI client you connected, and so to its provider. Check that provider's terms before connecting. See What the AI provider sees.
Which AI clients work?¶
Claude and ChatGPT. Both are on by default, and an administrator can turn either off. ChatGPT needs a paid plan (Plus or above) to add a custom connector; Claude's free plan allows one. Both companies discount their organisation plans for eligible nonprofits; see Connect your AI client. Other MCP clients cannot sign in yet; that is planned (Roadmap).
Can I just send my AI a link to the setup instructions?¶
Not yet. Claude and ChatGPT cannot open pages on lab.civicrm.org, which blocks automated readers. Copy the setup prompt from Connect your AI client and paste it into the chat instead.
Do I need to run a separate server?¶
No. The extension runs inside CiviCRM, like any other extension.
Sign-in fails, or the connector cannot be added¶
Check the following, in order:
- the URL ends in
/civicrm/mcp/, with the trailing slash - the host matches your site exactly, including
wwwif your site uses it - your user has the connect an AI client permission and an active permission profile (while Require a profile is on)
- the client ID in the connector matches the one in Setup
- the AI client you are using is turned on under Supported AI clients in Setup (the site's page then says it "is not turned on for this site")
- in ChatGPT, the token authentication method is
noneand the client secret is empty