EKB Builder
엔드포인트: /builder/mcp
권한: Build (odin:build) — 동의 레이블 Build in your workspace
Builder는 대신 Autopilot과 채팅하지 않습니다. Builder는 MCP 클라이언트에게 Autopilot이 보유한 것과 동일한 빌드 도구를 전달하고, 해당 클라이언트의 모델이 이를 계획하고 호출하게 합니다 — 예를 들어 에이전트 생성이나 워크플로우 편집.
도구 목록은 하드코딩되어 있지 않습니다. 서버는 라이브 Autopilot / composer 템플릿이 현재 부여하는 도구를 EKB에 묻기 때문에, 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는:
instructions에 모델이 먼저 가이드 도구를 호출하도록 안내하는 간략한 브리핑 전송- 전체 Autopilot 플레이북을 **
get_odin_build_guide**를 통해 제공 - 툴킷 가이드를
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로 프로젝트에 고정하지 않습니다. 모델은 다음을 수행해야 합니다:
- 프로젝트 발견 (예: 프로젝트 목록 스타일 도구 또는 Runtime의
list_odin_projects통해) - 모든 생성 또는 업데이트 호출에
target_project_id또는project_id로 대상 프로젝트 id 전달 (각 도구의 스키마를 따름) - id를 지어내지 않음 — 리소스를 조회하고 EKB가 반환한 id 재사용
권장 워크플로우
- 구성을 변경해야 하는 머신에만 Builder URL 연결
- 최초 쓰기 전에
get_odin_build_guide()(및 해당 툴킷 가이드) 호출 - 작업을 계획(todo 목록)한 다음, 명시적인 프로젝트 id로 리소스 생성 또는 수정
- 테스트하여 구축한 것을 검증 — 생성만으로 성공으로 보고하지 않음
Builder를 사용해야 할 때
- Cursor / Claude Code에서 에이전트 또는 워크플로우 골격 만들기
- 외부 코딩 에이전트가 주도하는 대량 또는 반복적 구성 변경
- EKB를 사용만 해야 하는 머신에서 빌드 접근 차단 — 대신 Runtime만 연결
문제 해결
| 증상 | 확인할 사항 |
|---|---|
| 모델이 EKB 규칙을 따르지 않고 빌드 | get_odin_build_guide 호출 / odin://guides/… 읽기를 확인하세요 |
| 쓰기가 잘못된 프로젝트에 기록됨 | 모든 변경 호출에 target_project_id / project_id를 요구하세요 |
| Autopilot UI에 있는 도구가 누락 | Autopilot이 해당 도구를 부여하는지 확인하세요. UI 전용 도구는 절대 노출되지 않습니다 |
| 파괴적 놀라움 | Builder를 프로덕션 Autopilot처럼 취급하세요 — 빌드가 의도된 곳에만 연결하세요 |