esa MCP Server（esa.io 公式）

esa.io とは

esa.io は、国産の社内情報共有 SaaS です。「シャベる Wiki」をコンセプトに、Markdown ベースの記事を「WIP（書きかけ）→ Ship It!（公開）」のステータスで管理し、カテゴリ階層でフォルダのように整理できます。スタートアップ・IT 企業を中心に、議事録・仕様書・日報・ナレッジ集約のツールとして広く使われています。

料金は 2 ヶ月の無料試用 つきで、その後 月 500 円（税込）/ ユーザー（公式 pricing 逐語）。Kibela / Notion / Confluence と並ぶ国産・廉価な選択肢です。

esa.io × AI でできること

この MCP サーバーを導入すると、esa.io API を AI への一言で呼び出せます。

📝 記事の検索・要約

「先週書いた仕様書のノートを検索して」
→ esa_search_posts で記事を横断検索 + esa_summarize_post（プロンプト）で要約

✏️ 新規記事の下書き作成

「今日の打ち合わせ議事録を WIP で下書きして」
→ esa_create_post でタイトル / 本文 / タグ / カテゴリー / WIP ステータス付き作成

📂 カテゴリ構造の把握と整理

「『開発標準』配下の全記事パス一覧」
→ esa_get_all_category_paths でフィルタリング付き取得（カテゴリ整理計画に最適）

💬 コメント管理

「このノートに『LGTM』とコメント追加」
→ esa_create_comment で AI が自然言語のままコメント投稿

提供される 25 ツール

esa MCP Server が提供するツール（公式 README 逐語抽出）。

チーム管理（4）

ツール名	機能
esa_get_teams	所属している esa チームの一覧
esa_get_team_stats	チームの統計情報（メンバー数、記事数、コメント数など）
esa_get_team_tags	チーム内で使われているタグと使用回数
esa_get_team_members	チームメンバーとその役割・プロフィール

記事管理（5）

ツール名	機能
esa_search_posts	記事を検索（esa の検索構文がそのまま使える）
esa_get_post	記事 ID から記事を取得（バックリンク総数 backlinks_count 含む）
esa_get_post_backlinks	指定記事を参照している記事の一覧（ページング対応）
esa_create_post	新しい記事を作成（タグ・カテゴリー・WIP ステータス付き）
esa_update_post	記事を更新（タイトル・本文・タグ・カテゴリー・WIP ステータス）

記事の操作（3）

ツール名	機能
esa_archive_post	記事をアーカイブ（Archived/ カテゴリーへ移動）
esa_ship_post	記事を Ship It!（WIP を外して公開）
esa_duplicate_post	記事を複製（別チームへの複製も可能）

コメント管理（6）

ツール名	機能
esa_get_comment	コメント ID からコメントを取得
esa_create_comment	記事にコメントを追加
esa_update_comment	コメントを編集
esa_delete_comment	コメントを削除
esa_get_post_comments	記事のコメント一覧（ページング対応）
esa_get_team_comments	チーム全体のコメント一覧（ページング対応）

カテゴリー管理（3）

ツール名	機能
esa_get_categories	指定パス配下のカテゴリー一覧
esa_get_top_categories	トップレベルのカテゴリー一覧
esa_get_all_category_paths	チーム内の全カテゴリーパス一覧（記事数付き・フィルタリング対応）

添付ファイル（1）

ツール名	機能
esa_get_attachment	記事やコメントの添付ファイルを取得（JPEG/PNG/GIF/WebP の 30MB 以下は base64、それ以外は署名付き URL 有効期限 5 分）

ヘルプとドキュメント（3）

ツール名	機能
esa_get_search_options_help	esa の検索構文ヘルプ
esa_get_markdown_syntax_help	esa の Markdown 記法ヘルプ
esa_search_help	esa のドキュメントから機能や用語を検索

このほか リソース esa_recent_posts（最近更新された記事 JSON リスト・URI テンプレート esa://teams/{teamName}/posts/recent）と プロンプト esa_summarize_post（記事の構造化要約）が提供されます（公式 README 逐語）。

esa MCP Server について

esa MCP Server は、esa LLC（esa.io 運営元）の公式 MCP サーバーです。リポジトリは github.com/esaio/esa-mcp-server。STDIO Transport 版で、Docker（公式推奨）または npx で起動します。

スペック

• 配布形態: npm @esaio/esa-mcp-server（最新 0.10.0・2026-05-23 公開）+ Docker イメージ ghcr.io/esaio/esa-mcp-server
• 実行コマンド: Docker（推奨）docker run -i --rm -e ESA_ACCESS_TOKEN -e LANG ghcr.io/esaio/esa-mcp-server、または npx npx @esaio/esa-mcp-server
• 認証: ESA_ACCESS_TOKEN 環境変数（PAT v2 推奨・公式 README 逐語）
• 提供元: esa LLC（公式）/ MIT ライセンス（package.json 明記）
• 対応範囲: チーム / 記事 / コメント / カテゴリ / 添付 / ヘルプの 25 ツール + リソース 1 + プロンプト 1
• 公式リポジトリ: github.com/esaio/esa-mcp-server
• 公式 API ドキュメント: docs.esa.io/posts/102

