DO 2.0DO Support

MCP 서버

MCP (Model Context Protocol)를 사용하면 외부 툴 서버를 DO 2.0에 연결할 수 있습니다.

참고: 툴 및 MCP 개요

MCP란?

MCP는 표준화된 툴 통합을 위한 프로토콜입니다:

  • 표준화 — MCP 호환 서버와 호환됨
  • 외부 — 툴이 자체 서버에서 실행됨
  • 강력함 — 툴이 복잡한 시스템과 상호작용 가능

참고: MCP 지원은 실험적입니다. 프로덕션에는 OpenAPI가 더 안정적입니다.

MCP 툴 서버 추가

  1. 워크스페이스 → MCP로 이동
  2. "+ 추가" 클릭

구성 필드가 있는 툴 서버 추가 대화상자

입력:

필드설명
유형MCP 또는 OpenAPI (OpenAPI 권장)
URL툴 서버의 엔드포인트 URL
인증인증 방법 (없음, Bearer, OAuth 등)
IDDO 2.0 내 고유 식별자
이름사용자가 보는 표시 이름
설명서버가 제공하는 툴

OpenAPI 서버 연결

OpenAPI는 프로덕션에 권장됩니다. 제공:

  • URL — API의 기본 URL
  • 경로 — OpenAPI 스펙 경로 (예: /openapi.json)
  • 인증 유형 — 없음, Bearer, 또는 커스텀
  • API 키 — Bearer 인증 사용 시

추가되면 OpenAPI 엔드포인트가 툴 목록에 개별 툴로 표시됩니다.

인증 방법

방법사용 사례
없음인증이 필요 없는 공개 API
Bearer토큰 기반 API (API 키)
세션사용자 세션 토큰 전달
OAuth 2.1MCP 전용; 동적 클라이언트 등록

모델에 연결

모델을 만들거나 편집할 때 MCP 툴이 툴 목록에 표시됩니다:

  1. 모델 만들기/편집 양식 열기
  2. "+ 툴 추가" 클릭
  3. 대화상자에 사용 가능한 모든 툴 표시 (커스텀 + MCP)
  4. 연결할 툴 선택
  5. 추가 클릭

MCP vs OpenAPI

MCP를 사용할 때:

  • 표준화된 MCP 서버에 연결할 때
  • 복잡한 툴 워크플로가 필요할 때
  • 장기적인 실험적 기능이 괜찮을 때

OpenAPI를 사용할 때:

  • 더 안정적이고 예측 가능할 때
  • 표준 REST API
  • 프로덕션 환경 (권장)

문제 해결

MCP 서버 연결 실패

원인: 서버 다운, URL 오류, 또는 인증 자격 증명이 잘못됨.

해결 방법:

  1. 서버 URL 직접 테스트
  2. 인증 자격 증명 확인
  3. 서버 로그에서 오류 확인

모델 대화상자에 툴이 표시되지 않음

원인: 서버가 올바르게 응답하지 않을 수 있음.

해결 방법: 서버 상태를 확인하세요. URL과 인증이 올바른지 확인하세요.

모델이 툴을 호출하지 않음

원인: 툴 설명이 불명확함.

해결 방법: 툴을 사용해야 하는 시점과 방법을 설명하는 더 명확한 설명을 작성하세요.

더 알아보기: