MCP로 프로덕션 시스템에 연결하는 에이전트 구축하기

에이전트의 가치는 결국 연결할 수 있는 시스템의 범위에 달려 있습니다. 외부 시스템과 에이전트를 연결하는 방식은 대개 세 가지로 수렴됩니다. 직접 API 호출, CLI, 그리고 MCP입니다. 이 글에서는 각 방식이 적합한 상황, 프로덕션 에이전트가 MCP로 귀결되는 이유, 그리고 MCP 통합을 효과적으로 구현하기 위한 패턴을 정리합니다.

에이전트를 외부 시스템에 연결하기

에이전트를 외부 시스템에 연결하는 경로는 크게 세 가지입니다. 직접 API 호출, CLI, 그리고 MCP입니다. 무엇을 만드느냐에 따라 각각의 방식이 제 역할을 합니다. 핵심은 에이전트와 서비스 사이에 공통 레이어가 있는지, 그리고 그 레이어가 얼마나 넓은 범위를 커버하는지에 있습니다.

직접 API 호출

에이전트가 API를 직접 호출하는 방식입니다. 코드 실행 샌드박스 안에서 HTTP 요청을 직접 보내거나, 범용 함수 호출 도구를 활용합니다. 대부분의 팀이 처음에 선택하는 방식이며, 에이전트 하나가 서비스 하나와 통신하거나 에이전트 플랫폼 간 재사용이 필요 없는 소규모 통합에는 충분합니다.

문제는 규모가 커질 때 시작됩니다. 에이전트와 서비스 사이에 공통 레이어가 없으면, 각 에이전트-서비스 조합마다 인증 처리, 도구 설명, 엣지 케이스를 별도로 구현해야 합니다. 이것이 바로 M×N 통합 문제입니다.

커맨드라인 인터페이스(CLI)

에이전트가 셸에서 커맨드라인 도구를 실행하는 방식입니다. 빠르고 가볍고 기존 툴링을 그대로 활용할 수 있습니다. 파일시스템과 셸이 있는 로컬 환경이나 샌드박스 컨테이너에서는 훌륭하게 동작합니다. 공통 레이어를 제공하지만 그 깊이는 얕습니다.

컨테이너를 노출하지 않는 모바일, 웹, 클라우드 호스팅 플랫폼에서는 CLI가 한계에 부딪힙니다. 인증도 대개 디스크의 자격증명 파일에 의존하는 CLI 고유 방식으로 처리됩니다. 로컬 환경에서 빠르게 검증하는 용도로 적합합니다.

모델 컨텍스트 프로토콜(MCP)

MCP는 프로토콜 형태로 공통 레이어를 제공합니다. 에이전트는 시스템의 기능을 노출하는 서버에 연결하며, 인증·검색·풍부한 시맨틱이 표준화되어 있습니다. 원격 서버 하나로 어떤 배포 환경에서든 호환되는 모든 클라이언트(Claude, ChatGPT, Cursor, VS Code 등)와 통신할 수 있습니다.

초기 투자가 조금 더 필요하지만, 그 대신 통합이 이식 가능해지고 기능이 풍부한 에이전트 통합에 필요한 시맨틱을 갖출 수 있습니다.

프로덕션 에이전트는 클라우드에서 실행된다

프로덕션 에이전트는 확장성과 지속적인 운영을 위해 점점 클라우드에서 실행됩니다. 이 에이전트들이 접근해야 하는 시스템—데이터가 저장되고, 작업이 추적되고, 인프라가 운영되는 곳—도 마찬가지로 클라우드에 있습니다. 이러한 시스템들은 대부분 원격에 있고 인증 뒤에 가려져 있기 때문에, MCP가 공통 레이어로 제 역할을 합니다.

