Posteady
Posteady Docs
사용 가이드개발자 가이드API 레퍼런스MCP
MCP시작하기

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_statusjobId로 비동기 상태 확인
repost_post지원 플랫폼 게시물 리포스트
schedule_post미래 시각에 예약
list_scheduled_posts예약 목록 조회
cancel_scheduled_post대기 중인 예약 취소
replace_scheduled_post대기 중인 예약을 새 내용·미디어·시각으로 교체
create_carousel주제·본문·링크로 카드뉴스 생성 접수
get_carouselcarouselId로 생성 상태와 렌더된 장 이미지 확인
list_carousel_options카드뉴스에 쓸 템플릿과 브랜드 조회
create_channel_texts원문 하나로 계정마다 페르소나 말투의 글 쓰기
list_comments내 게시물의 댓글을 댓글 인박스 상태와 함께 조회
reply_to_comment댓글을 받은 계정으로 답글 달기
hide_comment댓글 숨기기·다시 보이기
delete_comment댓글 삭제
save_chat_imagesChatGPT 전용: 대화에 첨부했거나 대화에서 만든 이미지를 미디어 라이브러리에 저장

워크스페이스 선택

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에 적습니다. 계정 분석을 참고하세요.

플랫폼별 예제 · 업로드 절차 · 예약·취소 규칙 · 지표 해석

관련 가이드 더 보기

이 페이지에서

카카오톡 문의하기