deepidv MCP

Servidor MCP para verificação de identidade e antifraude nativos de IA

Documentação

Servidor MCP DeepIDV

Acesso MCP hospedado às ferramentas de verificação, fluxo de trabalho, financeiras, de candidatos e de triagem da DeepIDV.

Recursos

Gerencie sessões de verificação para sua organização DeepIDV.
Recupere artefatos de verificação, cronologias e links de recursos de apoio.
Pesquise candidatos, verifique o status de convites e reenvie convites.
Crie fluxos de trabalho reutilizáveis com etapas de verificação da DeepIDV.
Revise registros de extratos bancários, métricas e crie novas solicitações de extratos.
Execute verificações de PEP e sanções, verificações de título, triagem de mídia adversa e sondagem assíncrona de trabalhos.
Conecte-se por meio de OAuth 2.0 hospedado com PKCE em vez de executar um servidor local.

Início Rápido

Use o endpoint MCP hospedado:

URL do servidor: https://mcp.deepidv.com/v1/mcp
Manifesto do servidor: https://mcp.deepidv.com/mcp.json
Metadados de recursos protegidos: https://mcp.deepidv.com/.well-known/oauth-protected-resource

Exemplos de comandos após a instalação:

Liste minhas sessões de verificação mais recentes.
Encontre o candidato com o e-mail jane@example.com.
Mostre os artefatos da sessão de verificação <session_id>.
Execute uma verificação de PEP e sanções para Jane Doe nascida em 1980-05-12.

Se o seu cliente MCP suporta servidores HTTP remotos com descoberta OAuth, adicionar a URL do servidor geralmente é suficiente para que o cliente descubra automaticamente os metadados OAuth da DeepIDV.

Instalação

A DeepIDV é um servidor MCP hospedado. Você não precisa clonar, compilar ou executar um processo Node.js local para usá-lo.

No seu cliente MCP, adicione um servidor remoto.
Insira https://mcp.deepidv.com/v1/mcp como a URL do servidor.
Se o cliente solicitar client_id, use deepidv.
Não insira um client_secret.
Conclua o fluxo OAuth baseado no navegador com seu e-mail e senha deepidv e, em seguida, o MFA, se necessário.
Peça ao seu assistente para chamar uma ferramenta DeepIDV, como listar fluxos de trabalho, listar sessões de verificação ou executar uma verificação de triagem.

Para instruções voltadas a instaladores, consulte llms-install.md.

Autenticação

A DeepIDV usa OAuth 2.0 hospedado com PKCE para acesso MCP.

O fluxo hospedado atual usa um cliente público compartilhado:

client_id é deepidv
client_secret não é usado
a troca de tokens usa PKCE com S256
o usuário faz login com seu e-mail e senha deepidv
o MFA é aplicado quando exigido pela conta

O acesso é limitado ao usuário e à organização DeepIDV autenticados. As chamadas de ferramentas são validadas em relação ao estado ativo da conta antes de serem executadas.

Ferramentas Disponíveis

Candidatos

Ferramenta	O que faz
`search_applicants`	Encontre candidatos correspondentes em sessões e solicitações de extratos bancários.
`get_applicant`	Recupere um perfil e histórico consolidados do candidato.
`get_invitation_status`	Verifique a entrega do convite e o status de engajamento.
`resend_invitation`	Reenvie um convite para uma sessão de verificação ou solicitação de extrato bancário.

Verificação

Ferramenta	O que faz
`list_verification_sessions`	Liste sessões de verificação com filtros e paginação.
`get_session_stats`	Recupere métricas e tendências agregadas de verificação.
`get_verification_session`	Recupere os detalhes completos de uma sessão de verificação.
`get_verification_session_artifacts`	Recupere dados de análise e links de recursos para uma sessão de verificação.
`get_session_timeline`	Recupere uma cronologia cronológica para uma sessão de verificação.
`create_verification_session`	Crie e envie um novo convite de verificação.
`update_verification_session_status`	Marque manualmente uma sessão como `VERIFIED` ou `REJECTED`.
`expire_session`	Expire uma sessão de verificação ativa.

Fluxos de Trabalho

Ferramenta	O que faz
`list_workflows`	Liste os fluxos de trabalho disponíveis para a organização autenticada.
`get_workflow`	Recupere um fluxo de trabalho e suas etapas configuradas.
`create_workflow`	Crie um fluxo de trabalho reutilizável com uma ou mais etapas de verificação da DeepIDV.

IDs atuais de etapas de fluxo de trabalho expostos por meio do MCP:

ID_VERIFICATION
FACE_LIVENESS
AGE_ESTIMATION
PEP_SANCTIONS
ADVERSE_MEDIA

Financeiro

Ferramenta	O que faz
`list_bank_statements`	Liste registros de extratos bancários para a organização autenticada.
`get_bank_statement_stats`	Recupere métricas e tendências agregadas de extratos bancários.
`get_bank_statement`	Recupere um registro de extrato bancário e os detalhes do extrato quando disponíveis.
`list_bank_statements_by_external_id`	Recupere registros de extratos bancários que correspondam ao seu ID de referência externo.
`create_bank_statement_request`	Crie e envie um novo convite de solicitação de extrato bancário.

Triagem Silenciosa

Ferramenta	O que faz
`run_pep_sanctions_check`	Execute uma triagem síncrona de PEP e sanções.
`run_title_check`	Execute uma pesquisa síncrona de título de propriedade ou titularidade.
`run_adverse_media_check`	Coloque em fila uma triagem assíncrona de mídia adversa e retorne um `job_id`.
`get_async_job`	Sonde um trabalho assíncrono de triagem de mídia adversa até que esteja pronto ou falhe.

Requisitos

Você precisa de:

Uma conta DeepIDV.
Um usuário DeepIDV ativo.
Seu e-mail e senha deepidv.
Acesso MFA se sua conta exigir.
Um cliente MCP que suporte servidores MCP HTTP remotos com código de autorização OAuth 2.0 e PKCE.

Como Funciona

O endpoint público em https://mcp.deepidv.com/v1/mcp fica à frente do transporte MCP hospedado da DeepIDV. O servidor expõe operações da plataforma DeepIDV por HTTP transmissível e usa a mesma lógica central de verificação, fluxo de trabalho, financeira e de triagem que alimenta a plataforma principal.

Para os usuários, o detalhe importante é mais simples: conecte-se uma vez, autorize uma vez e então chame operações DeepIDV como ferramentas MCP a partir do seu cliente preferido.

Notas de Segurança

Todas as solicitações MCP usam autenticação por token de portador.
O acesso é limitado à organização e ao usuário DeepIDV autenticados.
As chamadas de ferramentas têm limite de taxa.
Algumas ferramentas alteram o estado e podem criar registros, reenviar convites ou consumir créditos.
Artefatos de verificação e links retornados devem ser tratados como dados confidenciais do cliente.

Documentação

Guia de instalação para agentes de marketplace: llms-install.md
Site da DeepIDV: https://www.deepidv.com
Suporte da DeepIDV: https://www.deepidv.com/support

Contribuição

Esta pasta documenta o servidor MCP hospedado da DeepIDV para o repositório público. Se você encontrar um problema na documentação, abra um pull request ou issue no repositório principal.

Licença

Esta documentação faz parte do repositório principal e é coberta pela licença do repositório.