ข้ามไปยังเนื้อหาหลัก

Omise Model Context Protocol (MCP) เซิร์ฟเวอร์

เซิร์ฟเวอร์ Omise Model Context Protocol (MCP) ช่วยให้คุณสามารถรวมการดำเนินการชำระเงิน Omise โดยตรงเข้า AI assistants เช่น Claude Desktop Continue และเครื่องมือที่รองรับ MCP อื่นๆ ด้วยเซิร์ฟเวอร์ MCP คุณสามารถจัดการค่าใช้ ลูกค้า ค่าคืน ค่าโอน และอื่นๆ ผ่านการสนทนาภาษาธรรมชาติ

ภาพรวม​

Model Context Protocol (MCP) คืออะไร?​

Model Context Protocol (MCP) เป็นมาตรฐานเปิดที่พัฒนาโดย Anthropic ที่ช่วยให้ AI assistants เชื่อมต่อกับแหล่งข้อมูลและเครื่องมือภายนอกได้อย่างปลอดภัย เซิร์ฟเวอร์ MCP เปิดเผยความสามารถเฉพาะที่โมเดล AI สามารถใช้เพื่อดำเนินการในโลกแห่งความเป็นจริงในนามของผู้ใช้

เซิร์ฟเวอร์ Omise MCP ให้สะพานเชื่อมระหว่าง AI assistants และ Omise API ซึ่งอนุญาตให้คุณ:

  • ข้อมูลการชำระเงินจากแบบสอบถาม - ค่าใช้ ลูกค้า ค่าโอนฯลฯ
  • สร้างการทำธุรกรรม - ประมวลผลการชำระเงิน สร้างลูกค้า และออกค่าคืน
  • จัดการทรัพยากร - อัปเดตข้อมูลลูกค้า ยกเลิกค่าใช้ที่กำหนดตารางไว้ฯลฯ
  • อัตโนมัติเวิร์กโฟลว์ - ใช้ภาษาธรรมชาติเพื่อการดำเนินการชำระเงินที่ซับซ้อน

ประโยชน์หลัก​

  • อินเทอร์เฟสภาษาธรรมชาติ - โต้ตอบกับ Omise โดยใช้คำสั่งการสนทนา
  • เพิ่มผลผลิต - อัตโนมัติการดำเนินการชำระเงินทั่วไปโดยไม่ต้องเขียนโค้ด
  • การตรวจสอบสิทธิ์ที่ปลอดภัย - คีย์ API เก็บไว้ในเครื่องและไม่ส่งให้ผู้ให้บริการ AI
  • การดำเนินการแบบเรียลไทม์ - ดำเนินการธุรกรรมการชำระเงินสดผ่าน AI assistant
  • การรองรับหลายเครื่องมือ - ทำงานกับ Claude Desktop Continue Cline และลูกค้า MCP อื่นๆ

การติดตั้ง​

ข้อกำหนดเบื้องต้น​

  • Node.js 18+ - จำเป็นต้องรันเซิร์ฟเวอร์ MCP
  • Omise Account - บัญชีที่มีคีย์ API
  • ลูกค้าที่รองรับ MCP - Claude Desktop Continue หรือเครื่องมือที่คล้ายกัน

ติดตั้งผ่าน npm​

npm install -g @omise/mcp-server

ใช้ npx​

npx @omise/mcp-server

การตั้งค่า​

Claude Desktop Setup​

Claude Desktop เป็นแอปพลิเคชันเดสก์ท็อปที่สนับสนุนเซิร์ฟเวอร์ MCP ในการตั้งค่าเซิร์ฟเวอร์ Omise MCP:

  1. ค้นหาไฟล์กำหนดค่า

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. เพิ่มเซิร์ฟเวอร์ Omise MCP

    แก้ไขไฟล์กำหนดค่าเพื่อรวมเซิร์ฟเวอร์ Omise MCP:

    {
      "mcpServers": {
        "omise": {
          "command": "npx",
          "args": ["-y", "@omise/mcp-server"],
          "env": {
            "OMISE_SECRET_KEY": "skey_test_your_secret_key_here",
            "OMISE_PUBLIC_KEY": "pkey_test_your_public_key_here"
          }
        }
      }
    }

  3. รีสตาร์ท Claude Desktop

    ปิดและเปิด Claude Desktop เพื่อโหลดการตั้งค่าใหม่

  4. ตรวจสอบการเชื่อมต่อ

    เริ่มต้นการสนทนาใหม่และถาม "คุณสามารถแสดงค่าใช้ Omise ล่าสุดของฉันได้หรือไม่"

เครื่องมือที่พร้อมใช้งาน​

เซิร์ฟเวอร์ Omise MCP เปิดเผยเครื่องมือต่อไปนี้สำหรับ AI assistants:

