概要
MCP のドキュメントの多くは、外部ツールを EKB エージェントの内側へ接続する方法を説明しています。このセクションはその逆です。EKB 自体を MCP サーバーとして公開し、MCP 互換のクライアント — Claude、Cursor、ChatGPT、あるいは独自のエージェント — が誰でもワークスペースを構築・利用できるようにします。
| 方向 | 行うこと | ドキュメント |
|---|---|---|
| MCP in EKB | エージェントの MCP タブで Sentry、New Relic、Power BI、または独自の MCP サーバーを追加 | MCP in EKB |
| EKB as MCP | Claude / Cursor / ChatGPT を EKB の MCP URL に向けることで、それらのクライアントが EKB を操作 | このセクション |
前提条件
- 少なくとも1プロジェクトにアクセスできる EKB アカウント
- HTTP MCP URL と OAuth（または API キー用のカスタムヘッダー）をサポートする MCP クライアント
- 本番ホストの場合、環境の MCP ホスト名へのネットワークアクセス（例：
https://mcp.getodin.ai） - ヘッドレス CI の場合、ユーザー単位の API キーとシークレット
2つのサーバー、2種類のアクセス
EKB は 2つの MCP エンドポイントを公開しています。意図的に分かれています：サポートエージェントに質問することは、クライアントにエージェントの作成や書き換えを許可することより小さなグラントです。そのため、同意画面やトークンを共有しません。
| エンドポイント | サーバー | 同意ラベル | スコープ | クライアントができること |
|---|---|---|---|---|
/builder/mcp | EKB Builder | Build in your workspace | odin:build | エージェント、ワークフロー、スマートテーブル、インターフェース、ナレッジベースの作成と変更 — Autopilot が使うのと同じツールキットサーフェス |
/runtime/mcp | EKB Runtime | Use your agents and tools | odin:use | 既存のエージェントへの質問、公開済みツールの実行、ナレッジベースの検索、スマートテーブルのクエリ |
Runtime に対して発行されたトークンは Builder で再利用できず、その逆も同様です。「use」アクセスが「build」アクセスにエスカレートすることはできません。
同意画面では、EKB は要求している MCP クライアントとその権限を表示します。承認または拒否するまで何もグラントされません。拒否すると、クライアントを待たせたままにせず access_denied が返されます。
どちらを使うべきか
| 目標 | 使用するもの |
|---|---|
| 「Cursor からエージェント / ワークフローを構築して」 | Builder |
| 「サポートエージェントに質問して」 / 「この公開済みツールを実行して」 | Runtime |
| 「プロジェクトのナレッジベースを検索して」 | Runtime |
| 「スマートテーブルの行を読み取って」 | Runtime |
| ベンダーの MCP を EKB エージェントの内側へ接続 | MCP in EKB |
アクセスがどのように制限されるか
常に3つのレイヤーが適用されます：
- Audience — トークンは、あなたが承認したサーバー（Builder または Runtime）でのみ有効
- Scope —
odin:build対odin:use - あなたの EKB 権限 — クライアントはあなたとして動作します；プロジェクトの所属、Access Tags、公開状態はそのまま適用されます
MCP サービスは独自の資格情報を保持しません。すべての呼び出しはあなたの OAuth トークンまたは API キーを転送します。