# Conecte Salesforce à sua IA

> O time da ALTARA conecta o Salesforce sob pedido, começando só com leitura. Sua IA lê os mesmos registros pelos servidores MCP da Salesforce.

Canonical: https://www.altaratech.com/pt/kit/connections/salesforce
English: https://www.altaratech.com/toolkit/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 com PKCE, por meio de um External Client App que o seu admin cria
With ALTARA: Conectado sob pedido. O time da ALTARA conecta o Salesforce sob pedido, depois de uma ligação de 20 minutos: primeiro o acesso de leitura, e o de escrita só quando for preciso.

O Salesforce está na lista de CRMs da ALTARA, e o time da ALTARA faz a conexão sob pedido, começando com acesso de leitura. Até lá, o seu pipeline fica no CRM da ALTARA, sem nada para configurar. Os servidores MCP hospedados da própria Salesforce deixam a sua IA ler os mesmos registros, então a ALTARA e o seu assistente trabalham com um só pipeline.

## Como a ALTARA funciona com o Salesforce

A ALTARA trabalha em um pipeline por empresa, compartilhado pelo time inteiro, e cada vendedor tem o próprio chat com ela. Ela começa no CRM da ALTARA. Quando a sua empresa usa Salesforce, a conexão funciona assim:

1. Avise o time da ALTARA que você usa Salesforce.
2. O time marca uma ligação de 20 minutos.
3. Você dá só o acesso de leitura. O acesso de escrita só vem quando for preciso.
4. Assim que um admin confirmar, o time passa as suas contas do CRM da ALTARA para o Salesforce.

Seja qual for o CRM que guarda o pipeline, a ALTARA nunca grava nele sem o seu sim, e toda mudança fica registrada. Na ligação, pergunte ao time o que a ALTARA vai ler e mudar na sua organização.

Mensagens para mandar à ALTARA:

- "Qual é o meu plano para a semana?"
- "Me fale da Summit Ag Supply antes da reunião."
- "Quais leads estão em Proposta?"

## Conecte à sua IA

Os Salesforce Hosted MCP Servers estão em disponibilidade geral desde abril de 2026 para organizações Enterprise Edition ou superiores, para clientes com Flex Credits; a Salesforce diz que o uso dos servidores pode ser cobrado. A sua IA age como o usuário logado, então valem a segurança em nível de campo, as permissões de objeto e as regras de compartilhamento. Os servidores vêm desligados: um admin liga cada um em **Setup > MCP Servers** (em API Catalog), o que leva até 2 minutos. Cada cliente precisa de um External Client App (Connected Apps não são aceitos) com os escopos `mcp_api` e `refresh_token` e tokens de acesso baseados em JWT; um app novo pode levar até 30 minutos para funcionar. Organizações sandbox e scratch usam `/v1/sandbox/` na URL.

### Claude

1. Peça ao seu admin um External Client App com o callback `https://claude.ai/api/mcp/auth_callback` e a consumer key dele.
2. Abra **Customize > Connectors**, selecione **Add > Add custom connector** e cole a URL do servidor.
3. Em **OAuth client**, escolha **Use your own OAuth client** e cole a consumer key.
4. Selecione **Connect** e entre no Salesforce. No Team e no Enterprise, um Owner adiciona o conector em **Organization settings > Connectors**.

### ChatGPT

As ações de escrita pedem Business, Enterprise ou Edu; no Pro, só leitura e busca.

1. Em **Plugins**, selecione **+ > Add custom MCP server** e cole a URL do servidor.
2. Escolha um cliente OAuth definido pelo usuário, copie a URL de callback do ChatGPT para o External Client App, cole a consumer key e o secret e desligue **OIDC enabled**.
3. Crie o servidor, entre e depois selecione o servidor em **+** num chat.

### Claude Code

O Claude Code herda o conector que você adiciona no Claude. Para adicionar direto, registre `http://localhost:8080/callback` no External Client App e rode:

```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
```

