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.

Servidor MCP na documentação

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.

Os quatro grupos de ferramentas MCP, com um exemplo de prompt para cada um
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.”

Mais exemplos de prompts · Referência das ferramentas MCP

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. 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. 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. 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. 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. 5

    Definir o resultado do teste

    Aprovada, recusada ou com novo envio solicitado. O resultado dispara o webhook para o seu handler.

  6. 6

    Reproduzir entregas de webhook

    O agente busca a requisição assinada exata e a envia ao seu handler local até ela passar.

  7. 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>.

O prompt de integração completo

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.

Referência das ferramentas MCP

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.