Skip to main content

Claude.ai (web) — Connect to aprity

aprity exposes its Remote MCP Server as an OAuth 2.1 endpoint at https://mcp.aprity.ai/v1/mcp. You add aprity as a custom connector in Claude.ai and point it at that URL; Claude.ai then runs an OAuth 2.1 + PKCE sign-in that authenticates you with Salesforce SSO. There is no token to copy or paste by hand.

Claude.ai (the web app) can connect to aprity only if your Claude.ai plan includes the Custom Connectors feature. As of mid-2026 this is gated to specific Anthropic plan tiers -- check your Claude.ai account before following this guide.

caution

If your Claude.ai plan does not include custom connectors, the connection will not work. Use Claude Desktop instead -- it supports remote MCP with OAuth sign-in natively.

Prerequisites​

  • Your aprity tenant is on the Intelligence or Trial plan (the Remote MCP Server is not available on Documentation), with the feature.mcpRemoteServer feature enabled.
  • A Claude.ai account on a tier that includes Custom Connectors.
  • A Salesforce login for the org that aprity has scanned (you sign in with this during the OAuth flow).

Steps​

  1. Add a custom connector in Claude.ai :
    • Open claude.ai → Settings → Connectors (the menu name may read Integrations depending on your build).
    • Click Add custom connector (the exact label may vary by Claude.ai version).
    • Set the URL to https://mcp.aprity.ai/v1/mcp.
    • Confirm / Save.
  2. Sign in with Salesforce SSO :
    • Claude.ai opens the OAuth 2.1 + PKCE flow.
    • Sign in with Salesforce SSO -- the same credentials you use for your aprity-scanned org.
    • aprity resolves your tenant from your Salesforce org. Approve the connection.
  3. Verify -- open a conversation in Claude.ai, toggle the aprity connector on for the conversation, and ask "What does aprity know about my Case object?". The answer should cite specific automations from your scan. The tools run on aprity's deterministic knowledge tools over your latest scan.

Disconnect or reconnect​

Remove the aprity connector from Claude.ai's connector settings to disconnect, or revoke the connection on Anthropic's side. Add it back and sign in again to reconnect.

Limitations specific to Claude.ai (web)​

  • Custom connectors on Claude.ai are gated on Anthropic's side to certain paid tiers. The aprity Remote MCP Server cannot work around this gate.
  • Each Claude.ai workspace connects separately and signs in with its own Salesforce identity.

Troubleshooting​

SymptomWhere to start
Claude.ai does not show the option to add a custom connectorYour Anthropic plan does not include custom connectors. Use Claude Desktop instead.
The OAuth sign-in fails or loopsMCP authentication failed. Confirm you sign in with the correct Salesforce identity for your aprity-scanned org.
401 Unauthorized on every tool callMCP authentication failed
Tools missing after the connector loadsConfirm your plan includes the Remote MCP Server. See Plan Comparison.

For anything else, contact support@aprity.ai.