MCP 도구 작동

확인은 에이전트가 도구를 가져오는 MCP-서버가 응답하고 필요한 도구가 제자리에 있는지를 추적합니다. 서버는 보통 살아 있습니다: 더 자주 내용이 변합니다 — 도구의 이름이 바뀌거나 출력에서 제거되었습니다. 일반적인 HTTP-확인은 작동하는 주소를 보고 이 중 아무것도 감지하지 못합니다.

정확히 무엇을 확인할지

확인 표시 집합이 아니라 하나의 단계를 선택합니다: 단계들은 중첩되어 있습니다 — «도구가 있음»은 «서버가 응답함» 없이 발생하지 않습니다. 처음 두 단계는 서버에서 아무것도 실행하지 않으며, 비용이 같으므로 두 번째부터 시작하는 것이 좋습니다: 확인이 시작되는 이유입니다.

단계 확인할 항목 가격
서버가 응답함 서버가 요청을 수락하고 응답이 구분 분석됩니다. 사용 불가능한 서버, 잘못된 주소 및 거부된 토큰을 포착하며, 명시적으로 선택한 프로토콜 버전 — 서버의 마이그레이션도 포착합니다. 무료
서버가 도구를 가지고 있음 서버의 도구 목록에 지정한 도구가 있습니다. 이름이 변경되거나, 출력에서 제거되거나, 권한으로 숨겨진 도구를 포착합니다 — 서버 자체가 다운되는 것보다 훨씬 더 자주 발생합니다. 무료
도구가 실행 중 도구가 지정한 인수로 호출되고 오류 없이 응답합니다. 목록에는 있지만 쿼리가 거부되는 경우를 포착합니다: 도구가 제자리에 있지만, 그 뒤에 있는 것이 깨졌습니다 — 데이터베이스, 외부 API, 권한. 각 확인에서 실제 호출
세 번째 단계는 실제로 도구를 호출합니다. 도구 호출 — 이것은 작업입니다. 5분마다 이메일을 보내거나 티켓을 만드는 모니터링은 조용한 재앙을 초래할 것이며, 그 자체로는 «작동»될 것입니다. 따라서 단계는 기본값으로 비활성화되어 있으며, 읽기 도구에만 선택해야 합니다 — 검색, 읽기, 참조입니다. 읽기 도구를 변경하는 도구와 구분할 수 없으므로 선택 당신에게 남겨집니다.
프로토콜 버전 — 자동 또는 당신의 것입니다. 기본적으로 우리는 각 확인에서 버전을 정의합니다: 서버가 유지하는 모든 것이 적합합니다. 이것은 도구 응답이 중요한 경우 충분합니다. 하지만 자동 정의는 조용히 서버를 따릅니다: 새로운 개정으로 이동하고, 확인이 조정되고 «작동» 표시 — 그리고 이전 버전을 위해 설계된 당신의 응용 프로그램 이미 깨진 상태입니다. 코드가 특정 버전에 바인딩된 경우 이를 선택합니다: 그러면 서버의 마이그레이션 거부가 될 것이고 당신은 배울 것입니다. 선택한 버전을 지원하지 않으면 서버가 그것의 것을 이름으로 지을 것이고 우리는 확인 이유에 표시할 것입니다.
HTTP만 추적합니다. MCP-서버는 로컬일 수 있습니다 — 편집기나 에이전트가 당신의 머신에서 실행하고 표준 입력-출력을 통해 통신합니다. 그러한 서버에 외부에서 도달할 수 없으며, 우리도 마찬가지입니다. 인터넷에서 사용 가능한 서버를 추적할 수 있습니다.
레거시 전송은 지원되지 않습니다. 프로토콜의 첫 번째 개정, 2024-11-05, 다르게 작동했습니다: 서버가 별도의 이벤트 스트림과 메시지의 별도 주소를 유지했습니다. 봄 2025년에도 해당 버전이 사용되지 않는다고 선언되었으며, 버전 목록에 없습니다. 주소가 이에 따라 응답하면, 확인은 직접 말할 것입니다 — 주소는 일반 MCP 요청을 수락하지 않습니다.

양식 필드

