Servidor MCP da ProofAge: deixe seu agente de programação com IA integrar KYC e verificação de idade
O servidor MCP da ProofAge permite que um agente de programação com IA, como o Claude Code ou o Cursor, integre a verificação de identidade (KYC) e de idade ao seu app. Conecte-o em https://app.proofage.net/mcp/admin e entre com OAuth, sem chaves de API. O agente cria um workspace de teste, escreve o código com os nossos SDKs e testa os webhooks. É grátis em todas as contas.
Conecte em um passo
O seu cliente MCP abre uma janela do navegador. Você entra com a sua conta do console da ProofAge e aprova o acesso. Não há chaves de API para colar.
Claude Code
claude mcp add --transport http proofage https://app.proofage.net/mcp/admin
Depois, execute /mcp no Claude Code e escolha proofage para entrar.
Claude.ai
Em Settings → Connectors, adicione um conector personalizado com a URL https://app.proofage.net/mcp/admin, conecte-o e entre.
Cursor
No arquivo ~/.cursor/mcp.json:
{
"mcpServers": {
"proofage": { "url": "https://app.proofage.net/mcp/admin" }
}
}
VS Code
No arquivo .vscode/mcp.json:
{
"servers": {
"proofage": { "type": "http", "url": "https://app.proofage.net/mcp/admin" }
}
}
Grok
No grok.com, abra Connectors → New connector → Custom, informe https://app.proofage.net/mcp/admin e entre. Nos planos Business e Enterprise, talvez um administrador precise adicionar o conector antes.
Perplexity
Em Settings → Connectors, adicione um conector remoto personalizado com a URL https://app.proofage.net/mcp/admin e autenticação OAuth, depois entre. Conectores personalizados exigem um plano Pro, Max ou Enterprise.
ChatGPT, Codex e outros clientes
Aponte o cliente para https://app.proofage.net/mcp/admin. O servidor aceita descoberta OAuth e registro dinâmico de cliente. Podem se conectar o ChatGPT, o GitHub Copilot no VS Code, o Gemini CLI, o app Gemini, o Mistral Le Chat, o Copilot Studio, o Superhuman e o Coda, o Amazon Quick, o n8n Cloud e os clientes que entram por um endereço de retorno local, como o Codex. Se o seu cliente for recusado ao entrar, fale com a gente informando o nome dele: adicionamos clientes sob pedido.
O que o seu agente pode fazer
O agente trabalha com a sua conta como a sua equipe faz no console. Pedidos em linguagem simples bastam: o agente escolhe as ferramentas.
| Grupo | O que faz | Exemplo de prompt |
|---|---|---|
| Integrar | Cria um workspace de teste, lê as chaves e as URLs dele, cria verificações, define resultados de teste e reproduz webhooks em um handler local. Depois, cria o workspace de produção. | “Integre a verificação de idade da ProofAge neste app. Use um workspace de teste, o Browser SDK na página de checkout e um handler de webhook que marque o usuário como verificado.” |
| Investigar | Consulta verificações, a decisão e o motivo, imagens, entregas de webhook e estatísticas, com os mesmos dados do console. | “Por que a verificação 550e8400-… foi recusada?” |
| Suporte | Envia um link de verificação, bloqueia ou desbloqueia um rosto e apaga os dados de uma pessoa a pedido. | “Envie um link de verificação para o cliente 8812 no workspace "Checkout" e me passe a URL.” |
| Documentação | O agente lê a documentação para desenvolvedores e a especificação OpenAPI pelo servidor, com uma ferramenta ou como recursos MCP, então escreve código com base na API real. | “Compare o nosso handler de webhook com o guia de webhooks da ProofAge: verifique a assinatura com o SDK e ignore qualquer entrega cujo X-ProofAge-Webhook-Delivery-Id já tenhamos processado.” |
Do zero à produção, passo a passo
Com os SDKs, uma integração típica fica pronta e testada em um dia. Com um agente de programação com IA usando o servidor MCP, costuma levar algumas horas. Esta é a ordem que o agente segue.
-
1
Criar um workspace de teste
Com a verificação de que você precisa: Verificação de identidade (KYC), Estimativa de idade facial ou Verificação de idade por documento. O modo de teste é grátis.
-
2
Ler o guia de integração
O agente obtém as chaves e as URLs do workspace e lê na documentação o início rápido, os guias dos SDKs, os webhooks e os testes.
-
3
Escrever a integração com o SDK oficial
Para Node.js, Python, PHP ou Laravel. O SDK assina as requisições e valida os webhooks, então o agente não escreve código de assinatura próprio.
-
4
Criar uma verificação e concluí-la você mesmo
O agente entrega o link. As etapas com a câmera exigem uma pessoa, então você as conclui.
-
5
Definir o resultado do teste
Aprovada, recusada ou com novo envio solicitado. O resultado dispara o webhook para o seu handler.
-
6
Reproduzir entregas de webhook
O agente busca a requisição assinada exata e a envia ao seu handler local até ela passar.
-
7
Ir para produção
O agente pode criar o workspace de produção. Você copia a chave secreta dele no console e a coloca em produção: a chave secreta de produção nunca é mostrada ao agente.
O prompt de integração
Um briefing pronto para colar no seu agente. Ele começa assim:
Integrate ProofAge into this project.
What I want: <e.g. an age check (18+) before checkout; or identity verification (KYC) for new sellers>.
Where the person starts it: <e.g. the "Verify age" button on /checkout>.
What a result should change: <e.g. set users.age_verified_at on approval; block the order on decline>.
Feito para ser seguro
O agente age em seu nome, na conta em que você trabalha, e vê só as ferramentas que o seu papel no console permite. Toda ação é registrada em seu nome, como no console.
-
As chaves secretas de produção ficam com as pessoas
Elas nunca são devolvidas pelo MCP. Uma pessoa as copia do console.
-
Alterações em produção esperam por você
Uma alteração em um workspace de produção ou nas chaves dele fica só como prévia. Nada é aplicado até você confirmar.
-
Ações destrutivas têm duas etapas
Bloquear ou desbloquear um rosto e apagar os dados de uma pessoa primeiro devolvem uma prévia e um token de curta duração. Depois, o agente confirma com uma frase exata e um motivo.
-
Papéis e limites de uso
Desenvolvedores não podem apagar dados pessoais. Criar verificações, workspaces e resultados de teste, e apagar dados, têm limite de uso por usuário.
Depois do lançamento
As equipes de suporte e operações continuam usando o mesmo servidor, pelo Claude.ai ou pelo próprio assistente, com o papel de especialista de suporte.
- “Por que este usuário foi recusado?” O agente lê a decisão, o motivo e o que a pessoa enviou.
- “Envie um link de verificação para este cliente.” O agente cria uma verificação e entrega o link para você enviar.
- “Apague os dados desta pessoa.” O agente prepara a exclusão, mostra o que será removido e o que fica, e confirma quando você concordar.
Perguntas sobre o servidor MCP
A ProofAge tem um servidor MCP?
Sim. O servidor MCP da ProofAge é um servidor MCP remoto via HTTP em https://app.proofage.net/mcp/admin. Você entra com a sua conta do console da ProofAge por OAuth. Um agente de programação com IA pode usá-lo para integrar a verificação de identidade (KYC) e de idade ao seu app, consultar verificações e atender pedidos de suporte. Veja também a API de KYC (Esta página só está disponível em inglês) e a visão geral para desenvolvedores.
Quais agentes de programação com IA funcionam com ele?
A documentação traz os passos de configuração para Claude Code, Claude.ai, Cursor, VS Code, Grok e Perplexity. O ChatGPT, o Codex, o GitHub Copilot no VS Code, o Gemini CLI, o Mistral Le Chat e vários outros clientes se conectam com a mesma URL. Se o seu cliente for recusado ao entrar, fale com a gente: adicionamos clientes sob pedido.
Preciso de uma chave de API para conectar?
Não. O seu cliente MCP abre uma janela do navegador, você entra com a sua conta do console da ProofAge e aprova o acesso. O servidor aceita descoberta OAuth e registro dinâmico de cliente.
O agente pode mexer em dados ou chaves de produção?
Só dentro do seu papel no console, e com proteções. As chaves secretas de produção nunca são devolvidas pelo MCP: uma pessoa as copia do console. Uma alteração em um workspace de produção ou nas chaves dele fica só como prévia até você confirmar. Bloquear ou desbloquear um rosto e apagar os dados de uma pessoa exigem uma segunda etapa de confirmação, com um token de curta duração, uma frase exata e um motivo. Toda ação é registrada em seu nome.
Quanto tempo leva uma integração com um agente de IA?
Com os SDKs, uma integração típica fica pronta e testada em um dia. Com um agente de programação com IA usando o servidor MCP e o prompt de integração, costuma levar algumas horas.
O servidor MCP é grátis?
Sim. O servidor MCP está incluído em todas as contas, sem custo extra. As verificações reais que ele cria são cobradas normalmente, e o modo de teste é sempre grátis. Veja os preços.
Uma linha direta com os desenvolvedores que o construíram
Escreva para nós no LinkedIn, por e-mail ou no chat do painel. Quem responde são os próprios desenvolvedores que construíram a ProofAge, inclusive nos fins de semana.
Conecte seu agente e comece a construir
O modo de teste é grátis. 500 verificações reais também são grátis, sem cartão e sem prazo para usar.