MCP 도구와 작업
도구 목록과 워크스페이스 선택 규칙을 확인하세요.
AI 클라이언트에 원하는 작업을 말하면 대응하는 도구를 호출합니다. 먼저 “Posteady에서 연결된 계정과 지원 기능을 보여줘”라고 요청해 대상을 선택하세요.
도구 목록
| 도구 | 작업 |
|---|---|
list_workspaces | 접근 가능한 적격 워크스페이스 조회 |
list_accounts | 연결된 계정과 capability 조회 |
list_posts | 최근 90일 게시물과 동기화된 지표 조회 |
list_media | 현재 워크스페이스 미디어 조회 |
create_media_upload | 업로드 URL 예약 |
confirm_media_upload | 바이트 전송 후 업로드 완료 확인 |
publish_post | 즉시 텍스트 발행 또는 비동기 작업 접수 |
get_publish_status | jobId로 비동기 상태 확인 |
repost_post | 지원 플랫폼 게시물 리포스트 |
schedule_post | 미래 시각에 예약 |
list_scheduled_posts | 예약 목록 조회 |
cancel_scheduled_post | 대기 중인 예약 취소 |
워크스페이스 선택
list_accounts·list_posts·list_scheduled_posts는 workspaceId를 생략하면 접근 가능한 적격 워크스페이스를 함께 조회합니다. 한 곳으로 좁히려면 list_workspaces에서 받은 ID를 넣으세요.
publish_post·schedule_post는 accountIds, repost_post는 accountId, get_publish_status는 jobId, cancel_scheduled_post는 scheduledPostId와 platform에서 워크스페이스를 결정합니다. 선택 인자 workspaceId는 대상과 일치하는지 확인하는 용도이며 다른 워크스페이스로 옮기지 않습니다.
미디어 도구는 workspaceId를 지정하거나 생략 시 기본 워크스페이스를 사용합니다. 업로드한 미디어와 발행할 계정의 워크스페이스를 일치시키세요.
발행과 미디어
“이 글을 Threads 계정에 발행해줘”처럼 대상과 내용을 지정하세요. Threads·X·LinkedIn은 posts 텍스트를 사용합니다. TikTok은 posts + video, Instagram·YouTube·Facebook은 각각 instagram·youtube·facebook 객체를 사용합니다. REST 플랫폼 가이드의 입력을 해당 MCP 도구에도 사용할 수 있습니다.
X는 publish_post·schedule_post에서 posts[0]의 링크를 자동 제거합니다. http://, https://, www.와 프로토콜 없는 도메인 및 뒤따르는 경로·쿼리 문자열·프래그먼트가 대상입니다. 답글인 posts[1] 이후의 링크와 다른 플랫폼의 원문은 유지합니다. X 글자 수는 제거 후 검증하며 첫 글이 비면 발행·예약 저장 전에 요청 전체가 VALIDATION_ERROR로 실패합니다. 링크를 공유하려면 답글에 넣으세요. X 예제와 예약 적용 범위를 참고하세요.
새 파일은 create_media_upload → 반환 URL로 바이트 PUT → confirm_media_upload 순서입니다. 도구에 base64 파일을 보내지 마세요. 클라이언트가 로컬 파일을 PUT할 수 없다면 Posteady 미디어 라이브러리에 먼저 업로드하고 list_media로 선택하세요.
비동기 발행은 jobId를 받아 get_publish_status로 확인합니다. unknown이면 대상 플랫폼에서 발행 여부를 확인해야 하며 자동으로 새 요청을 만들지 않습니다.
예약과 조회
“내일 오전 9시, Asia/Seoul로 예약해줘”처럼 시간대를 명확히 지정하세요. schedule_post는 미래 scheduledAt과 선택 timezone을 받습니다. 취소에는 scheduledPostId를 사용하고 발행 상태 조회에는 jobId를 사용합니다.
지표는 “최근 조회수가 높은 게시물을 보여줘”처럼 요청할 수 있습니다. list_posts는 최근 90일에서 최대 100개를 반환하며 별도 날짜 필터·페이지네이션은 없습니다. 클라이언트가 기간을 좁혀 해석할 수는 있지만 반환되지 않은 게시물까지 포함한 전체 기간 분석이라고 가정하면 안 됩니다.