# MCP · Pakai blockwallets langsung dari alat AI Anda

> Server MCP jarak jauh blockwallets: cari dokumentasi integrasi, buat tagihan uji, cek pesanan dan saldo dari Claude, ChatGPT, Cursor, dan Codex. Tidak ada alat yang bisa mengeluarkan dana.

Biarkan Claude, ChatGPT, Cursor, dan Codex membaca dokumentasi, membuat tagihan uji, dan mengecek pesanan untuk Anda. Ia hanya bisa menerima pembayaran dan membaca data. Ia tidak bisa mengeluarkan dana.

## Dua URL

- `https://blockwallets.io/mcp` (Perlu masuk): Masuk lewat OAuth, atau token MCP (Bearer) dari dasbor. Semua alat.
- `https://blockwallets.io/mcp/public` (Tanpa masuk): Hanya alat publik: dokumentasi, jaringan, harga, penjelasan tanda tangan, daftar periksa integrasi.

## Singkatnya: integrasi, debug, dan cek pembukuan langsung dari AI.

- Saat Anda menulis integrasi, AI membaca dokumentasi dan aturan tanda tangan kami secara langsung, tanpa salin-tempel.
- Dengan token uji, AI membuat tagihan uji, Anda menyimulasikan pembayaran, lalu ia mengecek statusnya dari awal sampai akhir.
- Sehari-hari, tanyakan “berapa yang masuk kemarin?” atau “apakah order_1042 sudah dibayar?” dan dapatkan jawabannya.

## Salin satu cuplikan ke alat Anda.

Buat token di dasbor pada “Developer › Alat AI (MCP)”; token hanya ditampilkan sekali. Mulailah dengan token uji.

### Claude Code

Dengan token; atau hapus --header lalu jalankan /mcp di Claude Code untuk masuk lewat OAuth.

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

### Claude Code · hanya alat dokumentasi (tanpa masuk)

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

Simpan token di variabel lingkungan BLOCKWALLETS_MCP_TOKEN; butuh Codex versi terbaru yang mendukung MCP lewat HTTP.

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

## Claude dan ChatGPT: cukup masuk.

### Claude (web / desktop)

1. Pengaturan → Konektor → Tambah konektor kustom
2. Beri nama blockwallets dan pakai URL https://blockwallets.io/mcp
3. Klik Hubungkan lalu masuk ke dasbor blockwallets di halaman yang terbuka
4. Di halaman persetujuan pilih mode uji atau live dan apakah boleh membuat tagihan, lalu klik Izinkan

### ChatGPT

1. Pengaturan → Aplikasi & Konektor → Lanjutan, aktifkan Mode pengembang
2. Buat konektor dengan URL https://blockwallets.io/mcp dan autentikasi OAuth
3. Masuk ke dasbor blockwallets
4. Pilih mode dan izin di halaman persetujuan lalu klik Izinkan

Tidak mau masuk? Pakai https://blockwallets.io/mcp/public untuk alat dokumentasi publik saja.

## 11 alat, tak satu pun bisa mengeluarkan dana.

| Alat | Fungsinya | Izin |
|---|---|---|
| `search_docs` | Mencari di dokumentasi integrasi; mengembalikan bagian dan tautan yang relevan | publik |
| `get_doc` | Membaca satu bagian dokumentasi sebagai Markdown | publik |
| `list_networks` | Koin dan jaringan, konfirmasi, jumlah minimum | publik |
| `get_pricing` | Biaya dan tingkat volume | publik |
| `explain_signature` | Penjelasan langkah demi langkah cara menghitung tanda tangan (tidak pernah meminta API key) | publik |
| `integration_checklist` | Langkah integrasi dan daftar periksa penerimaan untuk stack Anda | publik |
| `create_payment` | Membuat tagihan dan mengembalikan halaman pembayarannya (idempoten per order_id) | payments:create |
| `create_payment_link` | Membuat tautan pembayaran dan kode QR | payments:create |
| `get_payment` | Membaca satu tagihan berdasarkan order_id atau uuid | read |
| `list_payments` | Menampilkan tagihan berdasarkan status dan tanggal | read |
| `get_balance` | Membaca saldo live (hanya baca, tanpa penarikan) | read |

## Hanya menerima. Tidak pernah mengirim.

- **Tidak ada alat yang mengeluarkan dana**: Penarikan, pembayaran keluar, refund, alamat penarikan, URL callback, dan kunci tidak ada di MCP dan tidak punya izin. Hanya Anda yang bisa melakukannya di dasbor.
- **Mulai di mode uji**: Kredensial uji hanya membuat tagihan di testnet dan hanya melihat data uji. Tanpa uang sungguhan.
- **Biarkan live hanya baca**: Kredensial live melihat pesanan dan saldo sungguhan. Berikan izin baca saja kecuali Anda perlu membuat tagihan. Akun dengan verifikasi dua langkah wajib memasukkan kode untuk kredensial live, dan kami mengirim email setiap kali.
- **Cabut kapan saja**: Token dan izin OAuth ada dalam satu daftar di dasbor. Cabut salah satunya dan tokennya langsung berhenti bekerja.
- **Hanya hash**: Token dan kode disimpan sebagai sha256; token hanya ditampilkan sekali. Setiap panggilan merchant diaudit, dan tiap kredensial dibatasi 60 permintaan per menit.

## Tanya jawab

### Apa itu MCP?

Model Context Protocol, standar terbuka agar alat AI bisa memanggil layanan eksternal. Setelah terhubung, Claude, ChatGPT, Cursor, dan lainnya bisa memanggil alat blockwallets secara langsung.

### Bisakah AI memakainya untuk mengambil uang saya?

Tidak. Tidak ada alat untuk penarikan, pembayaran keluar, refund, atau mengganti alamat maupun kunci, dan izin untuk itu pun tidak ada.

### Apa bedanya mode uji dan live?

Mode uji berjalan di testnet publik dengan tagihan dan data uji; live adalah akun Anda yang sesungguhnya. Jalankan alurnya di mode uji dulu.

### Apakah Cursor mendukung masuk dengan OAuth?

Untuk saat ini, pakai token dari dasbor di Cursor. OAuth berfungsi dengan klien yang memakai pengalihan https atau loopback, seperti Claude, ChatGPT, dan Claude Code.

### Bagaimana mencabut akses?

Cari token atau izinnya di dasbor pada “Developer › Alat AI (MCP)” lalu cabut; langsung berlaku.

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