สำหรับนักพัฒนา · รองรับ Claude และ Cursor

คู่มือการผสานรวม MCP

ใช้ Model Context Protocol เพื่อให้ Claude, Cursor หรือเอเจนต์ AI ของคุณเองดูข้อมูลใน DEXUN AdWhiz ได้ ทั้งบัญชีโฆษณาที่เชื่อมต่อไว้บนสามแพลตฟอร์ม คำแนะนำจาก AI และกิจกรรมล่าสุด แบบอ่านอย่างเดียว

MCP คืออะไร

MCP (Model Context Protocol) คือมาตรฐานเปิดที่ Anthropic เปิดตัวในปี 2024 ซึ่งกำหนดวิธีที่แอปพลิเคชัน AI เข้าถึงข้อมูลและเครื่องมือภายนอกได้อย่างปลอดภัย ลองนึกภาพว่าเป็น "USB-C สำหรับ AI" — อินเทอร์เฟซเดียวที่ให้ไคลเอนต์ MCP ใดก็ได้ (Claude Desktop, Cursor, เอเจนต์ของคุณเอง) เรียกใช้เซิร์ฟเวอร์ MCP ใดก็ได้ (DEXUN AdWhiz, Notion, GitHub ฯลฯ)

เซิร์ฟเวอร์ MCP ของ DEXUN AdWhiz มีเครื่องมือแบบอ่านอย่างเดียว 5 รายการ ได้แก่ บัญชีโฆษณาที่เชื่อมต่อไว้ คำแนะนำที่ยังเปิดอยู่ของ AI สรุปเงินที่ประหยัดได้ กิจกรรมล่าสุดของบัญชี และโควตา API ของคุณ เซิร์ฟเวอร์นี้ไม่สามารถเปลี่ยนแปลง หยุดชั่วคราว หรือสร้างสิ่งใดในบัญชีโฆษณาของคุณได้ ทุกการเรียกยืนยันตัวตนด้วย API key ของคุณ และใช้ขีดจำกัดอัตราตามแพ็กเกจเดียวกับ REST API ของเรา

เริ่มต้นอย่างรวดเร็ว

สามขั้นตอน ประมาณห้านาที คุณก็ถามผู้ช่วย AI เกี่ยวกับบัญชีโฆษณาของคุณได้

1

ตั้งค่า Claude Desktop

แก้ไข claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) แล้วเพิ่ม:

# Claude Desktop config: ~/.../claude_desktop_config.json
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": {
        "ADWHIZ_API_KEY": "dxk_live_..."
      }
    }
  }
}
2

ตั้งค่า Cursor

ผ่าน .cursor/mcp.json ระดับโปรเจกต์ หรือการตั้งค่าส่วนกลาง:

# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": { "ADWHIZ_API_KEY": "dxk_live_..." }
    }
  }
}
3

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

รีสตาร์ต Claude หรือ Cursor แล้วลองพรอมต์นี้ หากเห็น AI เรียก list_ad_accounts หรือ list_recommendations แล้วส่งข้อมูลจริงของคุณกลับมา แสดงว่าเชื่อมต่อสำเร็จแล้ว

ถาม Claude:

“แสดงรายการบัญชีโฆษณาที่ฉันเชื่อมต่อไว้ และสรุปคำแนะนำที่ยังเปิดอยู่ของ AI ว่าแนะนำให้ปรับแคมเปญไหน และเพราะอะไร”

แค็ตตาล็อกเครื่องมือ

เซิร์ฟเวอร์ MCP มีเครื่องมือ 5 รายการ ทั้งหมดเป็นแบบอ่านอย่างเดียว ทุกเครื่องมือมี JSON Schema ครบถ้วน AI จึงตัดสินใจได้เองว่าจะเรียกเครื่องมือใดเมื่อใด

list_ad_accounts

อ่านอย่างเดียว

บัญชี Google Ads, Meta Ads และ TikTok Ads ที่เชื่อมต่อไว้ พร้อมสถานะการเชื่อมต่อ

list_recommendations

อ่านอย่างเดียว

