개발자 문서
MCP 도구
도구와 필요한 권한
list_accounts
accounts:read연결된 계정 목록 · 다른 발행 도구보다 먼저 호출해 연결된 계정 ID와 채널을 확인하세요.
list_platforms
accounts:read채널 규격 목록 · 현재 지원 채널, 상태, 확인된 글·미디어 규격을 확인합니다.
validate_post
posts:read발행 전 검사 · 글을 저장하지 않고 모든 선택 채널의 규격 위반을 한 번에 검사합니다.
get_post
posts:read글 상세 · 글 하나의 전체 상태, 채널별 발행 결과와 수집된 지표를 확인합니다.
list_posts
posts:read발행 기록 목록 · 현재 워크스페이스의 글을 필터와 커서로 읽습니다.
media_upload_status
posts:read미디어 업로드 상태 · 업로드 검증이 끝났는지 확인합니다. ready가 true일 때만 글에 첨부하세요.
get_quota
posts:read남은 발행 수 · 현재 워크스페이스의 월 사용량과 채널별 하루 한도를 확인합니다.
publish
posts:write글 발행·예약·임시 저장 · 연결된 여러 계정에 글을 즉시 발행하거나 예약·임시 저장합니다. wait=true이면 즉시 발행 결과를 텍스트 최대 10초, 미디어 최대 60초 기다립니다. 같은 요청을 다시 보낼 때는 idempotencyKey를 재사용하세요.
update_post
posts:write임시·예약 글 수정 · 발행 전인 글의 본문, 계정, 미디어, 채널 옵션 또는 예약 시각을 수정합니다.
delete_post
posts:write글 삭제 · 임시·예약 글은 지우고, 발행된 글은 채널별 삭제를 요청합니다. 되돌릴 수 없습니다.
retry_post
posts:write실패한 채널 재시도 · 확정된 일시 실패 채널만 다시 검사하고 발행을 요청합니다.
media_upload_link
posts:write이미지 업로드 링크 · 사용자가 브라우저에서 현재 검증 가능한 이미지를 올릴 30분 링크를 발급합니다. 반환된 sessionId로 media_upload_status를 호출하세요.
media_from_url
posts:write공개 URL 이미지 가져오기 · 공개 HTTPS URL의 이미지를 가져와 서버에서 검증하고, 글에 첨부할 미디어 ID를 발급합니다.
list_webhooks
webhooks:read고객 웹훅 목록 · 현재 워크스페이스의 웹훅 구독을 조회합니다. 서명 비밀값은 표시하지 않습니다.
manage_webhook
webhooks:write고객 웹훅 관리 · 웹훅을 등록·변경·중지·재개·폐기하거나 서명 비밀값을 교체합니다. revoke는 되돌릴 수 없으므로 사용자에게 확인한 뒤 호출하세요. 새 비밀값은 성공한 첫 결과에서만 볼 수 있습니다.
list_queue_slots
posts:read큐 슬롯 규칙 목록 · 현재 워크스페이스의 반복 예약 규칙과 중지·폐기 상태를 확인합니다.
manage_queue_slot
posts:write큐 슬롯 규칙 관리 · 반복 예약 규칙을 만들거나 변경·중지·재개·폐기합니다. revoke는 되돌릴 수 없으므로 사용자에게 확인한 뒤 호출하세요. 글 예약은 publish의 queueSlot=true를 사용하세요.