Postiz MCP

공식

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

postiz.pro에서 보기

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

연결된 소셜 계정 목록 보기 — 에이전트에게 integrationList를 사용하여 연결된 모든 플랫폼을 검색하도록 요청하며, 고객 그룹별로 필터링할 수 있습니다.
플랫폼 게시 규칙 확인 — 게시 전에 integrationSchema를 사용하여 특정 플랫폼의 글자 수 제한, 지원 미디어 유형 및 설정을 확인합니다.
게시물 예약 또는 게시 — schedulePostTool을 통해 플랫폼별 형식으로 소셜 미디어 게시물을 생성, 초안 작성 또는 즉시 게시합니다.
게시물용 AI 이미지 생성 — generateImageTool을 통해 직접 이미지를 생성하여 예약된 콘텐츠에 첨부합니다.
게시물용 동영상 생성 — generateVideoOptions와 videoFunctionTool로 사용 가능한 동영상 옵션을 탐색한 후, generateVideoTool을 사용하여 동영상을 생성합니다.

문서

소개

모델 컨텍스트 프로토콜(MCP)을 사용하여 AI 에이전트를 Postiz에 연결하세요

MCP(모델 컨텍스트 프로토콜)를 사용하면 AI 에이전트가 Postiz와 직접 상호 작용할 수 있습니다. 통합 목록 조회, 게시물 예약, 이미지 및 비디오 생성까지 모두 표준화된 도구 호출 인터페이스를 통해 가능합니다.

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

작동 방식

Postiz는 AI 에이전트에 9가지 도구를 제공하는 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`	게시물 예약, 임시 저장 또는 즉시 게시
`generateImageTool`	게시물용 AI 이미지 생성
`generateVideoOptions`	사용 가능한 비디오 생성 옵션 나열
`videoFunctionTool`	비디오 생성기 설정 가져오기 (예: 사용 가능한 음성)
`generateVideoTool`	게시물용 비디오 생성

인증

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

API 키

Postiz의 설정 > 개발자 > 공개 API에서 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
```

자체 호스팅 인스턴스의 경우 `https://api.postiz.com`을 `NEXT_PUBLIC_BACKEND_URL`로 바꿉니다.

빠른 예시

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를 통해 트리거해야 합니다.