MCP Servers

MCP란?

Model Context Protocol (MCP)은 AI Agent가 외부 도구 및 서비스에 연결할 수 있게 하는 오픈 표준입니다. AI를 위한 플러그인 시스템이라고 생각하세요: MCP 없이 Claude Code 같은 Agent는 파일을 읽고 쓸 수만 있습니다. MCP를 사용하면 웹 검색, 데이터베이스 쿼리, API 호출, 디자인 도구와 상호 작용 — 모두 동일한 대화 내에서 가능합니다.

MCP 서버는 Agent가 호출할 수 있는 도구 세트를 노출하는 백그라운드에서 실행되는 작은 프로그램입니다. "현재 날씨가 어떤가요?"라고 Agent에게 물으면 날씨 MCP 도구를 호출하고 훈련 데이터에서 추측하는 대신 실제 답변을 얻을 수 있습니다.

MCP 서버는 표준 프로토콜을 통해 통신하므로 MCP를 지원하는 모든 Agent(Claude Code, Cursor, Windsurf 등)가 동일한 서버를 사용할 수 있습니다.

---

내장 MCP 서버

1DevTool은 즉시 사용할 수 있는 여러 MCP 서버와 함께 제공됩니다:

• 데이터베이스 접근 — Agent가 연결된 데이터베이스에 대해 쿼리를 실행하고 결과를 설명할 수 있습니다. 스키마를 자동으로 인식합니다.
• 파일 시스템 — Agent가 프로젝트 디렉터리에서 파일을 읽고 검색할 수 있어 코드베이스의 전체 컨텍스트를 제공합니다.
• HTTP 클라이언트 — Agent가 API 호출을 하고 엔드포인트에서 JSON을 가져오고 응답을 검사할 수 있습니다. 자체 API를 테스트하거나 서드파티 서비스를 호출하는 데 유용합니다.
• 디자인 도구 — Figma 및 Pencil과 통합되어 Agent가 디자인 파일을 검사하고 구성 요소 사양을 읽으며 디자인과 일치하는 코드를 제안할 수 있습니다.

이러한 서버는 터미널 세션을 열 때 자동으로 시작됩니다. 구성할 필요가 없습니다.

---

커스텀 MCP 서버 추가

MCP 생태계에는 플러그인할 수 있는 수백 개의 커뮤니티 빌드 서버가 있습니다. 추가 방법:

1. Settings → MCP Servers로 이동
2. + Add Server를 클릭
3. 서버 명령을 입력합니다 — 예: npx @modelcontextprotocol/server-brave-search
4. 아래의 필드에 필요한 환경 변수(API 키 등)를 추가
5. Save를 클릭

서버는 다음에 터미널을 열 때 자동으로 시작됩니다. Agent에게 새 도구를 사용하도록 요청하여 테스트할 수 있습니다.

---

프로젝트별 MCP 구성

다른 프로젝트는 종종 다른 도구가 필요합니다. 프론트엔드 프로젝트는 Figma 서버가 필요할 수 있고, 백엔드 프로젝트는 Postgres 또는 Redis 서버가 필요할 수 있습니다. 프로젝트별로 MCP 서버를 구성할 수 있습니다:

1. 사이드바에서 프로젝트를 우클릭
2. Settings → MCP를 선택
3. 해당 프로젝트에 대해서만 서버를 추가하거나 제거

프로젝트 수준 MCP 설정은 해당 프로젝트에 대해서만 전역 기본값을 재정의합니다.

팁: MCP 생태계에는 Slack, GitHub, Notion, 데이터베이스 등 수백 개의 커뮤니티 서버가 있습니다. modelcontextprotocol.io에서 찾아보세요.