MCP

Deixe o Claude, ChatGPT, Cursor e Codex lerem a documentação, criarem cobranças de teste e conferirem pedidos por você. Ele só recebe pagamentos e lê dados. Não consegue tirar dinheiro.

Obter um token
Requer loginhttps://blockwallets.io/mcp

Login via OAuth, ou um token MCP (Bearer) do painel. Todas as ferramentas.

Sem loginhttps://blockwallets.io/mcp/public

Só ferramentas públicas: documentação, redes, preços, explicação da assinatura, checklist de integração.

O que faz

Em resumo: integre, depure e confira suas contas pela IA.

Enquanto você escreve a integração, sua IA lê nossa documentação e as regras de assinatura direto, sem copiar e colar.

Com um token de teste, a IA cria uma cobrança de teste, você simula o pagamento e ela confere o status de ponta a ponta.

No dia a dia, pergunte “quanto recebemos ontem?” ou “o order_1042 foi pago?” e tenha a resposta.

Instalar

Copie um trecho para a sua ferramenta.

Crie tokens no painel, em “Desenvolvedores › Ferramentas de IA (MCP)”; o token aparece uma única vez. Comece com um token de teste.

Claude Code
claude mcp add --transport http blockwallets https://blockwallets.io/mcp \
  --header "Authorization: Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Com token; ou remova --header e rode /mcp dentro do Claude Code para entrar com OAuth.

Claude Code · só ferramentas de documentação (sem login)
claude mcp add --transport http blockwallets-docs https://blockwallets.io/mcp/public
Cursor · ~/.cursor/mcp.json
{
  "mcpServers": {
    "blockwallets": {
      "url": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
Windsurf · ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "blockwallets": {
      "serverUrl": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
Codex · ~/.codex/config.toml
[mcp_servers.blockwallets]
url = "https://blockwallets.io/mcp"
bearer_token_env_var = "BLOCKWALLETS_MCP_TOKEN"

Coloque o token na variável de ambiente BLOCKWALLETS_MCP_TOKEN; requer uma versão recente do Codex com suporte a MCP via HTTP.

Conectores

Claude e ChatGPT: é só entrar.

Claude (web / desktop)

  1. Configurações → Conectores → Adicionar conector personalizado
  2. Dê o nome blockwallets e use a URL https://blockwallets.io/mcp
  3. Clique em Conectar e entre no seu painel da blockwallets na página que abrir
  4. Na página de consentimento escolha modo de teste ou produção e se permite criar cobranças, depois clique em Permitir

ChatGPT

  1. Configurações → Apps e conectores → Avançado, ative o Modo desenvolvedor
  2. Crie um conector com a URL https://blockwallets.io/mcp e autenticação OAuth
  3. Entre no seu painel da blockwallets
  4. Escolha o modo e as permissões na página de consentimento e clique em Permitir

Não quer entrar? Use https://blockwallets.io/mcp/public para usar só as ferramentas públicas de documentação.

Ferramentas

11 ferramentas, nenhuma tira dinheiro.

FerramentaO que fazPermissão
search_docsBusca na documentação de integração; retorna trechos e links relevantespública
get_docLê uma seção da documentação em Markdownpública
list_networksMoedas e redes, confirmações, valores mínimospública
get_pricingTaxas e faixas de volumepública
explain_signatureExplica o cálculo da assinatura passo a passo (nunca recebe API key)pública
integration_checklistPassos de integração e checklist de aceitação para a sua stackpública
create_paymentCria uma cobrança e retorna a página de pagamento (idempotente por order_id)payments:create
create_payment_linkCria um link de pagamento e QR codepayments:create
get_paymentLê uma cobrança por order_id ou uuidread
list_paymentsLista cobranças por status e dataread
get_balanceLê o saldo de produção (só leitura, sem saques)read

Segurança

Só recebe. Nunca envia.

Nenhuma ferramenta tira dinheiro

Saques, pagamentos, reembolsos, endereços de saque, URLs de callback e chaves não estão no MCP e não têm permissão. Só você faz isso no painel.

Comece no modo de teste

Credenciais de teste só criam cobranças em testnets e só veem dados de teste. Nada de dinheiro real.

Mantenha produção só leitura

Credenciais de produção veem pedidos e saldos reais. Dê só leitura, a menos que precise criar cobranças. Contas com autenticação em duas etapas pedem um código para credenciais de produção, e avisamos você por e-mail a cada vez.

Revogue quando quiser

Tokens e autorizações OAuth ficam numa só lista no painel. Revogue e os tokens param de funcionar na hora.

Só hashes

Tokens e códigos são guardados como sha256; o token aparece uma vez. Toda chamada do lojista é auditada, e cada credencial tem limite de 60 requisições por minuto.

Perguntas

O que é MCP?

O Model Context Protocol, um padrão aberto para ferramentas de IA chamarem serviços externos. Depois de conectados, Claude, ChatGPT, Cursor e outros chamam as ferramentas da blockwallets diretamente.

Uma IA pode usar isso para levar meu dinheiro?

Não. Não há ferramenta de saque, pagamento, reembolso ou troca de endereços ou chaves, e não existe permissão para isso.

Qual a diferença entre teste e produção?

O modo de teste roda em testnets públicas com cobranças e dados de teste; produção é sua conta real. Faça o fluxo funcionar no modo de teste primeiro.

O Cursor aceita login OAuth?

Por enquanto, use um token do painel no Cursor. O OAuth funciona com clientes que usam redirecionamento https ou loopback, como Claude, ChatGPT e Claude Code.

Como revogo o acesso?

Encontre o token ou a autorização no painel, em “Desenvolvedores › Ferramentas de IA (MCP)”, e revogue; vale na hora.