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:
- เอเจนต์เรียก
integrationListเพื่อรับบัญชีที่เชื่อมต่อของคุณ (X, LinkedIn ฯลฯ) - เอเจนต์เรียก
integrationSchemaพร้อมplatform: "x"เพื่อเรียนรู้ข้อจำกัดจำนวนอักขระ การตั้งค่า และกฎของ X - เอเจนต์เรียก
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 ซึ่งเป็นแพลตฟอร์มเอกสารสำหรับนักพัฒนา