Hoạt động công cụ MCP

Kiểm tra theo dõi rằng máy chủ MCP, trong đó tác nhân của bạn lấy công cụ, phản hồi và công cụ cần thiết nằm ở đó. Máy chủ khi này thường là sống: nó thay đổi bộ phận bên trong thường xuyên hơn — công cụ được đổi tên hoặc bị gỡ khỏi danh sách. Kiểm tra HTTP thường sẽ thấy địa chỉ hoạt động và không nhận thấy gì trong số này.

Chính xác để kiểm tra

Một cấp độ được chọn, không phải một bộ các tích chọn: chúng lồng vào nhau — "công cụ nằm ở đó" mà không "máy chủ phản hồi" không bao giờ xảy ra. Hai cấp độ đầu tiên không thực thi bất cứ điều gì trên máy chủ và chi phí như nhau, vì vậy nên bắt đầu với cái thứ hai: nó là những gì ở đó để kiểm tra bị tạo.

Cấp độ Những gì được kiểm tra Giá
Máy chủ phản hồi Máy chủ chấp nhận yêu cầu và phản hồi được phân tích cú pháp. Bắt được máy chủ không khả dụng, địa chỉ không hợp lệ và mã thông báo bị từ chối, và khi phiên bản giao thức được chọn rõ ràng — và máy chủ chuyển sang một phiên bản khác. Miễn phí
Công cụ ở máy chủ Trong danh sách công cụ của máy chủ nằm cái mà bạn chỉ định. Bắt được đổi tên công cụ, bị gỡ bỏ từ danh sách hoặc bị ẩn theo quyền — điều này xảy ra đáng kể thường xuyên hơn sự sụp đổ của chính máy chủ. Miễn phí
Công cụ thực hiện Công cụ được gọi với các đối số bạn đã chỉ định và trả lời mà không gặp lỗi. Bắt được những gì danh sách không thấy: công cụ nằm ở đó, nhưng cái nó đi tìm bị hỏng — cơ sở dữ liệu, API bên ngoài, quyền. Cuộc gọi thực sẽ ở mỗi kiểm tra
Cấp độ thứ ba gọi công cụ có thật. Gọi công cụ — đây là một tác vụ. Giám sát, mà mỗi năm phút gửi email hoặc tạo vé, sẽ gây ra thảm họa yên tĩnh, mặc dù nó sẽ "hoạt động". Vì vậy cấp độ được tắt theo mặc định, và để chọn cho nó nên chỉ có một công cụ đọc — tìm kiếm, đọc, giúp đỡ. Để phân biệt một công cụ đọc từ công cụ thay đổi bằng mô tả của nó, chúng tôi không thể, vì vậy lựa chọn vẫn còn với bạn.
Phiên bản giao thức — tự động hoặc của bạn. Theo mặc định, chúng tôi xác định phiên bản của riêng mình ở mỗi kiểm tra: bất kỳ cái nào máy chủ giữ phù hợp. Điều này là đủ nếu quan trọng để công cụ phản hồi. Nhưng tự động xác định âm thầm theo máy chủ: nó chuyển sang sửa đổi mới, kiểm tra điều chỉnh và hiển thị "hoạt động" — và ứng dụng của bạn, được thiết kế cho phiên bản cũ, tại thời điểm này đã hỏng. Nếu mã của bạn được gắn với phiên bản cụ thể, hãy chọn nó: sau đó sẽ máy chủ chuyển sẽ trở thành từ chối, mà bạn sẽ tìm hiểu. Không hỗ trợ cái được chọn, máy chủ sẽ đặt tên của riêng họ, và chúng tôi sẽ hiển thị chúng trong lý do kiểm tra.
Theo dõi chỉ qua HTTP. Máy chủ MCP có thể ở địa phương — những cái mà biên tập viên hoặc tác nhân chạy trên máy của bạn và chuyện trò với họ thông qua đầu vào-đầu ra tiêu chuẩn. Tới máy chủ như vậy từ bên ngoài là không thể để ai, bao gồm chúng tôi. Theo dõi có thể được truy cập từ một địa chỉ từ Internet.
Giao vận cổ không được hỗ trợ. Bản sửa đổi đầu tiên của giao thức, 2024-11-05, đã hoạt động khác: máy chủ có một luồng sự kiện riêng biệt và một địa chỉ riêng biệt cho các tin nhắn. Nó được công bố lỗi thời vào mùa xuân năm 2025, và trong danh sách phiên bản nó không. Nếu địa chỉ của bạn phản hồi bằng nó, kiểm tra sẽ nói rõ — địa chỉ không chấp nhận yêu cầu MCP thông thường.

Trường biểu mẫu

