Integração de Novas Contas em Bolsas de Cripto: Uma Sequência de Decisões Operacionais com Claude

Principais pontos

• Claude pode coordenar as decisões de integração de uma bolsa de cripto, mas o cliente completa a recolha de Conheça o Seu Cliente (KYC) na interface de verificação alojada da Didit, não dentro do chat.
• didit_session_create requer um workflow_id existente. Retorna um URL que a bolsa fornece ao cliente.
• didit_transaction_screen_wallet retorna apenas resultados de rastreio. Não retém fundos, não cria um caso, nem notifica uma equipa de conformidade.
• 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: recolher as provas certas, interpretá-las de acordo com a política da bolsa, registar cada decisão e desencadear explicitamente qualquer ação de acompanhamento.

Uma bolsa de cripto não tem uma única decisão de integração. Tem uma cadeia de decisões: pode esta pessoa iniciar a verificação de identidade, a verificação alojada foi concluída, um resultado de rastreio de nome requer revisão, o que significa um resultado de carteira de acordo com a política, e uma transação submetida deve ser aceite para monitorização?

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

Este artigo foca-se nessa sequência operacional. Os mecanismos já têm guias dedicados para KYC via MCP, rastreio de carteiras via MCP e monitorização de transações via MCP.

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

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

A bolsa também precisa de um fluxo de trabalho de verificação existente. O design do fluxo de trabalho acontece antes da transferência para o cliente e determina quais as verificações a serem executadas. Para um fluxo de integração cripto comum, isso pode incluir Verificação de Identidade, Liveness Passiva, Face Match e Análise de IP. O preço publicado do pacote completo de KYC para essas verificações é de 0,33 USD.

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 alojado

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.

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

Devolver o url ao cliente e reter o session_id para a pesquisa de decisão.

O cliente abre esse URL e completa a recolha necessária na interface de utilizador alojada da Didit. As imagens do documento de identidade e a selfie são submetidas lá. Não permanecem dentro do chat de Claude.

Depois de o cliente terminar, 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 bolsa à resposta real. Este é um ciclo de entrega e recuperação, não uma afirmação de que Approved resolve todas as questões de conformidade a jusante.

Decisão 2: separar a prova de identidade do risco de nome

A verificação de identidade e o rastreio Anti-Branqueamento de Capitais (AML) respondem a perguntas diferentes. Depois de 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. O Rastreio AML custa 0,20 USD 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 exigir comparação com os dados do cliente verificados, documentação do raciocínio ou revisão manual sob a política da bolsa. Se o operador decidir que é necessário um caso, didit_case_create é uma chamada de ferramenta explícita separada. Nada na sessão KYC cria silenciosamente esse caso.

Esta separação mantém o rasto de auditoria legível:

• Provas KYC: o que o fluxo de trabalho de verificação alojado retornou.
• Provas AML: o que a resposta de rastreio de nome retornou.
• Decisão do operador: como a política da bolsa mapeou essas respostas para aprovar, rever ou recusar.

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

didit_transaction_screen_wallet aceita wallet_address, blockchain e uma direction opcional. O enumerador 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 de Claude executável com a forma exata da carga útil MCP. Substitua o endereço de exemplo pela carteira do cliente:

Chamar didit_transaction_screen_wallet com exatamente esta carga útil:
{
  "wallet_address": "0x0000000000000000000000000000000000000000",
  "blockchain": "ETH",
  "direction": "deposit"
}

Devolver os campos de resposta risk_score, severity, sanctions_hit, e a origem e destino dos fundos reportados. Não reter fundos, criar um caso, ou notificar ninguém.
Pedir uma instrução de acompanhamento explícita após resumir o resultado do rastreio.

A forma da resposta é um resultado de rastreio: risk_score, severity, sanctions_hit e informações sobre a origem/destino dos fundos. A ferramenta pode retornar uma resposta 409 quando a configuração de rastreio da monitorização de transações não está disponível.

O Rastreio de Carteira, também chamado de “conheça a sua transação” (KYT) no catálogo de produtos, custa 0,15 USD por verificação. O resultado em si não move dinheiro. Uma retenção, liberação, caso, escalonamento ou notificação pertence à política da própria bolsa e requer um sistema separado ou ação da ferramenta. Por exemplo, Claude pode chamar didit_case_create apenas depois que o operador ou uma camada de política autorizada escolher explicitamente essa ação.

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

didit_transaction_create submete uma transação para monitorização e avaliação de regras. Os seus campos de nível superior obrigatórios são:

• transaction_id: o identificador único da transação da bolsa.
• transaction_category: um dos valores de categoria documentados, incluindo finance, kyc, travel_rule e user_event.
• transaction_details: a carga útil da transação específica 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 montante como campos universais de nível superior. Se esses valores fazem parte dos dados de uma categoria, eles pertencem ao objeto relevante específico da categoria.

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

Os marcadores são deliberados. O esquema MCP afirma que transaction_details e subject dependem de transaction_category; não publica uma carga útil aninhada universal. Um operador deve usar os campos definidos para a categoria configurada em vez de copiar um esquema 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 a carga útil específica da categoria; não realiza automaticamente a verificação do beneficiário nem efetua a transferência.

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

Decisão 5: manter a autoria de políticas na Consola de Negócios

O construtor de regras de Monitorização de Transações da Consola de Negócios é onde as equipas configuram as regras de monitorização e a lógica de política. Não é o editor de fluxo de trabalho de verificação. A superfície MCP submete transações, recupera resultados, pesquisa registos e suporta operações de caso explícitas; não substitui a autoria de regras.

As ações de caso também são delimitadas. 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 da Consola de Negócios. Esse limite permite que uma bolsa use Claude para recolha de provas e assistência ao operador sem descrever o agente como uma autoridade de conformidade autónoma.

Conectar o copiloto do operador

O endpoint MCP alojado 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 os seus preços publicados. O nível gratuito oferece 500 verificações gratuitas por mês.

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

O padrão operacional duradouro é: primeiro a prova, depois a política, terceiro a ação. Claude reúne a decisão KYC, o resultado AML, o resultado da carteira e a avaliação da transação. A bolsa permanece explícita sobre qual resposta causou qual decisão e qual ação separada se seguiu.