メインコンテンツへスキップ

EKB Builder

エンドポイント： /builder/mcp
権限： Build (odin:build) — 同意ラベル Build in your workspace

Builder はあなたの代わりに Autopilot とチャットしません。Autopilot と同じビルドツールを MCP クライアントに渡し、そのクライアントのモデルに計画と呼び出しを行わせます — 例えばエージェントの作成やワークフローの編集など。

ツール一覧はハードコードされていません。サーバーは EKB に、現在稼働中の Autopilot / コンポーザテンプレートがどのツールを許可しているかを確認するため、Autopilot の変更は再デプロイなしに MCP 経由で反映されます。ツール名は EKB のツールキット名と一致します（例：create_agent_from_config、add_and_verify_node_to_workflow）。

前提条件​

  • このクライアントに対する Build in your workspace の同意
  • 変更予定のリソースの作成/編集を許可するプロジェクトの所属
  • ライブワークスペースでツール呼び出しを本番の書き込みとして扱う意識

できること​

  • エージェント、ワークフロー、スマートテーブル、インターフェース、ナレッジベースの作成と変更
  • EKB 内の Autopilot が使うのと同じツールキット操作の使用（UI 専用ツールを除く）
  • ツールキットごとのガイドを MCP リソース（odin://guides/<toolkit>）または build-guide ツール経由で読む
  • get_odin_build_guide を呼び出して完全な運用プレイブック（および任意のツールキットガイド）を取得

ビルドガイドと指示​

多くの MCP サーバーはサーバーの instructions フィールドを切り詰めます（一部は約2048文字まで）。そのため EKB は：

  1. instructions に短いブリーフィングを送り、モデルにガイドツールを最初に呼び出すよう指示
  2. get_odin_build_guide 経由で完全な Autopilot プレイブックを提供
  3. ツールキットガイドを odin://guides/ の下のリソースとして、およびガイドツールの任意の toolkit 引数として公開

セッションで何かを構築する前に get_odin_build_guide() を呼んでください。 ツールキットごとの詳細なルールが必要な場合は、ツールキット名（例：workflow_manager）を渡します。

プロダクト内の Autopilot との違い​

EKB 内（Autopilot チャット）MCP 経由（Builder）
Autopilot のモデルがプロダクト UI 内で計画あなたの MCP クライアントのモデルが計画（Claude、Cursor など）
完全な Autopilot ツールキットサーフェス同じビルドサーフェス（UI 専用ツールを除く）
ガイドはエージェントプロンプト内に存在ガイドはリソース / get_odin_build_guide で利用可能

UI 専用の Autopilot ツール（ask-user のようなチャット内ウィジェットなど）は除外されます — MCP クライアントはそれらをレンダリングできません。

プロジェクトコンテキスト​

Builder は x-project-id でプロジェクトに固定しません。モデルは以下を行うべきです：

  1. プロジェクトを検出（例：プロジェクト一覧系ツール、または Runtime の list_odin_projects）
  2. すべての create / update 呼び出しで target_project_id または project_id として対象プロジェクト id を渡す（各ツールのスキーマに従う）
  3. id を捏造しない — リソースをルックアップし、EKB が返した id を再利用する

推奨されるワークフロー​

  1. 構成を変更すべきマシンでのみ Builder URL を接続
  2. 最初の書き込みの前に get_odin_build_guide()（および関連するツールキットガイド）を呼び出す
  3. 作業を計画（todo リスト）してから、明示的なプロジェクト id でリソースを作成/変更
  4. 構築したものはテストして検証 — 作成しただけで成功と報告しない

Builder を使うべきとき​

  • Cursor / Claude Code からエージェントやワークフローの足場を作る
  • 外部コーディングエージェントが駆動する一括または反復的な構成変更
  • EKB を利用するだけのマシンから build アクセスを外す — その場合は Runtime のみを接続

トラブルシューティング​

症状確認すること
モデルが EKB のルールを守らずに構築get_odin_build_guide を呼んだか / odin://guides/… を読んだかを確認
書き込みが間違いのプロジェクトに入るすべての変更呼び出しで target_project_id / project_id を必須にする
Autopilot の UI にあるツールがないAutopilot がそのツールを許可しているかを確認；UI 専用ツールは決して公開されない
破壊的な操作の驚きBuilder を本番の Autopilot として扱う — build を意図する場所でのみ接続

関連​