esa MCP Server
公式esa.io向け公式Model Context Protocol (MCP)サーバー - STDIOトランスポート版。
Esa MCPで何ができますか?
- 投稿の検索と閲覧 —
esa_search_postsで投稿を検索し、番号を指定してesa_get_postで取得すると、被リンク数と本文の統計を確認できます。 - コンテンツの作成と編集 —
esa_create_postで投稿を作成し、esa_update_postで更新できます。また、esa_append_postとesa_prepend_postを使ってテキストを末尾または先頭に追加できます。 - 投稿のライフサイクル管理 —
esa_ship_postで投稿を公開し、esa_archive_postでアーカイブし、esa_duplicate_postで複製できます。または、以前のリビジョンに戻すこともできます。 - コメントの管理 — 投稿またはチームのコメントを一覧表示し、
esa_create_comment、esa_update_comment、esa_delete_commentで作成、更新、削除できます。 - カテゴリとチームの確認 —
esa_get_all_category_pathsでカテゴリのパスを確認し、esa_get_team_statsとesa_get_team_membersでチームの詳細を確認できます。 - 投稿の要約 —
esa_summarize_postプロンプトを使うと、指定したチームの投稿を構造化された形式で要約できます。
ドキュメント
esa MCP Server
日本語 | 英語
esa.io 向けの公式 Model Context Protocol (MCP) サーバー - STDIO トランスポート版。
概要
この MCP サーバーは、AI アシスタントと、共同ドキュメントプラットフォームである esa.io をシームレスに連携します。Model Context Protocol を通じて、AI アシスタントが esa のドキュメントを直接読み取り、作成、更新、管理できるようにします。
利用可能なツール
チーム管理
esa_get_teams- ユーザーがアクセスできる esa チームを取得esa_get_team_stats- チームの統計情報を取得(メンバー、投稿、コメント、スター、ウォッチ、アクティブユーザー)esa_get_team_tags- チームの投稿で使用されているすべてのタグを件数とともに取得esa_get_team_members- 役割とプロフィール情報を含むチームメンバーを取得
投稿管理
esa_search_posts- esa.io の投稿を検索esa_get_post- 投稿番号で特定の投稿を取得(本文の文字数と行数を含むbacklinks_countおよびbody_md_statsを含む)esa_get_post_backlinks- 特定の投稿を参照している投稿をページネーション付きで一覧表示esa_create_post- タグ、カテゴリ、WIP ステータスを指定して新しい投稿を作成esa_update_post- 既存の投稿を更新(タイトル、内容、タグ、カテゴリ、WIP ステータス)esa_append_post- 投稿本文の末尾に内容を追加(現在の本文を取得する必要はありません。新しいリビジョンとして保存されます)esa_prepend_post- 投稿本文の先頭に内容を追加(現在の本文を取得する必要はありません。新しいリビジョンとして保存されます)
投稿アクション
esa_archive_post- 投稿を Archived/ カテゴリに移動してアーカイブesa_ship_post- 投稿を Ship する(wip を false に設定して完了としてマーク)esa_duplicate_post- 投稿を複製(同じタイトルと本文で新しい WIP 投稿を作成。チームをまたいだ複製にも対応)esa_rollback_post_revision- 投稿を指定したリビジョンにロールバック(復元した内容は新しいリビジョンとして保存されます。リビジョン番号はesa_get_postのrevision_numberで確認してください)
コメント管理
esa_get_comment- ID で特定のコメントを取得esa_create_comment- 投稿に新しいコメントを作成esa_update_comment- 既存のコメントを更新esa_delete_comment- コメントを削除esa_get_post_comments- 特定の投稿のコメントをページネーション付きで取得esa_get_team_comments- チームのコメントをページネーション付きで取得
カテゴリ管理
esa_get_categories- 特定のパスのカテゴリとサブカテゴリを取得esa_get_top_categories- チームの最上位カテゴリをすべて取得esa_get_all_category_paths- チーム内のすべてのカテゴリパスを取得(投稿数を含み、フィルタリングに対応)- カテゴリ構造の把握、整理計画、クリーンアップに最適
- フィルタの例: 開発関連は
prefix: "dev"、API 関連カテゴリはmatch: "api"
添付ファイル
esa_get_attachment- esa の投稿やコメントから添付ファイルを取得- 30MB 未満の対応画像(JPEG、PNG、GIF、WebP)は base64 エンコードされたデータを返します
- その他のファイル形式、大きな画像、または forceSignedUrl が指定された場合は、署名付き URL(有効期間 5 分)を返します
ヘルプとドキュメント
esa_get_search_options_help- esa の検索構文ドキュメントを取得esa_get_markdown_syntax_help- esa の Markdown 構文ドキュメントを取得esa_search_help- 機能や用語について esa のドキュメントを検索
利用可能なリソース
esa_recent_posts- esa チームの最近更新された投稿を取得- テンプレート:
esa://teams/{teamName}/posts/recent - 戻り値: 最近更新された投稿の JSON リスト
- テンプレート:
利用可能なプロンプト
esa_summarize_post- esa の投稿内容を要約- 入力: チーム名と投稿番号
- 出力: 投稿内容の構造化された要約
MCP クライアントの設定
MCP クライアントの設定ファイルに追加します。
必須の環境変数
- ESA_ACCESS_TOKEN: アクセストークン
- 必須スコープ:
read writeまたはadmin:comment read:post write:post read:category read:tag read:attachment read:team read:member - PAT v2 を推奨します。
- 必須スコープ:
- LANG: UI の言語
Claude Desktop の例
claude_desktop_config.json に追加します。
オプション 1: Docker(推奨)
{
"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_personal_access_token",
"LANG": "en"
}
}
}
}
オプション 2: npx
{
"mcpServers": {
"esa": {
"command": "/Users/your-username/.nodenv/shims/npx",
"args": ["@esaio/esa-mcp-server"],
"env": {
"ESA_ACCESS_TOKEN": "your_personal_access_token",
"LANG": "en"
}
}
}
}
注:
/path/to/your/nodeをwhich nodeコマンドの出力に置き換えてください。
レジストリ
このパッケージには、パッケージのルートに registry.json が含まれており、登録済みのツール、リソース、プロンプトを公開しています。サーバーを起動せずに、プログラムから利用できます。
import registry from "@esaio/esa-mcp-server/registry.json" with {
type: "json",
};
スキーマ:
{
"tools": [{ "name": "esa_get_teams" }, "..."],
"resources": [
{
"name": "esa_recent_posts",
"uriTemplate": "esa://teams/{teamName}/posts/recent"
}
],
"prompts": [{ "name": "esa_summarize_post" }]
}
このファイルは npm run build:registry によって再生成され、CI チェックによって登録済みの項目との同期が保たれていることが検証されます。
リンク
- esa.io - 共同ドキュメントプラットフォーム
- Model Context Protocol - MCP の詳細
- API Documentation - esa.io API リファレンス
- Claude Desktop - MCP に対応した AI アシスタント
サポート
- 📧 サポート: フィードバックフォーム
- 🐛 問題の報告: GitHub Issues
- 📖 ヘルプ: esa Docs
esa チームが ❤️ を込めて作成