velog_mcp

ClaudeがVelogに直接投稿を作成・公開できるMCPサーバー。

公開APIが存在しないVelogを、GraphQLのリバースエンジニアリングによってサポートします。ドラフト作成 → ユーザーによるレビュー → 公開というHuman-in-the-loopフローで設計されており、自動化しつつもユーザーが完全な制御を維持できます。

インストール

npx velog_mcp_setup

Velogにログインした状態で、ブラウザのDevTools → Application → Cookies → https://velog.io から access_token と refresh_token の値をコピーして入力してください。

トークンは ~/.velog-mcp.json に 0600 権限で保存されます。.gitignore に追加してください。

Related MCP server: velog-mcp

Claude CLI (Claude Code) 設定

プロジェクトに追加

claude mcp add velog npx -y velog_mcp

または、プロジェクトの .claude/settings.json に直接追加します：

{
  "mcpServers": {
    "velog": {
      "command": "npx",
      "args": ["-y", "velog_mcp"]
    }
  }
}

グローバルに追加

claude mcp add --scope global velog npx -y velog_mcp

グローバル設定はすべてのプロジェクトで使用可能です。

確認

claude mcp list

velog サーバーがリストに表示されれば準備完了です。以降、Claude Codeの対話で直接使用できます。

나: "React 훅에 대한 글 써줘"
Claude: (velog_draft_post 호출 → 검토 후 발행)

Claude Desktop 設定

~/Library/Application Support/Claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "velog": {
      "command": "npx",
      "args": ["-y", "velog_mcp"]
    }
  }
}

使用方法

投稿の作成と公開

나: "React 19 concurrent features에 대한 글 써줘"

Claude: velog_draft_post 호출
→ { draft_id: "abc123", title: "React 19 Concurrent Features 정리", body_preview: "..." }

나: "좋아, 발행해"

Claude: velog_publish_post(draft_id: "abc123") 호출
→ { url: "https://velog.io/@username/react-19-...", post_id: "..." }

非公開での公開

나: "이 글 비공개로 발행해줘"
Claude: velog_publish_post(draft_id: "abc123", is_private: true)

ツール一覧

認証

• access_token: 約1〜2時間のTTL。VelogサーバーがGraphQLレスポンスの Set-Cookie で自動更新します。

• refresh_token: 約30日のTTL。期限切れの場合は npx velog_mcp_setup を再実行する必要があります。

• 個別のリフレッシュエンドポイントはありません — Velogミドルウェアが自動処理します。

エラー処理

注意事項

• ドラフトはMCPサーバープロセスのセッションメモリに保存されます。Claude Desktopを再起動すると消滅します。

• 公開せずに保存したい場合は velog_publish_post(is_private: true) で非公開保存してください。

• 画像: Markdownの外部URL参照方式 (![alt](url)) を使用してください。

ライセンス

MIT