Skip to main content

Cursor — Connect to aprity

You add aprity to Cursor as a remote MCP server and sign in with your Salesforce login. Cursor's agent can then look up your org's objects, rules and automations next to your code. See Remote MCP Server for what the connection gives you, plan availability and quotas.

Prerequisites​

  • Your aprity organization is on the Intelligence or Trial plan.

  • Your administrator has completed the administrator setup and given you your organization's MCP address (from Connectors in the aprity web portal). It looks like:

    https://mcp.aprity.ai/v1/mcp/t/<your-slug>

  • A Salesforce login on the org that aprity documents, with a profile authorized on the aprity Connected App.

  • A version of Cursor that supports remote MCP servers with OAuth.

Step 1 — Add the aprity server​

Add the aprity entry to Cursor's MCP configuration: ~/.cursor/mcp.json for all your projects, or .cursor/mcp.json in a project. Keep any servers already in the file and add aprity inside mcpServers:

{
    "mcpServers": {
        "aprity": {
            "url": "https://mcp.aprity.ai/v1/mcp/t/<your-slug>"
        }
    }
}

The Client configuration block on the aprity Connectors page gives you this snippet with your address already filled in.

Step 2 — Sign in​

Open Cursor's MCP settings: the aprity server appears and asks you to authenticate. Your browser opens on your Salesforce login page. Sign in with your usual Salesforce credentials and approve the access.

Check the connection​

In Cursor's agent chat, ask "What does aprity know about our Opportunity object?". The answer should cite automations, validations or fields from your scan.

Disconnect​

Remove the aprity entry from mcp.json, or disable the server in Cursor's MCP settings.

Troubleshooting​

SymptomWhere to start
The aprity server does not appearCheck the JSON syntax (no trailing comma, correct nesting) and the URL, then reload Cursor.
Salesforce shows redirect_uri_mismatchAsk your administrator to add the MCP callback URL to the Connected App (administrator setup).
The sign-in fails or loopsMCP authentication failed.
401 Unauthorized on every tool callAuthenticate again from Cursor's MCP settings.
Tools are refusedCheck that your plan includes the Remote MCP Server and that the tool-call quota is not used up.

For anything else, contact contact@aprity.ai.