Esa.io

esa.io API と連携するための Model Context Protocol Server (mcp server)です。Pythonで実装しています。

- ユーザー情報取得（user_get_info）
- 記事一覧取得（posts_get_list）
- 記事詳細取得（posts_get_detail）
- 記事作成 (posts_create)
- 記事更新 (posts_update)
- 記事削除 (posts_delete)

- あなたの esa.io チームのページにアクセスします (例:https://<your-team-name>.esa.io/)。
- 左カラムのSETTINGSをクリックし、「ユーザー設定」>「外部アプリ連携」を選択します。
- 「Personal access tokens」セクションで、「Generate new token」をクリックします。
- トークン名 (例:mcp-server) を入力し、必要な権限スコープを選択します。この MCP サーバーには少なくとも以下の権限が必要です:

- read(記事の読み取り)
- write(記事の作成・更新・削除)
- read_user(ユーザー情報の取得) （この項目は自動的に有効になるため、表示されない可能性があります）

esa.ioでは、サインアップから2ヶ月間の無料トライアル期間が提供されています。この期間を利用して、テスト用のチーム名とAPIトークンを取得することができます。

ESA_TEAM_NAME="YOUR_ESA_TEAM_NAME" # Replace with your esa.io team name (e.g., "myteam") ESA_TOKEN="YOUR_ESA_API_TOKEN" # Replace with your esa.io API access token

{ "mcpServers": { "mcp-esa-server": { "command": "uv", "args": [ "--directory", "<プロジェクトの絶対パス>", "run", "main.py" ], "env": { "ESA_TEAM_NAME": "<your-team-name>", "ESA_TOKEN": "<your-esa-token>" } } } }

- <your-team-name>と<your-esa-token>は各自のesa.ioチーム名・APIトークンに置き換えてください。
- env: 環境変数を直接設定します。この方法を使用する場合、.cursor/mcp.jsonのコミットは絶対に避けてください。

- CursorエディタのコマンドパレットやUIから「MCPサーバーを起動」または「AIツールを有効化」します。
- mcp.jsonの設定に従い、uv run main.pyでサーバーが起動します。
- .envファイルや環境変数も自動的に読み込まれます。

- AIチャット上でuser_get_infoやposts_get_listなどのMCPツールを呼び出すことで、esa.io APIと連携した操作が可能です。
- mcp-esa-serverを使って記事の作成をお願いしますなどとチャット上で書き込むことで利用できます。

このプロジェクトの一部では、以下のMIT Licenseで公開されているコードを参照しています。

- esa-mcp-server

- GitHubリポジトリ: [https://github.com/masseater/esa-mcp-server]
- ライセンス: MIT License

generated by Cursor (gemini-2.5-pro-exp-03-25)

An MCP server that enables AI assistants to interact with Confluence content through a standardized interface.

An MCP server for interacting with the esa.io knowledge-sharing platform.

A MCP server for the document sharing service esa.io.

Access personal and team knowledge from documents and Slack discussions.

Access personal and team knowledge repositories, including documents and Slack discussions.

Provides API tools to interact with Yonote documents and collections.

Official Notion MCP server for searching, reading, creating, and updating Notion pages, databases, and workspace content from AI agents.

Collaborative word processor you can use with your agent

MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.

Interact with Atlassian Confluence Cloud spaces, pages, and content in real-time.