การเชื่อมต่อ AI · MCP

เชื่อมผู้ช่วย AI ของคุณ

ค้นหาการชำระเงิน ตรวจยอด และสร้างใบแจ้งหนี้ผ่าน Wholly Crypto ที่คุณติดตั้งเอง

เซิร์ฟเวอร์ของคุณ URL MCP เดียว

รวมอยู่ในซอฟต์แวร์ผู้ค้า 5.0.0+ ไม่มี daemon เพิ่ม รันไทม์ Node.js หรือ relay ที่โฮสต์ภายนอก ใช้โดเมน API ที่ตั้งไว้ของการติดตั้ง เช่น https://api.example.com/mcp.

  1. เปิด การตั้งค่า → การเข้าถึง API สร้างข้อมูลรับรองเฉพาะและกำหนดโปรเจกต์ที่ผู้ช่วยต้องใช้ เริ่มจากอ่านอย่างเดียว
  2. ใน การเชื่อมต่อ AI · MCP เปิด MCP เลือกข้อมูลรับรอง แล้วเลือก อ่านอย่างเดียว แล้วบันทึก
  3. เพิ่ม URL ที่แสดงในค่าตั้ง HTTP/MCP ระยะไกลของผู้ช่วย
  4. สำหรับ OAuth ลงชื่อเข้าใช้คอนโซลผู้ค้า ตรวจชื่อไคลเอนต์ ที่อยู่กลับ และสิทธิ์ข้อมูลรับรอง แล้วอนุมัติ Basic Auth และ TOTP เดิมยังมีผล
{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

แทนโดเมนตัวอย่าง รูปแบบตั้งค่าต่างกันตามไคลเอนต์ เลือก Streamable HTTP ไม่ใช่คำสั่งในเครื่องหรือ URL SSE แบบเก่า

ถามเรื่องการชำระเงินของคุณ

  • “แสดงใบแจ้งหนี้ล่าสุดที่ยังไม่จ่ายของร้านฉัน”
  • “ร้านนี้รับสินทรัพย์อะไรได้บ้าง?”
  • “ตรวจยอดกระเป๋าและการส่ง webhook ที่ล้มเหลว”
  • “สร้างใบแจ้งหนี้ 25 EUR สำหรับคำสั่งซื้อ 1042” ต้องมีสิทธิ์สร้างใบแจ้งหนี้

เครื่องมืออ่านแปดตัวครอบคลุมโปรเจกต์ ร้าน วิธีชำระเงิน กระเป๋า ใบแจ้งหนี้ ประวัติส่ง และการแปลงในแคช เครื่องมือที่เก้าเป็นตัวเลือกสำหรับสร้างใบแจ้งหนี้ตามกฎ API เดิม

ผลลัพธ์มี ID โปรเจกต์และร้าน จำนวนเงินคงเป็นสตริงทศนิยม อัตราและยอดในแคชคงข้อมูลความใหม่ไว้ การแปลงไม่ใช่ราคาเสนอใบแจ้งหนี้ที่รับประกัน

เลือกสิ่งที่ผู้ช่วยเข้าถึงได้

MCP ปิดเป็นค่าเริ่มต้น รวมถึงหลังอัปเกรด คีย์ API เดิมไม่ได้สิทธิ์อัตโนมัติ ผู้ช่วยเห็นเฉพาะโปรเจกต์ที่อนุมัติ ข้อจำกัด IP และอัตรา REST ของข้อมูลรับรองมีผลกับ MCP ด้วย

เพื่อสร้างใบแจ้งหนี้ เลือกข้อมูลรับรองอ่าน/เขียนและ อ่าน + สร้างใบแจ้งหนี้ ไคลเอนต์ OAuth ต้องขอ mcp:invoice:create และคุณต้องเลือก อนุญาตให้สร้างใบแจ้งหนี้ด้วย ระหว่างอนุมัติ

ใช้ค่าเดิมของ idempotency_key และเนื้อหาใบแจ้งหนี้หลังหมดเวลารอ คีย์ใหม่สร้างใบแจ้งหนี้ใหม่ กฎส่วนต่าง ค่าคลาดเคลื่อน การชำระ และเครดิตปกติยังมีผล

ไม่มีเครื่องมือส่งออกคีย์หรือส่งเงิน MCP เปิดเผยวลีกู้คืน ส่งเงิน รวบรวมเงิน คืนเงิน ส่ง callback ซ้ำ หรือเปลี่ยนบัญชี โดเมน และการเรียกเก็บค่าธรรมเนียมไม่ได้

OAuth คีย์ bearer และการเพิกถอน

access token OAuth ใช้ได้ 15 นาที refresh token หมุนเปลี่ยน และการเชื่อมต่ออยู่ได้นานถึง 30 วัน การใช้ refresh token เก่าซ้ำจะเพิกถอนการเชื่อมต่อ ยอมรับเฉพาะ URL กลับแบบ HTTPS หรือ loopback ที่ลงทะเบียน

ใช้ ไคลเอนต์ที่เชื่อมต่อ → เพิกถอน เพื่อนำสิทธิ์ออก การปิด MCP เพิกถอนการเชื่อมต่อ OAuth การเปลี่ยนข้อมูลรับรอง นโยบาย MCP และโดเมน API หลักต้องเชื่อมใหม่

ไคลเอนต์ที่รองรับ header กำหนดเองใช้คีย์ API ที่เปิด MCP ใน Authorization: Bearer …ได้ คีย์นั้นยังมีสิทธิ์ REST แยก จึงควรใช้ OAuth หากต้องการเฉพาะ MCP อย่าวางข้อมูลลับในแชต URL หรือซอร์สโค้ด

อนุมัติเฉพาะไคลเอนต์ที่คุณรู้จัก ชื่อไคลเอนต์ไม่ได้รับการตรวจสอบ ผู้ให้บริการ AI รับข้อมูลที่คุณอนุญาตให้อ่าน รวมข้อมูลลูกค้าที่เครื่องมือใบแจ้งหนี้คืนมา

หากเชื่อมต่อไม่สำเร็จ

  • 404: เปิด MCP และใช้โฮสต์ API ไม่ใช่โฮสต์คอนโซลหรือหน้าชำระเงิน
  • 401: เชื่อมใหม่ด้วย OAuth หรือตรวจว่าข้อมูลรับรอง bearer ยังใช้ได้
  • 403: ตรวจสิทธิ์ข้อมูลรับรอง โปรเจกต์ที่อนุมัติ origin และข้อจำกัด IP ต้นทาง
  • 405 เมื่อใช้ GET: เป็นผลที่คาดไว้ endpoint ไร้สถานะนี้ใช้ POST และการตอบ JSON ที่จบเป็นครั้ง ๆ ไม่มีสตรีม SSE แยก
  • 429: รอตาม Retry-After MCP และ REST ใช้โควตาข้อมูลรับรองร่วมกัน
  • สร้างใบแจ้งหนี้ไม่ได้: ตรวจสิทธิ์เขียนทั้งหมด สถานะโปรเจกต์/ร้าน ความพร้อมชำระเงิน และการยืนยันบัญชีเครดิต

ปิดแคชและการทดสอบแบบโต้ตอบของ Cloudflare สำหรับ /mcp, /mcp/oauth/* และพาธค้นพบบริการ OAuth รายการ IP ที่อนุญาตต้องมีที่อยู่ขาออกของบริการผู้ช่วยตามเอกสาร

รุ่นโปรโตคอลที่รองรับ: 2025-11-25, 2025-06-18 และ 2025-03-26 ไคลเอนต์ต้องรองรับอย่างน้อยหนึ่งรุ่น ดู เอกสารอ้างอิง API สำหรับทุกเครื่องมือ endpoint และรูปแบบข้อผิดพลาด

เลือกวิธีชำระเงินแยกตามใบแจ้งหนี้

ใช้ invoice.payment_methods ร่วมกับ chain_slug: "ethereum" และ asset_tickers: ["USDC", "USDT"] หา slug และสัญลักษณ์ในวิธีชำระเงินของร้านหรือด้วย list_payment_methods.

ซอฟต์แวร์ผู้ค้า 5.4.0+ ข้ามตัวเลือกที่ปิดหรือไม่รับ หากไม่มีที่ตรงใช้ค่าเริ่มต้นร้าน ระบุเฉพาะเชนรวมทุกสินทรัพย์ที่เปิดและรับ สัญลักษณ์ซ้ำต้องใช้ค่าที่แน่นอนของ asset_ids ยังตรวจความพร้อมและอัตราพร้อมข้อผิดพลาดเฉพาะเชน Lightning แยกต่างหาก อาร์เรย์ตัวเลือกว่างใช้ไม่ได้ รูปแบบคำขอ →