Conectar agentes de IA ao Lefia (servidor MCP)

O Lefia tem um servidor MCP (Model Context Protocol, o padrão que os agentes de IA usam para chamar ferramentas). Com ele, o agente de IA que a sua empresa já usa pergunta ao Lefia e recebe a resposta com os dados desta empresa — por exemplo: "tem nota presa com o parceiro X?", "por que o pedido 4500123 não chegou?", "como foi o dia em produção?".

O que o agente consegue fazer

Só ler. Nenhuma ferramenta altera dados, reprocessa ou envia mensagem.

Ferramenta	Responde
`list_integrations`	Quais integrações existem e se estão entregando (falhas e entregas das últimas 24 h, última execução, última falha)
`search_messages`	Mensagens por período, situação (entregue, em espera, falhou, em trânsito), integração, documento, tipo ou parceiro
`get_message`	Uma mensagem em detalhe, com o erro explicado: resposta do destino, categoria e ação recomendada, erros de mapeamento, diagnóstico de IA (se já houver)
`monitor_summary`	Os números do Monitor no período: total, entregues, em espera, falhas, em trânsito, taxa de sucesso e latência
`list_executions`	Execuções recentes das integrações

O ambiente (DEV, QAS ou PRD) é escolhido a cada pergunta; o padrão é PRD. Ambiente inativo na empresa não responde.

Como conectar

Em Configurações → Conectar agentes de IA (MCP) (só o administrador da empresa), dê um nome à chave (ex.: "Joule — financeiro") e clique em Emitir credencial.
Copie a chave na hora — ela começa com lfm_ e não aparece de novo. O Lefia guarda só uma impressão (hash) dela.
No seu cliente MCP, cadastre o endereço do servidor mostrado na tela (termina em /api/mcp), transporte Streamable HTTP, com o cabeçalho Authorization: Bearer lfm_…. A tela traz um exemplo pronto para clientes com servidor remoto (Claude Code, Cursor, VS Code, MuleSoft MCP Bridge) e para o Claude Desktop (via mcp-remote).

Emita uma chave por agente ou ferramenta: assim você revoga uma sem derrubar as outras. A chave vence (padrão 365 dias, máximo 730) e pode ser revogada a qualquer momento na mesma tela.

Privacidade e segurança

A chave vale só para esta empresa e só para o servidor MCP. A credencial de export de relatórios (lfx_) não abre o MCP, e a chave MCP não abre o export.
O conteúdo das mensagens (payload) nunca é enviado ao agente. Ele recebe metadados (documento, tipo, parceiros, situação, horários) e explicações.
Textos livres (resposta do destino, mensagens de erro, diagnóstico) saem com dados pessoais mascarados (CPF, CNPJ, e-mail, telefone, IBAN, cartão). Dos erros de mapeamento sai a estrutura (campo, origem, esperado, sugestão), nunca o valor recebido.
Se a empresa desativar o uso de IA (Configurações → Uso de Inteligência Artificial), o servidor MCP recusa toda chamada até a IA ser reativada.
Toda chamada fica na trilha de auditoria da empresa: qual chave, qual ferramenta, com quais filtros, se deu certo e quantos itens voltaram.
Limite de 60 requisições por minuto por chave.

Perguntas comuns

Funciona com o conector personalizado do claude.ai? Ainda não: o claude.ai exige login OAuth, e esta versão usa chave. Use o Claude Desktop, o Claude Code ou outro cliente que aceite cabeçalho.

O agente pode reprocessar uma mensagem? Não nesta versão. Ações (reprocessar, reenviar, abrir chamado) ficam para uma versão futura, com permissão própria e confirmação.