Onboarding de Cripto Corretoras com Claude: Uma Sequência de Decisão do Operador

Principais pontos

• Claude pode coordenar as decisões de onboarding de uma corretora de cripto, mas o cliente completa a captura de Know Your Customer (KYC) na UI de verificação hospedada da Didit, não dentro do chat.
• didit_session_create requer um workflow_id existente. Ele retorna uma URL que a corretora fornece ao cliente.
• didit_transaction_screen_wallet retorna apenas os resultados da triagem. Ele não retém fundos, cria um caso ou notifica uma equipe de compliance.
• didit_transaction_create requer transaction_id, transaction_category, transaction_details e subject no nível superior. Os campos de transação variam por categoria.
• O valor do operador é a sequência de decisão: coletar as evidências corretas, interpretá-las sob a política da corretora, registrar cada decisão e acionar explicitamente qualquer ação de acompanhamento.

Uma corretora de cripto não tem uma única decisão de onboarding. Ela tem uma cadeia de decisões: esta pessoa pode iniciar a verificação de identidade, a verificação hospedada foi concluída, um resultado de triagem de nome requer revisão, o que significa um resultado de carteira sob a política, e uma transação enviada deve ser aceita para monitoramento?

O servidor Didit Model Context Protocol (MCP) permite que Claude coordene esses passos através de uma superfície de ferramenta autenticada. Ele não colapsa a experiência do cliente na conversa, e não transforma uma resposta de risco em um sistema automático de controle de fundos. O padrão útil é um copiloto do operador com transferências explícitas e ações explícitas.

Este artigo foca nessa sequência operacional. Os mecanismos já possuem guias dedicados para KYC sobre MCP, triagem de carteira sobre MCP e monitoramento de transações sobre MCP.

Decisão 0: estabelecer o escopo antes de interagir com um cliente

Um operador começa com didit_context_get. A ferramenta lista as organizações e aplicativos disponíveis para o usuário autenticado, para que Claude possa confirmar o contexto operacional pretendido em vez de misturar clientes ou ambientes.

A corretora também precisa de um fluxo de trabalho de verificação existente. O design do fluxo de trabalho ocorre antes da entrega ao cliente e determina quais verificações são executadas. Para um fluxo comum de onboarding de cripto, isso pode incluir Verificação de ID, Prova de Vida Passiva, Face Match e Análise de IP. O preço publicado do pacote KYC completo para essas verificações é de US$ 0,33.

A chamada MCP não recebe uma “configuração de fluxo de trabalho”. didit_session_create recebe um workflow_id que já existe. Essa distinção torna a primeira pergunta do operador concreta: qual fluxo de trabalho aprovado se aplica a este cliente e mercado?

Decisão 1: enviar o cliente para o fluxo KYC hospedado

Claude cria a sessão com o fluxo de trabalho selecionado e uma referência de cliente estável. A resposta contém session_id, url e session_token.

Crie uma sessão de verificação com didit_session_create:
{
  "workflow_id": "<uuid-do-fluxo-de-trabalho-de-onboarding-cripto-existente>",
  "vendor_data": "cliente_18427",
  "callback": "https://exchange.example/onboarding/complete",
  "language": "en"
}

Retorne a url ao cliente e mantenha o session_id para a consulta da decisão.

O cliente abre essa URL e completa a captura necessária na UI hospedada da Didit. Imagens de documentos de identidade e a selfie são enviadas lá. Elas não permanecem dentro do chat de Claude.

Após o cliente finalizar, Claude chama didit_session_get_decision com session_id. A ferramenta retorna a decisão de verificação completa e os dados extraídos para o fluxo de trabalho configurado. O operador pode então aplicar a política de revisão da corretora à resposta real. Este é um loop de entrega e recuperação, não uma afirmação de que Aprovado resolve todas as questões de compliance a jusante.

Decisão 2: separar a evidência de identidade do risco de nome

A verificação de identidade e a triagem Anti-Lavagem de Dinheiro (AML) respondem a perguntas diferentes. Após ler os dados de identidade verificados, Claude pode chamar didit_verify_aml com o nome completo da pessoa. Entradas opcionais, como data de nascimento e nacionalidade, podem melhorar a precisão da correspondência. A Triagem AML custa US$ 0,20 por verificação em mais de 1.300 listas.

A decisão do operador não é simplesmente “acerto ou não acerto”. Um resultado pode precisar de comparação com os dados verificados do cliente, documentação do raciocínio ou revisão manual sob a política da corretora. Se o operador decidir que um caso é necessário, didit_case_create é uma chamada de ferramenta explícita separada. Nada sobre a sessão KYC cria silenciosamente esse caso.

Essa separação mantém a trilha de auditoria legível:

• Evidência KYC: o que o fluxo de trabalho de verificação hospedado retornou.
• Evidência AML: o que a resposta de triagem de nome retornou.
• Decisão do operador: como a política da corretora mapeou essas respostas para aprovar, revisar ou recusar.

Decisão 3: triar a carteira e depois decidir o que fazer

