> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# emma MCP Server

> 公式MCPサーバーを使用して、AIエージェントをemmaのインテグレーションとSkillに接続します。

emma MCP Serverは、Cursor、Claude Code、Codexなど、あらゆるMCP対応クライアントに、emmaのインテグレーション群とSkillライブラリへのプログラマティックなアクセスを提供します。しかも、数百個の個別ツールでエージェントのコンテキストウィンドウを圧迫することはありません。

Slack・GitHub・Notionなどのアクション1つひとつに個別のMCPツールを登録する代わりに、emmaは（Composioに似た）**Tool Vendor**パターンを採用しています：少数のメタツールによって、エージェントが適切なインテグレーションを*検索*し、そのスキーマを*確認*し、必要に応じて*実行*できるようにします。保存済みの再利用可能なワークフローに対しては、同様の**Skill Vendor**パターンが用意されています。

## 機能

<CardGroup cols={2}>
  <Card title="ツールの発見" icon="search">
    ツール名を覚える代わりに、キーワードでemmaのインテグレーション（Slack、GitHub、Notion、Gmailなど）を検索
  </Card>

  <Card title="直接実行" icon="zap">
    発見したツールを構造化された引数で実行し、結果をそのまま受け取る
  </Card>

  <Card title="組み込みのOAuth処理" icon="key">
    ツールに認証が必要な場合、自動的に接続リンクが返される — 個別の認証フローを構築する必要はない
  </Card>

  <Card title="Skillライブラリ" icon="book">
    ワークフローを一度保存すれば、どのマシン・IDE・エージェントからでも再利用可能 — Skillはemmaのクラウドに保存される
  </Card>

  <Card title="ヘルスモニタリング" icon="heart-pulse">
    他の操作を行う前にAPIキーと接続を確認
  </Card>
</CardGroup>

## 認証

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

### API Keyの取得方法

1. [emma](https://app.emma.ai)にログイン
2. **API Keys**に移動
3. API Keyを作成またはコピー

すべてのリクエストで`Authorization: Bearer <api_key>`（または`X-API-Key: <api_key>`）として送信します。具体的なクライアント設定は[セットアップガイド](/ja/mcp/setup)を参照してください。

<Warning>
  API Keyは安全に保管してください。バージョン管理にコミットしたり、公開したりしないでください。
</Warning>

## 利用可能なツール

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

### ヘルスチェック

| ツール                 | 説明              |
| ------------------- | --------------- |
| `emma_health_check` | 接続とAPIキーの有効性を確認 |

### Tool Vendor

| ツール                    | 説明                                              |
| ---------------------- | ----------------------------------------------- |
| `emma_search_tools`    | キーワードでemmaのインテグレーションを検索（例：「post slack message」） |
| `emma_get_tool_schema` | 特定のインテグレーションツールの入力スキーマを取得                       |
| `emma_execute_tool`    | 特定のインテグレーションツールを引数付きで実行                         |

### Skill Vendor

| ツール                 | 説明                              |
| ------------------- | ------------------------------- |
| `emma_list_skills`  | 保存済みSkill（再利用可能なワークフロー）を新しい順に一覧 |
| `emma_get_skill`    | Skillの完全な手順を取得                  |
| `emma_create_skill` | 再利用可能なワークフローを新しいSkillとして保存      |
| `emma_update_skill` | 既存のSkillを更新                     |
| `emma_delete_skill` | Skillを削除                        |

<Note>
  各ツールの詳細なパラメータ、レスポンス形式、例は[ツールリファレンス](/ja/mcp/tools-reference)を参照してください。
</Note>

## 推奨ワークフロー

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

<Steps>
  <Step title="ツールを検索">
    自然言語のクエリ（オプションで`service`によるフィルタ）を指定して`emma_search_tools`を呼び出し、適切なインテグレーションツール名を見つけます。
  </Step>

  <Step title="スキーマを確認（必要な場合）">
    正確なツール名を指定して`emma_get_tool_schema`を呼び出し、必須・任意の引数を確認します。
  </Step>

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

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

<Steps>
  <Step title="既存のSkillを確認">
    タスクを始める前に`emma_list_skills`を呼び出します — （オプションで`query`によるフィルタ付きで）保存済みの全Skillをページネーション形式で返します。
  </Step>

  <Step title="手順を読む">
    `skill_id`を指定して`emma_get_skill`を呼び出し、完全な手順を取得します。
  </Step>

  <Step title="手順に従って実行">
    エージェント自身が手順を実行し、必要に応じて`emma_search_tools` / `emma_execute_tool`でインテグレーションアクションを行います。
  </Step>

  <Step title="新しいワークフローを保存">
    再利用する価値のあるワークフローが完成したら、`emma_create_skill`で保存し、後から他のマシンやエージェントでも使えるようにします。
  </Step>
</Steps>

## ユースケース

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

```
「'Deploy finished ✅' をSlackの#generalに投稿して」
「owner/repoに 'Fix login redirect bug' というタイトルのGitHub issueを作成して」
「Notionに関連するツールを検索して」
```

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

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

```
「チームのSlackにメッセージを送って」
```

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

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

```
「これを 'Weekly Status Report' というSkillとして保存して」
「保存済みのSkillを一覧表示して」
「'Weekly Status Report' Skillを実行して」
```

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

## 次のステップ

<CardGroup cols={2}>
  <Card title="セットアップガイド" icon="wrench" href="/ja/mcp/setup">
    Cursor、Claude Code、Codexでemma MCP Serverを設定
  </Card>

  <Card title="ツールリファレンス" icon="book" href="/ja/mcp/tools-reference">
    全ツールの詳細ドキュメント
  </Card>
</CardGroup>