본문으로 건너뛰기

MCP 서버

MCP (Model Context Protocol, 모델 컨텍스트 프로토콜)는 AI Agent가 외부 도구 서버와 통신할 수 있도록 하는 개방형 표준입니다. MCP를 통해 파일시스템 접근, 웹 검색, 데이터베이스 쿼리, 코드 저장소 탐색 등의 기능을 표준화된 방식으로 Elftia에 연결하여, 대화 중 Agent가 이러한 외부 도구를 직접 호출할 수 있습니다.

MCP가 필요한 이유​

Agent의 내장 기능에는 한계가 있습니다. MCP를 활용하면:

  • 도구셋 확장 — 외부 서비스의 기능을 Agent가 호출할 수 있는 도구로 등록합니다
  • 인터페이스 표준화 — 다양한 출처의 도구가 통합 프로토콜로 통신하므로 각 도구마다 커스텀 어댑터를 작성할 필요가 없습니다
  • 필요에 따른 연결 — 현재 작업에 필요한 서버만 활성화하여 도구 목록이 지나치게 길어지는 것을 방지합니다
  • 프로젝트 간 재사용 — 동일한 MCP 서버 설정을 여러 Agent에서 공유할 수 있습니다

세 가지 전송 프로토콜​

Elftia는 세 가지 MCP 전송 방식을 지원합니다. 사용 사례에 맞는 방식을 선택하세요:

전송 유형연결 방식사용 사례예시
Stdio로컬 자식 프로세스를 시작하여 표준 입출력으로 통신로컬 도구, CLI 래퍼, npm/pip 패키지npx @modelcontextprotocol/server-filesystem
SSEHTTP Server-Sent Events를 통한 장기 연결원격 서비스, 실시간 푸시가 필요한 시나리오https://api.example.com/mcp/sse
HTTPStreamable HTTP 기반의 요청/응답원격 REST 방식의 MCP 서비스https://api.example.com/mcp

:::tip 선택 방법

  • 대부분의 경우 Stdio 선택 — npm 또는 pip으로 설치하는 MCP 서버 패키지는 일반적으로 Stdio를 사용합니다
  • 원격 호스팅 서비스에는 SSE 또는 HTTP 선택 — 서드파티가 제공하는 클라우드 호스팅 MCP 서비스 등
  • SSE vs. HTTP — SSE는 구 버전 MCP 스펙 기반이고, HTTP는 MCP 2025-03-26 스펙 (Streamable HTTP) 기반입니다. 새로운 서비스에는 HTTP를 권장합니다 :::

도구 발견 및 사용 흐름​

MCP 서버를 설정하면 Elftia가 자동으로 다음 과정을 처리합니다:

MCP 서버 시작 / 연결
       ↓
Elftia가 서버에서 제공하는 도구 목록을 자동으로 발견
       ↓
도구가 Agent의 사용 가능한 도구셋에 등록됨
       ↓
Agent가 대화 중 필요에 따라 도구 호출
       ↓
도구가 결과를 반환하고 Agent가 이를 응답에 통합

도구 명명 형식: 각 MCP 도구는 mcp__<서버명>__<도구명> 형식으로 등록됩니다. 예를 들어 filesystem이라는 서버에서 제공하는 read_file 도구는 Agent 내에서 mcp__filesystem__read_file로 식별됩니다.

MCP와 Agent​

MCP 서버는 Agent와 유연하게 조합하여 사용할 수 있습니다:

  • 자동 모드 (기본값) — 활성화된 모든 MCP 서버의 도구가 모든 Agent에 자동으로 제공됩니다
  • 수동 모드 — 각 대화 시작 전에 사용할 MCP 서버를 선택합니다
  • Agent 바인딩 — 특정 MCP 서버를 특정 Agent에 연결하여 전용 도구 구성을 설정합니다

기능 요약​

기능설명
다중 전송 프로토콜Stdio, SSE, HTTP 연결 옵션
자동 도구 발견연결 후 도구 목록을 자동으로 가져오며 5분간 캐시
JSON 일괄 가져오기JSON 설정을 통해 여러 서버를 한 번에 추가
의존성 자동 감지node/npm/uv/uvx 등 CLI 도구 설치 여부 자동 확인
연결 테스트서버 연결 상태 및 사용 가능한 도구를 원클릭으로 테스트
도구 비활성화서버의 특정 도구를 선택적으로 비활성화
신뢰 관리신뢰할 수 있는 서버와 그렇지 않은 서버를 구분
공식 프리셋주요 MCP 서버의 원클릭 설치 구성 내장

다음 단계​