View a markdown version of this page

MCP Inspector 사용 - Amazon Bedrock AgentCore
문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

MCP Inspector 사용

모델 컨텍스트 프로토콜(MCP)을 통해 제공되는 MCP Inspector는 대화형 인터페이스를 통해에서 MCP 서버를 테스트하고 디버깅하는 데 도움이 되는 개발자 도구입니다. AgentCore 게이트웨이를 MCP 검사기에 연결하여 게이트웨이 대상을 디버깅할 수 있습니다.

MCP Inspector에 대한 자세한 내용은 MCP Inspector 설명서를 참조하세요.

게이트웨이를 검사기에 연결하려면

  1. 터미널을 열고를 실행npx @modelcontextprotocol/inspector하여 다음을 수행합니다.

    1. 검사기 설치

    2. localhost에서 검사기를 시작합니다.

    3. 인증을 위한 세션 토큰을 생성합니다.

    4. 브라우저를 열어 검사기 인터페이스를 엽니다.

  2. 검사기 인터페이스에서 다음 필드를 구성합니다.

    • 전송 유형 - 스트리밍 가능한 HTTP 선택

    • URL - 게이트웨이를 생성할 때 반환되는 게이트웨이 엔드포인트 URL을 입력합니다.

    • 인증을 확장합니다. 사용자 지정 헤더 섹션은 하나의 키-값 페어로 미리 채워져야 합니다.

  3. 연결을 선택합니다. 게이트웨이에 연결됩니다. MCP Inspector를 에이전트와 통합하기 전에 게이트웨이를 검사하고 테스트하는 도구로 사용할 수 있습니다.

게이트웨이가 연결된 MCP 서버를 검사하는 방법에 대한 자세한 내용은 MCP Inspector 설명서의 기능 개요에서 기능 개요를 참조하세요.

중요

MCP Inspector는 개발 도구이므로 프로덕션 환경에서 사용해서는 안 됩니다. 항상 액세스 토큰과 게이트웨이 자격 증명을 보호하십시오.

문제 해결

게이트웨이와 함께 MCP Inspector를 사용할 때 문제가 발생하면 다음을 확인하세요.

  • 연결 문제: 게이트웨이 URL이 올바르고 네트워크에서 액세스할 수 있는지 확인합니다.

  • 인증 문제: 액세스 토큰이 유효하고 만료되지 않았는지 확인

  • 도구 호출 오류: 응답의 오류 메시지를 확인하고 입력 파라미터가 도구 스키마와 일치하는지 확인합니다.

  • 프록시 오류: 프록시 연결과 관련된 오류가 표시되면 MCP Inspector를 다시 시작해 보십시오.