Postiz MCP

ทางการ

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

ดูบน postiz.pro

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

  • List connected social accounts — Ask the agent to retrieve all your linked platforms with integrationList, optionally filtered by customer group.
  • Check platform posting rules — Use integrationSchema to get character limits, supported media types, and settings for a specific platform before posting.
  • Schedule or publish posts — Create, draft, or immediately publish social media posts via schedulePostTool with platform-specific formatting.
  • Generate AI images for posts — Produce images directly through generateImageTool to attach to scheduled content.
  • Generate videos for posts — Explore available video options with generateVideoOptions and videoFunctionTool, then create videos using generateVideoTool.

เอกสาร

บทนำ

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

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

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

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

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

การตรวจสอบสิทธิ์

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

API Key

รับ API key ของคุณจาก Settings > Developers > Public API ใน Postiz ใช้โดยตรงใน URL ปลายทาง MCP หรือเป็น Bearer token

OAuth Token

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

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

ใช้ปลายทาง `/mcp` พร้อมกับ API key หรือ OAuth token ของคุณเป็น Bearer token: 
```
URL: https://api.postiz.com/mcp
Authorization: Bearer your-api-key
```

วิธีนี้รองรับทั้ง API key และ OAuth token (ที่ขึ้นต้นด้วย `pos_`)
ใช้ปลายทาง `/mcp/:apiKey` พร้อมกับ API key ของคุณที่ฝังอยู่ใน URL: 
```
URL: https://api.postiz.com/mcp/your-api-key
```
สำหรับอินสแตนซ์ที่โฮสต์เอง ให้แทนที่ `https://api.postiz.com` ด้วย `NEXT_PUBLIC_BACKEND_URL` ของคุณ

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

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

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

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

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

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

ฉันจำเป็นต้องใช้ OpenAI key เพื่อใช้ 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 ได้อย่างไร?

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

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

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