ChatGPT e Claude conectados ao CRM

Disponibilidade

A integração depende da habilitação do OAuth pela operação do CRM e da possibilidade de adicionar um servidor MCP no aplicativo de IA usado.

• ChatGPT: a disponibilidade depende do plano, das permissões do workspace

e da versão do aplicativo. Se usa o ChatGPT grátis, confirme primeiro se sua conta permite essa conexão. No ChatGPT na web, confira se aparece a opção de adicionar um servidor MCP em Plugins. Não é possível garantir essa conexão no plano gratuito. Ter acesso para consultar dados não garante permissão para criá-los ou editá-los. Consulte as instruções atuais da OpenAI.

• Claude: os conectores remotos personalizados estão disponíveis inclusive

no plano Free, com limite de um conector personalizado nesse plano. Em contas de equipe, a adição depende das permissões da organização. Consulte as instruções atuais da Anthropic.

Não é necessário compartilhar sua senha ou chave de API com a IA. A autorização é feita no login do próprio CRM.

Na Missão (onboarding)

Conectar o ChatGPT ou o Claude é o último passo da Missão (/onboarding). O passo mostra o endereço do servidor com o botão Copiar, o passo a passo de cada app e o vídeo tutorial, quando houver. Ao voltar pra aba do CRM (ou clicar em Verificar conexão), ele confere sozinho.

• Vale a conexão de qualquer pessoa do time: basta uma para o passo ficar

feito na conta.

• Só conta conexão que o app de IA chegou a usar. Se você autorizou e o

navegador não voltou pro app, refaça a conexão pelo app.

• Conexão revogada ou vencida (90 dias) faz o passo voltar a ficar pendente.

Como conectar

Adicione o servidor remoto https://crmdojordao.com.br/api/mcp no aplicativo, escolha OAuth e siga o login do CRM. Selecione explicitamente o workspace e as permissões. Cada conexão opera em um workspace; para trocar, reconecte.

Com as ferramentas liberadas no seu aplicativo de IA e as permissões do CRM, você pode consultar, criar e editar oportunidades, contatos e empresas visíveis à sua carteira, adicionar contatos e etiquetas a negócios, registrar notas e criar/reagendar/concluir atividades. Nota e atividade podem ir no negócio, na ficha do contato ou na ficha da empresa: a pessoa não precisa ter oportunidade aberta pra receber uma tarefa ou uma anotação. Também pode consultar o resumo comercial. Atividades ligadas só a contato ou empresa aparecem em listar atividades, com a mesma regra de carteira. As anotações dessas fichas podem ser criadas pela conexão; para consultar a linha do tempo completa, abra a ficha no CRM.

Configurações (funis, etapas, etiquetas, campos personalizados, motivos de perda, tipos de atividade, perfil comercial, produtos, objeções e cases) e importação exigem escopos adicionais e papel OWNER/ADMIN atual do workspace. Conversas privadas, transcrições e instruções internas das IAs não são expostas por esta conexão. Acesso de suporte/admin da plataforma não concede conexão.

Várias ações de uma vez (lote)

Para criar ou atualizar vários registros, a IA usa as ferramentas em lote em vez de uma chamada por registro: até 50 itens por chamada para criar e editar oportunidades, registrar notas em negócios, criar e atualizar atividades, criar e editar contatos e empresas, vincular contatos a negócios e etiquetar negócios. É bem mais rápido e evita que a IA se perca no meio de uma lista grande.

Cada item segue as mesmas permissões da ação individual: só entra o que está na sua carteira. Um item com problema não desfaz os outros; a resposta diz, item a item, o que foi gravado, o que falhou e por quê. Peça para a IA corrigir só os itens que falharam. Cada item conta no limite de ações por minuto da conexão.

Exemplos

• "Liste todas as minhas oportunidades no funil Outbound."
• "Adicione ao negócio escolhido uma nota: Quem usa CRM vende mais."
• "Crie uma atividade amanhã às 9h, no horário de São Paulo."
• "A Maria ainda não tem negócio: agende uma ligação pra ela amanhã às 10h."
• "Anote na ficha da Maria que ela prefere contato de manhã."
• "Cadastre esta empresa e um contato vinculado a ela."
• "Atualize o preço e a descrição deste produto."
• "Crie estes 30 negócios no funil Outbound, cada um com o contato da planilha."
• "Crie uma tarefa de follow-up amanhã às 10h em todos os negócios da etapa Proposta."

Quando houver dois negócios com o mesmo nome, escolha qual usar antes da ação. Para "amanhã", informe horário e fuso; não assuma que a data UTC é a data local.

