Postiz MCP
chính thứcHợ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ả |
|---|---|
integrationList | Liệ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) |
groupList | Liệt kê tất cả nhóm (khách hàng) trong tổ chức của bạn |
integrationConnectTool | Lấy liên kết để kết nối tài khoản mạng xã hội mới |
integrationSchema | Lấy quy tắc đăng bài và lược đồ cài đặt dành riêng cho từng nền tảng |
triggerTool | Thự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) |
schedulePostTool | Lên lịch, lưu nháp hoặc đăng bài ngay lập tức |
postsListTool | Liệ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) |
postSettingsTool | Cậ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 |
generateImageTool | Tạo hình ảnh AI cho bài đăng |
generateVideoOptions | Liệt kê các tùy chọn tạo video hiện có |
videoFunctionTool | Lấy cài đặt trình tạo video (ví dụ: các giọng đọc hiện có) |
generateVideoTool | Tạo video cho bài đăng |
clippingTool | Chuyể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 |
clippingStatusTool | Kiể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
/mcpvới khóa API hoặc token OAuth làm Bearer token:URL: https://mcp.postiz.com/mcp Authorization: Bearer your-api-keyPhươ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/:apiKeyvớ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:
- 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.) - Tác nhân gọi
integrationSchemavớiplatform: "x"và tìm hiểu giới hạn ký tự, cài đặt và quy tắc của X - 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.