# Connect Salesforce to your AI

> The ALTARA team connects Salesforce on request, read access first. Your own AI reads the same records through Salesforce's hosted MCP servers.

Canonical: https://www.altaratech.com/store/connections/salesforce
Shelf: Connection · Job: Keep the CRM current
Official MCP server: yes · URL: https://api.salesforce.com/platform/mcp/v1/platform/sobject-reads · Auth: OAuth 2.0 with PKCE through an External Client App your admin creates
With ALTARA: Connected on request. The ALTARA team connects Salesforce on request, after a 20-minute call: read access first, write access only when it is needed.

Salesforce is on ALTARA's list of CRMs, and the ALTARA team connects it on request, starting with read access. Until then, your pipeline lives in the ALTARA CRM, with nothing to set up. Salesforce's own hosted MCP servers let your own AI read the same records, so ALTARA and your assistant work from one pipeline.

## How ALTARA works with Salesforce

ALTARA works in one pipeline per company, shared by the whole team, and each seller has their own chat with it. It starts on the ALTARA CRM. When your company runs on Salesforce, the connection goes like this:

1. Tell the ALTARA team you use Salesforce.
2. The team books a 20-minute call.
3. You grant read access only. Write access comes only when it is needed.
4. Once an admin confirms, the team moves your accounts from the ALTARA CRM into Salesforce.

Whatever CRM holds the pipeline, ALTARA never writes to it without your yes, and every change is recorded. On the call, ask the team what ALTARA will read and change in your org.

Messages to send ALTARA:

- "What's my plan for the week?"
- "Tell me about Summit Ag Supply before the meeting."
- "Which leads are in Proposal?"

## Connect it to your AI

Salesforce Hosted MCP Servers are generally available since April 2026 for Enterprise Edition orgs and above, for customers with Flex Credits; Salesforce says server usage may be billed. Your AI acts as the signed-in user, so field-level security, object permissions and sharing rules apply. Servers are off by default: an admin turns each one on in **Setup > MCP Servers** (under API Catalog), which takes up to 2 minutes. Each client needs an External Client App (Connected Apps are not supported) with the `mcp_api` and `refresh_token` scopes and JWT-based access tokens; a new app can take up to 30 minutes to work. Sandbox and scratch orgs use `/v1/sandbox/` in the URL.

### Claude

1. Ask your admin for an External Client App with callback `https://claude.ai/api/mcp/auth_callback` and its consumer key.
2. Open **Customize > Connectors**, select **Add > Add custom connector** and paste the server URL.
3. Under **OAuth client**, choose **Use your own OAuth client** and paste the consumer key.
4. Select **Connect** and sign in to Salesforce. On Team and Enterprise, an Owner adds it in **Organization settings > Connectors**.

### ChatGPT

Write actions need Business, Enterprise or Edu; Pro is read and fetch only.

1. In **Plugins**, select **+ > Add custom MCP server** and paste the server URL.
2. Choose a user-defined OAuth client, copy ChatGPT's callback URL into the External Client App, paste the consumer key and secret and turn off **OIDC enabled**.
3. Create it, sign in, then select it from **+** in a chat.

### Claude Code

Claude Code inherits the connector you add in Claude. To add it directly, register `http://localhost:8080/callback` on the External Client App, then run:

```bash
claude mcp add --transport http --client-id YOUR_CONSUMER_KEY --callback-port 8080 salesforce https://api.salesforce.com/platform/mcp/v1/platform/sobject-reads
```

Run `/mcp` and sign in.

### Codex

```bash
codex mcp add salesforce --url https://api.salesforce.com/platform/mcp/v1/platform/sobject-reads --oauth-client-id YOUR_CONSUMER_KEY
```

Add the callback URL Codex prints to the External Client App, then run `codex mcp login salesforce`.

### Cursor

