Sistema de gestão com API: MCP, automações que recebem e chamam outros apps

Quem compra um sistema de gestão com API quer tirar dado de lá sem exportar planilha toda semana e pôr dado lá sem alguém digitar de novo. Antes de assinar, vale saber o que dá para ler, o que dá para alterar e quem controla isso.

No Mentrun, tudo isso está no plano de R$ 220 por mês por empresa e pode ser testado nos 7 dias grátis. Os detalhes técnicos, com exemplos de chamada, estão na página Desenvolvedores.

O que dá para integrar com o Mentrun?

Há três caminhos, cada um para uma necessidade: o MCP para ler e alterar os dados, a entrada das automações para outro sistema avisar o Mentrun e o passo Chamar outro app para o Mentrun avisar o seu sistema.

Como funciona o MCP do Mentrun?

O MCP é um protocolo aberto que funciona sobre HTTP, com JSON-RPC 2.0. O programa pede a lista de ferramentas e chama a que precisa, como listar_projetos, criar_tarefa ou ler_transcricao. A lista já vem filtrada: aparece só o que a conexão, o cargo da pessoa e a assinatura permitem.

• Reuniões: ler análises e transcrições, importar e reanalisar reuniões, registrar desfecho.
• Projetos e tarefas: criar projeto, criar e atribuir tarefa, mover no quadro, concluir, lançar horas.
• Documentos: ler, criar e atualizar documentos, pastas e fluxogramas, com versões.
• Clientes e chamados: cadastrar cliente, registrar contato, abrir e responder chamado.
• Leitura de gestão: painéis, metas, propostas, contratos com vigência e financeiro (com acesso próprio).
• Relatórios: exportar_relatorio devolve o Excel ou o PDF do período pedido.

Cada ferramenta tem esquema estrito: argumento desconhecido é recusado com a lista do que está errado. Textos longos, como uma transcrição, vêm em partes, e toda alteração fica no histórico da empresa no nome da pessoa dona da conexão.

Como conectar Claude, ChatGPT, n8n ou Make?

No Claude e no ChatGPT, você cola o endereço do MCP como conector, entra no Mentrun, escolhe a empresa e o nível: Só consultar ou Consultar e alterar. Em n8n, Make, scripts e Claude Code, a conexão usa uma credencial no cabeçalho ou um endereço único.

O passo a passo com as telas do Claude e do ChatGPT está em conectar o Claude aos dados da empresa. Em Empresa › Conectar outros apps, o guia da tela também traz Usar com segurança e o que fazer se uma credencial vazar.

Quem controla o que a integração pode fazer?

Quem cria a conexão escolhe um modelo: Só leitura, Comercial, Operação, Conhecimento, Analista de reuniões ou Personalizado, módulo por módulo. O que vale na prática é o escopo da conexão somado ao cargo da pessoa e à assinatura ativa: a integração nunca vê mais do que a pessoa veria.

• Riscos à vista: conexão que altera ou apaga dados mostra os riscos e só é criada depois de marcar Entendi os riscos.
• Excluir com volta: negócio, projeto, tarefa, documento ou pasta excluídos vão para a lixeira por 30 dias.
• Acesso administrativo: só o Dono cria, com verificação em duas etapas.
• Uso e auditoria: cada chamada fica registrada por conexão durante 180 dias, e dá para ver tudo o que cada uma alterou, com link para o item.
• Validade: 30 dias por padrão; girar cria uma nova e a antiga para na hora, em 1 hora ou em 24 horas.

O que o Claude consegue configurar pelo MCP?

O Claude conectado também configura o Mentrun: monta o Processo comercial a partir do seu playbook, ajusta como a IA analisa as reuniões e prepara nomes, menu, campos, modelos de projeto, pastas e trilhas do Treino. Você vê a prévia, confirma e pode desfazer.

Nas automações, o Claude monta, testa sem mandar nada para fora e, se você liberar, publica e liga. Esses acessos são marcados à parte na conexão e só valem para Dono e Gestor. O jeito de pedir está em configurar sistema com IA.

Como as automações conversam com outros sistemas?

Nos dois sentidos. Para receber, a automação ganha um endereço próprio e roda quando outro sistema manda um aviso. Para enviar, um passo chama o endereço do seu sistema com os dados do gatilho, e a resposta fica disponível para os passos seguintes.

1. 1

   Receber

   No editor da automação, escolha o gatilho Ao receber de outro app e toque em Gerar chave. O campo Endereço para o outro app já traz o endereço completo.

2. 2

   Evitar repetição

   Mande um identificador do aviso, como o número do pedido. O mesmo aviso repetido é ignorado.

3. 3

   Enviar

   Use Enviar aviso para outro app para um POST pronto, ou Chamar outro app para escolher método, cabeçalhos e corpo.

4. 4

   Guardar o acesso

   As credenciais dos seus sistemas ficam em Automações › Configurações › Chaves de outros apps e nunca aparecem no histórico.

5. 5

   Testar

   Testar agora simula a automação sem mandar nada; Testar a chamada, no passo, manda de verdade e mostra a resposta.

CHECKLIST DE INTEGRAÇÃO

Sistema que vai integrar: ______________________
Responsável técnico: ______________   Dono do processo: ______________

1. O QUE PRECISA ACONTECER
[ ] Ler dados do Mentrun (ex.: horas por projeto toda segunda)
[ ] Gravar dados no Mentrun (ex.: criar tarefa quando entra um pedido)
[ ] Avisar outro sistema quando algo muda (ex.: chamado aberto)

2. CAMINHO
[ ] MCP (ler e alterar)  [ ] Entrada da automação  [ ] Passo Chamar outro app

3. ACESSO
Modelo da conexão: [ ] Só leitura [ ] Comercial [ ] Operação [ ] Conhecimento [ ] Personalizado
Módulos marcados: ______________________
Pessoa dona da conexão (cargo): ______________
Validade: ____ dias   Onde fica guardada: ______________

4. TESTE
[ ] Chamada de teste feita e conferida em Uso e auditoria
[ ] Aviso repetido conferido (identificador do aviso: ______)
[ ] Quem é avisado se falhar: ______________

5. REVISÃO
Data para revisar ou girar o acesso: ____/____/______

Quanto custa usar a API do Mentrun?

O MCP, as automações e as integrações prontas fazem parte do plano do Mentrun: R$ 220 por mês por empresa, com usuários ilimitados e todos os recursos; no semestral e no anual, sai por R$ 183,33 por mês. Quem integra pode começar no teste grátis de 7 dias, sem cartão.

Para entender o protocolo antes de decidir, leia o que é MCP. Se a integração pede uma conversa com a equipe, peça a demonstração e leve o seu checklist preenchido.