Skip to main content

ChatGPT — 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 ChatGPT and point it at that URL; ChatGPT 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.

ChatGPT can connect to aprity only if your ChatGPT build supports remote MCP connectors with OAuth sign-in. This support is being rolled out by OpenAI and the UI varies between builds -- check your ChatGPT version against OpenAI's connector documentation before following this guide.

caution

If your version of ChatGPT cannot add a remote MCP connector that runs an OAuth sign-in, the connection will not work. Use Claude Desktop or Cursor instead.

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 ChatGPT build that supports remote MCP connectors with OAuth.
  • 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 ChatGPT :
    • Open Settings in ChatGPT and navigate to the connectors / custom MCP panel (location depends on your build -- it may be under Apps, Connectors, Tools, or behind a Developer Mode toggle).
    • Add a new remote MCP server with the URL https://mcp.aprity.ai/v1/mcp.
    • Save / Connect.
  2. Sign in with Salesforce SSO :
    • ChatGPT opens a browser window for 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 -- in any ChatGPT conversation, the aprity tools (Answer a question, Describe object behaviour, Draft a user story) should now appear in the tool list. They run on aprity's deterministic knowledge tools over your latest scan.

Disconnect or reconnect​

Remove the aprity connector from ChatGPT's connector settings to disconnect; the next request can no longer reach aprity. Add it back and sign in again to reconnect. Disconnect when the connection is no longer needed or the Salesforce user who authorized it leaves the company.

Troubleshooting​

SymptomWhere to start
ChatGPT does not let you add a remote MCP connector with OAuthYour version does not support OAuth-authenticated remote MCP yet. Use Claude Desktop or Cursor.
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.