개요
대부분의 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를 제어 | 이 섹션 |
전제 조건
- 최소 하나의 프로젝트에 접근 권한이 있는 EKB 계정
- HTTP MCP URL 및 OAuth를 지원하는 MCP 클라이언트 (또는 API 키를 위한 사용자 정의 헤더)
- 프로덕션 유형 호스트의 경우, 환경의 MCP 호스트네임에 대한 네트워크 접근 (예:
https://mcp.getodin.ai) - 헤드리스 CI의 경우, 사용자 수준 API 키 및 시크릿
두 개의 서버, 두 가지 접근 방식
EKB는 두 개의 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에서 재사용할 수 없으며 그 반대도 마찬가지입니다. "사용" 접근은 "빌드" 접근으로 승격될 수 없습니다.
동의 화면에서 EKB는 MCP 클라이언트와 요청하는 권한을 표시합니다. 승인하거나 거부할 때까지 아무것도 부여되지 않습니다. 거부하면 클라이언트를 멈춰두지 않도록 access_denied가 클라이언트에 반환됩니다.
어떤 것을 언제 사용할지
| 목표 | 사용 |
|---|---|
| "Cursor에서 에이전트 / 워크플로우를 만들어줘" | Builder |
| "우리 지원 에이전트에게 물어봐" / "이 게시된 도구를 실행해줘" | Runtime |
| "프로젝트 지식 베이스를 검색해줘" | Runtime |
| "스마트 테이블에서 행을 읽어줘" | Runtime |
| 벤더 MCP를 EKB 에이전트 안으로 연결 | MCP in EKB |
접근이 제한되는 방식
세 가지 계층이 항상 적용됩니다:
- Audience — 토큰은 승인한 서버(Builder 또는 Runtime)에만 유효합니다
- Scope —
odin:build대odin:use - EKB 권한 — 클라이언트는 본인으로서 행동합니다. 프로젝트 구성원 자격, Access Tag, 게시 상태가 계속 적용됩니다
MCP 서비스는 자체 자격 증명을 보유하지 않습니다. 모든 호출은 사용자의 OAuth 토큰 또는 API 키를 전달합니다.