도구¶

이 가이드는 Model Context Protocol(MCP) 도구를 Kiro와 함께 효과적으로 사용하여 생산성을 높이고 전문화된 기능에 액세스하는 방법을 설명합니다.

MCP 도구와 상호작용¶

MCP 서버를 구성한 후 여러 가지 방법으로 도구와 상호작용할 수 있습니다:

직접 질문¶

MCP 도구를 사용하는 가장 간단한 방법은 서버의 도메인과 관련된 질문을 하는 것입니다:

Tell me about Amazon Bedrock

How do I configure S3 bucket policies?

Kiro는 질문에 따라 자동으로 적절한 MCP 도구를 선택합니다.

특정 도구 요청¶

수행하려는 작업을 설명하여 특정 MCP 도구를 요청할 수 있습니다:

Search AWS documentation for information about ECS task definitions

Get recommendations for AWS CloudFormation best practices

명시적 컨텍스트¶

더 많은 제어를 위해 도구 선택기에 명시적 컨텍스트를 제공합니다:

#[aws-docs] search_documentation Tell me about AWS Lambda

이 형식은 서버(aws-docs)와 도구(search_documentation)를 모두 지정합니다.

MCP 도구 패널¶

Kiro 패널에는 다음을 제공하는 MCP 서버 탭이 포함되어 있습니다:

구성된 모든 MCP 서버 목록
연결 상태 표시기
개별 도구 관리
서버 도구에 대한 빠른 액세스

MCP 패널에 액세스하려면:

활동 표시줄에서 Kiro 아이콘 선택
MCP 서버 탭으로 이동
연결된 모든 서버와 사용 가능한 도구 보기

개별 도구 관리¶

각 MCP 서버는 여러 도구를 노출할 수 있습니다. 전체 서버에 영향을 주지 않고 특정 도구를 활성화하거나 비활성화할 수 있습니다:

Kiro 패널을 통해:

Kiro 패널을 열고 MCP 서버로 이동
서버를 확장하여 사용 가능한 도구 보기
도구를 클릭하여 옵션 보기:
- Enable - 비활성화된 도구 활성화
- Disable - 서버를 제거하지 않고 도구를 임시로 비활성화
비활성화된 도구는 "Disabled" 레이블을 표시하며 Kiro에서 사용할 수 없음

JSON 구성을 통해:

MCP 구성에서 disabledTools 배열을 사용하여 특정 도구를 영구적으로 비활성화합니다:

json

{ "mcpServers": { "github": { "command": "docker", "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"], "disabledTools": ["delete_repository", "force_push", "merge_pull_request"] } } }

다음에 유용합니다:

위험한 작업 차단 (삭제 또는 강제 푸시 등)
사용하지 않는 도구를 숨겨 도구 혼잡 감소
Kiro가 고려하는 도구를 제한하여 성능 향상
워크스페이스 구성을 공유할 때 팀 정책 시행

서버 수준 작업¶

MCP 패널에서 서버를 마우스 오른쪽 버튼으로 클릭하여 추가 옵션에 액세스합니다:

Reconnect - 서버 연결 재시작
Disable - 전체 서버를 임시로 비활성화
Disable All Tools - 이 서버의 모든 도구를 한 번에 비활성화
Enable All Tools - 이전에 비활성화된 모든 도구를 다시 활성화
Show MCP Logs - 문제 해결을 위한 자세한 로그 보기

도구 승인 프로세스¶

Kiro가 MCP 도구를 사용하려고 할 때 먼저 승인을 요청합니다:

도구와 그 목적을 설명하는 프롬프트가 표시됨
도구 세부 정보 및 매개변수 검토
"Approve"를 클릭하여 도구 실행을 허용하거나 "Deny"를 클릭하여 방지

신뢰할 수 있는 도구 자동 승인¶

신뢰하는 도구에 대한 반복적인 승인 프롬프트를 피하려면:

MCP 구성 파일 편집
autoApprove 배열에 도구 이름 추가:

json

{ "mcpServers": { "aws-docs": { "autoApprove": [ "mcp_aws_docs_search_documentation", "mcp_aws_docs_read_documentation" ] } } }

파일을 저장(Cmd+S)하여 변경 사항을 자동으로 적용

서버 유형별 예시¶

AWS Documentation 서버¶

문서 검색¶

Search AWS documentation for S3 bucket versioning

mcp_aws_docs_search_documentation 도구를 사용하여 관련 AWS 문서를 찾습니다.

문서 읽기¶

Read the AWS Lambda function URLs documentation

mcp_aws_docs_read_documentation 도구를 사용하여 문서 내용을 검색하고 표시합니다.

권장 사항 얻기¶

Find related content to AWS ECS task definitions

mcp_aws_docs_recommend 도구를 사용하여 관련 문서를 제안합니다.

GitHub MCP 서버¶

리포지토리 정보¶

Show me information about the tensorflow/tensorflow repository

지정된 GitHub 리포지토리에 대한 세부 정보를 검색합니다.

코드 검색¶

Find examples of React hooks in facebook/react

지정된 리포지토리에서 쿼리와 일치하는 코드를 검색합니다.

이슈 관리¶

Create an issue in my repository about the login bug

적절한 세부 정보로 새 GitHub 이슈를 만드는 데 도움을 줍니다.

고급 사용 기술¶

MCP 도구 연결¶

복잡한 작업을 위해 여러 MCP 도구를 순차적으로 사용할 수 있습니다:

First search AWS documentation for ECS task definitions, then find related content about service discovery

로컬 컨텍스트와 결합¶

MCP 도구는 로컬 컨텍스트와 결합할 때 가장 잘 작동합니다:

Based on my Terraform code, help me optimize my AWS Lambda configuration using best practices from AWS documentation

Specs에서 MCP 도구 사용¶

Kiro Specs 내에서 MCP 도구를 사용하여 개발 워크플로우를 향상시킬 수 있습니다:

In the implementation phase, use AWS documentation to ensure our S3 bucket configuration follows best practices

도구 사용 문제 해결¶

MCP 도구를 사용할 때 문제가 발생하는 경우:

도구가 응답하지 않음¶

Kiro 패널에서 MCP 서버 상태 확인
오류 메시지에 대한 MCP 로그 검토
Ask Kiro 기능을 사용하여 오류 해결

잘못된 결과¶

요청을 더 구체적으로 다시 작성해 보기
작업에 적합한 도구를 사용하고 있는지 확인
MCP 서버에 필요한 권한이 있는지 확인

도구를 사용할 수 없음¶

MCP 서버가 올바르게 구성되었는지 확인
서버가 실행 중이고 연결되어 있는지 확인
도구를 사용할 수 있는 필요한 권한이 있는지 확인

모범 사례¶

가장 관련성 높은 결과를 얻으려면 요청에서 구체적으로 작성
명시적 도구 참조를 사용하기 전에 직접 질문으로 시작
신뢰하고 자주 사용하는 도구만 자동 승인
최상의 결과를 위해 로컬 컨텍스트와 MCP 도구 결합
올바른지 확인하기 위해 승인 전에 도구 매개변수 확인

사용 가능한 MCP 서버 및 도구에 대한 정보는 MCP 서버 페이지를 참조하세요.