Postiz MCP

ทางการ

ปรับโซเชียลมีเดียของคุณให้คล่องตัวด้วย Postiz จัดตารางโพสต์ วิเคราะห์ประสิทธิภาพ และจัดการบัญชีทั้งหมดในที่เดียว

คุณทำอะไรได้บ้างด้วย Postiz MCP?

  • แสดงรายการบัญชีที่เชื่อมต่อ — ขอให้เอเจนต์แสดงรายการบัญชีโซเชียลมีเดียที่เชื่อมต่อของคุณ โดยเลือกกรองตามกลุ่มได้
  • ตรวจสอบกฎของแพลตฟอร์ม — ดูกฎการโพสต์และสคีมาการตั้งค่าเฉพาะของแต่ละแพลตฟอร์มก่อนร่างโพสต์
  • ตั้งเวลาหรือเผยแพร่โพสต์ — ตั้งเวลา บันทึกเป็นฉบับร่าง หรือเผยแพร่โพสต์ไปยังบัญชีที่เชื่อมต่อทันที
  • ตรวจสอบโพสต์ที่ตั้งเวลาไว้ — แสดงรายการโพสต์ขององค์กรที่ตั้งเวลาไว้ระหว่างวันที่สองวัน พร้อมการตั้งค่าปัจจุบัน
  • สร้างสื่อ — สร้างภาพหรือวิดีโอด้วย AI สำหรับโพสต์ และแสดงรายการตัวเลือกการสร้างวิดีโอที่มี
  • ตัดคลิปวิดีโอยาว — เปลี่ยนวิดีโอ YouTube แบบยาวให้เป็นคลิปแนวตั้งพร้อมคำบรรยายและโพสต์ฉบับร่าง จากนั้นตรวจสอบสถานะการตัดคลิป

เอกสาร

บทนำ

เชื่อมต่อเอเจนต์ AI กับ Postiz โดยใช้ Model Context Protocol (MCP)

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

ซึ่งหมายความว่าคุณสามารถเชื่อมต่อ Claude, ChatGPT, Cursor หรือไคลเอ็นต์อื่นที่รองรับ MCP กับบัญชี Postiz ของคุณ และจัดการโซเชียลมีเดียด้วยภาษาธรรมชาติได้

วิธีการทำงาน

Postiz เปิดให้บริการเซิร์ฟเวอร์ MCP ซึ่งมี 13 เครื่องมือ สำหรับเอเจนต์ AI เอเจนต์จะค้นพบเครื่องมือเหล่านี้ ทำความเข้าใจสคีมา แล้วเรียกใช้เครื่องมือแทนคุณ

sequenceDiagram
    participant Agent as AI Agent
    participant MCP as Postiz MCP Server
    participant Postiz as Postiz Backend

    Agent->>MCP: Connect with API key / OAuth token
    MCP-->>Agent: List available tools
    Agent->>MCP: Call tool (e.g., schedule post)
    MCP->>Postiz: Execute action
    Postiz-->>MCP: Return result
    MCP-->>Agent: Tool response

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

เครื่องมือคำอธิบาย
integrationListแสดงรายการบัญชีโซเชียลมีเดียที่เชื่อมต่อทั้งหมด (เลือกกรองตามกลุ่มได้)
groupListแสดงรายการกลุ่มทั้งหมด (ลูกค้า) ในองค์กรของคุณ
integrationConnectToolรับลิงก์สำหรับเชื่อมต่อบัญชีโซเชียลมีเดียใหม่
integrationSchemaรับกฎการโพสต์และสคีมาการตั้งค่าเฉพาะแพลตฟอร์ม
triggerToolเรียกใช้ตัวช่วยเฉพาะแพลตฟอร์ม (เช่น แสดงรายการช่อง Discord)
schedulePostToolตั้งเวลา บันทึกฉบับร่าง หรือเผยแพร่โพสต์ทันที
postsListToolแสดงรายการโพสต์ขององค์กรที่ตั้งเวลาไว้ระหว่างวันที่สองวันที่ระบุ (พร้อมการตั้งค่าปัจจุบัน)
postSettingsToolอัปเดตการตั้งค่าของผู้ให้บริการสำหรับโพสต์ที่ตั้งเวลาไว้หรือฉบับร่างที่ยังไม่ได้เผยแพร่
generateImageToolสร้างรูปภาพด้วย AI สำหรับโพสต์
generateVideoOptionsแสดงรายการตัวเลือกการสร้างวิดีโอที่มีให้ใช้งาน
videoFunctionToolรับการตั้งค่าตัวสร้างวิดีโอ (เช่น เสียงพูดที่มีให้เลือก)
generateVideoToolสร้างวิดีโอสำหรับโพสต์
clippingToolเปลี่ยนวิดีโอ YouTube ขนาดยาวให้เป็นคลิปแนวตั้งพร้อมคำบรรยาย และสร้างโพสต์ฉบับร่าง
clippingStatusToolตรวจสอบงานตัดคลิปและรับคลิปที่เสร็จแล้ว

