Servidor MCP

Conecte um assistente de IA à Certivant pelo Model Context Protocol — organize a fila de verificação, envie e acompanhe formulários, cobre solicitantes inativos, explique decisões e gere relatórios, tudo com a sua chave de API atual.

O servidor MCP da Certivant expõe a plataforma de verificação para assistentes de IA por meio do Model Context Protocol. Aponte para ele um host compatível — Claude Desktop, Claude Code, Cursor, VS Code, OpenAI Codex, Gemini ou Mistral — e o assistente poderá trabalhar na sua fila: ver o que precisa de atenção nesta manhã, enviar um formulário de verificação a um cliente indicado e acompanhar se ele respondeu, cobrar quem ficou sem resposta, explicar por que um caso foi rejeitado e consultar os números de conformidade do mês.

O servidor MCP é um cliente da mesma API REST /api/v1/kyc que você já usa. Ele não mantém conexão com banco de dados e não cria um segundo modelo de permissões: a organização, os escopos e o limite de requisições da sua chave de API são exatamente o que o assistente recebe.

Visão geral


Transporte	Streamable HTTP — `POST /mcp`
Porta padrão	`3007` (`MCP_PORT`)
API de destino	`CERTIVANT_API_BASE_URL`, padrão `http://localhost:3005`
Autenticação	`Authorization: Bearer kyk_…` — uma chave de API existente da Certivant
Verificação de integridade	`GET /health` (sem autenticação, informa apenas sobre este processo)
Catálogo	26 ferramentas · 4 recursos · 5 prompts

O que ele faz

Organizar o dia — uma única chamada retorna o panorama completo da fila: o que foi encaminhado para revisão, o que está parado, quais verificações de sanções falharam e quais encaminhamentos ultrapassaram o SLA de revisão.

Fazer o trabalho avançar — iniciar uma verificação (uma por vez ou até 50 de uma vez), enviar um formulário a um cliente por e-mail, lembrar quem ficou parado e renovar uma verificação prestes a vencer.

Entender uma decisão — ler os próprios vereditos por fator, as desqualificações e os gatilhos de revisão do mecanismo de pontuação, em vez de adivinhar a partir de uma pontuação.

Fazer pesquisa de KYB — ler o cadastro declarado da empresa e comparar os diretores declarados com o registro público.

Gerar relatórios — taxa de aprovação, funil completo, volume por tipo de documento, taxas de falha por verificação e tendência de 30 dias, sem dados de registros individuais e sem dados pessoais.

O modelo de segurança em um parágrafo

Por padrão, as respostas têm formato de veredito: um status, uma decisão, uma pontuação — nunca uma data de nascimento, um número de documento ou texto bruto de OCR. Qualquer coisa que o solicitante tenha digitado, ou que tenha sido extraída de um documento enviado por ele, chega dentro de um envelope não confiável rotulado, para que o modelo relate esse conteúdo em vez de obedecê-lo. As ferramentas que enviam e-mails a clientes reais são marcadas como não somente leitura, para que o seu host possa pedir confirmação antes de executá-las, e a única ferramenta realmente destrutiva informa isso. Leia os detalhes em Segurança e limites.

O que ainda não está disponível

Autenticação. Todos os caminhos de instalação deste site usam uma chave de API como token Bearer. Um fluxo de login OAuth 2.1 (Dynamic Client Registration, consentimento e tokens limitados a uma única organização) também está implementado para diretórios de conectores; os tokens que ele emite se comportam exatamente como chaves de API.

Um limite que vale conhecer antes de começar, porque você vai encontrá-lo:

explain_verification_decision não consegue explicar a maioria das verificações antigas. O raciocínio estruturado do mecanismo de pontuação só existe em requisições pontuadas depois que ele passou a ser registrado; para as demais, a ferramenta retorna reasoningAvailable: false.

Cada chamada de ferramenta é registrada no mesmo registro de auditoria de KYC, à prova de adulteração (kyc_audit_log), que as ações humanas, por meio da API REST com a chave do próprio chamador.

Próximos passos

Instalação — JSON de configuração para cada host, vinculado à sua chave de API atual.

Referência de ferramentas — as 26 ferramentas agrupadas por tarefa, com o que cada uma retorna e o que não retorna.

Recursos e prompts — o contexto que o modelo pode obter sem custo, e os cinco fluxos de trabalho prontos.

Segurança e limites — níveis de tratamento de PII, envelope não confiável, controles de velocidade e limites de requisições.