MCP 요청

MCP 요청은 작업 공간의 MCP 서버 하나에 대한 저장된 호출입니다. 도구 호출, 리소스 읽기, 프롬프트, 또는 임의의 JSON-RPC 메서드가 해당합니다. 자주 하는 호출을 저장하고 검사를 추가한 다음, 다른 요청과 마찬가지로 실행에서 실행하십시오.

MCP 서버 페이지에서 호출해 보기Copy Anchor Link

가장 빠른 시작 방법은 서버 자체에서 해 보는 것입니다.

1. MCP 서버 페이지를 열고 서버를 선택합니다. https://demo.echolot.dev/mcp를 가리키는 Alpenglow MCP 같은 것입니다.
2. 아직 확인하지 않았다면 검사를 선택합니다. 페이지에 서버의 도구, 리소스, 프롬프트가 나열됩니다.
3. 도구, 리소스 또는 프롬프트를 클릭합니다. 인수가 있는 시트가 열립니다.
4. 입력 스키마로 만든 양식이나 JSON으로 인수를 채우고 호출을 선택합니다.
5. 아래에 결과가 나타나며, 결과 또는 오류와 걸린 시간이 함께 표시됩니다.
6. 요청으로 저장을 선택하면 인수를 포함한 호출이 MCP 요청으로 보관됩니다.

MCP 요청 만들기Copy Anchor Link

사이드바의 요청 옆 + 메뉴에서 새로운 MCP 호출을 선택합니다. 편집기의 막대에 호출이 들어 있습니다.

1. 맨 앞의 메뉴에서 서버를 고릅니다. 같은 메뉴의 MCP 서버…는 MCP 서버 페이지를 엽니다.
2. 무엇을 호출할지 고릅니다. 도구, 리소스, 프롬프트, 메서드 중 하나입니다.
3. 대상을 입력합니다. 도구 이름, 리소스 URI, 프롬프트 이름, 또는 ping 같은 JSON-RPC 메서드입니다. 서버의 최신 검사에서 가져온 이름이 입력하는 동안 서버에서 아래에 제안됩니다.
4. 호출(⌘R)을 선택합니다. 실행 중에는 취소(⌘.)로 중단합니다.

편집기의 탭은 문서, 인수, 변수, 테스트, 설정입니다. MCP 요청에는 자체 헤더, 인증, 스크립트가 없습니다. 서버의 연결 설정, 헤더, 로그인은 MCP 서버 페이지에 있습니다. 서버 추가를 참고하십시오.

인수Copy Anchor Link

인수 탭에는 {{variables}}를 쓸 수 있는 JSON 객체가 들어 있습니다.

{
  "query": "ultralight tent",
  "limit": 3
}

서버의 최신 검사에서 해당 도구를 알고 있으면 탭의 편집기 위에 도구 설명이, 아래에 Fields: query*, limit 같은 필드가 표시됩니다. 별표는 필수 필드를 뜻합니다. 스키마로 채우기는 인수를 도구 입력 스키마의 모든 필드로 바꿔 줍니다. 이를 출발점으로 삼을 수 있습니다.

Alpenglow 작업 공간에는 Agent tools에 호출이 두 개 있습니다. 위의 인수를 쓰는 search_catalog와, {"order_id": "ord_7Hk2Lw"}를 조회하는 order_status입니다.

결과Copy Anchor Link

응답 패널은 다른 응답과 마찬가지로 본문 탭에 결과를 JSON으로 보여 줍니다. 응답 요약의 배지에는 초록색 결과 또는 빨간색 오류와 서버가 사용하는 프로토콜 버전이 표시됩니다. 포인터를 올리면 누가 응답했는지, 또는 무엇이 잘못되었는지 볼 수 있습니다.

호출은 두 가지 방식으로 실패할 수 있으며 Echolot은 이 둘을 구분합니다.

• 서버가 오류로 응답합니다. 오류로 표시된 도구 결과이거나 JSON-RPC 오류입니다. 배지에 오류가 표시되고 본문에 서버가 한 말이 들어 있습니다.
• 호출이 응답을 전혀 받지 못합니다. 서버에 연결할 수 없거나, 시작하지 않거나, 프로토콜을 어깁니다. 응답 패널에 이유가 표시됩니다. MCP 서버 페이지에서 서버를 검사하십시오. 메시지 로그에 마지막 검사의 모든 메시지가 있습니다.

모든 호출은 기록에 보관됩니다.

MCP 검사Copy Anchor Link

테스트 탭에서 다음을 쓸 수 있습니다.

• MCP 오류가 false와 같음은 호출이 성공했을 때 통과합니다. 실패하면 서버의 메시지가 표시됩니다.
• 도구 출력 스키마는 결과의 structuredContent를 도구가 선언한 outputSchema와 대조합니다. 도구가 선언하지 않았거나 결과에 structuredContent가 없으면 실패합니다.
• JSON 값은 $.structuredContent.results.length가 0 초과, $.content[0].type이 text와 같음처럼 결과의 임의의 값을 검사합니다.

모든 검사와 비교는 스크립트와 테스트를 참고하십시오.

명령줄에서Copy Anchor Link

echolot run은 저장된 MCP 요청을 검사와 함께 실행하고, echolot mcp check는 서버를 점검합니다. echolot mcp를 참고하십시오.