CRTI IA — Como configurar o MCP
Como configurar o MCP do CRTI IA, que conecta o CRTI ERP ao Claude, ao ChatGPT e ao Gemini para consultar os dados da empresa conversando com a IA. Serviço contratado à parte, por licença.
- 1. O que o assistente consegue fazer
- 2. Antes de começar
- 3. Onde encontrar o nome e a URL do conector
- 4. Adicionar ao Claude
- 5. Adicionar ao ChatGPT
- 6. Adicionar ao Gemini
- 7. Login e autorização no ERP
- 8. Dicas de uso
- 9. Segurança e privacidade
- 10. Problemas comuns
O CRTI IA conecta o CRTI ERP a assistentes de inteligência artificial — Claude, ChatGPT e Gemini — pelo protocolo MCP (Model Context Protocol). Esta página mostra como configurar o MCP do CRTI IA em cada assistente. Com o conector ativo, você pergunta em linguagem natural (“quais títulos a pagar vencem nesta semana?”, “quanto a filial de Curitiba vendeu em agosto?”) e o assistente consulta os relatórios do ERP para responder.
O CRTI IA é um serviço contratado à parte, por licença. Ele não faz parte do CRTI ERP padrão e só funciona para empresas que contrataram o serviço com a CRTI. Sem a contratação, o botão CRTI IA não aparece no ERP e o endereço do conector não responde. Para contratar ou tirar dúvidas, fale com a equipe comercial CRTI pelo e-mail comercial@crti.com.br ou pelo WhatsApp +55 41 8401-1717.
As telas dos assistentes mudam com frequência. O passo a passo abaixo reflete setembro de 2026: se um nome de menu estiver diferente, procure pela opção equivalente.
1. O que o assistente consegue fazer
O CRTI IA oferece ao assistente os relatórios e consultas do ERP, organizados por área: cadastros, compras, suprimentos, equipamentos e frota, custos, financeiro, contabilidade, fiscal e documentos eletrônicos (NF-e, NFS-e, CT-e e MDF-e), vendas, contratos e medições, terceiros e apropriações, locação de equipamentos, controle patrimonial, qualidade e log de acessos.
- Só consulta. O assistente não inclui, altera nem exclui nada no ERP.
- Com as suas permissões. Ele enxerga exatamente o que você enxerga no ERP: só os relatórios das telas a que você tem acesso e só as filiais liberadas para o seu usuário.
- Uma consulta traz no máximo 200 linhas. Para listas grandes, o assistente precisa refinar o filtro (um mês, uma filial) ou pedir totais.
- Período padrão de 1 mês e máximo de 1 ano. Sem período na pergunta, vale o último mês; nenhuma consulta passa de 1 ano (veja as dicas de uso).
2. Antes de começar
- Contratação do serviço pela empresa, junto à CRTI (veja o aviso acima).
- Permissão no ERP. O administrador concede a permissão Integrações B2B > MCP > Servidor MCP ao grupo de acesso do usuário, em Configurações do Sistema > Permissões > Grupos de Acesso. Sem ela, o botão CRTI IA não aparece e o ERP recusa as consultas. Depois de salvar o grupo, o usuário precisa sair do ERP e entrar de novo para as permissões serem atualizadas e o botão aparecer. Cada usuário com a permissão ocupa uma licença do CRTI IA: o ERP não deixa salvar o grupo ou o usuário que passaria do número contratado. A licença é pessoal, e cada login mantém no máximo 2 assistentes conectados — conectar o terceiro desconecta o menos usado. Para cada relatório, vale também a permissão da tela correspondente.
- Conta no assistente que aceite conectores personalizados:
| Assistente | Planos | Observação |
|---|---|---|
| Claude (claude.ai) | Free (um conector personalizado), Pro, Max, Team e Enterprise | No Team e no Enterprise, quem adiciona o conector é o proprietário da organização (seção 4.2) |
| ChatGPT (chatgpt.com) | Plus, Pro, Business, Enterprise e Edu, na versão web | O plano gratuito não tem a opção. Exige o modo de desenvolvedor (seção 5) |
| Gemini (gemini.google.com) | Conta pessoal do Google, maior de 18 anos | Contas do Google Workspace (trabalho ou escola) podem ainda não ter a opção |
3. Onde encontrar o nome e a URL do conector
Na tela inicial do CRTI ERP, ao lado de Alterar Senha, clique em CRTI IA e escolha o assistente: Adicionar ao Claude, Adicionar ao ChatGPT ou Adicionar ao Gemini. A janela mostra:
- Nome do conector, no formato
crtierp-<nome da sua empresa no ERP>; - URL do conector, no formato
https://<endereço do seu ERP>/api/v1/mcp.
Clique no campo para selecionar o conteúdo e copie (Ctrl+C). O botão Abrir no Claude / ChatGPT / Gemini leva direto à tela do assistente onde o conector é adicionado.
Se o botão CRTI IA não aparece, a sua empresa não contratou o serviço ou o seu usuário não tem a permissão Servidor MCP (passo 2 da seção 2). Se a permissão acabou de ser concedida, saia do ERP e entre de novo; se continuar sem o botão, fale com o administrador do ERP.
4. Adicionar ao Claude
4.1. Planos individuais (Free, Pro e Max)
- No ERP, clique em CRTI IA > Adicionar ao Claude e depois em Abrir no Claude.
- O claude.ai abre a janela de conector personalizado (Add custom connector) já preenchida com o nome e a URL, com um aviso de que os dados vieram de um link externo. Confira e confirme. Se você não estiver logado no Claude, ele pede o login antes.
- No conector recém-adicionado, clique em Conectar (Connect). Abre a tela de login do CRTI ERP: siga a seção 7.
Se preferir fazer à mão: em Personalizar > Conectores (Customize > Connectors), clique em +, Adicionar conector personalizado, cole o nome e a URL e clique em Adicionar.
4.2. Planos Team e Enterprise
Nesses planos, só o proprietário (Owner) da organização no Claude adiciona conectores personalizados:
- O proprietário copia o nome e a URL em CRTI IA > Adicionar ao Claude, no ERP.
- No Claude, abre Configurações da organização > Conectores (Organization settings > Connectors), clica em Adicionar, escolhe Personalizado > Web, cola a URL (e o nome) e clica em Adicionar.
- Depois disso, cada pessoa abre Personalizar > Conectores, localiza o conector do CRTI ERP e clica em Conectar, entrando com o próprio usuário do ERP (seção 7).
4.3. Usar numa conversa
Na conversa, clique em + (canto inferior esquerdo da caixa de mensagem), escolha Conectores e ligue o conector do CRTI ERP. Depois é só perguntar.
5. Adicionar ao ChatGPT
No ChatGPT, o conector é um app do modo de desenvolvedor, disponível na versão web (chatgpt.com) nos planos Plus, Pro, Business, Enterprise e Edu.
Business, Enterprise e Edu: o administrador do workspace precisa liberar o modo de desenvolvedor antes, em Configurações do workspace > Permissões e funções > Dados conectados (Modo de desenvolvedor / Criar conectores MCP personalizados). No Business, só administradores e proprietários criam o app e o disponibilizam para o workspace; no Enterprise e no Edu, o administrador pode liberar para pessoas específicas.
5.1. Ativar o modo de desenvolvedor
Abra Configurações > Segurança e login e ligue o Modo de desenvolvedor (Developer mode). A OpenAI já mudou esse item de lugar: se não o encontrar ali, procure em Configurações > Apps (ou Conectores) > Avançado.
5.2. Criar o app do CRTI ERP
- No ERP, clique em CRTI IA > Adicionar ao ChatGPT, copie o nome e a URL e clique em Abrir no ChatGPT (abre chatgpt.com/plugins).
- Clique em + para criar o app e preencha:
- Nome: cole o nome do conector;
- Descrição: por exemplo, “Consulta aos dados do CRTI ERP”;
- Conexão: endpoint público, colando a URL do conector (termina em
/api/v1/mcp); - Autenticação: OAuth.
- Abra Configurações avançadas de OAuth e, em Suporte ao OpenID, desmarque OIDC habilitado.
O ChatGPT marca a opção sozinho, e com ela o ERP recusa a conexão com
invalid_scope. O escopo padrão continua mcp, e o método de registro, Registro dinâmico de clientes (DCR). - Crie o app. O ChatGPT abre a tela de login do CRTI ERP: siga a seção 7. Ao voltar, o ChatGPT lista as ferramentas (relatórios) que encontrou.
5.3. Usar numa conversa
Numa conversa nova, clique em + na caixa de mensagem, escolha Modo de desenvolvedor (pode estar dentro de Mais) e selecione o app do CRTI ERP. Depois é só perguntar.
6. Adicionar ao Gemini
- No ERP, clique em CRTI IA > Adicionar ao Gemini, copie a URL e clique em Abrir no Gemini (abre gemini.google.com/apps). O Gemini não pede nome.
- Na seção Apps personalizados (pode aparecer como “Apps personalizados para o Spark”), cole a URL no campo Adicione um link de app personalizado para começar e clique em Avançar.
- Na janela Conectar-se a um servidor MCP, confira se a URL começa com
https://e clique em Avançar. Não é preciso mexer em Configurações avançadas: o ERP faz o cadastro do cliente automaticamente. - Abre a tela de login do CRTI ERP: siga a seção 7.
Depois de conectado, peça os dados do ERP normalmente numa conversa. Se o Gemini não recorrer ao CRTI ERP, mencione o app na pergunta.
7. Login e autorização no ERP
Em todos os assistentes, a conexão termina no próprio CRTI ERP:
- Abre a tela de login do ERP, a mesma do dia a dia. Entre com o seu usuário e senha.
- Na tela Autorizar aplicativo, o ERP mostra qual aplicativo quer acesso e com qual usuário você está logado (Entrar com outra conta troca o usuário). Clique em Autorizar.
- O assistente volta com o acesso liberado.
O assistente não recebe a sua senha: recebe um acesso temporário, válido por 1 hora, que ele renova sozinho, sem pedir login. A conexão continua enquanto o assistente for usado, inclusive em painéis e atualizações automáticas. O assistente pede para conectar de novo quando:
- a conexão fica 30 dias sem uso;
- completa 90 dias desde o login (mesmo em uso, por segurança);
- a sua senha ou o seu autenticador de dois fatores muda;
- o seu usuário é bloqueado no ERP;
- o mesmo login conecta um terceiro assistente (cada login mantém no máximo 2).
8. Dicas de uso
- Informe o período (por exemplo, “de 01/08/2026 a 31/08/2026”). Se você não informar, o assistente consulta o último mês até hoje e diz na resposta qual período usou.
- Cada consulta cobre no máximo 1 ano. Para períodos maiores, o assistente explica o limite e propõe dividir em partes de até 1 ano.
- Diga a filial, a obra ou o cliente quando a pergunta for sobre um recorte.
- Tem mais de uma empresa no CRTI ERP? Adicione um conector para cada uma, com o nome e a URL do botão CRTI IA dela. Cada conector se identifica para o assistente com o nome da empresa: diga a empresa na pergunta, e ele usa o conector certo.
- Peça totais para períodos longos. Cada consulta traz no máximo 200 linhas; o assistente avisa quando o resultado veio cortado.
- Uma pergunta de cada vez. O ERP atende uma consulta por vez para cada usuário e limita rajadas de consultas; quando o limite é atingido, o assistente espera alguns segundos e continua.
- Confira os números importantes no ERP antes de tomar uma decisão: a IA pode interpretar um relatório de forma errada.
Exemplos de perguntas:
- “Qual o saldo das contas correntes hoje?”
- “Quais títulos a pagar vencem entre 01/10/2026 e 15/10/2026, por fornecedor?”
- “Quanto foi vendido de concreto por cliente em agosto de 2026?”
- “Quais equipamentos estão parados e há quanto tempo?”
9. Segurança e privacidade
- O CRTI IA só consulta dados: não há ferramenta que altere o ERP.
- Valem as mesmas permissões do seu usuário, de telas e de filiais.
- O login acontece na tela do ERP; a senha não passa pelo assistente.
- Os dados que o assistente consulta são enviados ao provedor da IA (Anthropic, OpenAI ou Google) para gerar a resposta. Confira como o seu plano do assistente trata os dados das conversas.
- Para desconectar, remova o conector nas configurações do assistente. O administrador do ERP pode cortar o acesso retirando a permissão Servidor MCP do usuário (o acesso cai na próxima renovação, em até 1 hora) ou bloqueando o usuário (o acesso cai em segundos).
10. Problemas comuns
| Situação | O que fazer |
|---|---|
| O botão CRTI IA não aparece na tela inicial | A empresa não contratou o serviço (fale com a equipe comercial CRTI pelo e-mail comercial@crti.com.br ou pelo WhatsApp +55 41 8401-1717) ou o seu usuário não tem a permissão Servidor MCP (fale com o administrador do ERP). Se a permissão acabou de ser concedida, saia do ERP e entre de novo. |
| O assistente conecta, mas diz que não tem permissão | Falta a permissão Integrações B2B > MCP > Servidor MCP no seu usuário. Peça ao administrador do ERP. |
| Um relatório específico é recusado | Falta a permissão da tela desse relatório no ERP. |
| O assistente diz que a URL é inválida | Cole a URL inteira, começando com https:// e terminando em /api/v1/mcp. |
| No ChatGPT não aparece o modo de desenvolvedor ou o + em chatgpt.com/plugins | O plano não tem a opção, ou o administrador do workspace ainda não liberou (seção 5). |
| No ChatGPT, “OAuth failed: invalid_scope” ao conectar | A opção OIDC habilitado ficou marcada. Crie o app de novo, desmarcando-a em Configurações avançadas de OAuth > Suporte ao OpenID (seção 5.2). |
| No Gemini não aparece Apps personalizados | A conta é de trabalho ou escola, ou a opção ainda não chegou à sua conta. |
| O assistente pede para conectar de novo | A conexão ficou 30 dias sem uso ou completou 90 dias, a senha ou o autenticador de dois fatores mudou, ou o mesmo login conectou um terceiro assistente e este foi desconectado (seção 7): refaça o login e a autorização. Se isso se repete sem nenhum desses motivos, o login está sendo usado por mais de uma pessoa. |
| A resposta parece incompleta | A consulta pode ter batido no limite de 200 linhas: peça um período menor ou os totais. |