O MCP permite conectar o CRM DataCrazy a ferramentas de inteligência artificial, como o Codex, possibilitando consultar informações e executar operações no CRM por meio de comandos em linguagem natural.
Com essa integração, é possível solicitar à IA ações como consultar leads, localizar clientes e acessar informações do CRM, conforme as ferramentas disponibilizadas pelo servidor MCP e as permissões da conta.
A integração foi testada com sucesso utilizando o OpenAI Codex com uma conta ChatGPT Plus.
Antes de iniciar, é necessário:
Ter acesso ao CRM DataCrazy.
Possuir um token de API válido do DataCrazy.
Ter o servidor MCP habilitado na conta do CRM.
Possuir acesso ao OpenAI Codex (disponibilidade nos planos em todos os planos mas com diferentes limites e condições de utilização).
Plano | Codex local | Codex Cloud | MCP personalizado no ChatGPT web |
|---|---|---|---|
Free / Go | Disponível com limites | Não disponível | Não disponível |
Plus | Disponível | Disponível para contas elegíveis | Não disponível |
Pro | Disponível | Disponível | Disponível com limitações |
Business | Disponível | Disponível | Disponível com suporte completo |
Enterprise / Edu | Disponível | Disponível conforme elegibilidade | Disponível com suporte completo |
Observação: no plano Pro, os servidores MCP personalizados no ChatGPT web possuem permissões de leitura e recuperação de dados. O suporte completo, incluindo ações de gravação e modificação, está disponível nos planos Business e Enterprise/Edu.
Acesse a área de configuração MCP do CRM e localize as informações necessárias para estabelecer a conexão.
Endpoint MCP:
https://mcp.g1.datacrazy.io/api/mcpAutenticação:
Authorization: Bearer SEU_TOKENSubstitua SEU_TOKEN pelo token de API disponibilizado pelo DataCrazy.
Antes de continuar, confirme se o servidor MCP está habilitado na conta do CRM.
No aplicativo Codex:
Acesse Configurações → Plugins.
Selecione a opção para adicionar um MCP personalizado.
Informe um nome para a conexão, como MCP DATA.
Selecione o tipo HTTP com streaming.
Insira a URL do endpoint MCP do DataCrazy.
Configure a autenticação utilizando o cabeçalho Authorization, com Bearer seguido do token de API.
Salve a configuração.
Verifique se o servidor MCP está habilitado.
Importante: o token deve ser configurado de acordo com o método de autenticação suportado pelo ambiente utilizado. Não compartilhe tokens em conversas, documentos públicos ou capturas de tela.
É necessário criar uma pasta na máquina, ela pode estar em qualquer lugar da máquina.
No aplicativo do ChatGPT, criar um projeto.
Na criação do projeto, selecionar a pasta que foi criada anteriormente.
Criar o projeto.
Após salvar a configuração:
Reinicie o Codex, caso necessário.
Inicie uma nova conversa dentro do projeto criado.
Solicite a verificação da conexão utilizando o comando abaixo:
JavaScriptVerifique se o MCP DATA está conectado e liste todas as ferramentas disponíveis, sem executar nenhuma alteração no CRM.
Se o Codex reconhecer o servidor e listar as ferramentas disponíveis, a conexão foi estabelecida corretamente.
Após essa validação, é possível realizar consultas de teste, como localizar um lead pelo nome.
JavaScriptNo meu CRM tem algum cliente com o telefone XXX?
Recomendação: inicialmente, execute apenas consultas, evitando alterações nos dados do CRM até confirmar que a integração está funcionando corretamente.
Mensagem retornada:
MCP Server is not enabled for this tenantDescrição: o servidor MCP recebeu a requisição, mas recusou o acesso porque o recurso não está habilitado para a conta do DataCrazy identificada.
Como resolver:
Acesse a conta correspondente no CRM DataCrazy.
Verifique se o recurso MCP está habilitado.
Caso esteja desabilitado, realize a habilitação.
Reinicie a conexão no Codex e aguarde 2 minutos.
Execute novamente o teste.
Mensagem retornada:
MCP startup failed
Handshaking with MCP server failedDescrição: indica uma falha durante a inicialização da comunicação entre o Codex e o servidor MCP.
Possíveis causas:
URL do endpoint incorreta.
Caracteres adicionais ou espaços no endereço.
Projeto criado sem pasta.
Conversa criada fora do projeto.
Token inválido ou ausente.
MCP desabilitado na conta do DataCrazy.
Resposta inesperada do servidor.
Como resolver:
Confira se a URL do endpoint está correta.
Refazer o projeto selecionando novamente a pasta.
Criar a conversa dentro do projeto.
Verifique o método de autenticação e o token utilizado.
Confirme se o MCP está habilitado no DataCrazy.
Reinicie o Codex e tente novamente.
Caso o erro persista, verifique o retorno HTTP e os logs disponíveis.
Descrição: o servidor MCP aparece cadastrado e habilitado nas configurações, mas suas ferramentas não ficam disponíveis para utilização.
Como resolver:
Confirme se o servidor MCP foi salvo corretamente.
Verifique a URL e a autenticação.
Confirme se a conexão está habilitada.
Reinicie o Codex.
Abra uma nova conversa ou tarefa compatível e teste novamente.
Caso necessário, verifique o arquivo config.toml do Codex (C:\Users\XXX\.codex\config.toml)
Exemplo de configuração:
[mcp_servers.mcp_data]
enabled = true
url = "https://mcp.g1.datacrazy.io/api/mcp"Atenção: esse exemplo apresenta apenas o endpoint e a habilitação do servidor. A autenticação precisa ser configurada separadamente.
Habilitação por conta: o MCP precisa estar habilitado individualmente na conta do DataCrazy utilizada.
Token de API: deve corresponder à conta do CRM que será acessada.
Permissões: as ferramentas disponibilizadas podem permitir consultas e alterações de informações, dependendo das permissões configuradas.
Testes iniciais: recomenda-se validar primeiro as ferramentas de consulta, sem modificar dados.
Codex e ChatGPT: a configuração realizada no Codex não é automaticamente compartilhada com as conversas convencionais do ChatGPT.
Disponibilidade: o suporte a conexões MCP personalizadas pode variar conforme o produto, plano, ambiente e permissões da conta OpenAI.
Após concluir a configuração, o Codex deverá reconhecer o servidor MCP do DataCrazy e disponibilizar as ferramentas autorizadas para utilização.
Com isso, será possível realizar consultas e operações no CRM utilizando comandos em linguagem natural, sem precisar executar manualmente cada ação na interface do sistema, desde que a operação seja suportada pelas ferramentas disponibilizadas.