การยืนยันตัวตน

มีสองวิธีในการยืนยันตัวตนกับเซิร์ฟเวอร์ MCP:

API Key

ใช้คีย์นี้โดยตรงใน URL ของ MCP endpoint หรือใช้เป็น Bearer token

OAuth Token

หากคุณกำลังสร้างแอปสำหรับผู้ใช้ Postiz รายอื่น ให้ใช้ OAuth2 เพื่อรับโทเค็น OAuth จะขึ้นต้นด้วย pos_ และใช้งานได้เช่นเดียวกับ API key

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

[tab] Bearer Token

ใช้ endpoint /mcp พร้อม API key หรือ OAuth token ของคุณในรูปแบบ Bearer token:

URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key

วิธีนี้รองรับทั้ง API key และ OAuth token (ที่ขึ้นต้นด้วย pos_)

[tab] API Key in URL

ใช้ endpoint /mcp/:apiKey โดยฝัง API key ไว้ใน URL:

URL: https://mcp.postiz.com/mcp/your-api-key

ตัวอย่างแบบรวดเร็ว

ตัวอย่างต่อไปนี้แสดงการโต้ตอบทั่วไปเมื่อเอเจนต์ AI ใช้ Postiz MCP:

  1. เอเจนต์เรียก integrationList เพื่อรับบัญชีที่เชื่อมต่อของคุณ (X, LinkedIn ฯลฯ)
  2. เอเจนต์เรียก integrationSchema พร้อม platform: "x" เพื่อเรียนรู้ข้อจำกัดจำนวนอักขระ การตั้งค่า และกฎของ X
  3. เอเจนต์เรียก schedulePostTool เพื่อตั้งเวลาโพสต์ของคุณด้วยรูปแบบที่ถูกต้อง

ทั้งหมดนี้เกิดขึ้นโดยอัตโนมัติเมื่อคุณบอกเอเจนต์ AI เช่น:

"ตั้งเวลาโพสต์บน X สำหรับพรุ่งนี้เวลา 10am: ตื่นเต้นที่จะประกาศฟีเจอร์ใหม่ของเรา!"

คำถามที่พบบ่อย

ต้องมีคีย์ OpenAI เพื่อใช้ Postiz MCP หรือไม่?

ไม่ เซิร์ฟเวอร์ MCP เพียงเปิดให้ใช้เครื่องมือของ Postiz ไคลเอ็นต์ AI ของคุณ (Claude, ChatGPT, Cursor ฯลฯ) เป็นผู้ให้บริการโมเดล Postiz ต้องใช้ OPENAI_API_KEY เฉพาะเมื่อคุณใช้ฟีเจอร์ AI ของ Postiz เอง (การสร้างรูปภาพ, copilot) ซึ่งแยกจากเครื่องมือ MCP ที่เปิดให้ไคลเอ็นต์ของคุณใช้งาน

จะเกิดอะไรขึ้นเมื่อ API key หมดอายุหรือถูกเปลี่ยน?

API key ของ Postiz จะไม่เปลี่ยนโดยอัตโนมัติ แต่หากคุณสร้างคีย์ใหม่ใน Settings → Developers → Public API ไคลเอ็นต์ MCP ทุกตัวที่ใช้คีย์เก่าจะหยุดทำงานจนกว่าคุณจะอัปเดตการตั้งค่า ให้อัปเดต URL หรือส่วนหัว Authorization ในการตั้งค่าไคลเอ็นต์ แล้วเชื่อมต่อใหม่

โฮสต์เอง: จะเปิดให้เข้าถึง MCP endpoint ได้อย่างไร?

เซิร์ฟเวอร์ MCP จะเริ่มทำงานเป็นส่วนหนึ่งของแบ็กเอนด์ Postiz และเข้าถึงได้ที่ /mcp (การยืนยันตัวตนแบบ Bearer), /mcp/:apiKey (ใส่คีย์ใน URL) และ /mcp-oauth (ป้องกันด้วย OAuth) พร็อกซีย้อนกลับของคุณต้องส่งต่อพาธเหล่านี้ไปยังแบ็กเอนด์และรองรับ HTTP แบบสตรีม (Transfer-Encoding: chunked) ดู พร็อกซีย้อนกลับ

MCP อ่านหรือตอบกลับความคิดเห็นได้หรือไม่?

ยังไม่ได้ในตอนนี้ ชุดเครื่องมือปัจจุบันรองรับเฉพาะการอ่านข้อมูลการเชื่อมต่อ และรองรับเฉพาะการเขียนโพสต์/สื่อ ไม่มีการเปิดให้ใช้ getComments หรือ replyToComment ผ่าน MCP การตอบกลับความคิดเห็นต้องดำเนินการผ่าน UI ของ Postiz

เอกสารนี้สร้างและโฮสต์บน Mintlify ซึ่งเป็นแพลตฟอร์มเอกสารสำหรับนักพัฒนา