YAPAY ZEKÂ BAĞLANTILARI · MCP

Yapay zekâ asistanını bağla.

Kendi Wholly Crypto kurulumun üzerinden ödeme bul, bakiye kontrol et ve fatura oluştur.

Sunucun. Tek MCP URL'si.

Satıcı yazılımına dahildir: 5.0.0+. Ek arka plan hizmeti, Node.js çalışma ortamı veya barındırılan röle yoktur. Kurulumun yapılandırılmış API alan adını kullan; örneğin https://api.example.com/mcp.

  1. Aç: Ayarlar → API erişimi. Bu işe özel kimlik bilgisi oluştur ve asistanının ihtiyaç duyduğu projeleri ata. Salt okunur erişimle başla.
  2. Şurada: Yapay zekâ bağlantıları · MCP, MCP'yi etkinleştir. Kimlik bilgisini seç ve şunu seç: Salt okunur ve kaydet.
  3. Gösterilen URL'yi asistanının uzak HTTP/MCP ayarlarına ekle.
  4. OAuth için satıcı konsoluna giriş yap. İstemci adını, dönüş adresini ve kimlik bilgisi izinlerini incele, ardından onayla. Mevcut Basic Auth ve TOTP geçerliliğini korur.
{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

Örnek alan adını değiştir. Yapılandırma biçimleri istemciye göre değişir; yerel komut veya eski SSE URL'si yerine Streamable HTTP seç.

Ödemelerin hakkında soru sor.

  • “Mağazamın son ödenmemiş faturalarını göster.”
  • “Bu mağaza hangi varlıkları kabul edebilir?”
  • “Cüzdan bakiyelerini ve başarısız webhook teslimlerini kontrol et.”
  • “1042 numaralı sipariş için 25 EUR fatura oluştur.” Fatura oluşturma izni gerektirir.

Sekiz okuma aracı projeleri, mağazaları, ödeme yöntemlerini, cüzdanları, faturaları, teslim geçmişini ve önbellekteki dönüştürmeleri kapsar. İsteğe bağlı dokuzuncu araç mevcut API kurallarıyla fatura oluşturur.

Sonuçlar proje ve mağaza kimliklerini içerir. Tutarlar ondalık sayı dizeleri olarak kalır. Önbellekteki kur ve bakiyeler güncellik bilgilerini korur; dönüştürme garantili fatura teklifi değildir.

Asistanın nelere erişeceğini seç.

MCP yükseltmeden sonra da varsayılan olarak kapalıdır. Mevcut API anahtarları otomatik erişim kazanmaz. Asistan yalnızca onaylanmış projeleri görür; IP kısıtlamaları ve kimlik bilgisinin REST istek sınırı MCP için de geçerlidir.

Fatura oluşturmak için okuma/yazma kimlik bilgisi ve şunu seç: Oku ve fatura oluştur. OAuth istemcileri şunu istemelidir: mcp:invoice:create, ayrıca sen şu seçeneği işaretlemelisin: Fatura oluşturmaya da izin ver onay sırasında.

Aynı değeri yeniden kullan: idempotency_key ve zaman aşımından sonra aynı fatura gövdesini. Yeni anahtar yeni fatura oluşturur. Normal fiyat marjı, tolerans, ödeme ve kredi kuralları geçerliliğini korur.

Anahtar dışa aktarma veya para gönderme aracı yok. MCP kurtarma ifadelerini gösteremez, fon gönderemez, bakiye aktarımı veya iade yapamaz, geri çağrıları yeniden gönderemez, hesapları, alan adlarını veya faturalandırmayı değiştiremez.

OAuth, bearer anahtarları ve erişimi iptal etme

OAuth erişim token'ları 15 dakika geçerlidir. Yenileme token'ları dönüşümlü değiştirilir ve bağlantı en fazla 30 gün sürer. Eski yenileme token'ını tekrar kullanmak bağlantıyı iptal eder. Yalnızca kayıtlı HTTPS veya geri döngü dönüş URL'leri kabul edilir.

Kullan: Bağlı istemciler → İptal et erişimi kaldırmak için. MCP'yi kapatmak OAuth bağlantılarını iptal eder. Kimlik bilgisini yenilemek, MCP politika değişiklikleri ve kanonik API alan adı değişiklikleri yeni bağlantı gerektirir.

Özel üst bilgi desteği olan istemciler, MCP etkin API anahtarını şurada kullanabilir: Authorization: Bearer …. Bu anahtar ayrı REST izinlerini korur; yalnızca MCP erişimi için OAuth'u tercih et. Sırları asla sohbete, URL'lere veya kaynak koda yapıştırma.

Yalnızca tanıdığın istemciyi onayla. İstemci adları doğrulanmaz. Yapay zekâ sağlayıcın, fatura araçlarının döndürdüğü müşteri verileri dahil okumasına izin verdiğin bilgileri alır.

Bağlantı başarısız olursa.

  • 404: MCP'yi etkinleştir ve konsol veya ödeme sayfası sunucusu yerine API sunucusunu kullan.
  • 401: OAuth ile yeniden bağlan veya bearer kimlik bilgisinin geçerli olduğunu kontrol et.
  • 403: Kimlik bilgisi erişimini, onaylanmış projeleri, köken ve kaynak IP kısıtlamalarını kontrol et.
  • GET isteğinde 405: beklenen durumdur. Bu durumsuz uç nokta, bağımsız SSE akışı olmadan POST ve sonlu JSON yanıtları kullanır.
  • 429: Şunu bekle: Retry-After. MCP ve REST kimlik bilgisi kotasını paylaşır.
  • Fatura oluşturulamıyor: tüm yazma izinlerini, proje/mağaza durumunu, ödeme hazırlığını ve kredi hesabı doğrulamasını kontrol et.

Şu yollar için Cloudflare önbelleğini ve etkileşimli doğrulamaları kapalı tut: /mcp, /mcp/oauth/* ve OAuth keşif yolları. IP izin listeleri asistan hizmetinin belgelenmiş çıkış adreslerini içermelidir.

Desteklenen protokol revizyonları: 2025-11-25, 2025-06-18 ve 2025-03-26. İstemci bunlardan birini desteklemelidir. Şuna bak: API başvuru kaynağı her araç, uç nokta ve hata biçimi için.

Ödeme yöntemlerini fatura başına seç.

Kullan: invoice.payment_methods şununla birlikte: chain_slug: "ethereum" ve asset_tickers: ["USDC", "USDT"]. Kısa adları ve sembolleri mağazanın Ödeme yöntemleri bölümünde veya şununla bul: list_payment_methods.

Merchant 5.4.0+ etkin olmayan veya kabul edilmeyen seçimleri yok sayar. Hiçbiri eşleşmezse mağaza varsayılanları uygulanır. Yalnızca zincir seçimi etkin ve kabul edilen tüm varlıkları içerir. Ortak semboller tam olarak şu değeri gerektirir: asset_ids. Zincire özel hatalarla hazırlık ve kur kontrolleri geçerliliğini korur. Lightning ayrıdır; boş seçim dizisi geçersizdir. İstek biçimi →