Postiz MCP
공식소셜 미디어를 Postiz로 간소화하세요. 게시물을 예약하고, 성과를 분석하며, 모든 계정을 한 곳에서 관리할 수 있습니다.
Postiz MCP(으)로 무엇을 할 수 있나요?
- 연결된 계정 목록 조회 — 에이전트에게 연결된 소셜 미디어 계정 목록을 요청합니다. 필요하면 그룹별로 필터링할 수 있습니다.
- 플랫폼 규칙 확인 — 게시물을 작성하기 전에 플랫폼별 게시 규칙과 설정 스키마를 확인합니다.
- 게시물 예약 또는 게시 — 연결된 계정에 게시물을 예약하거나 초안으로 저장하거나 즉시 게시합니다.
- 예약된 게시물 검토 — 두 날짜 사이에 예약된 조직의 게시물과 현재 설정을 확인합니다.
- 미디어 생성 — 게시물에 사용할 AI 이미지나 동영상을 생성하고, 사용 가능한 동영상 생성 옵션을 확인합니다.
- 긴 동영상 클립으로 만들기 — 긴 YouTube 동영상을 자막이 포함된 세로형 클립과 게시물 초안으로 만들고, 클립 생성 상태를 확인합니다.
문서
소개
Model Context Protocol (MCP)을 사용해 AI 에이전트를 Postiz에 연결하세요
MCP(Model Context Protocol)를 사용하면 AI 에이전트가 Postiz와 직접 상호작용할 수 있습니다. 통합을 나열하고, 게시물을 예약하고, 이미지와 동영상을 생성하고, 긴 동영상을 짧은 클립으로 자를 수 있으며, 이 모든 작업을 표준화된 도구 호출 인터페이스를 통해 수행합니다.
즉, Claude, ChatGPT, Cursor 또는 MCP와 호환되는 클라이언트를 Postiz 계정에 연결하고 자연어로 소셜 미디어를 관리할 수 있습니다.
작동 방식
Postiz는 AI 에이전트에 13개의 도구를 제공하는 MCP 서버를 노출합니다. 에이전트는 이러한 도구를 검색하고 스키마를 파악한 다음 사용자를 대신해 호출합니다.
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
사용 가능한 도구
| 도구 | 설명 |
|---|---|
integrationList | 연결된 모든 소셜 미디어 계정을 나열합니다(그룹별 필터링 가능). |
groupList | 조직의 모든 그룹(고객)을 나열합니다. |
integrationConnectTool | 새 소셜 미디어 계정을 연결하기 위한 링크를 가져옵니다. |
integrationSchema | 플랫폼별 게시 규칙과 설정 스키마를 가져옵니다. |
triggerTool | 플랫폼별 도우미를 실행합니다(예: Discord 채널 나열). |
schedulePostTool | 게시물을 예약하거나 초안으로 저장하거나 즉시 게시합니다. |
postsListTool | 두 날짜 사이에 예약된 조직의 게시물을 현재 설정과 함께 나열합니다. |
postSettingsTool | 아직 게시되지 않은 예약 게시물 또는 초안의 제공자 설정을 업데이트합니다. |
generateImageTool | 게시물용 AI 이미지를 생성합니다. |
generateVideoOptions | 사용 가능한 동영상 생성 옵션을 나열합니다. |
videoFunctionTool | 동영상 생성기 설정을 가져옵니다(예: 사용 가능한 음성). |
generateVideoTool | 게시물용 동영상을 생성합니다. |
clippingTool | 긴 YouTube 동영상을 자막이 포함된 세로형 클립으로 만들고 게시물 초안을 작성합니다. |
clippingStatusTool | 클립 생성 작업을 확인하고 완성된 클립을 가져옵니다. |
인증
MCP 서버에 인증하는 방법은 두 가지입니다.
API 키
MCP 엔드포인트 URL에 직접 사용하거나 Bearer 토큰으로 사용하세요.
OAuth 토큰
다른 Postiz 사용자를 위한 앱을 개발하는 경우 OAuth2를 사용해 토큰을 발급받으세요. OAuth 토큰은 pos_로 시작하며 API 키와 동일하게 작동합니다.
연결
[tab] Bearer 토큰
/mcp엔드포인트에 API 키 또는 OAuth 토큰을 Bearer 토큰으로 사용하세요.URL: https://mcp.postiz.com/mcp Authorization: Bearer your-api-key이 방법은 API 키와 OAuth 토큰을 모두 지원합니다(
pos_접두사 사용).
[tab] URL에 API 키 포함
URL에 API 키를 포함해
/mcp/:apiKey엔드포인트를 사용하세요.URL: https://mcp.postiz.com/mcp/your-api-key
빠른 예시
AI 에이전트가 Postiz MCP를 사용할 때 일반적으로 다음과 같이 상호작용합니다.
- 에이전트가
integrationList를 호출해 연결된 계정(X, LinkedIn 등)을 가져옵니다. - 에이전트가
integrationSchema을platform: "x"와 함께 호출해 X의 글자 수 제한, 설정 및 규칙을 파악합니다. - 에이전트가
schedulePostTool를 호출해 올바른 형식으로 게시물을 예약합니다.
AI 에이전트에게 다음과 같이 말하면 이 모든 과정이 자동으로 진행됩니다.
"내일 오전 10시에 X에 게시물을 예약해 줘: 새로운 기능을 발표하게 되어 기쁩니다!"
FAQ
Postiz MCP를 사용하려면 OpenAI 키가 필요한가요?
아니요. MCP 서버는 Postiz의 도구를 노출할 뿐입니다. 모델은 AI 클라이언트(Claude, ChatGPT, Cursor 등)가 제공합니다. Postiz 자체 AI 기능(이미지 생성, 코파일럿)을 사용하는 경우에만 OPENAI_API_KEY이 필요합니다. 이러한 기능은 클라이언트에 노출되는 MCP 도구와는 별개입니다.
API 키가 만료되거나 교체되면 어떻게 되나요?
Postiz API 키는 자동으로 교체되지 않습니다. 하지만 Settings → Developers → Public API에서 키를 새로 생성하면 이전 키를 사용하는 모든 MCP 클라이언트는 설정을 업데이트할 때까지 작동하지 않습니다. 클라이언트 설정에서 URL 또는 Authorization 헤더를 업데이트한 다음 다시 연결하세요.
자체 호스팅: MCP 엔드포인트를 어떻게 노출하나요?
MCP 서버는 Postiz 백엔드의 일부로 시작되며 /mcp(Bearer 인증), /mcp/:apiKey(URL에 키 포함), /mcp-oauth(OAuth 보호)에서 접근할 수 있습니다. 리버스 프록시는 이러한 경로를 백엔드로 전달하고 스트리밍 HTTP(Transfer-Encoding: chunked)를 지원해야 합니다. 리버스 프록시를 참조하세요.
MCP로 댓글을 읽거나 답글을 달 수 있나요?
현재는 불가능합니다. 현재 도구 모음은 통합에 대해서는 읽기 전용이고 게시물 및 미디어에 대해서는 쓰기 전용입니다. MCP를 통해 노출되는 getComments 또는 replyToComment은 없습니다. 댓글 답글은 Postiz UI에서 실행해야 합니다.
이 문서는 개발자 문서 플랫폼인 Mintlify에서 빌드 및 호스팅됩니다.