Postiz MCP

Giới thiệu

Kết nối các tác nhân AI với Postiz bằng Giao thức Ngữ cảnh Mô hình (MCP)

MCP (Giao thức Ngữ cảnh Mô hình) 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 video ngắn, tất cả thông qua giao diện gọi công 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ỳ máy khách tương thích MCP nào với tài khoản Postiz của mình và quản lý mạng xã hội thông qua ngôn ngữ tự nhiên.

Cách Hoạt Động

Postiz cung cấp một máy chủ MCP cung cấp 13 công cụ cho các tác nhân AI. Tác nhân khám phá các công cụ này, hiểu lược đồ của chúng và gọi chúng thay mặt 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ụ Có Sẵn

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) cho tổ chức của bạn
integrationSchema	Lấy quy tắc đăng bài và lược đồ cài đặt theo từng nền tảng
triggerTool	Thực thi các trình trợ giúp theo nền tảng (ví dụ: liệt kê kênh Discord)
schedulePostTool	Lên lịch, lưu nháp hoặc xuất bản bài đăng ngay lập tức
postsListTool	Liệt kê các bài đăng của tổ chức được lên lịch giữa hai ngày (kèm cài đặt hiện tại của chúng)
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 xuất bản
generateImageTool	Tạo hình ảnh AI cho bài đăng
generateVideoOptions	Liệt kê các tùy chọn tạo video có sẵn
videoFunctionTool	Lấy cài đặt trình tạo video (ví dụ: giọng nói có sẵn)
generateVideoTool	Tạo video cho bài đăng
clippingTool	Chuyển video YouTube dài thành clip dọc có phụ đề và tạo bài đăng nháp
clippingStatusTool	Kiểm tra quá trình cắt và lấy các clip hoàn chỉnh

Xác Thực

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

Khóa API

Sử dụng trực tiếp trong URL điểm cuối MCP hoặc làm mã thông báo Bearer.

Mã Thông Báo OAuth

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

Kết Nối

Sử dụng điểm cuối `/mcp` với khóa API hoặc mã thông báo OAuth của bạn làm mã thông báo Bearer:

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

Phương pháp này hỗ trợ cả khóa API và mã thông báo OAuth (có tiền tố `pos_`).

Sử dụng điểm cuối `/mcp/:apiKey` với khóa API được nhúng trong URL:

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

Ví Dụ Nhanh

Đây là giao diện điển hình khi một tác nhân AI sử dụng Postiz MCP:

1. Tác nhân gọi integrationList, nhận lại 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à học được 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 chính xác

Tất cả điều này xảy ra tự động khi bạn nói với tác nhân AI của mình điều gì đó như:

"Lên lịch bài đăng cho X vào lúc 10 giờ sáng mai: Rất vui được công bố 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ỉ hiển thị các công cụ của Postiz. Máy khách AI của bạn (Claude, ChatGPT, Cursor, v.v.) cung cấp mô hình. Postiz chỉ cần OPENAI_API_KEY nếu bạn sử dụng các tính năng AI của riêng Postiz (tạo hình ảnh, copilot) — các tính năng này tách biệt với các công cụ MCP được hiển thị cho máy khách của bạn.

Điều gì xảy ra khi khóa API của tôi hết hạn hoặc bị xoay vòng?

Khóa API Postiz không tự động xoay vòng, nhưng nếu bạn tạo lại khóa trong Cài đặt → Nhà phát triển → API công khai, mọi máy khách MCP sử dụng khóa cũ sẽ ngừng hoạt động cho đến khi bạn cập nhật cấu hình. Cập nhật URL hoặc tiêu đề Authorization trong cấu hình máy khách và kết nối lại.

Tự lưu trữ: làm cách nào để hiển thị điểm cuối MCP?

Máy chủ MCP khởi động như một phần của backend Postiz và có thể truy cập tại /mcp (xác thực Bearer), /mcp/:apiKey (khóa trong URL) và /mcp-oauth (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 backend và hỗ trợ HTTP phát trực tuyến (Transfer-Encoding: chunked). Xem Reverse Proxies.

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

Hiện tại thì không. Bộ công cụ hiện tại chỉ đọc trên các tích hợp và chỉ ghi trên bài đăng/phương tiện. Không có getComments hoặc replyToComment được hiển thị qua MCP. Trả lời bình luận phải được kích hoạt 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.