whollycrypto.
Bahasa Indonesia

KONEKSI AI · MCP

Hubungkan asisten AI-mu.

Temukan pembayaran, periksa saldo, dan buat faktur melalui instalasi Wholly Crypto milikmu.

Servermu. Satu URL MCP.

Disertakan dalam merchant 5.0.0+. Tanpa daemon tambahan, runtime Node.js, atau relay yang dihosting. Gunakan domain API yang dikonfigurasi untuk instalasi, misalnya https://api.example.com/mcp.

  1. Buka Pengaturan → Akses API. Buat kredensial khusus dan tetapkan proyek yang diperlukan asistenmu. Mulai dengan hanya baca.
  2. Di Koneksi AI · MCP, aktifkan MCP. Pilih kredensialmu, pilih Hanya baca dan simpan.
  3. Tambahkan URL yang ditampilkan ke pengaturan HTTP/MCP jarak jauh asistenmu.
  4. Untuk OAuth, login ke konsol merchant-mu. Tinjau nama klien, alamat kembali, dan izin kredensial, lalu setujui. Basic Auth dan TOTP yang ada tetap berlaku.
{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

Ganti domain contoh. Format konfigurasi bervariasi menurut klien; pilih Streamable HTTP, bukan perintah lokal atau URL SSE lama.

Tanyakan tentang pembayaranmu.

  • “Tampilkan faktur belum dibayar terbaru untuk tokoku.”
  • “Aset apa yang bisa diterima toko ini?”
  • “Periksa saldo dompet dan pengiriman webhook yang gagal.”
  • “Buat faktur 25 EUR untuk pesanan 1042.” Memerlukan izin pembuatan faktur.

Delapan alat baca mencakup proyek, toko, metode pembayaran, dompet, faktur, riwayat pengiriman, dan konversi dalam cache. Alat kesembilan opsional membuat faktur menggunakan aturan API yang ada.

Hasil mencakup ID proyek dan toko. Jumlah tetap berupa string desimal. Kurs dan saldo dalam cache mempertahankan informasi kebaruannya; konversi bukan kuotasi faktur yang dijamin.

Pilih apa yang bisa diakses asisten.

MCP nonaktif secara bawaan, termasuk setelah pembaruan. Kunci API yang ada tidak otomatis mendapatkan akses. Asisten hanya melihat proyek yang disetujui; pembatasan IP dan batas permintaan REST kredensial juga berlaku pada MCP.

Untuk membuat faktur, pilih kredensial baca/tulis dan Baca + buat faktur. Klien OAuth harus meminta mcp:invoice:create, dan kamu harus mencentang Izinkan juga pembuatan faktur saat persetujuan.

Gunakan kembali idempotency_key dan body faktur yang sama setelah batas waktu terlampaui. Kunci baru membuat faktur baru. Aturan spread, toleransi, pembayaran, dan kredit normal tetap berlaku.

Tanpa ekspor kunci atau alat pengiriman uang. MCP tidak bisa mengungkap frasa pemulihan, mengirim dana, melakukan sweep, mengembalikan dana, mengirim ulang callback, atau mengubah akun, domain, dan penagihan.

OAuth, kunci bearer, dan pencabutan

Token akses OAuth berlaku 15 menit. Token penyegaran dirotasi dan koneksi berlaku hingga 30 hari. Memakai ulang token penyegaran lama mencabut koneksi. Hanya URL kembali HTTPS atau loopback yang terdaftar yang diterima.

Gunakan Klien terhubung → Cabut untuk menghapus akses. Menonaktifkan MCP mencabut koneksi OAuth. Rotasi kredensial, perubahan kebijakan MCP, dan perubahan domain API kanonis memerlukan koneksi baru.

Klien yang mendukung header kustom bisa menggunakan kunci API yang mengaktifkan MCP pada Authorization: Bearer …. Kunci tersebut mempertahankan izin REST terpisahnya, jadi utamakan OAuth untuk akses khusus MCP. Jangan pernah menempelkan rahasia ke percakapan, URL, atau kode sumber.

Setujui hanya klien yang kamu kenali. Nama klien tidak diverifikasi. Penyedia AI-mu menerima informasi yang kamu izinkan untuk dibaca, termasuk data pelanggan yang dikembalikan alat faktur.

Jika koneksi gagal.

  • 404: aktifkan MCP dan gunakan host API, bukan host konsol atau checkout.
  • 401: hubungkan kembali dengan OAuth atau periksa apakah kredensial bearer-mu valid.
  • 403: periksa akses kredensial, proyek yang disetujui, origin, dan pembatasan IP sumber.
  • 405 pada GET: ini normal. Endpoint stateless ini menggunakan POST dan respons JSON terbatas, tanpa aliran SSE terpisah.
  • 429: tunggu Retry-After. MCP dan REST berbagi kuota kredensial.
  • Tidak bisa membuat faktur: periksa semua izin tulis, status proyek/toko, kesiapan pembayaran, dan verifikasi akun kredit.

Biarkan caching Cloudflare dan tantangan interaktif nonaktif untuk /mcp, /mcp/oauth/* serta path penemuan OAuth. Daftar IP yang diizinkan harus mencakup alamat egress yang didokumentasikan layanan asisten.

Revisi protokol yang didukung: 2025-11-25, 2025-06-18 dan 2025-03-26. Klien harus mendukung salah satunya. Lihat Referensi API untuk setiap alat, endpoint, dan format kesalahan.

Pilih metode pembayaran per faktur.

Gunakan invoice.payment_methods dengan chain_slug: "ethereum" dan asset_tickers: ["USDC", "USDT"]. Temukan slug dan ticker di Metode pembayaran toko atau dengan list_payment_methods.

Merchant 5.4.0+ mengabaikan pilihan nonaktif atau tidak diterima. Jika tidak ada yang cocok, pengaturan bawaan toko berlaku. Pilihan blockchain saja mencakup semua aset aktif yang diterima. Ticker yang sama memerlukan asset_idsyang persis. Pemeriksaan kesiapan dan kurs tetap berlaku, dengan kesalahan khusus blockchain. Lightning terpisah; array pilihan kosong tidak valid. Format permintaan →