문서
MCP로 나만의 AI와 함께 글 쓰기
Claude 등 MCP 클라이언트가 콘텐츠 큐에서 직접 글을 쓰게 하세요. 주제를 선점하고, 브리프를 읽고, 초안·번역·커버를 제출할 수 있으며, Mac에서 무인으로 실행할 수도 있습니다.
콘텐츠 엔진에는 두 번째 작성자가 있습니다. 바로 여러분의 AI입니다. Claude Code, Claude 앱, Cursor처럼 AutoPSEO에 로그인한 MCP 클라이언트라면 같은 큐에서 주제를 가져오고, 같은 브리프와 규칙을 읽고, AutoPSEO 자체 작성기와 동일한 검사를 통과하는 초안을 제출할 수 있습니다. 이렇게 작성한 초안은 월간 글 할당량에 포함되지 않습니다. 채팅으로 함께 작업할 수도 있고, 무인 실행으로 일정에 맞춰 글을 쓰게 할 수도 있습니다.
AI 연결하기
MCP 엔드포인트는 https://app.autopseo.com/mcp입니다. 연결 방법은 두 가지이며, 모두 계정의 MCP & API 페이지에서 설정합니다.
- "로그인으로 연결"의 OAuth로 로그인: Claude Code에서는
claude mcp add --transport http autopseo https://app.autopseo.com/mcp을 실행한 뒤/mcp에서 Authenticate를 선택합니다. apk_live_로 시작하는 API 키:Authorization: Bearer <key>형태로 전송합니다. 내용을 변경하는 콘텐츠 도구에는 읽기 및 쓰기 키가 필요하며, 읽기 전용 키로는 읽기 도구만 사용할 수 있습니다.
역할도 영향을 줍니다. 조회 권한만 있는 멤버는 읽기 도구만 쓸 수 있고, 일부 속성에만 초대된 멤버는 해당 속성만 볼 수 있습니다. Search Console 도구를 포함한 전체 목록은 MCP 페이지에 있으며, 키 관리는 MCP & ChatGPT app에서 설명합니다.
콘텐츠 페이지의 설정에서 큐의 주제를 누가 작성할지를 정하면 큐를 담당하는 작성자가 결정됩니다. 선택지는 AutoPSEO(위에 설정한 속도로)와 나만의 AI(MCP 사용)입니다. 나만의 AI를 선택하면 AutoPSEO 작성기는 큐에 쌓인 작업을 더 이상 가져가지 않습니다. 어느 쪽을 선택하든 "나만의 AI는 여기서 무엇을 선택했는지와 관계없이 언제든 글을 쓰고 다시 쓸 수 있습니다." 작업을 선점하고 제출하려면 해당 속성의 엔진이 켜져 있고 요금제가 활성 상태여야 합니다.
콘텐츠 도구
| 도구 | 권한 | 기능 |
|---|---|---|
content_instructions | 읽기 | 속성 설정을 바탕으로 만든, 해당 속성의 무인 실행 1회분 전체 지침 |
content_report | 읽기 | 설정, 콘텐츠 유형, 할당량, 작업 수, 최신 게시 글 20개, 거부된 전달 내역 |
content_list_tasks | 읽기 | 가능성이 높은 순서의 작업 목록과 각 작업의 담당자 |
content_find_pages | 읽기 | 검색어와 일치하는 사이트 페이지를 찾아 커버리지를 확인하고 링크 대상을 고르는 도구 |
content_get_page | 읽기 | 글의 게시 본문, 검토 중인 초안, 리비전, 28일간의 검색어 |
content_get_translation | 읽기 | 한 언어의 원문, 번역 규칙, 현재 번역본 |
content_get_brief | 유료 | 작성 규칙, 브리프, 허용된 링크, 유형 지정 페이지의 주소, 커버 필요 여부 |
content_add_topics | 쓰기 | 주제 1~200개를 계획하며, 게이트와 검토를 거칩니다 |
content_claim | 쓰기 | 작업을 2시간 동안 선점합니다. 작업, 페이지(rewrite, optimize, refresh), 키워드 중 하나로 지정합니다 |
content_submit | 쓰기 | 초안을 검사하고 저장합니다. 오류가 남아 있으면 저장되지 않습니다 |
content_submit_translation | 쓰기 | 초안 또는 게시된 글의 한 언어를 검사하고 저장합니다 |
content_cover | 쓰기 | 장면을 검사하고 이미지 프롬프트, 참고 이미지, 업로드 주소를 받습니다 |
content_set_cover | 쓰기 | 커버를 설정하거나 교체하며, 업로드 주소를 받을 수도 있습니다 |
content_publish | 쓰기 | 초안을 승인하거나 이전 리비전으로 되돌립니다 |
content_unpublish | 쓰기 | 글을 내립니다 |
content_merge | 쓰기 | 글을 다른 페이지에 병합하고 301 리디렉션을 설정합니다 |
content_decline | 쓰기 | 사유를 남기고 작업을 영구적으로 거절합니다 |
content_propose_value | 쓰기 | 사이트에 확인한 뒤, 유형 지정 콘텐츠 유형에 새 값을 제안합니다 |
content_submit_value | 쓰기 | 새 값의 근거 정보를 검토용으로 보냅니다 |
content_remove_path | 쓰기 | 사이트에 해당 값의 경로를 내려 달라고 요청합니다 |
읽기 전용 키나 조회 권한만 있는 멤버는 읽기가 아닌 모든 도구를 사용할 수 없습니다. 게시, 내리기, 병합, 경로 제거를 수행하는 도구는 AI가 사용자의 승인을 받은 뒤에만 실행하도록 안내합니다.
글 작성하기
- 작업 고르기.
content_list_tasks로 큐에 있는 작업을 확인하고,content_find_pages로 사이트에 이미 같은 내용이 있는지 확인합니다. - 선점하기.
content_claim { taskId }는 작업을 2시간 동안 선점하며, 다시 선점하면 기간이 연장됩니다.pageId와kind로 게시된 글을 선점하거나, 키워드(필요하면 콘텐츠 유형 키 포함)로 시작할 수도 있습니다. 키워드는 먼저 게이트를 거칩니다. - 브리프 읽기.
content_get_brief는rules(AutoPSEO 작성기가 받는 것과 같은 작성 규칙),brief,allowedLinks,cover.wanted를 반환합니다. 첫 호출에서는 검색 결과를 조사하며 리서치 크레딧이 차감되고, 같은 작업에 대한 이후 호출은 무료입니다. - 작성 및 제출. 전달에 설명된 형식의 JSON으로 글을 만들어
content_submit으로 보냅니다. 검사를 통과하지 못하면 응답이 "Not saved. Fix these and submit again:"으로 시작하고 문제 목록이 이어집니다.allowedLinks에 없는 링크는 굵은 텍스트로 바뀝니다. 작업이 게시된 글을 수정하는 경우에는 작업 기준이 된 리비전인baseRev를 함께 전달하세요. 그사이 글이 변경되었다면 충돌로 제출이 거부됩니다. - 번역하기. 나머지 언어마다
content_get_translation을 호출한 뒤content_submit_translation으로 제출합니다. 언어별 제출은 병렬로 진행할 수 있습니다. 자세한 내용은 번역을 참고하세요. - 커버 추가하기. 브리프에서 커버가 필요하다고 하면 추가합니다(아래 참고).
- 게시하기. 초안은 검토 대기 상태로 남습니다.
content_publish { taskId }로 승인하며, 이 도구는 사용자가 지시했을 때만 쓰도록 되어 있습니다.
선점 기간이 만료되면 5분 주기의 스케줄이 선점을 해제하고 작업은 큐로 돌아갑니다. content_decline은 3~300자의 사유와 함께 작업을 영구적으로 거절하므로 같은 작업이 다시 제안되지 않습니다.
검토 중인 초안 수정하기
검토자가 수정을 요청해도 초안을 반려할 필요는 없습니다.
- 작업(또는 페이지나 키워드)을 지정해
content_claim을 호출하면 초안이 다시 작성 상태로 돌아가므로, 그동안 다른 사람이 게시할 수 없습니다. content_get_page가 초안을draft로 반환합니다.content_submit은 같은 주소에 다음 리비전을 저장하고 이전 초안을 대체된 것으로 표시합니다.- 번역을 다시 보냅니다. 새 리비전에는 해당 언어만 들어 있으며,
content_get_translation은 대체된 초안의 번역본을current로 제공합니다.
그 전에 선점 기간이 만료되면 초안은 변경 없이 검토 상태로 돌아갑니다.
프롬프트
서버는 프롬프트도 제공하며, Claude Code에서는 /mcp__autopseo__write-articles 같은 슬래시 명령으로 나타납니다.
| 프롬프트 | 인자 | 안내하는 작업 |
|---|---|---|
write-articles | site, count(1~10) | 큐에서 글을 단계별로 작성 |
revise-draft | site, draft, changes | 검토 대기 중인 초안 수정 |
optimize-page | site, page | 게시된 글 하나 개선 |
refresh-decayed | site, limit(최대 10) | 클릭이 줄어든 글 갱신 |
connect-repo | articlesUrl | 사이트 코드에 서명된 웹훅 수신기 구축 |
나만의 AI로 만드는 커버
사이트에 커버가 표시되는 경우 content_get_brief가 cover.wanted로 알려 줍니다. AI는 직접 만든 이미지를 content_submit의 cover(https url 또는 최대 2.5 MB의 base64 data)로 전달하거나, content_submit이 반환하는 coverUploadUrl에 파일을 PUT으로 업로드하거나, 나중에 content_set_cover로 설정할 수 있습니다. content_cover를 사용해 AutoPSEO의 프롬프트로 이미지를 생성할 수도 있습니다. 형식, 크기, 검사 기준은 커버에서 확인하세요.
비용
- 나만의 AI가 작성한 초안과 번역은 월간 글 할당량에 포함되지 않으며, 제출은 무료입니다.
- 브리프에서 처음 검색 결과를 조사할 때와, 두 가지 유형이 모두 가능한 키워드의 콘텐츠 유형을 모델이 선택할 때는 리서치 크레딧이 사용됩니다.
- 주제 추가, 거절, 읽기 도구는 무료입니다. AutoPSEO가 번역하는 사이트에서 언어가 빠진 초안을 승인하면 리서치 크레딧으로 번역이 시작됩니다.
Mac에서의 무인 실행
content_instructions는 한 속성에 대해 무인 실행 1회가 해야 할 모든 작업을 반환합니다. 보고서 확인, 이전 실행이 남긴 작업 마무리, 브리프에 비용을 쓰기 전 커버리지 확인, 중복 거절, 작성, 번역, 커버 추가, 그리고 사이트의 검토가 꺼져 있을 때만 게시하는 것까지 포함됩니다. 글을 내리거나 되돌리는 일은 하지 않으며, 마지막에 스크립트가 읽을 수 있는 한 줄을 출력합니다.
AUTOPSEO_RESULT property=<id> published=<n> review=<n> declined=<n> failed=<n> values=<n>AutoPSEO 작성기는 사용자의 Claude 구독으로 사용자의 Claude Code를 launchd 아래에서 실행하는 소형 macOS 스크립트 모음입니다. 스크립트가 필요하시면 문의하기를 이용해 주세요. 설정 방법은 다음과 같습니다.
- Claude Code를 AutoPSEO에 연결합니다(Claude의 커넥터를 사용하거나,
claude mcp add --scope user --transport http autopseo https://app.autopseo.com/mcp을 실행한 뒤/mcp에서 Authenticate 선택). ./install.sh를 실행합니다.~/.autopseo/폴더에run.sh,cover-mcp.mjs, 샘플writer.json이 만들어지고, 매일 15:07에 실행되는 launchd 작업이 등록됩니다(AUTOPSEO_HOUR와AUTOPSEO_MINUTE로 변경 가능). 이 작업은 아직 로드되지 않은 상태입니다.~/.autopseo/writer.json을 채웁니다. 항목은properties(각id와 선택 항목인 실행당 새 글 수limit, 기본값 8, 최대 20),model과fallbackModel, 번역 서브에이전트용 선택 항목subagentModel, 속성별 실행 간격everyDays(기본값 3),covers(codex,grok또는off)입니다.AUTOPSEO_FORCE=1 ~/.autopseo/run.sh로 한 번 실행해 본 뒤~/.autopseo/logs/history.log를 확인합니다.launchctl load ~/Library/LaunchAgents/com.autopseo.writer.plist로 스케줄을 로드합니다.
실행할 때마다 속성별로 claude -p가 하나씩 시작되며, AutoPSEO 도구와 서브에이전트만 사용할 수 있습니다. 셸, 파일, 웹은 사용할 수 없습니다. 실행은 결과 줄을 출력했을 때만 성공으로 간주합니다. values가 0보다 크면 두 번째 세션이 유형 지정 페이지의 새 경로를 처리합니다. 이 세션은 웹을 검색하고 읽을 수 있지만, 값 작업에 필요한 도구만 사용할 수 있습니다. 일시적인 이유로 실패한 실행은 최대 3번 재시도하고, 사용량 한도에 도달하면 남은 속성의 실행을 중단하며, 워치독이 5시간이 지난 실행을 종료합니다. 실행 중에는 Mac이 절전 모드로 들어가지 않게 유지됩니다.
커버를 만들 때 스크립트는 Claude Code에 make_cover라는 도구 하나만 있는 두 번째 MCP 서버를 제공합니다. 이 도구는 Codex CLI(ChatGPT로 로그인) 또는 Grok CLI로 AutoPSEO의 프롬프트를 그리며, 각각 별도의 샌드박스에서 실행되고 app.autopseo.com으로만 업로드합니다.
나만의 AI만 글을 쓰게 하려면 작성기로 나만의 AI(MCP 사용)를 선택하고 주간 새 글 수를 0보다 크게 유지하세요. 이 속도는 큐를 채우는 일일 검토와 보충에도 쓰이므로, 0이면 새 주제가 큐에 들어오지 않습니다.