Skip to Content
사용자 가이드🛠️ Custom MCP Server

Custom MCP 서버 연동

기업 내부에 이미 구축된 MCP 서버를 QueryPie AI Hub와 연결할 수 있습니다.

주요 기능

  • SSE(Server-Sent Events) 기반으로 Remote MCP 서버와 실시간 통신합니다.
  • 커스텀 헤더를 통한 인증을 지원합니다. 현재는 고정값으로만 인증 가능합니다.
  • 동적 도구 스키마 로딩을 지원합니다.
  • 다양한 MCP 프로토콜 버전을 지원합니다.

Custom MCP 서버 연동 방법

MCP Integrations 페이지 접근

Integrations 메뉴의 All Integrations 탭을 클릭합니다.

MCP Integrations 페이지

사용자 정의 MCP 연동 설정 카드를 클릭하여, Install New MCP Integration 페이지로 이동합니다.

Integration 정보 입력

Custom SSE 설정

Integration Information 섹션에서 다음 정보를 입력합니다:

  • Name (필수): 연동할 MCP 서버의 이름 (예: Custom SSE)
  • Description (필수): MCP 서버에 대한 간단한 설명 (예: Connect to Custom MCP SSE endpoint)
  • MCP Server URL (SSE) (필수): MCP 서버의 SSE 엔드포인트 URL
    • 형식: https://mcp.example.com/sse
    • 실제 운영 중인 MCP 서버의 SSE 엔드포인트 URL을 입력합니다.

Headers for MCP server (선택) 섹션에서 인증이 필요한 경우 헤더를 설정합니다.

  • Key: 헤더 키 (예: Authorization, X-API-Key)
  • Value: 헤더 값 (예: Bearer your-token-here)
  • 추가 헤더가 필요한 경우 + 버튼을 클릭하여 더 많은 헤더를 추가할 수 있습니다.

모든 정보를 입력한 후 Install 버튼을 클릭합니다.

연동 완료

Integration 정보 입력

연동이 성공하면 Installed Integrations 목록에서 확인할 수 있습니다.

연동된 MCP 서버의 도구들이 AI 채팅에서 자동으로 사용 가능해집니다.
MCP Preset을 생성하여 특정 워크플로우에 맞게 도구를 조합해서 사용할 수 있어요.

문제 해결

연결 실패 시

  1. MCP 서버 URL이 올바른지 확인합니다.
  2. 방화벽 설정을 확인합니다.
  3. 커스텀 헤더 설정이 올바른지 확인합니다.
  4. MCP 서버가 정상적으로 동작하는지 확인합니다.

도구 로딩 실패 시

  1. MCP 서버가 올바른 도구 스키마를 반환하는지 확인합니다.
  2. JSON 형식이 올바른지 확인합니다.
  3. 서버 로그를 확인하여 오류 메시지를 분석합니다.
Last updated on
Kakao Navigation🎛️ Settings