Postiz MCP

บทนำ

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

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

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

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

Postiz เปิดเผย MCP server ที่ให้ 11 เครื่องมือ แก่ AI agents ตัว agent จะค้นพบเครื่องมือเหล่านี้ เข้าใจ schema ของมัน และเรียกใช้แทนคุณ

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	แสดงรายการกลุ่ม (ลูกค้า) ทั้งหมดสำหรับองค์กรของคุณ
integrationSchema	รับกฎการโพสต์และ schema การตั้งค่าที่เฉพาะเจาะจงของแพลตฟอร์ม
triggerTool	ดำเนินการตัวช่วยเฉพาะแพลตฟอร์ม (เช่น แสดงรายการช่อง Discord)
schedulePostTool	กำหนดเวลา ร่าง หรือเผยแพร่โพสต์ทันที
postsListTool	แสดงรายการโพสต์ขององค์กรที่กำหนดเวลาไว้ระหว่างสองวันที่ (พร้อมการตั้งค่าปัจจุบัน)
postSettingsTool	อัปเดตการตั้งค่าผู้ให้บริการของโพสต์ที่กำหนดเวลาหรือร่างที่ยังไม่ได้เผยแพร่
generateImageTool	สร้างรูปภาพ AI สำหรับโพสต์
generateVideoOptions	แสดงรายการตัวเลือกการสร้างวิดีโอที่มีให้
videoFunctionTool	รับการตั้งค่าตัวสร้างวิดีโอ (เช่น เสียงที่มีให้)
generateVideoTool	สร้างวิดีโอสำหรับโพสต์

การรับรองความถูกต้อง

มีสองวิธีในการรับรองความถูกต้องกับ MCP server:

คีย์ API

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

โทเค็น OAuth

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

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

ใช้ endpoint `/mcp` กับคีย์ API หรือโทเค็น OAuth ของคุณเป็น Bearer token:

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

วิธีนี้รองรับทั้งคีย์ API และโทเค็น OAuth (นำหน้าด้วย `pos_`)

ใช้ endpoint `/mcp/:apiKey` โดยฝังคีย์ API ของคุณใน URL:

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

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

นี่คือลักษณะการโต้ตอบทั่วไปเมื่อ AI agent ใช้ Postiz MCP:

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

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

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

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

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

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

จะเกิดอะไรขึ้นเมื่อคีย์ API ของฉันหมดอายุหรือถูกหมุนเวียน?

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

โฮสต์เอง: ฉันจะเปิดเผย MCP endpoint ได้อย่างไร?

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

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

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