Postiz MCP

공식

소셜 미디어를 Postiz로 간소화하세요. 게시물을 예약하고, 성과를 분석하며, 모든 계정을 한 곳에서 관리할 수 있습니다.

postiz.pro에서 보기이 MCP 사용해 보기스폰서

Postiz MCP(으)로 무엇을 할 수 있나요?

Postiz MCP를 사용하면 AI 어시스턴트에게 소셜 미디어 게시물을 관리하고 미디어를 직접 생성하도록 요청할 수 있습니다.

연결된 계정 목록 보기 — integrationList를 통해 연결된 모든 소셜 미디어 계정을 요청할 수 있으며, 그룹별로 필터링할 수도 있습니다.
플랫폼 규칙 확인 — integrationSchema를 사용하여 X와 같은 플랫폼의 게시 규칙 및 설정을 가져옵니다.
게시물 예약 — schedulePostTool을 사용하여 게시물을 예약하거나 초안으로 저장하거나 즉시 게시할 수 있습니다.
예약된 게시물 목록 보기 — postsListTool을 사용하여 두 날짜 사이에 예약된 게시물을 확인합니다.
이미지 생성 — generateImageTool을 사용하여 게시물용 AI 이미지를 생성합니다.
비디오 생성 — generateVideoTool을 사용하여 비디오를 제작하며, generateVideoOptions의 옵션을 활용할 수 있습니다.

문서

소개

Model Context Protocol(MCP)을 사용하여 AI 에이전트를 Postiz에 연결하세요

MCP(Model Context Protocol)를 사용하면 AI 에이전트가 표준화된 도구 호출 인터페이스를 통해 통합 목록 확인, 게시물 예약, 이미지 및 비디오 생성 등 Postiz와 직접 상호작용할 수 있습니다.

즉, Claude, ChatGPT, Cursor 또는 MCP 호환 클라이언트를 Postiz 계정에 연결하고 자연어로 소셜 미디어를 관리할 수 있습니다.

작동 방식

Postiz는 AI 에이전트에게 11개의 도구를 제공하는 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`	조직의 모든 그룹(고객) 나열
`integrationSchema`	플랫폼별 게시 규칙 및 설정 스키마 가져오기
`triggerTool`	플랫폼별 헬퍼 실행(예: Discord 채널 나열)
`schedulePostTool`	게시물 예약, 초안 작성 또는 즉시 게시
`postsListTool`	두 날짜 사이에 예약된 조직의 게시물 나열(현재 설정 포함)
`postSettingsTool`	아직 게시되지 않은 예약 게시물 또는 초안의 공급자 설정 업데이트
`generateImageTool`	게시물용 AI 이미지 생성
`generateVideoOptions`	사용 가능한 비디오 생성 옵션 나열
`videoFunctionTool`	비디오 생성기 설정 가져오기(예: 사용 가능한 음성)
`generateVideoTool`	게시물용 비디오 생성

인증

MCP 서버에 인증하는 방법은 두 가지입니다:

API 키

MCP 엔드포인트 URL에 직접 사용하거나 Bearer 토큰으로 사용하세요.

OAuth 토큰

다른 Postiz 사용자를 위한 앱을 구축하는 경우 OAuth2를 사용하여 토큰을 얻으세요. OAuth 토큰은 pos_으로 시작하며 API 키와 동일한 방식으로 작동합니다.

연결

API 키 또는 OAuth 토큰을 Bearer 토큰으로 사용하여 `/mcp` 엔드포인트를 사용하세요:

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

이 방법은 API 키와 OAuth 토큰(접두사 `pos_`)을 모두 지원합니다.

URL에 API 키를 포함하여 `/mcp/:apiKey` 엔드포인트를 사용하세요:

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

빠른 예시

AI 에이전트가 Postiz MCP를 사용할 때 일반적인 상호작용은 다음과 같습니다:

에이전트가 integrationList을 호출하여 연결된 계정(X, LinkedIn 등)을 가져옵니다
에이전트가 platform: "x"와 함께 integrationSchema을 호출하여 X의 문자 제한, 설정 및 규칙을 파악합니다
에이전트가 schedulePostTool을 호출하여 올바른 형식으로 게시물을 예약합니다

다음과 같이 AI 에이전트에게 지시하면 이 모든 것이 자동으로 수행됩니다:

"내일 오전 10시에 X에 게시물을 예약해줘: 새로운 기능을 발표하게 되어 기쁩니다!"

FAQ

Postiz MCP를 사용하려면 OpenAI 키가 필요한가요?

아닙니다. MCP 서버는 Postiz의 도구를 노출할 뿐입니다. 모델은 AI 클라이언트(Claude, ChatGPT, Cursor 등)가 제공합니다. Postiz는 클라이언트에 노출되는 MCP 도구와 별개인 Postiz 자체 AI 기능(이미지 생성, copilot)을 사용할 때만 OPENAI_API_KEY이 필요합니다.

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)를 지원해야 합니다. Reverse Proxies를 참조하세요.

MCP가 댓글을 읽거나 답변할 수 있나요?

현재는 불가능합니다. 현재 도구 세트는 통합에 대해 읽기 전용이고 게시물/미디어에 대해 쓰기 전용입니다. MCP를 통해 노출되는 getComments 또는 replyToComment은 없습니다. 댓글 답변은 Postiz UI를 통해 수행해야 합니다.