왜 Custom MCP 서버인가
Stripe는 500개의 내부 도구를 MCP 서버 하나로 연결했습니다. "Toolshed"라 불리는 이 중앙 MCP 서버는 코딩 에이전트가 필요한 도구만 선별해서 제공하고, 주당 1,300개 이상의 PR을 자동 처리합니다. 사내 시스템이 5개 이상이라면, 각각의 API를 개별 연결하는 대신 MCP 서버 하나로 통합하는 것이 운영 비용과 확장성 모두에서 유리합니다.
시작하기 전에
Step 1: 아키텍처 설계 — 3가지 결정
Transport 선택
MCP 서버는 두 가지 전송 방식을 지원합니다.stdio는 로컬 프로세스 간 통신으로, 설정이 간단하고 빠릅니다.Streamable HTTP는 네트워크를 통한 원격 통신으로, 프로덕션 환경에 적합합니다.
3 Primitives 결정
MCP는 세 가지 기본 요소(Primitives)를 정의합니다. 서버를 설계하기 전에 각 요소에 무엇을 배치할지 결정하세요.
- Tools (동사) — AI가 실행하는 동작. "Jira 이슈 생성", "Slack 메시지 전송" 등
- Resources (명사) — AI가 읽는 데이터. "프로젝트 목록", "사용자 프로필" 등
- Prompts (문법) — AI가 따르는 작업 템플릿. "주간 보고서 작성", "코드 리뷰 요청" 등
출처: Model Context Protocol, "Architecture" 원문
Step 2: SDK 선택
MCP 서버를 구축할 언어를 선택하세요. 팀의 기술 스택과 성능 요구사항에 따라 결정합니다.
MCP SDK 비교 (2026년 기준)
| 항목 | TypeScript | Python | Go | Kotlin/Java |
|---|---|---|---|---|
| 성숙도 | 공식 Reference SDK | 공식 SDK | 커뮤니티 (mcp-go) | 공식 SDK |
| 응답 지연 | 0.895ms | ~1.2ms | 0.835ms | ~1.1ms |
| 메모리 | 95MB | ~120MB | 18MB | ~150MB |
| 생태계 | 가장 큰 커뮤니티 | ML/데이터 강점 | 경량·고성능 | Spring Boot 통합 |
| 추천 | 빠른 프로토타입 | AI/ML 파이프라인 | 고성능 프로덕션 | JVM 엔터프라이즈 |
출처: TM Dev Lab, "MCP Server Performance Benchmark" (2026) 원문
Step 3: 도구 정의
MCP 서버의 핵심은 도구(Tool) 정의입니다. 각 도구는 name, description, inputSchema를 가지며, LLM은 description을 읽고 어떤 도구를 호출할지 판단합니다.
Stripe는 Toolshed에 500개 도구를 등록했지만, 에이전트에게는 작업에 필요한 약 15개만 선별 제공합니다. 이 "surgical subset" 패턴이 핵심입니다. 도구를 전부 노출하면 컨텍스트 윈도우가 도구 정의로 가득 차서 LLM의 추론 품질이 떨어집니다.
QANDA AX의 Wizard 시스템도 이 패턴을 따릅니다. 7개 도메인의 60+ AI Skills를 도메인별 MCP 서버로 분리하고, 각 워크플로우에 필요한 도구만 선별 제공합니다. AI가 올바른 도구를 올바른 순서로 사용하도록 설계하는 것이 MCP 서버 구축의 본질입니다.
Step 4: 보안 설계
MCP 서버는 사내 시스템의 관문입니다. 보안 설계를 빠뜨리면 AI 에이전트가 의도치 않은 데이터에 접근하거나, 악의적 프롬프트에 의해 위험한 동작을 실행할 수 있습니다.
Step 5: 테스트 & 배포
배포 경로
단계적으로 배포 범위를 넓히세요.
- 로컬 stdio — 개발 중 Claude Desktop에서 바로 연결. 빠른 피드백 루프로 도구 정의를 반복 수정합니다.
- Docker 컨테이너화 — Streamable HTTP로 전환하고, Docker 이미지로 패키징합니다. 팀원들이 동일한 환경에서 테스트할 수 있습니다.
- Kubernetes / Cloud 배포 — 프로덕션 환경에 배포합니다. 로드 밸런싱, 오토스케일링, 모니터링을 설정하세요.
MCP 서버 구축 시 흔한 실수
배포 전 체크리스트
MCP 서버 구축은 시작일 뿐입니다. QANDA AX의 AI Integration 서비스를 통해 설계부터 운영까지 전문가의 지원을 받을 수 있습니다. 팀이 MCP를 올바르게 이해해야 서버도 올바르게 설계할 수 있습니다 — AI Literacy 프로그램도 함께 검토하세요.
자주 묻는 질문
MCP 서버를 꼭 직접 만들어야 하나요?
아닙니다. Jira, Slack, GitHub 등 주요 도구는 이미 커뮤니티 MCP 서버가 있습니다. 직접 구축이 필요한 경우는 다음과 같습니다.
- 사내 전용 시스템 연결 시
- 보안 요구사항이 높을 때
- 여러 시스템을 하나의 통합 서버로 묶고 싶을 때
어떤 사내 시스템부터 연결하면 좋을까요?
가장 자주 수동으로 데이터를 복사·붙여넣기 하는 시스템부터 시작하세요. 대부분의 경우 프로젝트 관리 도구(Jira, Linear)나 문서 도구(Notion, Confluence)가 1순위입니다. 그 다음 커뮤니케이션 도구(Slack), 개발 도구(GitHub) 순서를 권장합니다.
사내 시스템과 AI 연결, 전문가와 함께 시작하세요
QANDA AX는 Custom MCP 서버 설계·구축·배포를 지원합니다. 48개 내부 AI Skills 운영 경험으로 최적의 아키텍처를 설계합니다.
무료 상담 신청하기