필드 의미 입력할 내용 예시
이름 확인 이름입니다. 어떤 서버와 왜 중요한지 명시하세요. 데이터베이스 검색 MCP
그룹 작업을 프로젝트나 섹션에 할당할 수 있습니다. 프로젝트별로 작업을 함께 유지하려면 그룹을 선택하세요. 주요 프로젝트
서버 주소 MCP-엔드포인트 주소 — 당신이 에이전트 설정에 입력하는 것. 주소 전체를 경로와 함께 입력하세요. 보통 경로는 /mcp로 끝나지만, 어떤 것도 될 수 있습니다. https://example.com/mcp
프로토콜 버전 코드가 설계된 MCP 개정 또는 «자동» — 서버가 보유한 모든 버전. 도구가 응답하는 것만 중요하면 «자동»을 유지하세요. 서버의 마이그레이션을 알고 싶으면 클라이언트가 선언하는 것과 동일한 버전을 선택하세요. 자동
토큰 서버가 인증으로 닫혀 있으면 Bearer-토큰입니다. 서버가 열려 있으면 비워두세요. 작업을 변경할 때 빈 필드는 «이전 토큰 유지»를 의미합니다; 다른 호스트로 이동할 때 이전 토큰은 이동되지 않습니다 — 우리는 새 주소로 그것을 보내지 않을 것입니다. 서버 설정의 토큰
확인할 항목 위에 설명된 확인 단계입니다. 두 번째를 선택하세요: 서버에서 아무것도 실행하지 않으며, 첫 번째와 마찬가지로, 확인이 시작되는 이유에 답합니다. 세 번째 — 읽기 도구용만. 서버가 도구를 가지고 있음
도구 추적 중인 도구 이름입니다. 두 번째 단계부터 요청됩니다. 서버가 도구 목록에서 제공하는 것과 정확히 동일하게 지정하세요: 비교는 엄격합니다. 이것이 도구가 호출되는 이름이지만, 설명이 아닙니다. search_documents
인수 도구를 호출할 항목입니다. 세 번째 단계에만 요청됩니다. 도구가 인수를 기대하는 방식의 JSON 객체입니다. 도구가 확실히 응답할 무해한 쿼리를 선택하세요. 빈 필드 — 인수 없이 호출합니다. {"query": "test"}
대기 시간 전체 확인에 할당된 시간(모든 단계)입니다. 지정된 시간보다 오래 걸리는 확인은 거부로 간주됩니다: 응답하지만 천천히 하는 서버도 고장입니다. 서버가 일반적으로 응답하는 시간, 여유를 두고 나아갑니다. 30초
간격 확인을 실행하는 빈도입니다. 처음 두 단계에서 — 편의에 따라, 합리적인 빈도 — 5분. 세 번째에서 — 15분부터: 각 확인이 도구를 호출합니다. 5분
알림 채널 문제 및 복구 메시지를 보낼 위치입니다. 실제로 알림을 읽는 채널을 선택하세요. Telegram 및 이메일
보고서 작업에 대한 주기적 요약입니다. 패널에 수동으로 로그인하지 않고 개요를 받으려면 활성화하세요. 주간 보고서

경고가 올 때

선택한 확인이 실패하면 경고가 옵니다:

  • 서버를 사용할 수 없음, 오류로 응답하거나 토큰을 거부했습니다;
  • 서버가 선택한 프로토콜 버전을 지원하지 않습니다 — 이유에 지원하는 버전이 나열됩니다;
  • 주소가 MCP-서버가 아니거나 레거시 전송의 서버로 응답합니다;
  • 지정한 도구가 목록에 없습니다 — 두 번째와 세 번째 단계에서;
  • 도구가 오류로 실행되었거나 결과 대신 입력을 요청했습니다 — 세 번째 단계에서;
  • 전체 확인이 대기 시간보다 오래 걸렸습니다 — 모든 단계.

확인이 건너뛸 때

서버가 더 드물게 요청하도록 요청한 경우, 작업은 다운되거나 올라가지 않습니다 — 확인 건너뛰고 상태는 이전 상태로 유지됩니다. 이것이 유일한 경우입니다: 빈도 제한은 우리 자신의 성가심을 나타냅니다, 서버가 아닙니다. 다른 모든 것 — 무음 네트워크, 서버 오류, 거부된 토큰 — 이 작업을 위해 도구를 지금 사용할 수 없음을 의미합니다.

한 가지 작업 — 한 가지 도구

한 서버의 3개 도구를 추적 — 이것들은 3개 작업입니다. 각 도구는 자신의 가동 시간을 가지고 있습니다: 여러 질문을 한 작업에서 혼합하면 가동 시간을 얻을 것입니다, 그것이 무엇인지 불명확합니다. 도구가 똑같이 중요하면 작업을 그룹으로 수집합니다.

알림 설정

작업의 각 알림 채널에 추가 매개변수를 설정할 수 있습니다. DOWN 이벤트에만 적용됩니다.

매개변수 기능
활성화 이 채널로 해당 작업의 알림 전송을 허용하거나 금지합니다.
지연 PRO DOWN에 대한 첫 알림을 선택한 시간(최대 12시간)만큼 지연합니다. 단기 오류에 대한 알림을 받지 않도록 하는 데 편리합니다.
반복 PRO 작업이 DOWN 상태로 유지되는 동안 주기적으로 알림을 반복합니다 (반복 간격 최대 1시간). 장기적인 장애를 놓치지 않아야 할 때 적합합니다.
«지연» 및 «반복» 매개변수는 UP 이벤트와 복구 알림에 영향을 주지 않습니다.
작업 유형 목록으로