การดำเนินการค่าใช้​

  • list_charges - ดึงรายการค่าใช้ที่อ้างอิง
  • get_charge - รับรายละเอียดค่าใช้เฉพาะ
  • create_charge - สร้างค่าใช้ใหม่สำหรับการชำระเงิน
  • capture_charge - ค่าใช้ที่ได้รับอนุญาตก่อนหน้านี้
  • reverse_charge - ยกเลิกค่าใช้ที่ได้รับอนุญาตที่ยังไม่ได้ส่วน
  • update_charge - อัปเดตข้อมูลเมตาค่าใช้

การดำเนินการลูกค้า​

  • list_customers - แสดงรายการลูกค้าทั้งหมดที่มีการแบ่งหน้า
  • get_customer - ดึงลูกค้าเฉพาะตามรหัส
  • create_customer - สร้างโปรไฟล์ลูกค้าใหม่
  • update_customer - อัปเดตข้อมูลลูกค้า
  • delete_customer - ลบโปรไฟล์ลูกค้า

การดำเนินการการ์ด​

  • list_cards - แสดงรายการการ์ดที่เกี่ยวข้องกับลูกค้า
  • get_card - รับรายละเอียดของการ์ดเฉพาะ
  • update_card - อัปเดตข้อมูลการ์ด (ชื่อ หมดอายุ)
  • delete_card - เอาการ์ดออกจากลูกค้า

การดำเนินการคืนเงิน​

  • list_refunds - แสดงรายการเงินคืนทั้งหมดสำหรับค่าใช้
  • get_refund - รับรายละเอียดเงินคืนเฉพาะ
  • create_refund - ออก refund เต็มหรือบางส่วน

การดำเนินการโอนเงิน​

  • list_transfers - โอนรายการไปยังบัญชีธนาคาร
  • get_transfer - รับรายละเอียดการโอนเฉพาะ
  • create_transfer - สร้างการโอนด้วยตนเอง
  • update_transfer - อัปเดตข้อมูลการโอน

การดำเนินการแหล่งที่มา​

  • list_sources - แสดงรายการแหล่งการชำระเงิน
  • get_source - รับรายละเอียดแหล่งที่มาเฉพาะ
  • create_source - สร้างแหล่งการชำระเงินใหม่

การดำเนินการสมดุล​

  • get_balance - ดึงยอดเงินบัญชีปัจจุบัน
  • get_transaction - รับรายละเอียดธุรกรรม

การดำเนินการข้อพิพาท​

  • list_disputes - แสดงรายการข้อพิพาททั้งหมด
  • get_dispute - รับรายละเอียดข้อพิพาทเฉพาะ
  • update_dispute - อัปเดตข้อมูลข้อพิพาท

การดำเนินการเหตุการณ์​

  • list_events - แสดงรายการเหตุการณ์ API สำหรับการแก้ไขข้อบกพร่อง webhook
  • get_event - รับรายละเอียดเหตุการณ์เฉพาะ

ตัวอย่างการใช้​

ตัวอย่างคำเรียน​

เมื่อตั้งค่าแล้ว คุณสามารถโต้ตอบกับ Omise โดยใช้ภาษาธรรมชาติ:

การดึงข้อมูล:

"แสดงค่าใช้ล่าสุด 10 รายการของฉัน"
"ยอดเงินบัญชีปัจจุบันของฉันเป็นเท่าไร"
"รับรายละเอียดสำหรับ chrg_test_5v7h8gp2xqf0v0k4zy7"
"แสดงรายการลูกค้าทั้งหมดที่สร้างเดือนนี้"

สร้างทรัพยากร:

"สร้างค่าใช้ 10000 THB ด้วยการ์ดโทเค็น tokn_test_123"
"สร้างลูกค้าใหม่ด้วยอีเมล customer@example.com"
"ออกเงินคืนเต็มจำนวนสำหรับ chrg_test_5v7h8gp2xqf0v0k4zy7"

อัปเดตทรัพยากร:

"อัปเดตลูกค้า cust_test_123 ด้วยหมายเลขโทรศัพท์ +66812345678"
"ค่าใช้ chrg_test_5v7h8gp2xqf0v0k4zy7"
"เพิ่มข้อมูลเมตา order_id: 12345 ไปยังค่าใช้ chrg_test_5v7h8gp2xqf0v0k4zy7"

พิจารณาด้านความปลอดภัย​

ที่จัดเก็บคีย์ API​

