# MCP · Use a blockwallets nas suas ferramentas de IA

> O servidor MCP remoto da blockwallets: consulte a documentação de integração, crie cobranças de teste, confira pedidos e saldos no Claude, ChatGPT, Cursor e Codex. Nenhuma ferramenta consegue tirar dinheiro.

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.

## Dois endereços

- `https://blockwallets.io/mcp` (Requer login): Login via OAuth, ou um token MCP (Bearer) do painel. Todas as ferramentas.
- `https://blockwallets.io/mcp/public` (Sem login): Só ferramentas públicas: documentação, redes, preços, explicação da assinatura, checklist de integração.

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

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

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

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

### Claude Code · só ferramentas de documentação (sem login)

```bash
claude mcp add --transport http blockwallets-docs https://blockwallets.io/mcp/public
```

### Cursor · ~/.cursor/mcp.json

```json
{
  "mcpServers": {
    "blockwallets": {
      "url": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

### Windsurf · ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "blockwallets": {
      "serverUrl": "https://blockwallets.io/mcp",
      "headers": {
        "Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

### Codex · ~/.codex/config.toml

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

```toml
[mcp_servers.blockwallets]
url = "https://blockwallets.io/mcp"
bearer_token_env_var = "BLOCKWALLETS_MCP_TOKEN"
```

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

## 11 ferramentas, nenhuma tira dinheiro.

| Ferramenta | O que faz | Permissão |
|---|---|---|
| `search_docs` | Busca na documentação de integração; retorna trechos e links relevantes | pública |
| `get_doc` | Lê uma seção da documentação em Markdown | pública |
| `list_networks` | Moedas e redes, confirmações, valores mínimos | pública |
| `get_pricing` | Taxas e faixas de volume | pública |
| `explain_signature` | Explica o cálculo da assinatura passo a passo (nunca recebe API key) | pública |
| `integration_checklist` | Passos de integração e checklist de aceitação para a sua stack | pública |
| `create_payment` | Cria uma cobrança e retorna a página de pagamento (idempotente por order_id) | payments:create |
| `create_payment_link` | Cria um link de pagamento e QR code | payments:create |
| `get_payment` | Lê uma cobrança por order_id ou uuid | read |
| `list_payments` | Lista cobranças por status e data | read |
| `get_balance` | Lê o saldo de produção (só leitura, sem saques) | read |

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

OAuth metadata: https://blockwallets.io/.well-known/oauth-protected-resource · https://blockwallets.io/.well-known/oauth-authorization-server