# MCP · Usa blockwallets desde tus herramientas de IA

> El servidor MCP remoto de blockwallets: consulta la documentación de integración, crea facturas de prueba y revisa pedidos y saldos desde Claude, ChatGPT, Cursor y Codex. Ninguna herramienta puede sacar dinero.

Deja que Claude, ChatGPT, Cursor y Codex lean la documentación, creen facturas de prueba y revisen pedidos por ti. Solo cobra y lee datos. No puede sacar dinero.

## Dos URL

- `https://blockwallets.io/mcp` (Requiere iniciar sesión): Inicio de sesión OAuth, o un token MCP (Bearer) del panel. Todas las herramientas.
- `https://blockwallets.io/mcp/public` (Sin iniciar sesión): Solo herramientas públicas: documentación, redes, precios, explicación de la firma, lista de integración.

## En resumen: integra, depura y revisa tus cuentas desde tu IA.

- Mientras escribes la integración, tu IA lee directamente nuestra documentación y las reglas de firma, sin copiar y pegar.
- Con un token de prueba, la IA crea una factura de prueba, tú simulas el pago y ella comprueba el estado de principio a fin.
- En el día a día, pregunta “¿cuánto cobramos ayer?” o “¿está pagado order_1042?” y obtén la respuesta.

## Copia un fragmento en tu herramienta.

Crea tokens en el panel, en “Desarrolladores › Herramientas de IA (MCP)”; el token se muestra una sola vez. Empieza con un token de prueba.

### Claude Code

Con token; o quita --header y ejecuta /mcp dentro de Claude Code para iniciar sesión con OAuth.

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

### Claude Code · solo herramientas de documentación (sin iniciar sesión)

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

Pon el token en la variable de entorno BLOCKWALLETS_MCP_TOKEN; requiere una versión reciente de Codex con soporte de MCP por HTTP.

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

## Claude y ChatGPT: solo inicia sesión.

### Claude (web / escritorio)

1. Ajustes → Conectores → Añadir conector personalizado
2. Llámalo blockwallets y usa la URL https://blockwallets.io/mcp
3. Pulsa Conectar e inicia sesión en tu panel de blockwallets en la página que se abre
4. En la página de consentimiento elige modo de prueba o real y si permites crear facturas, y pulsa Permitir

### ChatGPT

1. Ajustes → Apps y conectores → Avanzado, activa el modo desarrollador
2. Crea un conector con la URL https://blockwallets.io/mcp y autenticación OAuth
3. Inicia sesión en tu panel de blockwallets
4. Elige el modo y los permisos en la página de consentimiento y pulsa Permitir

¿No quieres iniciar sesión? Usa https://blockwallets.io/mcp/public para usar solo las herramientas públicas de documentación.

## 11 herramientas, ninguna puede sacar dinero.

| Herramienta | Qué hace | Permiso |
|---|---|---|
| `search_docs` | Busca en la documentación de integración; devuelve secciones y enlaces relevantes | público |
| `get_doc` | Lee una sección de la documentación en Markdown | público |
| `list_networks` | Monedas y redes, confirmaciones, importes mínimos | público |
| `get_pricing` | Comisiones y tramos por volumen | público |
| `explain_signature` | Explica paso a paso cómo se calcula la firma (nunca pide la API key) | público |
| `integration_checklist` | Pasos de integración y lista de aceptación para tu stack | público |
| `create_payment` | Crea una factura y devuelve su página de pago (idempotente por order_id) | payments:create |
| `create_payment_link` | Crea un enlace de pago y un código QR | payments:create |
| `get_payment` | Lee una factura por order_id o uuid | read |
| `list_payments` | Lista facturas por estado y fecha | read |
| `get_balance` | Lee el saldo real (solo lectura, sin retiros) | read |

## Solo cobra. Nunca envía.

- **Ninguna herramienta saca dinero**: Retiros, pagos, reembolsos, direcciones de retiro, URL de callback y claves no están en MCP ni tienen permiso. Solo tú puedes hacerlo en el panel.
- **Empieza en modo de prueba**: Las credenciales de prueba solo crean facturas en testnets y solo ven datos de prueba. Nada de dinero real.
- **Deja el modo real en solo lectura**: Las credenciales reales ven pedidos y saldos reales. Da solo lectura salvo que necesites crear facturas. Las cuentas con verificación en dos pasos piden un código para credenciales reales, y te avisamos por correo cada vez.
- **Revoca cuando quieras**: Los tokens y las autorizaciones OAuth están en una misma lista del panel. Revoca uno y sus tokens dejan de funcionar al instante.
- **Solo hashes**: Los tokens y los códigos se guardan como sha256; el token se muestra una vez. Cada llamada del comercio queda auditada y cada credencial tiene un límite de 60 peticiones por minuto.

## Preguntas

### ¿Qué es MCP?

El Model Context Protocol, un estándar abierto para que las herramientas de IA llamen a servicios externos. Una vez conectados, Claude, ChatGPT, Cursor y otros pueden llamar directamente a las herramientas de blockwallets.

### ¿Puede una IA usarlo para llevarse mi dinero?

No. No hay ninguna herramienta para retiros, pagos, reembolsos ni para cambiar direcciones o claves, y no existe permiso para ello.

### ¿En qué se diferencian prueba y real?

El modo de prueba funciona en testnets públicas con facturas y datos de prueba; el modo real es tu cuenta de verdad. Haz que el flujo funcione primero en modo de prueba.

### ¿Cursor admite inicio de sesión OAuth?

Por ahora, usa en Cursor un token del panel. OAuth funciona con clientes que usan redirección https o loopback, como Claude, ChatGPT y Claude Code.

### ¿Cómo revoco el acceso?

Busca el token o la autorización en el panel, en “Desarrolladores › Herramientas de IA (MCP)”, y revócalo; surte efecto al instante.

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