MCP 도구와 작업
도구 목록과 워크스페이스 선택 규칙을 확인하세요.
AI 클라이언트에 원하는 작업을 말하면 대응하는 도구를 호출합니다. 먼저 “Posteady에서 연결된 계정과 지원 기능을 보여줘”라고 요청해 대상을 선택하세요.
도구 목록
| 도구 | 작업 |
|---|---|
list_workspaces | 접근 가능한 적격 워크스페이스 조회 |
list_accounts | 연결된 계정과 capability 조회 |
list_posts | 기간의 게시물과 동기화된 지표 조회(기본 최근 90일) |
get_account_analytics | 기간의 계정별 팔로워 변화와 게시물 성과 조회 |
list_media | 현재 워크스페이스 미디어 조회 |
create_media_upload | 업로드 URL 예약 |
confirm_media_upload | 바이트 전송 후 업로드 완료 확인 |
import_media_from_url | 링크의 이미지·영상을 내려받아 미디어 라이브러리에 저장 |
publish_post | 즉시 텍스트 발행 또는 비동기 작업 접수 |
get_publish_status | jobId로 비동기 상태 확인 |
repost_post | 지원 플랫폼 게시물 리포스트 |
schedule_post | 미래 시각에 예약 |
list_scheduled_posts | 예약 목록 조회 |
cancel_scheduled_post | 대기 중인 예약 취소 |
replace_scheduled_post | 대기 중인 예약을 새 내용·미디어·시각으로 교체 |
create_carousel | 주제·본문·링크로 카드뉴스 생성 접수 |
get_carousel | carouselId로 생성 상태와 렌더된 장 이미지 확인 |
list_carousel_options | 카드뉴스에 쓸 템플릿과 브랜드 조회 |
create_channel_texts | 원문 하나로 계정마다 페르소나 말투의 글 쓰기 |
list_comments | 내 게시물의 댓글을 댓글 인박스 상태와 함께 조회 |
reply_to_comment | 댓글을 받은 계정으로 답글 달기 |
hide_comment | 댓글 숨기기·다시 보이기 |
delete_comment | 댓글 삭제 |
save_chat_images | ChatGPT 전용: 대화에 첨부했거나 대화에서 만든 이미지를 미디어 라이브러리에 저장 |
워크스페이스 선택
list_accounts·list_posts·get_account_analytics·list_comments·list_scheduled_posts는 workspaceId를 생략하면 접근 가능한 적격 워크스페이스를 함께 조회합니다. 한 곳으로 좁히려면 list_workspaces에서 받은 ID를 넣으세요.
publish_post·schedule_post·replace_scheduled_post는 accountIds, repost_post와 댓글에 조치하는 댓글 도구는 accountId, get_publish_status는 jobId, cancel_scheduled_post는 scheduledPostId와 platform에서 워크스페이스를 결정합니다. 선택 인자 workspaceId는 대상과 일치하는지 확인하는 용도이며 다른 워크스페이스로 옮기지 않습니다.
미디어 도구, 카드뉴스 도구, create_channel_texts는 workspaceId를 지정하거나 생략 시 기본 워크스페이스를 사용합니다. 업로드한 미디어와 발행할 계정의 워크스페이스를 일치시키세요.
발행과 미디어
“이 글을 Threads 계정에 발행해줘”처럼 대상과 내용을 지정하세요. Threads·X·LinkedIn은 posts 텍스트를 사용합니다. TikTok은 posts + video 또는 posts + tiktokPhoto, Instagram·YouTube·Facebook은 각각 instagram·youtube·facebook 객체를 사용합니다. REST 플랫폼 가이드의 입력을 해당 MCP 도구에도 사용할 수 있습니다.
Threads·X·LinkedIn 글에는 미디어 라이브러리의 이미지를 붙일 수 있습니다. publish_post·schedule_post에 이미지 ID를 mediaIds로 넣으세요. 이미지는 첫 글에 붙고 답글은 텍스트 그대로입니다. Threads는 120장(2장 이상이면 캐러셀), X는 장당 5 MiB 이하 14장, LinkedIn은 1~20장을 받습니다. 플랫폼이 여럿이면 가장 좁은 한도를 적용합니다. Threads·X 연결 글의 답글에도 이미지를 붙이려면 대신 mediaIdsByPost에 글마다 ID 목록을 하나씩 넣으세요. Threads 글에는 5분 이하 MP4·MOV 영상도 붙일 수 있습니다. 영상 하나만 붙이거나 캐러셀에 이미지와 섞을 수 있습니다. LinkedIn 글에는 30분 이하 MP4·MOV 영상 하나를 다른 미디어 없이 붙일 수 있습니다. 영상이 든 요청에는 X 계정을 넣을 수 없습니다. 영상이 있는 LinkedIn 글은 백그라운드에서 발행하며 get_publish_status로 결과를 확인합니다. Threads·X·LinkedIn 가이드를 참고하세요.
LinkedIn 글에는 linkedinOptions로 첫 댓글(이미지 한 장 포함 가능)과 웹 페이지의 링크 미리보기 카드도 붙일 수 있습니다. “이 기사를 링크 카드로 내 LinkedIn에 공유하고 해시태그는 첫 댓글에 달아줘”처럼 요청해 보세요. LinkedIn 가이드를 참고하세요.
X는 publish_post·schedule_post에서 posts[0]의 링크를 자동 제거합니다. http://, https://, www.와 프로토콜 없는 도메인 및 뒤따르는 경로·쿼리 문자열·프래그먼트가 대상입니다. 답글인 posts[1] 이후의 링크와 다른 플랫폼의 원문은 유지합니다. X 글자 수는 제거 후 검증하며 첫 글이 비면 발행·예약 저장 전에 요청 전체가 VALIDATION_ERROR로 실패합니다. 링크를 공유하려면 답글에 넣거나, xOptions.keepFirstPostLink를 true로 보내 첫 글에 남기세요. 남긴 주소를 X가 링크로 인식하면 그 글은 링크가 든 글로 크레딧을 받습니다. X 예제와 예약 적용 범위를 참고하세요.
X 발행·예약에는 조직 크레딧이 듭니다. 첫 글의 링크를 제거한 뒤 글마다 2, 링크가 든 글은 20으로 셉니다. 예약은 만들 때 크레딧을 받고, cancel_scheduled_post로 취소하면 돌려줍니다. 크레딧이 모자라면 도구가 INSUFFICIENT_CREDITS를 돌려주고 아무것도 발행·예약하지 않습니다. X 크레딧을 참고하세요.
새 파일은 create_media_upload → 반환 URL로 바이트 PUT → confirm_media_upload 순서입니다. 8 MiB 이하 JPEG는 그대로 저장하고, 20 MiB 이하 PNG·WebP는 완료 확인 때 JPEG로 바꿔 저장합니다. 2 GiB를 넘는 영상(최대 4 GiB)은 uploadMethod: "multipart"로 예약하고, 반환된 파트를 각자의 URL로 PUT한 뒤 확인합니다. 100 MiB 이하 PDF·PPT·PPTX·DOC·DOCX 문서는 mediaType: "DOCUMENT"로 예약하고 PUT 한 번으로 올립니다. 완료 확인 때 내용도 확인합니다. PDF는 열 수 있어야 하고 최대 300쪽이며, PPTX·DOCX는 PowerPoint·Word 파일 구조여야 하고, PPT·DOC는 Office 바이너리 파일이어야 합니다. 올린 문서는 list_media에 mediaType: "DOCUMENT"를 넘겨 조회합니다. 도구에 base64 파일을 보내지 마세요. 클라이언트가 로컬 파일을 PUT할 수 없다면 Posteady 미디어 라이브러리에 먼저 업로드하고 list_media로 선택하세요.
파일이 이미 인터넷에 있다면 “이 이미지를 Posteady 미디어 라이브러리에 넣어줘: https://…”처럼 요청하세요. import_media_from_url이 링크에서 파일을 내려받아 mediaId가 담긴 확정 미디어를 한 번에 돌려줍니다. 링크는 파일 자체를 내려받는 주소여야 합니다. 소셜 미디어 게시물 같은 웹 페이지나 로그인이 필요한 링크는 받지 않습니다. 이미지는 JPEG·PNG·WebP 20MiB까지, 영상은 MP4·MOV 200MiB까지 받습니다. 8MiB 이하 JPEG는 그대로 저장하고, 그 밖의 이미지는 JPEG로 바꿉니다. 호출할 때마다 새 사본을 저장합니다. REST로 쓸 때의 같은 규칙은 가져오기 레퍼런스를 참고하세요.
ChatGPT에서는 “방금 만든 이미지를 Threads에 올려줘”처럼 요청해 보세요. save_chat_images가 대화에 첨부했거나 대화에서 만든 이미지를 미디어 라이브러리에 저장합니다. ChatGPT가 파일마다 임시 링크를 넘기면 Posteady가 JPEG(긴 변 최대 2160px)로 바꿔 저장하고 mediaId를 돌려줍니다. 저장한 이미지는 다른 확인된 미디어처럼 공개 URL을 가집니다. 다른 AI 클라이언트는 대화 속 파일을 넘길 수 없어 이 도구가 보이지 않습니다.
비동기 발행은 jobId를 받아 get_publish_status로 확인합니다. unknown이면 대상 플랫폼에서 발행 여부를 확인해야 하며 자동으로 새 요청을 만들지 않습니다.
글이 2개 이상인 Threads 연결 글은 Posteady 앱의 '지금 게시'와 같은 방식으로 발행합니다. publish_post가 호출 안에서 첫 글을 발행하고, 나머지는 글당 약 10초씩 백그라운드에서 발행합니다. Threads 계정의 결과에는 status: "processing"과 jobId가 있습니다. get_publish_status는 지금까지 발행된 글을 postIds에 보여 주고, 연결 글이 모두 올라가면 published를 알립니다. X 연결 글은 호출 안에서 모두 발행합니다. 다만 mediaIdsByPost로 답글에 이미지를 붙인 X 연결 글은 Threads 연결 글과 같은 방식으로 발행합니다. 첫 글에 영상이 있는 Threads 글은 publish_post가 호출 안에서 아무것도 발행하지 않습니다. Threads가 영상을 백그라운드에서 처리하고, 결과에는 status: "processing"과 jobId가 있으며 postIds는 아직 비어 있습니다. 글이 올라가면 get_publish_status가 알려 줍니다.
카드뉴스
“이 글로 카드뉴스 만들어줘”처럼 요청하면 create_carousel이 주제(topic), 본문(text), 링크(url) 중 하나로 생성을 접수합니다. Posteady가 장마다 문구를 쓰고 디자인하며, 한 번에 조직 크레딧이 차감됩니다. 사진 칸은 스톡 사진, 템플릿의 원래 이미지, 사진 없음 중 하나로 채웁니다(imageMode). AI 이미지 생성은 Posteady 앱과 REST API에서만 쓸 수 있고 MCP에서는 쓸 수 없습니다. 특정 템플릿이나 브랜드를 쓰려면 먼저 list_carousel_options로 ID를 확인하세요.
생성에는 보통 1~3분이 걸립니다. create_carousel은 carouselId만 돌려주므로 get_carousel로 completed 또는 failed가 될 때까지 확인하세요. 완성되면 편집기 주소, 캡션과 함께 렌더된 장의 mediaId를 순서대로 받습니다. 이 ID를 publish_post·schedule_post의 instagram 미디어로 넘기면 바로 발행할 수 있습니다. 생성이 실패하면 생성 크레딧은 환불됩니다.
같은 requestId로 다시 호출하면 같은 카드뉴스를 반환하고 다시 차감하지 않습니다. 새 카드뉴스에만 새 requestId를 쓰세요. 자료의 동영상은 정지 이미지로 들어가며, 동영상 장은 Posteady 앱에서 만듭니다. 입력과 실패 코드는 카드뉴스 만들기 가이드에 있습니다.
여러 채널 글
“이 기사로 내 Threads와 LinkedIn 계정에 올릴 글을 써줘: https://…”처럼 요청하세요. create_channel_texts는 원문 하나로 고른 계정마다 글을 씁니다. 원문은 텍스트(text), 공개 링크(url), 내 게시물(post) 중 하나입니다. 글은 그 계정 페르소나의 말투와 플랫폼 형식으로 쓰며, Posteady 앱의 '여러 채널 한 번에'와 같습니다. targets에는 플랫폼마다 계정을 하나씩 넣고, 계정마다 활성 페르소나가 있어야 합니다. 글을 다 쓸 때까지 기다리며 보통 10~30초가 걸립니다.
Posteady는 결과를 저장하거나 발행하지 않습니다. 채널마다 받은 posts를 그 계정으로 publish_post나 schedule_post에 넘기세요. X·Threads는 연결 글이고, 다른 플랫폼은 글 하나입니다. Instagram·TikTok·YouTube는 미디어가 더 필요하고, YouTube는 제목도 필요합니다. 쓴 채널마다 5크레딧이고, 링크 원문은 요청마다 한 번 5크레딧이 더 듭니다. 실패한 채널은 failed에 나오고 차감하지 않습니다. 입력과 실패 코드는 여러 채널 글 쓰기 가이드에 있습니다.
댓글
“이번 주에 답하지 않은 댓글을 보여줘”, “내 Instagram 게시물의 최근 댓글에 답글 달아줘”처럼 요청하세요. list_comments는 Posteady에 동기화된 댓글을 댓글 인박스와 같은 필터·상태(unanswered·replied·resolved)로 읽습니다. 플랫폼을 새로 불러오지는 않습니다. 결과에는 댓글 작성자의 사용자 이름과 댓글 내용이 들어갑니다. workspaceId를 생략하면 댓글을 볼 수 있는 워크스페이스마다 첫 페이지를 돌려주고, 다음 페이지가 있는 워크스페이스는 workspaces에 nextCursor와 함께 나옵니다. 더 읽으려면 그 workspaceId와 cursor를 넣으세요.
reply_to_comment는 댓글을 받은 계정으로 텍스트 답글을 달고, hide_comment는 다른 사람의 댓글을 숨기거나 다시 보이게 합니다. delete_comment는 내 계정의 댓글은 모든 플랫폼에서, 다른 사람의 댓글은 Instagram·Facebook에서 지웁니다. list_comments에서 받은 commentId·platform·accountId를 넣고, LinkedIn은 postId도 넣으세요. 답글과 삭제는 플랫폼에 바로 반영되며 Posteady에서 되돌릴 수 없습니다. 답글이 PLATFORM_ERROR나 시간 초과로 끝나면 다시 보내기 전에 플랫폼에서 확인하세요. 플랫폼별 차이는 댓글 읽고 답하기를 참고하세요.
예약과 조회
“내일 오전 9시, Asia/Seoul로 예약해줘”처럼 시간대를 명확히 지정하세요. schedule_post는 미래 scheduledAt과 선택 timezone을 받습니다. 취소에는 scheduledPostId를 사용하고 발행 상태 조회에는 jobId를 사용합니다.
예약한 게시물을 바꾸려면 “내일 Instagram 예약을 금요일로 옮기고 캡션을 이걸로 바꿔줘”처럼 요청하세요. replace_scheduled_post는 schedule_post와 같은 입력에 원래 예약의 scheduledPostId와 platform을 더 받습니다. accountIds에는 원래 예약의 계정을 넣습니다. Posteady는 새 예약을 먼저 만들고, 새 예약이 접수된 뒤에만 원래 예약을 취소합니다. 그래서 교체가 실패하면 원래 예약은 그대로이고 replaced는 null입니다. 원래 예약이 취소되기 전에 발행을 시작하면 새 예약을 취소하고 POST_NOT_CANCELLABLE을 반환합니다. 미디어 게시물에는 새 requestId가 필요합니다. 예약 교체를 참고하세요.
지표는 “최근 조회수가 높은 게시물을 보여줘”처럼 요청할 수 있습니다. list_posts는 기본으로 최근 90일을 읽고 한 번에 최대 100개를 반환합니다. 다른 기간은 since와 until(시간대가 붙은 ISO 8601)로 최대 90일까지 고릅니다. totalMatched는 기간 안의 게시물 수이고, hasMore가 true이면 offset으로 다음 페이지를 읽습니다. 여러 워크스페이스를 함께 볼 때는 앞쪽 100개까지만 넘길 수 있고, 더 넘기려면 workspaceId로 한 곳을 고릅니다(offset 최대 9,900). 기간 전체를 분석하려면 모든 페이지를 먼저 읽으세요.
계정 단위 수치는 “지난달 팔로워가 얼마나 늘었어?”처럼 요청하세요. get_account_analytics는 계정마다 기간의 팔로워 변화와 게시물 성과를 Posteady 분석 화면과 같은 정의로 돌려줍니다. previous에는 바로 앞 같은 길이 기간의 같은 지표가 있습니다. 팔로워 값은 하루 단위 스냅샷에서 오며 스냅샷은 Threads·X·Instagram·LinkedIn에만 있습니다. 분석을 볼 권한이 없는 워크스페이스는 건너뛰고 note에 적습니다. 계정 분석을 참고하세요.