# MCP · blockwallets direkt aus Ihren KI-Tools nutzen

> Der Remote-MCP-Server von blockwallets: Integrationsdoku durchsuchen, Testrechnungen erstellen, Bestellungen und Guthaben prüfen – in Claude, ChatGPT, Cursor und Codex. Kein Tool kann Geld abziehen.

Lassen Sie Claude, ChatGPT, Cursor und Codex die Doku lesen, Testrechnungen erstellen und Bestellungen für Sie prüfen. Es kann nur Zahlungen annehmen und Daten lesen. Es kann kein Geld abziehen.

## Zwei URLs

- `https://blockwallets.io/mcp` (Anmeldung nötig): OAuth-Anmeldung oder ein MCP-Token (Bearer) aus dem Dashboard. Alle Tools.
- `https://blockwallets.io/mcp/public` (Ohne Anmeldung): Nur öffentliche Tools: Doku, Netzwerke, Preise, Signatur-Erklärung, Integrations-Checkliste.

## Kurz gesagt: integrieren, debuggen und Ihre Zahlen prüfen – direkt in der KI.

- Während Sie die Integration schreiben, liest Ihre KI unsere Doku und die Signaturregeln direkt, ohne Copy-and-paste.
- Mit einem Test-Token erstellt die KI eine Testrechnung, Sie simulieren die Zahlung, und sie prüft den Status von Anfang bis Ende.
- Im Alltag fragen Sie „Wie viel haben wir gestern eingenommen?“ oder „Ist order_1042 bezahlt?“ und bekommen die Antwort.

## Einen Schnipsel kopieren und in Ihr Tool einfügen.

Tokens erstellen Sie im Dashboard unter „Entwickler › KI-Werkzeuge (MCP)“; ein Token wird nur einmal angezeigt. Beginnen Sie mit einem Test-Token.

### Claude Code

Mit Token; oder --header weglassen und in Claude Code /mcp ausführen, um sich per OAuth anzumelden.

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

### Claude Code · nur Doku-Tools (ohne Anmeldung)

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

Token in die Umgebungsvariable BLOCKWALLETS_MCP_TOKEN legen; benötigt eine aktuelle Codex-Version mit HTTP-MCP-Unterstützung.

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

## Claude und ChatGPT: einfach anmelden.

### Claude (Web / Desktop)

1. Einstellungen → Connectoren → Eigenen Connector hinzufügen
2. Name blockwallets, URL https://blockwallets.io/mcp
3. Auf Verbinden klicken und auf der sich öffnenden Seite im blockwallets-Dashboard anmelden
4. Auf der Zustimmungsseite Test- oder Live-Modus wählen und ob Rechnungen erstellt werden dürfen, dann Erlauben

### ChatGPT

1. Einstellungen → Apps & Connectoren → Erweitert, Entwicklermodus einschalten
2. Connector mit der URL https://blockwallets.io/mcp und OAuth-Authentifizierung anlegen
3. Im blockwallets-Dashboard anmelden
4. Auf der Zustimmungsseite Modus und Berechtigungen wählen und Erlauben

Keine Anmeldung gewünscht? Mit https://blockwallets.io/mcp/public nutzen Sie nur die öffentlichen Doku-Tools.

## 11 Tools, keines kann Geld abziehen.

| Tool | Funktion | Berechtigung |
|---|---|---|
| `search_docs` | Durchsucht die Integrationsdoku; liefert passende Abschnitte und Links | öffentlich |
| `get_doc` | Liest einen Doku-Abschnitt als Markdown | öffentlich |
| `list_networks` | Coins und Netzwerke, Bestätigungen, Mindestbeträge | öffentlich |
| `get_pricing` | Gebühren und Volumenstaffel | öffentlich |
| `explain_signature` | Erklärt die Signaturberechnung Schritt für Schritt (nimmt nie einen API key entgegen) | öffentlich |
| `integration_checklist` | Integrationsschritte und Abnahme-Checkliste für Ihren Stack | öffentlich |
| `create_payment` | Erstellt eine Rechnung und liefert die Zahlungsseite (idempotent per order_id) | payments:create |
| `create_payment_link` | Erstellt einen Zahlungslink mit QR-Code | payments:create |
| `get_payment` | Liest eine Rechnung per order_id oder uuid | read |
| `list_payments` | Listet Rechnungen nach Status und Datum | read |
| `get_balance` | Liest das Live-Guthaben (nur lesen, keine Auszahlung) | read |

## Es nimmt ein. Es sendet nie.

- **Kein Tool zieht Geld ab**: Auszahlungen, Payouts, Erstattungen, Auszahlungsadressen, Callback-URLs und Schlüssel gibt es in MCP nicht, auch keine Berechtigung dafür. Das können nur Sie im Dashboard.
- **Im Testmodus starten**: Test-Zugangsdaten erstellen Rechnungen nur im Testnet und sehen nur Testdaten. Kein echtes Geld.
- **Live nur lesend**: Live-Zugangsdaten sehen echte Bestellungen und Guthaben. Geben Sie nur Leserechte, außer Sie müssen Rechnungen erstellen. Konten mit Zwei-Faktor-Anmeldung brauchen für Live-Zugangsdaten einen Code, und wir informieren Sie jedes Mal per E-Mail.
- **Jederzeit widerrufbar**: Tokens und OAuth-Freigaben stehen in einer Liste im Dashboard. Widerrufen Sie einen Eintrag, funktionieren seine Tokens sofort nicht mehr.
- **Nur Hashes**: Tokens und Codes werden als sha256 gespeichert; ein Token wird nur einmal angezeigt. Jeder Händler-Aufruf wird protokolliert, und jede Zugangsberechtigung ist auf 60 Anfragen pro Minute begrenzt.

## FAQ

### Was ist MCP?

Das Model Context Protocol, ein offener Standard, über den KI-Tools externe Dienste aufrufen. Nach dem Verbinden können Claude, ChatGPT, Cursor und andere die blockwallets-Tools direkt aufrufen.

### Kann eine KI damit mein Geld abziehen?

Nein. Es gibt kein Tool für Auszahlungen, Payouts, Erstattungen oder das Ändern von Adressen oder Schlüsseln, und es existiert auch keine Berechtigung dafür.

### Was ist der Unterschied zwischen Test und Live?

Der Testmodus läuft in öffentlichen Testnets mit Testrechnungen und Testdaten; Live ist Ihr echtes Konto. Bringen Sie den Ablauf zuerst im Testmodus zum Laufen.

### Unterstützt Cursor die OAuth-Anmeldung?

Nutzen Sie in Cursor vorerst ein Token aus dem Dashboard. OAuth funktioniert mit Clients, die https- oder Loopback-Weiterleitungen verwenden, etwa Claude, ChatGPT und Claude Code.

### Wie widerrufe ich den Zugriff?

Token oder Freigabe im Dashboard unter „Entwickler › KI-Werkzeuge (MCP)“ suchen und widerrufen; das gilt sofort.

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