1. Register `http://localhost:8787/callback` on the External Client App (some versions use `cursor://anysphere.cursor-mcp/oauth/callback`; add both).
2. Add this to `~/.cursor/mcp.json`, then open **Customize**, turn on salesforce and sign in:

```json
{
  "mcpServers": {
    "salesforce": {
      "url": "https://api.salesforce.com/platform/mcp/v1/platform/sobject-reads",
      "auth": { "CLIENT_ID": "${env:SF_CONSUMER_KEY}" }
    }
  }
}
```

## Start read-only

Activate only `platform/sobject-reads` first: it describes objects, runs SOQL and SOSL and reads related records, but cannot create, update or delete. Keep SObject Deletes and SObject All off. Salesforce also suggests a permission set on the External Client App and a refresh token valid 30 days or less. To revoke access, remove the connector in your AI tool; with single logout turned on, ending your Salesforce session ends the MCP session too.

## Prompts to try

```text
Using Salesforce, list my open opportunities closing this quarter: name, account, stage, amount, close date and last activity date. Flag any with no activity in 14 days. Read only.
```

```text
Find everything about [account] in Salesforce: contacts with titles, open opportunities, recent tasks and notes, and cases opened in the last 30 days. Summarize it in eight lines for a meeting tomorrow.
```

```text
Find opportunities that have been in the same stage for more than 30 days. Group them by owner and give the last activity on each.
```

```text
Describe the Opportunity object in my org: the stages in use, the record types and the custom fields that have values. Return a short list I can share before connecting a new tool.
```

## If it does not work

- **Sign-in works but no tools appear:** an admin turns the server on in **Setup > MCP Servers**.
- **Authorization fails right after setup:** a new External Client App can take up to 30 minutes to work.
- **Redirect error:** the callback URL in the External Client App must match your client's exactly.
- **Your org blocks login.salesforce.com or test.salesforce.com:** use the My Domain server URL format from Salesforce's guide.
- **Query timeouts:** ask for a WHERE clause and a LIMIT, and filter on indexed fields.

## Sources

- [ALTARA help center: Integrations](https://docs.altaratech.com/en/docs/console/integrations), read on 2026-11-20
- [ALTARA help center: Pipeline and CRM](https://docs.altaratech.com/en/docs/agent/pipeline-and-crm), read on 2026-11-20
- [ALTARA help center: The agent](https://docs.altaratech.com/en/docs/agent), read on 2026-11-20
- [Salesforce Developers: Hosted MCP Servers, Get Started](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/hosted-mcp-servers-overview.html), read on 2026-11-20
- [Salesforce Developers Blog: Salesforce Hosted MCP Servers Are Now Generally Available](https://developer.salesforce.com/blogs/2026/04/salesforce-hosted-mcp-servers-are-now-generally-available), read on 2026-11-20
- [Salesforce Developers: Activate MCP Servers](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/activate-mcp-servers.html), read on 2026-11-20
- [Salesforce Developers: Create an External Client App](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/create-external-client-app.html), read on 2026-11-20
- [Salesforce Developers: Connecting an MCP Client](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/client-connection-overview.html), read on 2026-11-20
- [Salesforce Developers: Standard MCP Servers Reference](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/references/reference/servers-reference.html), read on 2026-11-20
- [Salesforce Developers: SObject Reads MCP Server](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/references/reference/sobject-reads.html), read on 2026-11-20
- [Salesforce Developers: Configure Claude](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/claude.html), read on 2026-11-20
- [Salesforce Developers: Configure ChatGPT](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/chatgpt.html), read on 2026-11-20
- [Claude Help Center: Get started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp), read on 2026-11-20
- [OpenAI Help Center: Connecting custom MCP servers in ChatGPT](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt), read on 2026-11-20
- [Claude Code: Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp), read on 2026-11-20
- [OpenAI: Codex Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp?surface=cli), read on 2026-11-20
- [Cursor: Model Context Protocol](https://cursor.com/docs/mcp), read on 2026-11-20