Rode `/mcp` e entre.

### Codex

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

Adicione ao External Client App a URL de callback que o Codex mostra e depois rode `codex mcp login salesforce`.

### Cursor

1. Registre `http://localhost:8787/callback` no External Client App (algumas versões usam `cursor://anysphere.cursor-mcp/oauth/callback`; adicione as duas).
2. Adicione isto em `~/.cursor/mcp.json`, depois abra **Customize**, ative salesforce e entre:

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

## Comece só com leitura

Ative primeiro só o `platform/sobject-reads`: ele descreve objetos, roda SOQL e SOSL e lê registros relacionados, mas não consegue criar, atualizar nem excluir. Mantenha SObject Deletes e SObject All desligados. A Salesforce também sugere um conjunto de permissões no External Client App e um refresh token válido por 30 dias ou menos. Para revogar o acesso, remova o conector na sua ferramenta de IA; com o single logout ligado, encerrar a sua sessão no Salesforce encerra também a sessão MCP.

## Prompts para testar

```text
Usando o Salesforce, liste as minhas oportunidades abertas que fecham neste trimestre: nome, conta, fase, valor, data de fechamento e data da última atividade. Marque as que estão sem atividade há 14 dias. Só leitura.
```

```text
Encontre tudo sobre [conta] no Salesforce: contatos com cargos, oportunidades abertas, tarefas e notas recentes, e casos abertos nos últimos 30 dias. Resuma em oito linhas para uma reunião amanhã.
```

```text
Encontre as oportunidades que estão na mesma fase há mais de 30 dias. Agrupe por proprietário e mostre a última atividade de cada uma.
```

```text
Descreva o objeto Oportunidade da minha organização: as fases em uso, os tipos de registro e os campos personalizados que têm valores. Devolva uma lista curta que eu possa compartilhar antes de conectar uma ferramenta nova.
```

## Se não funcionar

- **O login funciona, mas nenhuma ferramenta aparece:** um admin liga o servidor em **Setup > MCP Servers**.
- **A autorização falha logo depois da configuração:** um External Client App novo pode levar até 30 minutos para funcionar.
- **Erro de redirecionamento:** a URL de callback no External Client App precisa ser exatamente igual à do seu cliente.
- **A sua organização bloqueia login.salesforce.com ou test.salesforce.com:** use o formato de URL de servidor com My Domain, do guia da Salesforce.
- **Consultas estourando o tempo:** peça uma cláusula WHERE e um LIMIT, e filtre por campos indexados.

## Fontes

- [ALTARA help center: Integrations](https://docs.altaratech.com/en/docs/console/integrations), lido em 2026-11-20
- [ALTARA help center: Pipeline and CRM](https://docs.altaratech.com/en/docs/agent/pipeline-and-crm), lido em 2026-11-20
- [ALTARA help center: The agent](https://docs.altaratech.com/en/docs/agent), lido em 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), lido em 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), lido em 2026-11-20
- [Salesforce Developers: Activate MCP Servers](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/activate-mcp-servers.html), lido em 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), lido em 2026-11-20
- [Salesforce Developers: Connecting an MCP Client](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/client-connection-overview.html), lido em 2026-11-20
- [Salesforce Developers: Standard MCP Servers Reference](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/references/reference/servers-reference.html), lido em 2026-11-20
- [Salesforce Developers: SObject Reads MCP Server](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/references/reference/sobject-reads.html), lido em 2026-11-20
- [Salesforce Developers: Configure Claude](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/claude.html), lido em 2026-11-20
- [Salesforce Developers: Configure ChatGPT](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/chatgpt.html), lido em 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), lido em 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), lido em 2026-11-20
- [Claude Code: Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp), lido em 2026-11-20
- [OpenAI: Codex Model Context Protocol](https://learn.chatgpt.com/docs/extend/mcp?surface=cli), lido em 2026-11-20
- [Cursor: Model Context Protocol](https://cursor.com/docs/mcp), lido em 2026-11-20