이미 채택 지표에서도 이 흐름이 보입니다. MCP SDK는 최근 월 다운로드 수가 3억 건을 넘었습니다. 연초 1억 건에서 크게 늘어난 수치이며, 기업과 주요 에이전트 플랫폼 전반에서 폭넓게 채택되고 있습니다. 매일 수백만 명이 Claude와 함께 MCP를 사용하고 있으며, Claude Cowork, Claude Managed Agents, Claude Code의 채널 등 최근 출시된 주요 기능들도 이 프로토콜을 기반으로 합니다.
‍
MCP가 프로덕션 에이전트 시스템을 뒷받침하는 범위가 계속 넓어지면서, 저희는 효과적인 통합 구현 패턴을 공유합니다. 고급 서버 구축부터 컨텍스트 효율적인 클라이언트 구성, 그리고 스킬이 프로토콜을 보완하는 방식까지 다룹니다.

효과적인 MCP 서버 구축하기

저희 디렉터리에는 200개가 넘는 MCP 서버가 등록되어 있고, 매일 수백만 명이 사용하고 있습니다. 프로토콜 위에서 개발하는 기업과 개발자들과 긴밀하게 협력하면서, 에이전트가 서버를 얼마나 안정적으로 활용할 수 있는지를 좌우하는 설계 패턴 몇 가지를 발견했습니다.

더 넓은 도달 범위를 위해 원격 서버를 구축하세요

배포 범위를 넓히려면 원격 서버가 필수입니다. 원격 서버만이 웹, 모바일, 클라우드 호스팅 에이전트 전반에서 동작하며, 모든 주요 클라이언트가 최적화된 방식으로 소비할 수 있는 유일한 구성입니다. 에이전트가 어디서 실행되든 시스템에 접근할 수 있도록 원격 서버를 구축하세요.

엔드포인트가 아닌 의도 중심으로 도구를 묶으세요

잘 설명된 소수의 도구가 방대한 API 미러보다 일관되게 뛰어난 성능을 보입니다. API를 일대일로 MCP 서버에 매핑하지 말고, 의도 중심으로 도구를 묶어 에이전트가 수많은 기본 작업을 조합하는 대신 몇 번의 호출로 작업을 완료할 수 있게 하세요. `get_thread` + `parse_messages` + `create_issue` + `link_attachment`를 조합하는 것보다 `create_issue_from_thread` 하나가 낫습니다. 전체 패턴은 에이전트를 위한 효과적인 도구 작성에서 확인하세요.

규모가 큰 서비스는 코드 오케스트레이션 방식으로 설계하세요

Cloudflare, AWS, Kubernetes처럼 수백 가지 개별 작업이 필요한 서비스라면 의도 중심으로 도구를 묶는 방식으로는 커버하기 어렵습니다. 대신 코드를 받아 실행하는 얇은 도구 레이어를 노출하세요. 에이전트가 짧은 스크립트를 작성하면 서버가 샌드박스 안에서 API를 호출해 결과만 돌려주는 방식입니다. Cloudflare의 MCP 서버가 대표적인 예로, 두 개의 도구(검색과 실행)만으로 약 2,500개의 엔드포인트를 1K 토큰 수준에서 커버합니다.

필요한 곳에 풍부한 시맨틱을 활용하세요

MCP Apps는 첫 번째 공식 프로토콜 확장으로, 도구가 차트·폼·대시보드 같은 인터랙티브 인터페이스를 반환하고 이를 채팅 인터페이스에 인라인으로 렌더링할 수 있게 합니다. MCP Apps를 적용한 서버는 텍스트만 반환하는 서버보다 채택률과 리텐션이 눈에 띄게 높습니다. 중요한 순간에 에이전트나 최종 사용자 앞에 제품 UI를 바로 제공하는 데 활용하세요. Claude.ai, Claude Cowork, 그리고 많은 주요 AI 도구에서 지원합니다.

