Postiz MCP

공식

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

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

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

연결된 계정 목록 보기 — 어시스턴트에게 integrationList를 사용해 연결된 모든 소셜 미디어 프로필을 표시하도록 요청하세요. 선택적으로 그룹으로 필터링할 수 있습니다.
게시물 예약 또는 게시 — 어시스턴트에게 schedulePostTool을 사용해 초안 작성, 예약, 또는 즉시 게시를 지시하세요.
AI 이미지 생성 — generateImageTool을 통해 게시물용 AI 생성 이미지를 직접 요청하세요.
비디오 클립 만들기 — 긴 YouTube 비디오를 자막이 있는 세로형 숏폼으로 변환하고 clippingTool을 사용해 게시물 초안을 작성하세요.
플랫폼 규칙 확인 — 예약 전에 integrationSchema를 통해 특정 플랫폼의 게시 제한 및 설정을 문의하세요.

문서

소개

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`	조직의 모든 그룹(고객) 나열
`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 키와 동일한 방식으로 작동합니다.

연결

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

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

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

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

```text theme={null}
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 키는 자동으로 회전되지 않지만, 설정 → 개발자 → 공개 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에서 구축 및 호스팅됩니다.