Skip to main content

MCP/API

MCP/API คืออินเทอร์เฟซแบบโปรแกรมรวมศูนย์ของ Qubix ไคลเอนต์ภายนอก — ผู้ช่วย AI, สคริปต์ BI, เครื่องมืออัตโนมัติ — เชื่อมต่อกับ endpoint เดียวผ่าน MCP (Model Context Protocol) และเรียกใช้เมธอดที่แสดงในหน้านี้ การเรียกทุกครั้งทำงานอยู่ ภายในสิทธิ์ของคุณอย่างเคร่งครัด: ผู้ดูแลระบบเข้าถึงทั้งบัญชี ส่วน buyer เข้าถึงได้ เฉพาะข้อมูลของทีมตนเองเท่านั้น

ไม่มี REST API แยกต่างหากให้ต้องเรียนรู้: เมธอดที่คุณเห็นที่นี่คือสิ่งที่ endpoint ให้บริการ ทุกประการ ดังนั้นแคตตาล็อกจึงไม่มีทางคลาดเคลื่อนจากอินเทอร์เฟซจริง

เมธอดชุดเดียวกันนี้ขับเคลื่อนผู้ช่วยในตัวด้วย​

เมธอดเหล่านี้ไม่ได้มีไว้สำหรับไคลเอนต์ภายนอกเท่านั้น ผู้ช่วย AI ในตัวของ Qubix — แผงที่ใช้ได้ในทุกหน้าจอของแผงผู้ดูแลระบบ โดยไม่ต้องตั้งค่าใด ๆ — เรียกใช้แคตตาล็อก ชุดเดียวกันนี้ ดังนั้นไม่ว่าคุณจะถามผู้ช่วยในตัวหรือเชื่อมต่อ AI agent ของคุณเองผ่าน MCP ทั้งสองอย่างจะอ่านข้อมูลและดำเนินการผ่านเมธอดชุดเดียวกัน ภายในสิทธิ์ของคุณเสมอ

หาได้ที่ไหน​

ในแผงผู้ดูแลระบบ เปิด เมนูบัญชี (มุมขวาบน ถัดจากชื่อของคุณ) แล้วเลือก

MCP/API

Endpoint​

ทุกอย่างส่งไปยังที่อยู่เดียว:

POST https://<your-domain>/api/mcp

ทรานสปอร์ตคือ Streamable HTTP (JSON-RPC 2.0) — endpoint เดียวที่ไคลเอนต์ MCP สำเร็จรูป รองรับโดยตรง และคุณยังเรียกใช้ได้โดยตรงจากภาษาใดก็ได้ (ดู ตัวอย่างโค้ด ด้านล่าง)

โทเค็น API ของคุณ​

การเข้าถึงแบบโปรแกรมใช้ โทเค็นส่วนตัว (PAT) — สร้างและจัดการได้ในหน้านี้โดยตรง ในบล็อก API Token

  1. กด สร้าง API token (หรือ สร้างใหม่ หากคุณมีอยู่แล้ว)
  2. คัดลอกโทเค็นทันที — จะแสดงเพียง ครั้งเดียว เท่านั้น

โทเค็นมีรูปแบบเช่น qbx_… Qubix เก็บไว้เพียงค่าแฮชและไม่สามารถแสดงให้คุณเห็นอีกได้

  • หนึ่งโทเค็นต่อผู้ใช้ โทเค็นสืบทอดบทบาทและสิทธิ์ของคุณ ดังนั้นผ่าน API คุณจึงเห็น ข้อมูลและการดำเนินการเหมือนกับในอินเทอร์เฟซทุกประการ
  • สร้างใหม่ จะออกโทเค็นใหม่และโทเค็นเก่าจะหยุดทำงานทันที
  • เพิกถอน จะลบโทเค็นและตัดการเข้าถึงทั้งหมดที่ใช้โทเค็นนั้น
ปฏิบัติต่อโทเค็นเหมือนรหัสผ่าน

โทเค็นส่วนตัวเทียบเท่ากับการลงชื่อเข้าใช้ในฐานะตัวคุณ อย่าเผยแพร่หรือแชร์ให้ผู้อื่น หากรั่วไหล ให้กด สร้างใหม่ ที่นี่ — โทเค็นเก่าจะหยุดทำงานทันที

เชื่อมต่อไคลเอนต์​

ไคลเอนต์ MCP ส่วนใหญ่ต้องการการกำหนดค่าเล็กน้อย: endpoint บวกกับเฮดเดอร์ Authorization ขณะที่โทเค็นแสดงอยู่ทันทีหลังการสร้าง หน้านี้ได้กรอกค่าจริงลงในตัวอย่างด้านล่างให้แล้ว — คัดลอกได้ตามที่เห็น

