MCP Usage

연결된 MCP 서버의 도구, 프롬프트, 리소스 템플릿을 Kiro에서 호출하고, 실행 중에 추가 입력을 요청하는 elicitation을 다루는 방법을 정리합니다.

MCP 도구를 호출하는 세 가지 방식

Kiro는 사용자의 메시지를 분석해 어떤 MCP 도구를 쓸지 자동으로 판단합니다. 다음 세 가지 패턴 중 상황에 맞는 방식을 골라 쓰면 됩니다.

  1. 일반 질문 — 평소처럼 질문하면 Kiro가 적합한 도구를 자동 선택합니다. 예: Tell me about Amazon Bedrock, How do I configure S3 bucket policies?
  2. 구체적인 동작 지정 — 수행할 작업을 명확히 적으면 Kiro가 그에 맞는 도구를 호출합니다. 예: Search AWS documentation for information about ECS task definitions
  3. 서버와 도구를 명시 — #[server-name] tool_name your query 형식으로 직접 지정합니다. 예: #[aws-docs] search_documentation Tell me about AWS Lambda

MCP Tools 패널

연결된 서버 목록, 상태, 도구 활성화 여부를 한눈에 확인하고 관리할 수 있는 패널입니다.

  1. activity bar에서 Kiro 아이콘을 클릭합니다.
  2. MCP servers 탭으로 이동합니다.
  3. 연결된 서버와 사용 가능한 도구 목록을 확인합니다.

개별 도구 켜고 끄기

패널에서 서버를 펼친 뒤 도구를 클릭하면 Enable, Disable 옵션이 나타납니다. 비활성화된 도구는 "Disabled" 라벨로 표시됩니다.

JSON 설정에서 일괄적으로 차단하려면 disabledTools 배열을 사용합니다.

{
  "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"]
    }
  }
}
위험한 파괴적 동작을 차단하거나 팀 정책을 강제할 때, 또는 노이즈를 줄여 성능을 개선할 때 유용합니다.

서버 단위 동작 (우클릭 메뉴)

도구 승인 흐름

  1. 도구 호출 시점에 승인 프롬프트가 표시됩니다.
  2. 도구 설명과 전달될 파라미터를 확인합니다.
  3. Approve 또는 Deny를 클릭합니다.

신뢰하는 도구 자동 승인

반복적으로 호출되는 안전한 도구는 autoApprove 배열에 추가해 매번 승인하지 않아도 되게 만들 수 있습니다.

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

저장(Cmd+S)하면 즉시 반영됩니다.

쓰기 권한이 있거나 외부에 영향을 주는 도구는 자동 승인 대상에서 제외하세요.

서버 유형별 사용 예시

AWS Documentation Server

GitHub MCP Server

고급 활용

MCP Prompts

서버가 제공하는 재사용 가능한 프롬프트 템플릿입니다. 채팅 입력창에서 #를 입력하면 MCP 아이콘이 붙은 항목으로 노출됩니다.

  1. 채팅 입력창에 #를 입력합니다.
  2. MCP 아이콘이 표시된 프롬프트를 선택합니다.
  3. 인자가 있는 프롬프트라면 인라인 폼을 채워 제출합니다.
프롬프트는 항상 사용자 의지로 시작됩니다. Kiro가 자동으로 보내는 일은 없습니다.

MCP Resource Templates

docs://{topic}/{version}처럼 파라미터를 갖는 URI 템플릿입니다. # 메뉴에서 선택해 인자 폼을 채우면, 해석된 리소스의 내용이 대화 컨텍스트로 들어갑니다.

MCP Elicitation

도구가 실행 도중 추가 정보를 요청해야 할 때, Kiro가 사용자에게 입력을 받아 서버로 전달하는 기능입니다.

폼 기반 요청

필드 유형UI 표현
Text텍스트 입력 (email, date 등 포맷 힌트 가능)
Number숫자 입력
Yes/No체크박스
Choice선택 드롭다운

제출, 거절, 닫기 중 원하는 동작을 선택할 수 있습니다.

URL 기반 요청

OAuth 같은 외부 인증 흐름에서는 URL과 함께 Open 버튼이 표시됩니다.

Kiro는 어느 서버가 어떤 정보를 요청하는지 명시하지만, 비밀번호·API 키 같은 민감 정보는 elicitation으로 입력받아서는 안 됩니다.

문제 해결

권장 사항