Skip to main content
emma MCP Serverは、Cursor、Claude Code、Codexなど、あらゆるMCP対応クライアントに、emmaのインテグレーション群とSkillライブラリへのプログラマティックなアクセスを提供します。しかも、数百個の個別ツールでエージェントのコンテキストウィンドウを圧迫することはありません。 Slack・GitHub・Notionなどのアクション1つひとつに個別のMCPツールを登録する代わりに、emmaは(Composioに似た)Tool Vendorパターンを採用しています:少数のメタツールによって、エージェントが適切なインテグレーションを検索し、そのスキーマを確認し、必要に応じて実行できるようにします。保存済みの再利用可能なワークフローに対しては、同様のSkill Vendorパターンが用意されています。

機能

ツールの発見

ツール名を覚える代わりに、キーワードでemmaのインテグレーション(Slack、GitHub、Notion、Gmailなど)を検索

直接実行

発見したツールを構造化された引数で実行し、結果をそのまま受け取る

組み込みのOAuth処理

ツールに認証が必要な場合、自動的に接続リンクが返される — 個別の認証フローを構築する必要はない

Skillライブラリ

ワークフローを一度保存すれば、どのマシン・IDE・エージェントからでも再利用可能 — Skillはemmaのクラウドに保存される

ヘルスモニタリング

他の操作を行う前にAPIキーと接続を確認

認証

emma MCP Serverは認証にAPI Keyを使用します。

API Keyの取得方法

  1. emmaにログイン
  2. API Keysに移動
  3. API Keyを作成またはコピー
すべてのリクエストでAuthorization: Bearer <api_key>(またはX-API-Key: <api_key>)として送信します。具体的なクライアント設定はセットアップガイドを参照してください。
API Keyは安全に保管してください。バージョン管理にコミットしたり、公開したりしないでください。

利用可能なツール

emma MCP Serverは3つのカテゴリに分類された9つのツールを提供します:

ヘルスチェック

Tool Vendor

Skill Vendor

各ツールの詳細なパラメータ、レスポンス形式、例はツールリファレンスを参照してください。

推奨ワークフロー

Tool Vendor: 検索 → スキーマ確認 → 実行

1

ツールを検索

自然言語のクエリ(オプションでserviceによるフィルタ)を指定してemma_search_toolsを呼び出し、適切なインテグレーションツール名を見つけます。
2

スキーマを確認(必要な場合)

正確なツール名を指定してemma_get_tool_schemaを呼び出し、必須・任意の引数を確認します。
3

実行

ツール名と引数のJSONオブジェクトを指定してemma_execute_toolを呼び出します。対象サービスの認証がまだ済んでいない場合、レスポンスにconnect_linkが含まれます — アクセスして認証後、再試行してください。

Skill Vendor: 一覧 → 取得 → 実行 → 保存

1

既存のSkillを確認

タスクを始める前にemma_list_skillsを呼び出します — (オプションでqueryによるフィルタ付きで)保存済みの全Skillをページネーション形式で返します。
2

手順を読む

skill_idを指定してemma_get_skillを呼び出し、完全な手順を取得します。
3

手順に従って実行

エージェント自身が手順を実行し、必要に応じてemma_search_tools / emma_execute_toolでインテグレーションアクションを行います。
4

新しいワークフローを保存

再利用する価値のあるワークフローが完成したら、emma_create_skillで保存し、後から他のマシンやエージェントでも使えるようにします。

ユースケース

IDEからインテグレーションを発見して使う

エージェントはemma_search_toolsを呼び出し、次にemma_execute_toolを呼び出します(引数がわからない場合は先にスキーマを取得します)。

タスク実行中に認証を処理する

まだSlackを接続していない場合、emma_execute_toolsuccess: falsereason: "auth_required"、およびconnect_linkを返します。エージェントはそのリンクを提示し、ユーザーの認証を待ってから同じ呼び出しを再試行してください。

ワークフローをSkillとして保存・再利用する

この方法で作成したSkillはemmaのWeb UIのSkillsタブにも表示され、MCPクライアントだけでなくemma自身のエージェントからも利用できます。

次のステップ

セットアップガイド

Cursor、Claude Code、Codexでemma MCP Serverを設定

ツールリファレンス

全ツールの詳細ドキュメント