Postiz MCP

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, 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ỳ ứng dụng 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 với 11 công cụ cho các tác nhân AI. Tác nhân sẽ khám phá các công cụ này, hiểu cấu trúc của chúng và gọi chúng thay cho 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à cấu trú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, soạn thảo 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ụ: các giọng đọc có sẵn)
generateVideoTool	Tạo video cho bài đăng

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 dưới dạng 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 dưới dạng mã thông báo Bearer:

```
URL: https://api.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:

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

Ví dụ nhanh

Đây là một tương tác đ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à 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 chính xác

Tất cả điều này diễn 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 đăng bài lên X vào 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ỉ 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 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) - 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 ứng dụng 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 Settings → Developers → Public API, mọi ứng dụng 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 ứng dụng khách và kết nối lại.

Tự lưu trữ: làm thế 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). Reverse proxy của bạn phải chuyển tiếp các đường dẫn này đến backend và hỗ trợ HTTP streaming (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ì chưa. 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 nào đượ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.