Rotinas guiadas no plugin

O pacote CRM do Jordão 0.3.0 inclui orientações para começar no CRM, importar planilhas, cuidar de cards e tarefas, analisar o funil e enriquecer o contexto dos clientes. A distribuição por marketplace é independente da aprovação no diretório público da OpenAI. Cadastrar apenas o endereço MCP conecta as ferramentas; as rotinas exigem também instalar o pacote de skills.

Você pode pedir, por exemplo:

• “Não sei por onde começar. Veja minha configuração e me ajude.”
• “Leia esta planilha e crie as oportunidades no meu funil Comercial.”
• “Conclua a tarefa de ligar para este cliente.”
• “Pesquise notícias desta empresa e registre o contexto relevante no card.”
• “Use a proposta que está no Drive para atualizar esta oportunidade.”

Na importação, o aplicativo de IA lê o arquivo e envia os registros estruturados ao CRM. Contatos podem ser importados em lotes; oportunidades são criadas pelo MCP. O assistente precisa resolver colunas, destino e duplicatas antes de gravar. A permissão de importação continua exigindo administrador autorizado.

Gmail, Drive, sites e arquivos dependem das ferramentas que você conectou ou disponibilizou ao aplicativo. O plugin do CRM não dá acesso automático a esses serviços. Para analisar calls, forneça a transcrição ou use uma ferramenta conectada que permita consultá-la. O CRM não expõe suas transcrições internas por este MCP. Atualizar um card com uma proposta não significa marcar a venda como ganha; isso exige evidência de aceite ou sua instrução explícita.

Com permissão administrativa, o assistente pode consultar o “Sobre a empresa” para personalizar orientações. Sem esse acesso, ele pode usar o contexto que você fornecer na conversa. Para dúvidas da plataforma, as ferramentas search_help_articles e get_help_article consultam artigos oficiais com links para esta Central de Ajuda, apontando a seção exata do passo a passo, e trazem os vídeos tutoriais publicados sobre o assunto. A busca é a mesma do assistente do CRM: entende erro de digitação e sinônimo ("puxar conversas" acha a sincronização). A leitura inclui correções publicadas pela administração; recursos descritos na interface nem sempre podem ser executados pelo MCP.

Revogar e reconectar

Em Configurações → ChatGPT e Claude, abra Aplicativos conectados e clique em Revogar conexão. Novas chamadas e renovações são bloqueadas imediatamente. Remover o membro do workspace também invalida suas conexões. Conexões expiram em até 90 dias; o aplicativo pode pedir um novo consentimento.

Se algo falhar

• Se o aplicativo de IA não mostrar a opção de adicionar um servidor MCP,

confira o plano, a versão web e as permissões com o administrador do aplicativo. Isso, por si só, não indica erro no CRM. Não contrate um plano sem confirmar antes que ele permite a conexão e as ferramentas de que você precisa.

• Depois de Autorizar conexão, o navegador deve retornar ao aplicativo de IA.

Se permanecer no formulário, reinicie a conexão pelo aplicativo e tente de novo. Se persistir, informe ao suporte o navegador e o horário da tentativa, sem enviar códigos ou tokens da URL.

• Permissão insuficiente: reconecte autorizando o escopo; ser administrador no

ChatGPT não muda seu papel no CRM.

• Conexões antigas não ganham automaticamente os novos escopos de edição de

contatos e empresas: é necessário autorizar essas permissões novamente.

• Negócio não encontrado: pode estar fora da sua carteira ou de outro workspace.
• Resultado incerto: não repita criando uma nova ação. Use o ID da operação

para pedir reconciliação ao suporte; isso evita notas e tarefas duplicadas.

• A conexão OAuth não oferece exclusões, arquivamento de cadastros, substituição

integral de catálogos, envio de WhatsApp/email, cobrança, gestão de usuários ou acesso a chaves e configurações de integrações. Edições permitidas podem alterar valores e limpar campos opcionais; confirme mudanças importantes.

Privacidade

Os dados comerciais autorizados nas ferramentas são enviados ao aplicativo de IA que você conectou. Permissões de carteira continuam valendo. Senhas, hashes e chaves internas não fazem parte dos campos retornados. Há mascaramento adicional para credenciais reconhecíveis e campos personalizados identificados como segredo, mas ele não consegue identificar qualquer senha arbitrária escrita numa nota. Não armazene credenciais em nomes, notas ou outros campos comerciais.

Vídeo: passo a passo

YouTube

▶ Vídeo curto sobre como conectar o CRM do Jordão ao ChatGPT.