didit_transaction_screen_wallet aceita wallet_address, blockchain e uma direction opcional. O enum blockchain é um identificador misto de ativo ou cadeia: inclui identificadores de cadeia como BTC, ETH, SOL e TRX, e identificadores de ativo como USDT e USDC. USDT e USDC são ativos, não blockchains.

O seguinte é um prompt executável do Claude com o formato exato do payload MCP. Substitua o endereço de exemplo pela carteira do cliente:

Chame didit_transaction_screen_wallet com exatamente este payload:
{
  "wallet_address": "0x0000000000000000000000000000000000000000",
  "blockchain": "ETH",
  "direction": "deposit"
}

Retorne os campos de resposta risk_score, severity, sanctions_hit e a origem e destino de fundos relatados. Não retenha fundos, crie um caso ou notifique ninguém.
Peça uma instrução de acompanhamento explícita após resumir o resultado da triagem.

O formato da resposta é um resultado de triagem: risk_score, severity, sanctions_hit e informações de origem/destino de fundos. A ferramenta pode retornar uma resposta 409 quando a configuração de triagem do monitoramento de transações não estiver disponível.

A Triagem de Carteira, também chamada de know your transaction (KYT) no catálogo de produtos, custa US$ 0,15 por verificação. O resultado em si não move dinheiro. Uma retenção, liberação, caso, escalada ou notificação pertence à própria política da corretora e requer um sistema ou ação de ferramenta separada. Por exemplo, Claude pode chamar didit_case_create somente depois que o operador ou uma camada de política autorizada escolher explicitamente essa ação.

Decisão 4: enviar uma transação com o esquema real

didit_transaction_create envia uma transação para monitoramento e avaliação de regras. Seus campos de nível superior obrigatórios são:

• transaction_id: o identificador de transação exclusivo da corretora.
• transaction_category: um dos valores de categoria documentados, incluindo finance, kyc, travel_rule e user_event.
• transaction_details: o payload da transação específico da categoria.
• subject: a parte que inicia a transação.

Objetos de nível superior opcionais incluem counterparty, travel_rule_details, network_snapshot e custom_properties. A ferramenta não define hash de transação, endereço de origem, endereço de destino, ativo ou valor como campos de nível superior universais. Se esses valores fizerem parte dos dados de uma categoria, eles pertencem ao objeto específico da categoria relevante.

O contrato de nível superior para didit_transaction_create é:
{
  "transaction_id": "<id-de-transação-exclusivo-da-corretora>",
  "transaction_category": "finance",
  "transaction_details": { "<campos-da-categoria-financeira>": "<valores>" },
  "subject": { "<campos-da-parte-iniciadora>": "<valores>" },
  "counterparty": { "<campos-da-outra-parte>": "<valores>" },
  "transaction_at": "<timestamp-ISO>"
}

Os placeholders são intencionais. O esquema MCP afirma que transaction_details e subject dependem de transaction_category; ele não publica um payload aninhado universal. Um operador deve usar os campos definidos para a categoria configurada em vez de copiar um esquema de cripto inventado.

Para travel_rule, o mesmo contrato de nível superior se aplica, com dados de transferência específicos da categoria em transaction_details, a parte iniciadora em subject, a outra parte em counterparty e dados da Regra de Viagem em travel_rule_details. Não há campo metadata nesta ferramenta. A seleção de travel_rule identifica o payload específico da categoria; não realiza automaticamente a verificação do beneficiário ou libera a transferência.

A transação é avaliada quando é enviada. É impreciso descrever um único registro enviado como sendo continuamente reavaliado para sempre. Claude pode recuperar a transação monitorada e seu resultado de avaliação de regras com didit_transaction_get.

Decisão 5: manter a autoria da política no Business Console

O construtor de regras de Monitoramento de Transações do Business Console é onde as equipes configuram as regras de monitoramento e a lógica da política. Não é o editor de fluxo de trabalho de verificação. A superfície MCP envia transações, recupera resultados, pesquisa registros e suporta operações explícitas de caso; não substitui a autoria de regras.

As ações de caso também são limitadas. didit_case_manage suporta assign, comment, escalate, reopen, resolve e update. Os fluxos de trabalho de Relatório de Atividade Suspeita (SAR) permanecem operações do Business Console. Esse limite permite que uma corretora use Claude para coleta de evidências e assistência ao operador sem descrever o agente como uma autoridade de compliance autônoma.

Conecte o copiloto do operador

O endpoint MCP hospedado da Didit expõe 115 ferramentas via HTTP Streamable e usa OAuth 2.1 com Proof Key for Code Exchange (PKCE). O servidor MCP é gratuito; as verificações subjacentes seguem seus preços publicados. O nível gratuito inclui 500 verificações gratuitas por mês.

Conecte o Claude hospedado com o link direto do conector Didit. Revise a visão geral do MCP, o guia de autenticação e a referência de ferramentas. A implementação está disponível no repositório GitHub com licença MIT, e a visão geral do produto está em didit.me/developers/mcp.

O padrão operacional duradouro é evidência primeiro, política segundo, ação terceiro. Claude coleta a decisão KYC, o resultado AML, o resultado da carteira e a avaliação da transação. A corretora permanece explícita sobre qual resposta causou qual decisão e qual ação separada se seguiu.