คำแนะนำการปรับประสิทธิภาพที่ยังเปิดอยู่ของ AI (เพิ่มงบประมาณ ลดงบประมาณ หยุดชั่วคราว) พร้อมเหตุผล ผลกระทบที่คาดไว้ และระดับความมั่นใจ

get_savings_summary

อ่านอย่างเดียว

สรุปเงินที่ประหยัดได้: ลิงก์ไปยังตัวเลขเงินที่ประหยัดได้บนแดชบอร์ด พร้อมแพ็กเกจของคุณ

get_recent_activity

อ่านอย่างเดียว

กิจกรรมล่าสุดของบัญชี: การเข้าสู่ระบบ การเปลี่ยนแปลง API key การเชื่อมต่อบัญชีโฆษณา และการเปลี่ยนแปลงการสมัครสมาชิก

get_quota

อ่านอย่างเดียว

ขีดจำกัด API ปัจจุบัน: จำนวนคำขอต่อนาที จำนวนที่เหลือ และเวลารีเซ็ต

ไคลเอนต์ AI ของคุณแสดงรายการเครื่องมือชุดเดียวกันพร้อมพารามิเตอร์ได้ผ่านคำขอ tools/list มาตรฐานของ MCP

ตัวอย่างเซสชัน

ตัวอย่างบทสนทนา (ข้อมูลสมมติ) ที่แสดงให้เห็นว่าการเข้าถึงแบบอ่านอย่างเดียวเป็นอย่างไร:

ฉันเชื่อมต่อบัญชีโฆษณาอะไรไว้กับ AdWhiz บ้าง

คุณมีบัญชีที่เชื่อมต่อไว้ 3 บัญชี ได้แก่ Google Ads, Meta Ads และ TikTok Ads อย่างละหนึ่งบัญชี ทั้งสามบัญชีอยู่ในสถานะเชื่อมต่อแล้ว

list_ad_accounts

ตอนนี้ AI แนะนำอะไรบ้าง

มีคำแนะนำที่ยังเปิดอยู่ 2 รายการ: ① ลดงบประมาณรายวันของแคมเปญ Meta “Lookalike 1%” เพราะ ROAS ต่ำกว่าค่าเฉลี่ยของบัญชีมาตลอดสัปดาห์ที่ผ่านมา ② เพิ่มงบประมาณของแคมเปญ TikTok Spark Ads หนึ่งแคมเปญ แต่ละรายการมีเหตุผลและระดับความมั่นใจกำกับไว้ หากต้องการนำไปใช้ ให้ทำในแพลตฟอร์มโฆษณาของคุณ ส่วนตรงนี้ฉันเปลี่ยนแปลงอะไรไม่ได้

list_recommendations

ช่วงนี้บัญชีของฉันมีอะไรเปลี่ยนไปไหม

ใน 7 วันที่ผ่านมา: เข้าสู่ระบบ 2 ครั้ง สร้าง API key ใหม่ 1 รายการ และเชื่อมต่อบัญชี TikTok Ads ใหม่ ไม่มีรายการอื่นที่บันทึกไว้

get_recent_activity

ความปลอดภัยและสิทธิ์

  • เครื่องมือทั้ง 5 รายการเป็นแบบอ่านอย่างเดียว AI ดูข้อมูลของคุณได้ แต่เปลี่ยนงบประมาณ หยุดโฆษณาชั่วคราว หรือสร้างแคมเปญไม่ได้
  • เซิร์ฟเวอร์ MCP ทำงานบนเครื่องของคุณ — API key dxk_ จะไม่ถูกส่งออกไปยังบุคคลที่สาม
  • การเรียกยืนยันตัวตนด้วย API key ของคุณ และใช้ขีดจำกัด REST API ตามแพ็กเกจร่วมกัน (ตรวจสอบได้ด้วย get_quota)
  • การเปลี่ยนแปลงแคมเปญคุณเป็นผู้ทำเอง ไม่ใช่ผ่าน MCP
  • เพิกถอนสิทธิ์เข้าถึง MCP ได้ทุกเมื่อที่แดชบอร์ด → การตั้งค่า → API Keys