AI Client (MCP) Cannot Connect
AI clients such as ChatGPT, Claude (Desktop, web and Code), Cursor and GitHub Copilot connect to aprity through the aprity MCP server. There is no token to paste: the client opens a browser, you sign in with Salesforce, and the client then keeps its access up to date by itself.
MCP access is included in the Intelligence and Trial plans.
Use the right connection URL
Each organization has its own MCP URL, of the form:
https://mcp.aprity.ai/v1/mcp/t/<your-organization>
Copy it from the web portal rather than typing it: an aprity Admin opens Connectors in the account menu, then the AI assistants · MCP card, and clicks Copy URL. If the card says "The MCP URL is not configured", contact aprity support.
Salesforce shows an error during sign-in
The sign-in uses your org's External Client App, the same one as the web portal.
- redirect_uri_mismatch — the AI client callback URL is missing from the app's Callback URL field. The setup wizard lists it as the third callback URL.
- user hasn't approved this consumer — your profile is not in the app's Selected Profiles. Ask your Salesforce administrator to add it.
aprity refuses the connection after sign-in
| Error | Cause | Fix |
|---|---|---|
tenant_not_found | You signed in with a user of an org that aprity does not know. | Sign out of Salesforce in the browser and sign in with a user of the org aprity analyses. |
ambiguous_tenant | Your org is linked to more than one aprity account. | Contact aprity support. |
MCP_FEATURE_DISABLED | MCP is not enabled for your organization, for example on the Documentation plan. | Check your plan, or contact aprity support. |
Every tool call fails with 401
A 401 Unauthorized or invalid_token means the client's access is missing, expired or revoked. This happens when:
- the sign-in was never finished or was cancelled,
- the access was revoked, or the Salesforce user was deactivated,
- the client could not renew its access.
Fix: remove the aprity connection from your AI client, add it again with your MCP URL, and complete the Salesforce sign-in. Then restart the client.
Setup steps for each client:
"MCP tool-call quota reached for this plan."
Your organization used its MCP quota: 2,000 tool calls per month on Intelligence, 25 for the whole Trial. See Analysis Refused or Quota Reached.
"429 Too Many Requests" when connecting
Too many connection attempts in a short time. Wait a minute and try again.
Contact support
Contact aprity support with:
- Your AI client and its version.
- The Salesforce username you signed in with.
- The exact error, or a screenshot with sensitive data hidden.