AI 에이전트 (MCP)
PostClaw는 원격 Model Context Protocol 서버를 제공합니다. AI 어시스턴트를 연결하면 “다음 주 게시물 세 개를 써서 내 Facebook 페이지에 예약해 줘”처럼 평소 말투로 부탁할 수 있습니다. 어시스턴트가 사용자로서 채널을 확인하고, 초안을 작성하고, 캘린더에 넣습니다.
Free를 포함한 모든 요금제에서 사용할 수 있습니다. 요금제 한도는 앱에서와 똑같이 적용됩니다.
필요한 것
- 채널이 하나 이상 연결된 PostClaw 계정.
- Streamable HTTP로
Authorization헤더를 보낼 수 있는 MCP 클라이언트: Claude Code, Cursor, VS Code 및 대부분의 MCP 클라이언트. - 설정 → AI 에이전트에서 만든 토큰.
브라우저의 Claude.ai와 ChatGPT는 아직 지원하지 않습니다. OAuth 로그인이 필요하며, 지원할 예정입니다.
2분 만에 연결하기
- 설정 → AI 에이전트를 열고 새 토큰을 클릭합니다.
- 알아보기 쉬운 이름(예: “노트북의 Cursor”)을 붙이고 권한을 고릅니다.
- 토큰을 복사합니다. 토큰은 한 번만 표시됩니다. 잃어버렸다면 취소하고 새로 만드세요.
- 클라이언트에 서버를 추가합니다. 설정 페이지에 토큰이 채워진 아래 스니펫이 표시됩니다.
서버 URL: https://app.postclaw.fun/mcp
Claude Code
claude mcp add --transport http postclaw https://app.postclaw.fun/mcp --header "Authorization: Bearer YOUR_TOKEN"Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"postclaw": {
"url": "https://app.postclaw.fun/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}VS Code (.vscode/mcp.json)
{
"servers": {
"postclaw": {
"type": "http",
"url": "https://app.postclaw.fun/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}연결을 확인하려면 어시스턴트에게 “PostClaw에 어떤 채널이 있어?”처럼 물어보세요.
권한
토큰마다 권한이 따로 있습니다. 어시스턴트는 토큰이 허용한 도구만 볼 수 있습니다.
| 권한 | 어시스턴트가 할 수 있는 일 |
|---|---|
| 읽기 (항상 켜짐) | 채널, 게시물, 미디어, 분석 보기 및 게시 시간 추천 받기 |
| 쓰기 | 초안 작성·수정, 미디어 업로드, AI로 게시물 작성, AI 이미지 생성 |
| 게시 (기본값 꺼짐) | 실제 계정에서 게시물 예약, 게시, 예약 취소, 삭제 |
게시 권한이 없으면 어시스턴트는 초안만 남기고, 검토와 승인은 PostClaw에서 직접 합니다. 대신 게시해도 된다고 믿을 수 있는 어시스턴트에만 켜세요.
활성 토큰은 최대 10개까지 둘 수 있습니다. 토큰 취소는 어시스턴트의 다음 요청부터 적용됩니다.
도구
| 도구 | 권한 | 기능 |
|---|---|---|
list_channels | 읽기 | 게시할 수 있는 연결된 계정과 페이지 |
list_posts, get_post | 읽기 | 초안, 예약된 게시물, 게시된 게시물(링크와 오류 포함) |
get_analytics | 읽기 | 합계, 플랫폼별 분석, 최적 시간, 인기 게시물 |
suggest_posting_times | 읽기 | 플랫폼별 좋은 게시 시간대 |
list_media | 읽기 | 최근 업로드한 미디어 |
generate_post | 쓰기 | 브리프로 게시물 문구 작성(브랜드 보이스 선택 가능) |
adapt_post | 쓰기 | 하나의 콘텐츠를 플랫폼별로 다시 작성 |
create_image | 쓰기 | 게시물용 AI 이미지 |
upload_media, add_media_to_post | 쓰기 | 직접 가진 이미지와 동영상 첨부 |
create_post, update_post | 쓰기 | 초안 작성과 수정. 시간을 지정하면 예약됩니다(게시 필요) |
publish_post | 게시 | 지금 게시하고 플랫폼별 게시물 링크 반환 |
unschedule_post | 게시 | 예약된 게시물을 초안으로 되돌리기 |
delete_post | 게시 | PostClaw에서 게시물 삭제 |
미디어는 https:// URL이거나 upload_media로 보낸 파일이어야 합니다.
create_post와 publish_post는 선택적으로 idempotency_key를 받습니다. 어시스턴트가 24시간 안에 같은 키로 다시 호출하면, PostClaw는 두 번 만들거나 게시하지 않고 처음 결과를 돌려줍니다.
한도와 크레딧
어시스턴트는 앱에서와 같은 요금제로 동작합니다:
- 월간 게시물 수, AI 크레딧, 이미지 할당량은 PostClaw에서 하든 어시스턴트를 통하든 똑같이 계산됩니다.
- 설정에서 자신의 AI 키를 연결했다면 AI 도구는 그 키를 사용합니다.
- 토큰마다 분당 최대 60회 요청할 수 있습니다.
- 모든 호출은 계정에 기록됩니다.
문제 해결
| 보이는 것 | 원인 | 해결 방법 |
|---|---|---|
401 / “invalid token” | 토큰이 잘못되었거나 취소됨 | 새 토큰을 만들고 클라이언트를 업데이트 |
429 | 한 토큰에서 분당 60회를 넘는 요청 | 몇 초 기다리기(응답에 대기 시간 표시) |
| 도구가 보이지 않음 | 토큰에 해당 도구 권한이 없음 | 그 권한이 있는 토큰 만들기 |
scope_missing | 게시 권한 없이 예약하거나 게시함 | 새 토큰에서 게시를 켜거나 앱에서 예약 |
quota_exceeded, credit_cap_exceeded | 요금제의 월간 한도를 다 씀 | 다음 기간을 기다리거나 업그레이드 |
| ”your … configuration failed” | 자신의 AI 키가 오류를 반환함(할당량, 결제, 로그인 만료) | 설정 → Providers에서 키를 수정하거나 삭제 |
토큰을 안전하게 보관하기
토큰은 사용자로서 동작합니다. 비밀번호처럼 다루세요:
- 저장소에 커밋하거나 공유 채팅에 붙여 넣지 마세요.
- 기기나 도구마다 토큰을 따로 쓰면, 하나를 취소해도 다른 것에 영향이 없습니다.
- 쓰지 않는 토큰은 설정 → AI 에이전트에서 취소하세요.