# Conecte Zoho CRM à sua IA

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

Canonical: https://www.altaratech.com/pt/kit/connections/zoho-crm
English: https://www.altaratech.com/toolkit/connections/zoho-crm
Shelf: Connection · Job: Keep the CRM current
Official MCP server: yes · URL: https://zoho-crm-data-insights-60065097786.zohomcp.in/mcp/d17dfe13292e0414a929516bb8f8e797/message · Auth: OAuth com o seu login do Zoho CRM
With ALTARA: Conectado sob pedido. O time da ALTARA conecta o Zoho CRM sob pedido, depois de uma ligação de 20 minutos: primeiro o acesso de leitura, e o de escrita só quando for preciso.

O Zoho CRM 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 prontos do Zoho 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 Zoho CRM

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 Zoho CRM, a conexão funciona assim:

1. Avise o time da ALTARA que você usa Zoho CRM.
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 Zoho CRM.

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 Vale Alto Construction antes da reunião."
- "Quantas tarefas estão atrasadas?"

## Conecte à sua IA

O Zoho publica quatro servidores MCP prontos para o Zoho CRM, então você não hospeda nada. O **Data Insights** é só de leitura: consulta registros com COQL, lista módulos e lê o esquema dos campos. O **Data Operations** acrescenta criar, atualizar e excluir. Os servidores Module Customization e Workflow and Process Automation mudam a configuração do seu CRM; deixe esses com um admin. Toda chamada fica dentro das permissões do seu papel no CRM e usa os créditos de API da sua organização, como as chamadas de API comuns. O Zoho lista a URL de cada servidor nas páginas de configuração, e **Setup > Developer Hub > MCP for AI Agents**, no Zoho CRM, instala um servidor nas ferramentas compatíveis. Os passos abaixo usam a URL do Data Insights (`mcp_url` acima).

### Claude

1. Abra **Customize > Connectors** e selecione **Add > Add custom connector**.
2. Dê o nome `Zoho CRM Data Insights`, cole a URL do servidor e selecione **Add**.
3. Selecione o conector, selecione **Connect** e entre na sua organização do Zoho CRM. No Team e no Enterprise, um Owner adiciona o conector em **Organization settings > Connectors**.

### ChatGPT

A OpenAI desativou a antiga sincronização com o Zoho CRM. Adicione o Zoho como servidor personalizado; as ações de escrita pedem Business, Enterprise ou Edu, em que normalmente um admin ou owner faz a adição.

1. Em **Plugins**, selecione **+ > Add custom MCP server**.
2. Dê um nome, cole a URL do servidor, escolha OAuth, aceite o aviso de risco e crie o servidor.
3. Entre no Zoho e depois selecione o plugin com `@` num chat.

### Claude Code

```bash
claude mcp add --transport http zoho-crm https://zoho-crm-data-insights-60065097786.zohomcp.in/mcp/d17dfe13292e0414a929516bb8f8e797/message
```

Rode `/mcp` e entre no Zoho.

### Codex

```bash
codex mcp add zoho-crm --url https://zoho-crm-data-insights-60065097786.zohomcp.in/mcp/d17dfe13292e0414a929516bb8f8e797/message
codex mcp login zoho-crm
```

### Cursor

1. No Zoho CRM, abra **Setup > Developer Hub > MCP for AI Agents**, escolha o servidor e selecione **Cursor**.
2. Selecione **Install MCP Server in Cursor** e depois **Install** no Cursor.
3. Em **Cursor Settings > Tools & MCP**, selecione **Connect** e entre.

Para configurar à mão, adicione a URL do servidor em `mcpServers` no `~/.cursor/mcp.json` e conecte pela mesma tela.

## Comece só com leitura

Instale só o Data Insights. Ele não consegue mudar dados. O Data Operations pode excluir registros, e o próprio prompt de exemplo do Zoho exclui todos os negócios parados numa etapa, então deixe esse servidor desligado enquanto a ALTARA e o seu time cuidam das mudanças. Se você adicionar depois, mantenha as ferramentas de escrita em "perguntar toda vez" e nunca rode exclusões em massa por um chat. Para revogar o acesso ou trocar de organização, desconecte o servidor na sua ferramenta de IA e entre de novo com a conta certa.

## Prompts para testar

```text
Usando o Zoho CRM, liste os negócios que fecham este mês com etapa, valor, proprietário e última atividade. Marque os que estão sem atividade há 14 dias.
```

```text
Liste as notas, tarefas e ligações adicionadas a negócios abertos no Zoho CRM nos últimos 7 dias, agrupadas por negócio, com a etapa e a próxima tarefa aberta.
```

```text
Mostre os contatos ligados a [conta] no Zoho CRM, com cargos e a última vez que falamos com cada um. Depois, liste os negócios abertos e as tarefas abertas dessa conta, para uma reunião amanhã.
```

```text
Liste os negócios fechados como perdidos nos últimos 90 dias, com valor, proprietário e o motivo da perda, se houver um registrado. Agrupe por motivo e conte cada um.
```

## Se não funcionar

- **A IA diz que não pode gravar:** você conectou o Data Insights, que é só de leitura. Esse é o começo seguro.
- **As chamadas falham no fim do dia:** confira o uso de créditos de API da sua organização no Zoho CRM.
- **Organização ou usuário errado:** desconecte o servidor e entre de novo na organização certa.
- **O Cursor ignora o servidor:** se o `mcp.json` já lista servidores, junte a entrada do Zoho ao objeto `mcpServers` que já existe.

## 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
- [Zoho CRM Developer: Zoho CRM MCP Servers overview](https://www.zoho.com/crm/developer/docs/mcp/overview.html), lido em 2026-11-20
- [Zoho CRM Developer: MCP setup for Claude Desktop](https://www.zoho.com/crm/developer/docs/mcp/setup/claude.html), lido em 2026-11-20
- [Zoho CRM Developer: MCP setup for Cursor](https://www.zoho.com/crm/developer/docs/mcp/setup/cursor.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
- [OpenAI Help Center: Troubleshooting plugins and apps in ChatGPT](https://help.openai.com/en/articles/20001497-troubleshooting-plugins-and-apps-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
