Postiz MCP

chính thức

Hợp lý hóa mạng xã hội của bạn với Postiz. Lên lịch đăng bài, phân tích hiệu suất và quản lý tất cả tài khoản tại một nơi

Bạn có thể làm gì với Postiz MCP?

  • Liệt kê tài khoản đã kết nối — Yêu cầu agent liệt kê các tài khoản mạng xã hội đã kết nối của bạn, có thể lọc theo nhóm.
  • Kiểm tra quy tắc của nền tảng — Xem quy tắc đăng bài và lược đồ cài đặt riêng của từng nền tảng trước khi soạn bài.
  • Lên lịch hoặc đăng bài — Lên lịch, lưu dưới dạng bản nháp hoặc đăng ngay bài viết lên tài khoản đã kết nối.
  • Xem lại bài viết đã lên lịch — Liệt kê các bài viết của tổ chức bạn được lên lịch trong khoảng thời gian giữa hai ngày, cùng với cài đặt hiện tại.
  • Tạo nội dung đa phương tiện — Tạo hình ảnh hoặc video bằng AI cho bài viết và liệt kê các tùy chọn tạo video hiện có.
  • Cắt video dài — Chuyển video YouTube dài thành các đoạn video dọc có phụ đề và bài viết nháp, sau đó kiểm tra trạng thái cắt video.

Tài liệu

Giới thiệu

Kết nối các tác nhân AI với Postiz bằng Model Context Protocol (MCP)

MCP (Model Context Protocol) cho phép các tác nhân AI tương tác trực tiếp với Postiz, liệt kê các tích hợp, lên lịch bài đăng, tạo hình ảnh và video, cắt video dài thành các video ngắn, tất cả thông qua một giao diện gọi công cụ được chuẩn hóa.

Điều này có nghĩa là bạn có thể kết nối Claude, ChatGPT, Cursor hoặc bất kỳ ứng dụng khách nào tương thích với MCP với tài khoản Postiz của mình và quản lý mạng xã hội bằng ngôn ngữ tự nhiên.

Cách hoạt động

Postiz cung cấp một máy chủ MCP với 13 công cụ dành cho các tác nhân AI. Tác nhân sẽ khám phá các công cụ này, tìm hiểu lược đồ của chúng và gọi chúng thay bạn.

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

Các công cụ hiện có

Công cụMô tả
integrationListLiệt kê tất cả tài khoản mạng xã hội đã kết nối (có thể lọc theo nhóm)
groupListLiệt kê tất cả nhóm (khách hàng) trong tổ chức của bạn
integrationConnectToolLấy liên kết để kết nối tài khoản mạng xã hội mới
integrationSchemaLấy quy tắc đăng bài và lược đồ cài đặt dành riêng cho từng nền tảng
triggerToolThực thi các tiện ích dành riêng cho từng nền tảng (ví dụ: liệt kê các kênh Discord)
schedulePostToolLên lịch, lưu nháp hoặc đăng bài ngay lập tức
postsListToolLiệt kê các bài đăng của tổ chức được lên lịch trong khoảng thời gian giữa hai ngày (kèm cài đặt hiện tại)
postSettingsToolCập nhật cài đặt nhà cung cấp của bài đăng đã lên lịch hoặc bản nháp chưa được đăng
generateImageToolTạo hình ảnh AI cho bài đăng
generateVideoOptionsLiệt kê các tùy chọn tạo video hiện có
videoFunctionToolLấy cài đặt trình tạo video (ví dụ: các giọng đọc hiện có)
generateVideoToolTạo video cho bài đăng
clippingToolChuyển video YouTube dài thành các đoạn video dọc có phụ đề và tạo bản nháp bài đăng
clippingStatusToolKiểm tra quá trình cắt và lấy các đoạn video đã hoàn tất

Xác thực

Có hai cách xác thực với máy chủ MCP:

Khóa API

Dùng trực tiếp trong URL điểm cuối MCP hoặc làm Bearer token.

Token OAuth

Nếu bạn đang xây dựng ứng dụng cho những người dùng Postiz khác, hãy dùng OAuth2 để lấy token. Token OAuth bắt đầu bằng pos_ và hoạt động giống như khóa API.

Kết nối

[tab] Bearer Token

Dùng điểm cuối /mcp với khóa API hoặc token OAuth làm Bearer token:

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

Phương thức này hỗ trợ cả khóa API lẫn token OAuth (có tiền tố pos_).

[tab] API Key in URL

Dùng điểm cuối /mcp/:apiKey với khóa API được nhúng trong URL:

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

Ví dụ nhanh

Sau đây là ví dụ về một tương tác điển hình khi tác nhân AI sử dụng Postiz MCP:

  1. Tác nhân gọi integrationList, nhận về các tài khoản đã kết nối của bạn (X, LinkedIn, v.v.)
  2. Tác nhân gọi integrationSchema với platform: "x" và tìm hiểu giới hạn ký tự, cài đặt và quy tắc của X
  3. Tác nhân gọi schedulePostTool, lên lịch bài đăng của bạn với định dạng phù hợp

Tất cả diễn ra tự động khi bạn yêu cầu tác nhân AI như sau:

"Lên lịch đăng bài lên X vào ngày mai lúc 10 giờ sáng: Rất vui được thông báo về tính năng mới của chúng tôi!"

Câu hỏi thường gặp

Tôi có cần khóa OpenAI để sử dụng Postiz MCP không?

Không. Máy chủ MCP chỉ cung cấp các công cụ của Postiz. Ứng dụng khách AI của bạn (Claude, ChatGPT, Cursor, v.v.) cung cấp mô hình. Postiz chỉ cần một OPENAI_API_KEY nếu bạn sử dụng các tính năng AI riêng của Postiz (tạo hình ảnh, copilot), vốn tách biệt với các công cụ MCP được cung cấp cho ứng dụng khách của bạn.

Điều gì xảy ra khi khóa API hết hạn hoặc được thay mới?

Khóa API Postiz không tự động được thay mới, nhưng nếu bạn tạo lại khóa trong Settings → Developers → Public API, mọi ứng dụng khách MCP đang dùng khóa cũ sẽ ngừng hoạt động cho đến khi bạn cập nhật cấu hình. Hãy cập nhật URL hoặc tiêu đề Authorization trong cấu hình ứng dụng khách rồi kết nối lại.

Tự lưu trữ: làm cách nào để cung cấp điểm cuối MCP?

Máy chủ MCP khởi chạy cùng với phần phụ trợ Postiz và có thể truy cập tại /mcp (xác thực Bearer), /mcp/:apiKey (khóa trong URL) và /mcp-oauth (được bảo vệ bằng OAuth). Proxy ngược của bạn phải chuyển tiếp các đường dẫn này đến phần phụ trợ và hỗ trợ HTTP truyền luồng (Transfer-Encoding: chunked). Xem Reverse Proxies.

MCP có thể đọc hoặc trả lời bình luận không?

Hiện chưa thể. Bộ công cụ hiện tại chỉ có quyền đọc đối với các tích hợp và chỉ có quyền ghi đối với bài đăng/phương tiện. MCP không cung cấp getComments hoặc replyToComment. Bạn phải thực hiện trả lời bình luận thông qua giao diện Postiz.

Tài liệu này được xây dựng và lưu trữ trên Mintlify, một nền tảng tài liệu dành cho nhà phát triển.