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 ที่มีเครื่องมือ 13 รายการ สำหรับ AI agents โดย agent จะค้นพบเครื่องมือเหล่านี้ เข้าใจโครงสร้างข้อมูล และเรียกใช้แทนคุณ

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

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

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

API Key

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

OAuth Token

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

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

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

```text theme={null}
URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key
```

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

ใช้ endpoint `/mcp/:apiKey` พร้อมฝัง API key ใน URL:

```text theme={null}
URL: https://mcp.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 key เพื่อใช้ Postiz MCP หรือไม่?

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

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

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

Self-hosted: ฉันจะเปิดเผย MCP endpoint ได้อย่างไร?

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

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

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

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