‍Elicitation을 사용하면 서버가 도구 호출 중간에 멈추고 사용자에게 입력을 요청할 수 있습니다. Form 모드는 간단한 스키마를 전송하면 클라이언트가 네이티브 폼을 렌더링합니다. 누락된 파라미터를 요청하거나, 파괴적인 작업을 확인하거나, 옵션을 명확히 할 때 활용하세요. URL 모드는 사용자를 브라우저로 안내합니다. 다운스트림 OAuth를 완료하거나, 결제를 처리하거나, MCP 클라이언트를 거치면 안 되는 자격증명을 수집할 때 사용합니다. 두 방식 모두 사용자를 설정 페이지로 내보내지 않고 흐름 안에 유지합니다. Form 모드는 광범위하게 지원되며, URL 모드는 Claude Code에서 지원되고 더 많은 클라이언트로 확대 중입니다.

표준화된 인증을 활용하세요

표준화된 인증은 클라우드 호스팅 에이전트에서 MCP를 실용적으로 만드는 핵심입니다. 서버에 OAuth가 필요한 경우, 최신 MCP 사양은 클라이언트 등록을 위한 CIMD(클라이언트 ID 메타데이터 문서)를 지원합니다. 덕분에 사용자는 최초 인증을 빠르게 완료할 수 있고, 예상치 못한 재인증 요청도 크게 줄어듭니다. 저희가 권장하는 인증 방식으로, MCP SDK, Claude.ai, Claude Code에서 지원하며 업계 전반에 빠르게 채택되고 있습니다.

사용자 인증이 완료되면, 다음 과제는 클라우드 호스팅 에이전트가 런타임에 토큰을 보관하고 재사용하는 방법입니다. 볼트(vault)는 Claude Managed Agents에서 이를 해결합니다. 사용자의 OAuth 토큰을 한 번 등록하고 세션 생성 시 볼트 ID로 참조하면, 플랫폼이 각 MCP 연결에 올바른 자격증명을 주입하고 갱신까지 대신 처리합니다. 별도의 시크릿 저장소를 구축하거나 호출마다 토큰을 전달할 필요가 없습니다.

MCP 클라이언트의 컨텍스트 효율 높이기

MCP는 AI 에이전트(클라이언트)가 필요한 도구와 데이터 소스(서버)에 연결하고 활용하는 방식을 표준화합니다. 서버는 다양한 기능을 안전하게 노출하고, 클라이언트는 이를 오케스트레이션하며 컨텍스트를 관리합니다. MCP 클라이언트를 구축할 때는 점진적 공개(progressive disclosure) 패턴으로 컨텍스트 효율을 높이세요.

도구 검색으로 필요할 때만 도구 정의를 불러오세요

도구 검색은 모든 도구를 처음부터 컨텍스트에 로드하지 않고, 런타임에 에이전트가 카탈로그를 검색해 필요한 도구만 가져오도록 합니다. 저희 테스트에서 도구 검색은 도구 정의 토큰을 85% 이상 줄이면서도 높은 선택 정확도를 유지했습니다.

프로그래밍 방식 도구 호출로 도구 결과를 코드에서 처리하세요

프로그래밍 방식 도구 호출은 도구 결과를 모델에 그대로 반환하는 대신 코드 실행 샌드박스에서 처리합니다. 에이전트가 코드 안에서 반복·필터링·집계를 수행하고, 최종 결과만 컨텍스트에 전달합니다. 저희 테스트에서 복잡한 다단계 워크플로우의 토큰 사용량을 약 37% 줄였습니다.

이 두 패턴은 여러 서버에서 자연스럽게 조합됩니다. 더 가벼운 컨텍스트, 더 적은 왕복 호출, 더 빠른 응답을 기대할 수 있습니다. 전체 내용은 advanced tool use를 참고하세요.

MCP 서버와 스킬 함께 활용하기