Trường Ý nghĩa Nên điền gì Ví dụ
Tên Tên của kiểm tra. Chỉ rõ máy chủ nào và lý do nó quan trọng với bạn. MCP tìm kiếm cơ sở dữ liệu
Nhóm Cho phép gán tác vụ vào dự án hoặc phần. Chọn nhóm nếu muốn giữ các tác vụ dự án cùng nhau. Dự án chính
Địa chỉ máy chủ Địa chỉ của điểm cuối MCP — cái mà bạn ghi vào cài đặt tác nhân. Nhập địa chỉ đầy đủ, cùng với đường dẫn. Thường là đường dẫn kết thúc trên /mcp, nhưng nó có thể là bất kỳ điều gì. https://example.com/mcp
Phiên bản giao thức Sửa đổi MCP được thiết kế của bạn, hoặc "Tự động" — bất kỳ máy chủ giữ. Để lại "Tự động" nếu quan trọng chỉ để công cụ phản hồi. Chọn cùng phiên bản như khách hàng của bạn công bố nếu bạn muốn tìm hiểu về sự chuyển tiếp của máy chủ sang một phiên bản khác. Tự động
Mã thông báo Mã thông báo Bearer, nếu máy chủ được đóng bằng ủy quyền. Để trống nếu máy chủ mở. Khi sửa đổi tác vụ, trường trống có nghĩa là "giữ mã thông báo cũ"; khi chuyển sang máy chủ khác, mã thông báo cũ không được chuyển — chúng tôi sẽ không gửi nó tới người nhận mới. Mã thông báo từ cài đặt máy chủ
Để kiểm tra Cấp độ kiểm tra từ những cái được mô tả ở trên. Lấy cái thứ hai: nó không thực thi bất cứ điều gì trên máy chủ, như cái thứ nhất, và trả lời câu hỏi ở đó để kiểm tra được tạo. Thứ ba — chỉ cho công cụ đọc. Công cụ ở máy chủ
Công cụ Tên của công cụ để theo dõi. Được yêu cầu từ cấp độ thứ hai. Chỉ định nó chính xác như máy chủ đưa ra nó trong danh sách công cụ: kiểm tra nghiêm ngặt. Đây là tên với công cụ được gọi, không phải mô tả của nó. search_documents
Đối số Cái để gọi công cụ với. Được yêu cầu chỉ ở cấp độ thứ ba. Đối tượng JSON theo cách công cụ mong đợi các đối số. Chọn yêu cầu vô hại, công cụ sẽ chắc chắn trả lời. Trường trống — gọi mà không có đối số. {"query": "test"}
Thời gian chờ Bao nhiêu dành cho kiểm tra trong tổng thể, ở bất kỳ cấp độ nào. Kiểm tra lâu hơn thời gian được chỉ định được coi là từ chối: máy chủ, người phản hồi, nhưng chậm cũng bị hỏng. Hướng dẫn ở máy chủ thường phản hồi của bạn, với lề. 30 giây
Khoảng thời gian Bao thường để chạy kiểm tra. Trên hai cấp độ đầu tiên — như bạn muốn, tần suất hợp lý — năm phút. Trên cái thứ ba — từ 15 phút: mỗi kiểm tra gọi công cụ. 5 phút
Kênh thông báo Nơi gửi tin nhắn về vấn đề và khôi phục. Đánh dấu các kênh bạn thực sự đọc thông báo. Telegram và email
Báo cáo Tóm tắt định kỳ theo tác vụ. Bật nếu muốn nhận tổng quan mà không cần vào bảng điều khiển thủ công. Báo cáo hàng tuần

Khi nào báo động

Cảnh báo sẽ đến nếu kiểm tra đã chọn không vượt qua:

  • máy chủ không khả dụng, trả lời lỗi hoặc từ chối mã thông báo;
  • máy chủ không hỗ trợ phiên bản giao thức được chọn — lý do sẽ liệt kê những cái nó hỗ trợ;
  • địa chỉ trả lời không phải máy chủ MCP hoặc máy chủ trên giao vận cũ;
  • công cụ được chỉ định không trong danh sách — ở cấp độ thứ hai và thứ ba;
  • công cụ thực hiện với lỗi hoặc thay vì kết quả yêu cầu đầu vào — ở cấp độ thứ ba;
  • kiểm tra toàn bộ mất thời gian chờ — ở bất kỳ cấp độ nào.

Khi nào bỏ qua kiểm tra

Nếu máy chủ yêu cầu gọi ít thường xuyên hơn, tác vụ không gặp sự cố và không đi lên — kiểm tra bị bỏ qua, và trạng thái vẫn giữ nguyên. Đây là trường hợp duy nhất như vậy: giới hạn tần suất nói về sự được kiềm chế của chính chúng tôi, không máy chủ của bạn. Mọi thứ khác — mạng yên tĩnh, lỗi máy chủ, mã thông báo bị từ chối — đối với tác vụ này và có nghĩa là công cụ hiện không thể sử dụng.

Một tác vụ — một công cụ

Theo dõi ba công cụ của một máy chủ — đây là ba tác vụ. Vì vậy mỗi công cụ uptime riêng của nó và lịch sử của nó: trộn nhiều câu hỏi trong một tác vụ, bạn sẽ nhận được uptime, về những gì không rõ ràng, ai của nó. Nếu công cụ quan trọng như nhau, hãy thu thập tác vụ vào nhóm.

Thiết lập thông báo

Cho mỗi kênh thông báo trong tác vụ, bạn có thể đặt các thông số bổ sung. Chúng chỉ áp dụng cho sự kiện DOWN.

Tham số Làm gì
Bật Cho phép hoặc cấm gửi thông báo qua kênh này cho tác vụ này.
Hoãn lại đến PRO Hoãn lại thông báo DOWN đầu tiên trong thời gian chọn (tối đa 12 giờ). Tiện lợi để tránh thông báo về sự cố ngắn hạn.
Lặp lại sau PRO Lặp lại thông báo định kỳ, trong khi tác vụ vẫn ở trạng thái DOWN (tối đa 1 giờ giữa các lần lặp). Phù hợp khi quan trọng không bỏ lỡ sự cố kéo dài.
Các tham số "Hoãn lại" và "Lặp lại" không ảnh hưởng đến sự kiện UP và thông báo khôi phục.
Về danh sách các loại tác vụ