Integração com IA

Servidor MCP e prompt pronto para integrar a Legitimuz com agentes de IA como Claude Code, Cursor e Copilot.

Ferramentas e contexto especializado para integrar a Legitimuz com IA. Se você usa Claude Code, Cursor ou Copilot, dê o contexto primeiro: o agente erra menos e você revisa menos.

O que está disponível

Servidor MCP

O agente busca e lê esta documentação de dentro do editor, sem copiar nada.

Prompt de integração

Um prompt pronto, com os requisitos e as restrições que o agente precisa respeitar.

Para quem é cada ferramenta

	Servidor MCP	Prompt de integração
Objetivo	dar acesso vivo à documentação	orientar a integração completa
Ideal para	consultas pontuais durante o desenvolvimento	começar uma integração do zero
Formato	conexão no editor	texto para colar
Requer chave de API	não	não

Servidor MCP

O servidor MCP deixa o agente pesquisar e ler estas páginas de dentro do editor.

.mcp.json

{
  "mcpServers": {
    "legitimuz-docs": {
      "url": "https://documentacao.legitimuz.com/mcp"
    }
  }
}

Depois de conectar, peça em linguagem natural: “procure na documentação da Legitimuz como criar uma verificação”.

Se o seu agente não fala MCP, o índice completo está em texto puro:

https://documentacao.legitimuz.com/llms.txt

Prompt de integração

Cole isto no seu agente, preenchendo os valores do topo:

Integre a verificação de identidade da Legitimuz neste projeto.

Contexto:
- Stack: <SEU FRAMEWORK>
- Fluxo (flow_public_id): <FLOW_PUBLIC_ID>
- A documentação está em https://documentacao.legitimuz.com/llms.txt. Leia antes de escrever código.

Requisitos, nesta ordem:

1. Crie uma rota de backend que chame POST https://api-core.legitimuz.com/public/verifications
   com o header X-API-Key lido de variável de ambiente. A rota deve:
   - autenticar quem está pedindo;
   - pegar o CPF do cadastro do usuário autenticado, nunca do corpo da requisição;
   - enviar ref_id com o identificador do meu cadastro;
   - enviar flow_public_id com o valor acima;
   - devolver ao cliente apenas o campo entry da resposta.

2. No front, chame essa rota e abra a verificação com a entry recebida.
   Carregue o Web SDK pela tag https://sdk.legitimuz.com/v1/websdk.iife.js e use window.Legitimuz.mount.
   Não fixe nenhuma credencial no código do cliente.

3. Crie um handler de webhook que:
   - leia o corpo cru antes de qualquer parse;
   - confira X-Legitimuz-Signature (HMAC-SHA256 sobre `${t}.${corpo}`, tolerância de 5 minutos);
   - responda 2xx antes de processar;
   - descarte repetição pelo header X-Legitimuz-Delivery;
   - trate os status approved, reproved e review, sabendo que review não é recusa;
   - aceite receber verification.decided duas vezes para a mesma verificação.

Restrições:
- A chave de API nunca pode aparecer no front, no app ou em log.
- O desfecho vem do webhook, nunca de um evento de tela.
- A API pública tem uma rota: POST /public/verifications. Não invente outras.

Revise o que o agente escreveu

Agentes erram nos mesmos pontos. Confira estes cinco antes de aprovar.

Verifique	Por quê
A chave está só no servidor	lz_ no bundle do front é credencial exposta
O CPF vem do seu cadastro	se vier do corpo, qualquer um verifica qualquer pessoa
A assinatura é conferida sobre o corpo cru	reserializar o JSON invalida a conferência
review é tratado	sem isso, uma pessoa legítima fica presa
O desfecho vem do webhook	evento de tela é controlado por quem está na tela

Ecossistema

Documentação

A referência completa, também em llms.txt.

Web SDK

Como abrir a verificação na web.

Referência da API

O contrato que o agente deve seguir.