JSON
{
  "mcpServers": {
    "qubix": {
      "url": "https://<your-domain>/api/mcp",
      "headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
    }
  }
}

สำหรับการตั้งค่าทีละขั้นตอนของผู้ช่วยแต่ละตัว (Claude Code, Claude Desktop, Cursor) ดูที่ การเชื่อมต่อ AI ภายนอก

ตัวอย่างโค้ด​

หากต้องการเรียก endpoint จากโค้ดของคุณเอง ให้ส่งคำขอ JSON-RPC พร้อมเฮดเดอร์ auth และ Streamable-HTTP หน้านี้มีสนิปเปตสำเร็จรูปสำหรับ cURL, JavaScript และ Python — สลับแท็บแล้วคัดลอก ตัวอย่างเช่น การแสดงรายการเมธอดที่ใช้ได้:

Bash
curl -X POST 'https://<your-domain>/api/mcp' \
  -H 'Authorization: Bearer qbx_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Python
import requests

res = requests.post(
    "https://<your-domain>/api/mcp",
    headers={
        "Authorization": "Bearer qbx_YOUR_TOKEN",
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
    },
    json={"jsonrpc": "2.0", "id": 1, "method": "tools/list"},
)
print(res.text)
สำหรับการผสานรวมแบบกำหนดเอง

การเรียกแบบดิบเหล่านี้แสดงให้เห็นโปรโตคอลจากภาษาใดก็ได้ ไคลเอนต์สำเร็จรูป (Claude, Cursor) ไม่จำเป็นต้องใช้ — เพราะใช้การกำหนดค่าด้านบน

API เปิดเผยอะไรบ้าง​

หน้านี้แสดง แคตตาล็อกเมธอด ทั้งหมด — ปัจจุบันมีประมาณร้อยเมธอด — และแต่ละเมธอด ติดป้ายกำกับว่า อ่าน หรือ เขียน เมธอดเหล่านี้ครอบคลุมสิ่งต่อไปนี้ ภายในสิทธิ์ของคุณ:

  • การวิเคราะห์ — แดชบอร์ด, geo, ออฟเฟอร์, เครือข่าย, แหล่งทราฟฟิก, หน้าจอ Facebook และ funnel ของผู้เข้าชม รวมถึงการเจาะลึกสำหรับโฆษณา แคมเปญ ออฟเฟอร์ ครีเอทีฟ PWA geo หรือแหล่งทราฟฟิกแต่ละรายการ
  • ครีเอทีฟ — การค้นหาเชิงความหมายและธีมครีเอทีฟที่ทำผลงานดีที่สุด
  • Britva — ดูกฎอัตโนมัติ โฆษณาที่ถูกพัก และประวัติการทำงานของกฎ; สร้าง แก้ไข และ ปล่อยกฎ
  • การดำเนินการ — พักและเรียกใช้โฆษณาและแคมเปญต่อ; จัดการออฟเฟอร์ เครือข่าย แหล่งทราฟฟิก แคมเปญในตัวติดตาม pixel เว็บไซต์ โดเมน PWA และแคมเปญ push
  • คำขอแบบอิสระ — เมธอดคำขอแบบอ่านอย่างเดียวสำหรับคำถามที่เมธอดสำเร็จรูป ครอบคลุมไม่ถึง

แต่ละเมธอดแสดงพารามิเตอร์และว่าเมธอดนั้นเปลี่ยนแปลงข้อมูลหรือไม่ ใช้ช่องค้นหาเพื่อค้นหา เมธอดตามชื่อหรือคำอธิบาย

เมธอดเขียนเกิดผลจริง

การพักโฆษณา ลบกฎ หรือลบออฟเฟอร์ผ่าน API จะเปลี่ยนแปลงแคมเปญที่กำลังทำงานจริงของคุณ ในไคลเอนต์แชท การดำเนินการเหล่านี้จะทำงานหลังจากที่คุณยืนยันเท่านั้น — ตรวจสอบสิ่งที่ เสนอมาก่อนอนุมัติ

ขั้นต่อไป​

การเชื่อมต่อ AI ภายนอก

ตั้งค่า Claude, Cursor หรือไคลเอนต์ MCP อื่นทีละขั้นตอน

การเชื่อมต่อ

คีย์สำหรับบริการภายนอกที่ Qubix ผสานรวมด้วย

เทมเพลต

ข้อมูลและการดำเนินการใดที่บทบาทของคุณ — และโทเค็นของคุณ — เข้าถึงได้

On this page