← Central de Documentação

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.

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

  1. Contratação do serviço pela empresa, junto à CRTI (veja o aviso acima).
  2. 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.
  3. 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)

  1. No ERP, clique em CRTI IA > Adicionar ao Claude e depois em Abrir no Claude.
  2. 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.
  3. 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:

  1. O proprietário copia o nome e a URL em CRTI IA > Adicionar ao Claude, no ERP.
  2. 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.
  3. 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

  1. 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).
  2. 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.
  3. 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).
  4. 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

  1. 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.
  2. 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.
  3. 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.
  4. 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:

  1. Abre a tela de login do ERP, a mesma do dia a dia. Entre com o seu usuário e senha.
  2. 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.
  3. 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.