EKB Runtime
エンドポイント： /runtime/mcp
権限： Use (odin:use) — 同意ラベル Use your agents and tools
Runtime は、EKB に既に存在するものを名前付きの MCP ツールに変換します。下書き / 未公開の成果物は決して公開されません — カスタムツールを MCP 経由で利用可能にするのは公開（publish）です。
前提条件
- このクライアントに対する Use your agents and tools の同意
- 使用したいエージェント、ツール、KB、スマートテーブルがあるプロジェクトへのアクセス
run_*ツールが必要な場合、公開済みのワークフロー / カスタムツール
クライアントに表示されるツール
常に存在するツール
| ツール | 目的 | 主な入力 |
|---|---|---|
list_odin_projects | プロジェクトの id、名前、説明を検出 | （なし） |
search_knowledge | プロジェクトのナレッジベースを検索し、ソース付きの該当箇所を返す | query（必須）；project_id（固定していない場合は必須）；任意の max_results（デフォルト 10） |
query_smart_table | スマートテーブルから名前または id で行を読み取る | table（必須）；project_id（固定していない場合は必須）；任意の search、limit、page、sort_column、sort_direction |
ドキュメントから事実を調べるには search_knowledge を使用します。それらの結果の上でエージェントに推論させたい場合は ask_<agent> ツールを使用します。
動的ツール（プロジェクトごと）
| パターン | 意味 | 主な入力 |
|---|---|---|
ask_<agent_name> | 到達可能なエージェントに質問 | message（必須）；会話を継続する任意の chat_id |
run_<tool_name> | 公開済みのカスタムツール / ワークフローを実行 | 入力はツールの宣言スキーマを反映（実際の名前と型） |
命名に関する注意：
- エージェントとツールの名前は MCP 用にスラッグ化されます（句読点は正規化）
- 複数プロジェクトで固定していない場合、名前にプロジェクト修飾が含まれる可能性がある
- ツール一覧は大きくなることがある；対象が分かっているときはプロジェクトを固定
すべての ask_* 応答には chat_id が含まれます。次の呼び出しでそれを渡すと同じ会話を継続し、省略すると新しく始めます。
プロジェクトの固定
MCP クライアント設定からこのヘッダーを送信します：
x-project-id: <your-project-id>
| モード | 動作 |
|---|---|
| 固定あり | ツールがそのプロジェクトにスコープされる；静的ツールでは project_id が任意になることが多い |
| 固定なし | アクセス可能なプロジェクト間で集約される場合がある；search_knowledge / query_smart_table では project_id が必須 |
id がまだ分かっていない場合は list_odin_projects で検出してください。
公開と可視性
| リソース | Runtime で公開される条件 |
|---|---|
| エージェント | 同じアカウントで EKB から到達できる |
| カスタムツール / ワークフロー | 公開済み（下書きは除外） |
| ナレッジベースの箇所 | ドキュメントがあなたに見える（Access Tags を含む） |
| スマートテーブルの行 | アクセス可能なプロジェクトにテーブルが存在する |
Runtime は追加の可視性をグラントしません。Access Tags とプロジェクトの所属は、検索とエージェントが返せる内容を引き続きフィルタリングします。
Runtime を使うべきとき
- 「Claude からサポート / HR / 運営エージェントに質問して」
- 「この公開済みワークフローをこの入力で実行して」
- 「KB を検索して」または「スマートテーブルから行を取り出して」
- 構成を変更する権限なしに EKB を利用するべきクライアント全般
ヒント
- ワークフローを
run_*ツールとして期待する前に公開する - エージェントを編集してはならないラップトップやアシスタントでは Runtime のみの接続を推奨
- 判断が必要なら
ask_*を、直接のルックアップにはsearch_knowledge/query_smart_tableを推奨 chat_idを再利用して会話を一貫させる
トラブルシューティング
| 症状 | 確認すること |
|---|---|
期待した run_* がない | ツールを公開；アカウントがプロダクトでそれを見られることを確認 |
| 間違いまたは巨大なツール一覧 | x-project-id を設定 |
| 非常に隠したいはずの検索結果が返る | 呼び出しユーザーの Access Tags / プロジェクトアクセス — Runtime はそのユーザーとして振る舞う |
project_id is required | list_odin_projects を呼ぶか x-project-id で固定 |
| 会話が毎ターンリセットされる | 前の ask_* 応答の chat_id を渡す |