วิธีปฏิบัติที่สำคัญด้านความปลอดภัย:

  1. ไม่ต้องคำมติคีย์ API - ไม่ต้องเก็บไว้ในการควบคุมเวอร์ชัน
  2. ใช้คีย์ทดสอบในการพัฒนา - ใช้ skey_test_* คีย์เสมอ
  3. ป้องกันไฟล์กำหนดค่า - จำกัดสิทธิ์ไฟล์ในไฟล์กำหนดค่า
  4. คีย์เฉพาะสภาพแวดล้อม - ใช้คีย์ต่างกันสำหรับการทดสอบ/การผลิต
  5. การหมุนเวียนคีย์ปกติ - หมุนเวียนคีย์การผลิตเป็นระยะ

FAQ​

MCP และการรวม API โดยตรงแตกต่างกันอย่างไร?

MCP ให้อินเทอร์เฟสภาษาธรรมชาติไปยัง Omise API ผ่าน AI assistants ในขณะที่การรวม API โดยตรงต้องเขียนโค้ด MCP เหมาะสำหรับ:

  • การดำเนินการครั้งเดียวและการทดสอบ
  • งานสนับสนุนลูกค้า
  • การกระทบยอดทางการเงิน
  • การสร้างต้นแบบอย่างรวดเร็ว

การรวม API โดยตรงเหมาะกว่าสำหรับ:

  • การไหลของการชำระเงินในการผลิต
  • การดำเนินการปริมาณมาก
  • ตรรกะธุรกิจที่กำหนดเอง
  • การควบคุมเต็มรูปแบบ
ฉันสามารถใช้ MCP ในสภาพแวดล้อมการผลิตได้หรือไม่?

ใช่ แต่ด้วยความระมัดระวัง MCP เหมาะสำหรับงานดำเนินการ การสนับสนุนลูกค้า และการดำเนินการบริหาร อย่างไรก็ตาม สำหรับการไหลของการชำระเงินที่หันหน้าเข้าหาลูกค้า ให้ใช้การรวม API โดยตรง ควร:

  • ใช้คีย์ live เมื่อจำเป็นเท่านั้น
  • ใช้การควบคุมการเข้าถึงที่เหมาะสม
  • ตรวจสอบการดำเนินการทั้งหมด
  • ฝึกอบรมผู้ใช้เกี่ยวกับแนวทางปฏิบัติที่ดีที่สุดด้านความปลอดภัย
  • ตรวจสอบการใช้งานเป็นประจำ
AI assistants ใดบ้างที่รองรับเซิร์ฟเวอร์ Omise MCP?

เซิร์ฟเวอร์ Omise MCP ทำงานกับลูกค้าที่รองรับ MCP:

  • Claude Desktop - แอปเดสก์ท็อปโดย Anthropic
  • Continue - AI code assistant โอเพ่นซอร์สสำหรับ VS Code
  • Cline - ส่วนขยาย VS Code
  • ลูกค้า MCP อื่นๆ - เครื่องมือใดๆ ที่ใช้มาตรฐาน MCP

ทรัพยากรที่เกี่ยวข้อง​

เอกสาร Omise​

  • API Reference - เอกสาร Omise API ที่สมบูรณ์
  • Authentication Guide - การจัดการคีย์ API
  • Testing Guide - กลยุทธ์การทดสอบ
  • Webhook Integration - สถาปัตยกรรมขับเคลื่อนด้วยเหตุการณ์

ทรัพยากร MCP​

  • MCP Specification - มาตรฐาน MCP อย่างเป็นทางการ
  • MCP GitHub - การนำไปใช้แบบเปิดซอร์ส
  • Anthropic MCP - บทนำ MCP

ขั้นตอนต่อไป​

เริ่มต้น​

  1. ติดตั้ง MCP Server

    npm install -g @omise/mcp-server

  2. ตั้งค่า Claude Desktop

    เพิ่มเซิร์ฟเวอร์ Omise MCP ไปยังการตั้งค่า

  3. ทดสอบการเชื่อมต่อ

    ขอให้ Claude ดึงข้อมูลยอดเงินบัญชี

  4. สำรวจความสามารถ

    ลองใช้คำสั่งและการดำเนินการต่างๆ

การใช้ขั้นสูง​

  • อัตโนมัติเวิร์กโฟลว์ - สร้างการดำเนินการหลายขั้นตอน
  • สร้างพรอมต์ที่กำหนดเอง - พัฒนาเทมเพลตสำหรับงานทั่วไป
  • รวมเข้ากับ CI/CD - ใช้ MCP สำหรับการทดสอบอัตโนมัติ
  • ฝึกอบรมทีม - แบ่งปันวิธีปฏิบัติที่ดีที่สุด

พร้อมที่จะรวม Omise กับ AI หรือยัง? ติดตั้งเซิร์ฟเวอร์ MCP และเริ่มต้นการอัตโนมัติการดำเนินการชำระเงินของคุณวันนี้!