스킬과 MCP는 서로 보완적입니다. MCP가 에이전트에게 외부 시스템의 도구와 데이터 접근 권한을 주는 반면, 스킬은 그 도구를 어떻게 활용해 실제 작업을 완수하는지에 대한 절차적 지식을 가르칩니다. 가장 유능한 에이전트는 둘 다 활용하며, 스킬 덕분에 MCP 서버가 소수의 연결을 넘어 더 넓게 확장될 수 있습니다. 두 가지를 결합하는 일반적인 패턴은 두 가지입니다.

스킬과 MCP 서버를 플러그인으로 묶으세요

Claude용 플러그인은 스킬, MCP 서버, 훅, LSP 서버, 전문화된 서브에이전트를 하나의 배포 단위로 묶을 수 있는 유용한 추상화입니다. 마찰을 최소화하면서 여러 컨텍스트 공급자를 통합하는 가장 좋은 방법입니다.

MCP 서버와 스킬을 결합하면 Claude가 도메인 전문가처럼 행동할 수 있습니다. MCP로 도구를 가져오고, 스킬로 워크플로우를 엔드투엔드로 오케스트레이션하는 방법을 Claude에게 알려주세요. Snowflake, Databricks, BigQuery, Hex 등의 앱을 위한 10개의 스킬과 8개의 MCP 서버로 구성된 Cowork용 데이터 플러그인을 예시로 참고하세요.

MCP 서버에서 스킬을 배포하세요

최근에는 MCP 서버와 함께 스킬을 게시하는 사례가 늘고 있습니다. 에이전트가 원시 기능과 함께 그 기능을 잘 활용하는 방법에 대한 검증된 가이드를 함께 얻을 수 있습니다. Canva, Notion, Sentry 등이 이미 Claude에서 이 방식을 채택하고 있으며, 저희 웹 디렉터리에 커넥터 옆에 스킬을 함께 등록했습니다.

이 조합을 모든 클라이언트에서 이식 가능하게 만들기 위해, MCP 커뮤니티는 현재 서버에서 직접 스킬을 제공하는 확장 기능을 활발히 개발 중입니다. 이를 통해 클라이언트는 의존하는 API와 함께 버전 관리된 관련 전문 지식을 자동으로 가져올 수 있습니다. 이 확장 기능이 안정화되면 폭넓게 채택될 것으로 기대합니다.

복리로 쌓이는 레이어

글 초반에 세 가지 연결 경로를 소개했습니다. 실제로 성숙한 통합은 세 가지를 모두 갖추게 됩니다. API는 기반으로, CLI는 로컬 우선 환경으로, MCP는 클라우드 기반 에이전트를 위해 사용합니다.

프로덕션 에이전트가 클라우드로 이동하면서 MCP는 핵심 레이어가 되고 있습니다. 그리고 이 레이어는 복리처럼 가치가 쌓입니다. 오늘날 원격 서버 하나로 인증, 인터랙티비티, 풍부한 시맨틱을 프로토콜 수준에서 처리하면서 모든 호환 클라이언트와 배포 환경에 도달할 수 있습니다. 더 많은 클라이언트가 사양을 채택하고 더 많은 확장 기능이 추가될수록, 새로 배포하지 않아도 같은 서버가 점점 더 강력해집니다.

통합을 구축할 때 목표가 클라우드의 프로덕션 에이전트를 내 시스템에 연결하는 것이라면, MCP 서버를 만들고 위의 패턴으로 완성도를 높이세요. MCP 위에 쌓이는 모든 통합은 생태계를 강화합니다. 혼자 해결해야 할 엣지 케이스가 줄어들고, 유지보수해야 할 일회성 통합도 줄어듭니다.

감사의 말

이 블로그 글에 기여해 주신 Den Delimarsky, David Soria Parra, Henry Shi, Felix Rieseberg, Conor Kelly, Molly Vorwerck, Andy Schumeister, Kevin Garcia, Amie Rotherham, Matt Samuels, Angela Jiang, Katelyn Lesse, AJ Rebeiro, Jess Yan 께 감사드립니다.