Skip to content
🚀 EDDI 6.5.0

19개 LLM 프로바이더, 사이트를 크롤링하고 파일을 읽는 지식 베이스, 호환되는 에이전트 버전을 따라가는 대화새로운 기능

매니지드 클라우드 시작하기
모든 통합
에이전트 프로토콜mcpcalls

MCP Client

외부 MCP 서버의 도구를 EDDI 에이전트에 제공합니다. 서버의 도구는 에이전트의 도구가 되며, 다른 모든 도구와 같은 승인 게이트와 감사 추적을 거칩니다.

제공되는 기능

  • Streamable HTTP를 지원하는 모든 MCP 서버의 도구
  • 도구 목록을 간결하게 유지하기 위한 이름 기반 허용 및 거부 목록
  • 선택 사항인 리소스 목록 조회 및 읽기
  • 실패하는 서버에 대한 호출을 중단하는 서킷 브레이커

EDDI에서의 동작 방식

  1. 서버 URL, 전송 방식 http, ${vault:...} 참조 형태의 API 키를 포함해 mcpcalls 설정을 만듭니다.
  2. 워크플로 단계(eddi://ai.labs.mcpcalls)로 참조합니다.
  3. 에이전트의 LLM 태스크가 서버의 도구를 자동으로 가져옵니다(enableMcpCallTools의 기본값은 true입니다).
  4. 중요한 호출이 사람의 판단을 기다리도록 해당 도구를 toolApprovals에 추가합니다.
  5. stdio 전용 서버는 자체 컨테이너에서 HTTP 브리지 뒤에 두고 실행한 다음, EDDI가 그 브리지를 가리키게 합니다.

설정

EDDI 문서를 기준으로 합니다. your-agent-id 같은 플레이스홀더는 직접 바꿔서 사용하세요.

mcpcalls configurationmcpcalls 설정입니다. 토큰은 볼트 참조입니다.
{
  "mcpServerUrl": "https://mcp.example.com/mcp",
  "name": "example",
  "transport": "http",
  "apiKey": "${vault:example-mcp-token}",
  "timeoutMs": 30000
}
agent configuration (hitlConfig)읽기 전용 도구를 제외한 모든 MCP 도구에 게이트를 적용합니다.
{
  "hitlConfig": {
    "toolApprovals": {
      "requireApproval": [
        "mcp:*"
      ],
      "exempt": [
        "mcp:read_*"
      ],
      "approvalTimeout": "PT30M",
      "timeoutPolicy": "AUTO_REJECT"
    }
  }
}

거버넌스

  • MCP 도구 호출은 다른 모든 도구 소스와 같은 휴먼 인 더 루프 승인 게이트에 참여합니다.
  • 도구 설명에서는 지시문 형태의 텍스트가 마스킹되고 길이가 제한됩니다. 도구 결과에는 출처 정보가 덧붙으며, 기본적으로 지시문 형태의 내용은 마스킹됩니다.
  • 도구 화이트리스트는 컨텍스트 관리일 뿐 보안 경계가 아닙니다. 경계는 연결에 부여하는 자격 증명과 승인 게이트입니다.
  • 게이트를 거친 모든 결정은 감사 원장에 기록됩니다.

알아 두면 좋은 점

  • EDDI가 구현한 MCP 전송 방식은 Streamable HTTP 하나뿐입니다. 설정에서 편집할 수 있는 명령은 EDDI 프로세스 사용자 권한의 임의 코드 실행이 되므로, EDDI는 stdio 서버를 직접 실행하지 않습니다. 브리지 사이드카를 사용하세요.
  • 서킷 브레이커는 60초 안에 3번 실패하면 열리므로, 도구가 보이지 않는다면 대개 서버가 실패하고 있다는 뜻입니다.

관련 통합

이 페이지의 설정과 동작은 2026-10-14에 확인한 EDDI 문서를 따릅니다. 필드 이름과 기본값은 릴리스마다 달라질 수 있으므로, 사용 중인 버전의 문서에서 확인하세요.