MCP Servers 개요

Model Context Protocol(MCP)을 활용해 Kiro를 외부 도구·지식·서비스와 연결하는 방법을 한눈에 정리합니다.

MCP란 무엇인가

MCP는 Kiro와 외부 서버가 서로 도구(tool), 프롬프트(prompt), 리소스(resource)를 주고받기 위한 공통 통신 규약입니다. 예를 들어 AWS Documentation MCP 서버를 연결하면 Kiro 안에서 곧바로 AWS 공식 문서를 검색하고 권장 사항을 확인할 수 있습니다. 직접 만든 사내 API 래퍼나 도메인 특화 도우미를 붙이는 것도 같은 방식으로 가능합니다.

MCP로 할 수 있는 일

특정 분야의 지식 베이스 또는 문서에 즉시 접근
외부 서비스·API와 연동된 자동화 워크플로 구성
도메인에 특화된 커스텀 도구를 Kiro 워크플로에 추가
채팅창의 # mention 시스템을 통해 서버가 제공하는 prompt template과 resource template 호출
서버가 추가 정보를 요구하는 elicitation 요청 처리
팀 또는 프로젝트 고유의 작업을 자동화하는 전용 도구 제작

MCP 지원 활성화하기

Settings를 엽니다. macOS는 Cmd + ,, Windows/Linux는 Ctrl + ,.
설정 검색창에 MCP를 입력합니다.
표시되는 MCP 지원 옵션을 토글하여 켭니다.

사용하려는 각 MCP 서버는 Node.js, Python, 또는 별도 토큰 등 자체 prerequisite가 있을 수 있습니다. Kiro를 최신 버전으로 유지한 뒤, 서버별 설치 안내를 함께 확인하세요.

MCP servers 탭 살펴보기

activity bar에서 Kiro 아이콘을 클릭하면 MCP servers 탭이 나타납니다. 이 탭에서는 다음 정보를 확인할 수 있습니다.

현재 구성된 모든 MCP 서버 목록
각 서버의 연결 상태 표시
서버가 노출한 도구로의 빠른 접근

특정 도구 이름을 클릭하면 채팅 입력창에 해당 도구를 호출하는 placeholder prompt가 자동으로 삽입되어, 이어서 인자만 채워 넣으면 바로 실행할 수 있습니다.

로그 확인 및 트러블슈팅

문제가 발생하면 Kiro 패널의 Output 탭을 열고 드롭다운에서 Kiro - MCP Logs를 선택해 서버 동작 로그를 확인합니다. 자주 마주치는 증상과 점검 포인트는 다음과 같습니다.

연결 실패 — 서버가 요구하는 런타임과 의존성이 올바르게 설치되어 있는지 확인합니다.
권한 오류 — 환경 변수나 설정 파일에 등록한 토큰·API 키가 유효한지 점검합니다.
도구가 응답하지 않음 — MCP Logs에 남은 stack trace로 원인을 추적합니다.
설정이 적용되지 않음 — 구성 JSON의 문법 오류 여부와 저장 상태를 다시 확인합니다.

외부 MCP 서버는 사용자의 토큰을 사용해 실제 API를 호출하기 때문에, 신뢰할 수 있는 서버만 등록하고 민감한 자격 증명은 코드 저장소에 커밋하지 않도록 주의합니다.

다음 단계

이어지는 문서에서 구성, 서버 관리, 사용법, 보안 권장 사항을 단계별로 살펴볼 수 있습니다.

Configuring MCPs — 설정 파일과 적용 범위
MCP Server 관리 — 서버 추가·갱신·제거
MCP 도구 사용법 — 채팅 안에서 호출하기
Best Practices — 안전한 운영 가이드
외부: Model Context Protocol 공식 문서