導入手順

1. esa.io アカウントとチームの作成

1. esa.io にアクセスして無料試用を開始
2. チームを作成（チーム作成月から 2 ヶ月後の月末まで無料・以降は月 500 円 / ユーザー）

2. PAT v2（Personal Access Token v2）の発行

esa.io 公式手順（docs.esa.io/posts/559 逐語）:

1. esa にログイン
2. SETTINGS > その他 > パーソナルアクセストークン・OAuth に進む
3. 「新しい PAT v2 を作成」 ボタンをクリック
4. 必要なスコープを選択（read write または細分化スコープ admin:comment read:post write:post read:category read:tag read:attachment read:team read:member）
5. 申請が必要なチームを選択した場合は、申請理由を入力
6. 発行されたトークン（ep2_ プレフィックス付き）を安全に保管

3. クライアント設定の登録

オプション 1: Docker（公式推奨）

claude_desktop_config.json 等に上記「クライアント別設定」の Docker 版 JSON を追記し、<YOUR_ESA_PAT_V2_TOKEN> を発行した PAT に置き換えてください。

オプション 2: npx

{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": ["@esaio/esa-mcp-server"],
      "env": {
        "ESA_ACCESS_TOKEN": "<YOUR_ESA_PAT_V2_TOKEN>",
        "LANG": "ja"
      }
    }
  }
}

注: クライアントによっては npx の絶対パス（例: which npx で取得した /Users/your-username/.nodenv/shims/npx）が必要な場合があります（公式 README 注記）。

4. 動作確認

クライアントを再起動し、「所属チーム一覧を見せて」「『議事録』を検索して」のように依頼してみてください。

注意事項

• esa.io は有料 SaaS です。チーム作成から 2 ヶ月の無料試用後、月 500 円（税込）/ ユーザー の課金が発生します（公式 pricing）。「すべての機能が使える」と公式に明記されており、MCP / PAT v2 もこの範囲で利用できます。試用期間中の MCP 利用可否は公式に明記なし。
• PAT v2 は強い権限を持ちます。リポジトリ・チャット履歴・公開ノートにそのまま貼らないでください。漏洩時は esa.io 上で revoke できます。write:post 等の書き込みスコープを付与する場合は AI による誤操作リスクを考慮してください（不要なら read のみのスコープに絞る）。
• 公式推奨は Docker です。Node.js 環境を汚さず、@modelcontextprotocol/sdk 等の依存更新もイメージ側で吸収されます。npx 版を使う場合は Node.js 24 以上が必要です。
• 添付ファイルの取得: 30MB 以下の JPEG / PNG / GIF / WebP は base64 エンコードで返却、それ以外（大きい画像・その他のファイル形式・forceSignedUrl 指定時）は 有効期限 5 分 の署名付き URL が返されます（公式 README 逐語）。AI に渡すサイズには上限があるため、大きな添付は要約のみ依頼するなどの工夫が必要です。
• アーカイブ操作は破壊的ではない: esa_archive_post は記事を Archived/ カテゴリーへ「移動」するだけで削除ではありません。元に戻したい場合はカテゴリー変更で復帰できます。
• 本記事は公式情報リサーチに基づくものです（編集部による実機検証は未実施）。動作確認は npm registry での @esaio/esa-mcp-server@0.10.0 実在確認（2026-05-23 公開・MIT）と、公式 README からのツール 25 件逐語抽出を実施しています。

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_ACCESS_TOKEN",
        "-e",
        "LANG",
        "ghcr.io/esaio/esa-mcp-server"
      ],
      "env": {
        "ESA_ACCESS_TOKEN": "<YOUR_ESA_PAT_V2_TOKEN>",
        "LANG": "ja"
      }
    }
  }
}

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_ACCESS_TOKEN",
        "-e",
        "LANG",
        "ghcr.io/esaio/esa-mcp-server"
      ],
      "env": {
        "ESA_ACCESS_TOKEN": "<YOUR_ESA_PAT_V2_TOKEN>",
        "LANG": "ja"
      }
    }
  }
}

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_ACCESS_TOKEN",
        "-e",
        "LANG",
        "ghcr.io/esaio/esa-mcp-server"
      ],
      "env": {
        "ESA_ACCESS_TOKEN": "<YOUR_ESA_PAT_V2_TOKEN>",
        "LANG": "ja"
      }
    }
  }
}