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ê 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ụ đượ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 bằng ngôn ngữ tự nhiên.

Cách thức hoạt động

Postiz cung cấp một máy chủ MCP cung cấp 9 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ả cá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ả các nhóm (khách hàng) cho tổ chức của bạn
integrationSchema	Lấy lược đồ quy tắc và cài đặt đăng bài cụ thể cho nền tảng
triggerTool	Thực thi các trình trợ giúp cụ thể cho nền tảng (ví dụ: liệt kê kênh Discord)
schedulePostTool	Lên lịch, nháp hoặc xuất bản ngay lập tức các bài đă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 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

Xác thực

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

Khóa API

Lấy khóa API của bạn từ Cài đặt > Nhà phát triển > API công khai trong Postiz. 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 thức 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ủa bạn được nhúng trong URL:

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

Đối với các phiên bản tự lưu trữ, thay thế `https://api.postiz.com` bằng `NEXT_PUBLIC_BACKEND_URL` của bạn.

Ví dụ nhanh

Đây là giao diện của 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" — 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 một bài đăng lên X vào 10 giờ sáng mai: Rất vui mừng thông báo 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 — 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) 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 được xoay vòng?

Khóa API Postiz không tự động xoay vòng, nhưng nếu bạn tạo lại một 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ủa nó. Cập nhật URL hoặc tiêu đề Authorization trong cấu hình máy khách của bạn 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 (được bảo vệ bởi 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 streaming (Transfer-Encoding: chunked). Xem Proxy ngược.

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 là 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. Việc trả lời bình luận phải được kích hoạt thông qua giao diện người dùng Postiz.