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를 다시 시작해 보십시오.