MCP 도구 작동
확인은 에이전트가 도구를 가져오는 MCP-서버가 응답하고 필요한 도구가 제자리에 있는지를 추적합니다. 서버는 보통 살아 있습니다: 더 자주 내용이 변합니다 — 도구의 이름이 바뀌거나 출력에서 제거되었습니다. 일반적인 HTTP-확인은 작동하는 주소를 보고 이 중 아무것도 감지하지 못합니다.
정확히 무엇을 확인할지
확인 표시 집합이 아니라 하나의 단계를 선택합니다: 단계들은 중첩되어 있습니다 — «도구가 있음»은 «서버가 응답함» 없이 발생하지 않습니다. 처음 두 단계는 서버에서 아무것도 실행하지 않으며, 비용이 같으므로 두 번째부터 시작하는 것이 좋습니다: 확인이 시작되는 이유입니다.
| 단계 | 확인할 항목 | 가격 |
|---|---|---|
| 서버가 응답함 | 서버가 요청을 수락하고 응답이 구분 분석됩니다. 사용 불가능한 서버, 잘못된 주소 및 거부된 토큰을 포착하며, 명시적으로 선택한 프로토콜 버전 — 서버의 마이그레이션도 포착합니다. | 무료 |
| 서버가 도구를 가지고 있음 | 서버의 도구 목록에 지정한 도구가 있습니다. 이름이 변경되거나, 출력에서 제거되거나, 권한으로 숨겨진 도구를 포착합니다 — 서버 자체가 다운되는 것보다 훨씬 더 자주 발생합니다. | 무료 |
| 도구가 실행 중 | 도구가 지정한 인수로 호출되고 오류 없이 응답합니다. 목록에는 있지만 쿼리가 거부되는 경우를 포착합니다: 도구가 제자리에 있지만, 그 뒤에 있는 것이 깨졌습니다 — 데이터베이스, 외부 API, 권한. | 각 확인에서 실제 호출 |
양식 필드
| 필드 | 의미 | 입력할 내용 | 예시 |
|---|---|---|---|
| 이름 | 확인 이름입니다. | 어떤 서버와 왜 중요한지 명시하세요. | 데이터베이스 검색 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시간). 장기적인 장애를 놓치지 않아야 할 때 적합합니다. |