Claude에서 직접 게시하기 — API와 MCP

MiraiPage는 브라우저를 열지 않고도 조작할 수 있습니다. REST API가 있고, MCP 서버가 본체에 내장되어 있어 Claude Code 같은 AI 에이전트에서 직접 "기사를 써서 공개해줘"라고 요청할 수 있습니다. 설정은 3분이면 끝납니다.

필요한 것: Premium 플랜

API 액세스는 Premium 플랜의 기능입니다. Free나 Pro에서는 사용할 수 없습니다.

1단계: API 토큰 발급하기

설정 화면의 "API 토큰"에서 토큰을 발급합니다. 이름을 붙여 생성하면 그 자리에서 단 한 번 원본 문자열이 표시됩니다.

이는 다시 표시되지 않습니다. 서버 측에는 해시만 저장되므로, 복원하는 것도 불가능합니다. 반드시 그 자리에서 복사하여 패스워드 매니저 등에 저장해 두세요.

토큰은 계정당 최대 10개까지 보유할 수 있습니다. 용도별로 나눠 발급하고, 불필요해지면 폐기하는 방식이 안전합니다. 유효 기간을 설정할 수도 있습니다.

2단계: 먼저 통신 확인하기

curl https://www.miraipage.net/api/v1/me \
  -H "Authorization: Bearer 당신의토큰"

자신의 사용자명과 플랜이 반환되면 성공입니다.

3단계: 기사 게시해보기

curl -X POST https://www.miraipage.net/api/v1/posts \
  -H "Authorization: Bearer 당신의토큰" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "APIから投稿してみた",
    "content": "## 見出し\n\n本文です。",
    "status": "draft",
    "category": "development",
    "tags": ["API"]
  }'

status를 draft로 설정해두면 임시 저장으로 생성되므로 안심하고 테스트할 수 있습니다. 공개할 때는 published로 설정합니다.

API 문서의 인증 란. ①이 요청에 추가하는 헤더, ②가 필요한 플랜입니다

본론: MCP로 Claude에 연결하기

여기서부터가 핵심입니다. MiraiPage에는 HTTP 방식의 MCP 서버가 내장되어 있습니다. 엔드포인트는 https://www.miraipage.net/api/mcp입니다.

별도로 서버를 구축하거나 npm 패키지를 설치할 필요가 없습니다.

Claude Code에 등록하기

claude mcp add -t http miraipage "https://www.miraipage.net/api/mcp" \
  -H "Authorization: Bearer 당신의토큰"

이 프로젝트뿐만 아니라 모든 프로젝트에서 사용하고 싶은 경우에는 -s user를 추가합니다.

claude mcp add -s user -t http miraipage "https://www.miraipage.net/api/mcp" \
  -H "Authorization: Bearer 당신의토큰"

설정 파일에 직접 작성하는 방식도 가능합니다.

{
  "mcpServers": {
    "miraipage": {
      "url": "https://www.miraipage.net/api/mcp",
      "headers": {
        "Authorization": "Bearer 당신의토큰"
      }
    }
  }
}

무엇을 할 수 있게 되는가

등록하면 43개의 툴을 사용할 수 있게 됩니다. 주요 기능을 소개합니다.

• 기사 — 목록 조회·가져오기·생성·수정·삭제
• 이미지 — 업로드하여 기사에 삽입
• 슬라이드 — 덱 가져오기·교체·섹션 단위 삽입과 삭제
• 번역 — 기사 번역 / 번역문 교체
• 연재 — 생성·수정·기사 연결
• 살롱 — 스레드 생성·수정, 메시지 게시와 조회
• 이벤트 — 목록 조회·가져오기·예약
• 프로필 — 자기소개 및 링크 목록 수정
• Webhook — 등록·삭제
• 반응 — 좋아요, 댓글, 팔로우

실제 활용 방법

등록 후에는 자연스럽게 한국어로 요청할 수 있습니다.

"이 조사 결과를 기사로 만들어서 임시 저장해줘"

"방금 그 기사, 영어로 번역해줘"

"슬라이드 세 번째 장만 교체해줘"

에이전트가 해당 툴을 선택해 실행합니다. 로컬 파일이나 터미널 출력을 그대로 기사로 만들 수 있어, 작업 기록이 그대로 기사가 되는 활용이 현실적으로 가능해집니다.

안전하게 사용하기 위해

• 토큰은 용도별로 나눠서 발급. 유출 시 영향 범위를 최소화할 수 있습니다
• 자동 게시를 구성할 때는 먼저 status: "draft"로 실행하여 결과를 눈으로 확인한 후 published로 전환
• 불필요해진 토큰은 설정 화면에서 폐기

Webhook과 조합하기

MiraiPage는 기사의 생성·수정·공개·비공개·삭제 시점에 Webhook을 발송할 수 있습니다.

post.published를 수신하여 SNS에 전달하거나, 사내 채팅에 알림을 보내는 등의 연동을 구성할 수 있습니다. MCP로 작성하고, Webhook으로 배포하는 방식으로 발신의 전후 과정을 자동화할 수 있습니다.

다음 회에는 살롱 채팅에 내장된 AI 커맨드를 전부 소개합니다.