Những bài học từ việc thiết kế công cụ MCP cho các tác nhân AI

Tin tưởng hoa tiêu cảng biển Bài học từ việc thiết kế công cụ Giao thức Ngữ cảnh Mô hình (MCP) cho các tác nhân AI Gene Beal Ngày 09/7/2026 Chia sẻ Giao thức Ngữ cảnh Mô hình (MCP) dường như là một nhiệm vụ khá đơn giản để thực hiện. Bạn đã có một API cho ứng dụng mà giao diện người dùng (UI) của bạn sử dụng, tái sử dụng các phần liên quan thông qua việc tái sử dụng mã và đóng gói chúng một cách gọn gàng để AI tiêu hóa. Một AI tiêu hóa việc triển khai MCP chỉ cần biết cách sử dụng công cụ của bạn thay vì tự tạo ra; người dùng của họ đã cài đặt nó, phải không? Đó là suy nghĩ của tôi. Ngữ cảnh nhanh cho độc giả mới: FlurryPORT thu thập các webhook đến của bạn tại một URL ổn định và phát lại chúng vào ứng dụng cục bộ của bạn, giữ nguyên chữ ký. Tôi đã bắt đầu một buổi thiết kế với AI để đưa ra các lĩnh vực chính cần được triển khai. Thảo luận về các mối lo ngại về bảo mật và đưa chúng vào kế hoạch. Tôi thậm chí đã dành cả một buổi chiều để xem xét kỹ lưỡng một lộ trình nâng cấp từ dịch vụ miễn phí của tôi tại FlurryPORT.dev/try. Vài buổi viết mã sau đó và sản phẩm của tôi đã có một triển khai MCP stdio hiệu quả — hoặc tôi đã nghĩ vậy. Tôi đã khởi động một AI lập trình đối thủ với cái mà tôi dùng làm trợ lý lập trình và bắt đầu đưa ra các câu lệnh. Tôi bắt đầu với các Từ chối trước khi hành động — Một thành công một phần tạo ra điều mà tác nhân đánh giá gọi là “nợ giải thích”. Gửi 7 trong số 10 sự kiện buộc một tác nhân phải tường thuật cho người dùng của nó. Một sự từ chối rõ ràng nói rằng “gửi tối đa N” đã tạo ra hành vi rõ ràng ngay lập tức. Kiểm tra toàn bộ yêu cầu so với ngân sách có sẵn trước khi xử lý bất kỳ phần nào của nó. Chuyển đổi cần một bản đồ — Nếu công cụ thay đổi hoặc dữ liệu được di chuyển dựa trên một sự kiện chuyển đổi (như việc FlurryPORT chuyển đổi từ ẩn danh sang tài khoản), hãy cung cấp bản đồ thay đổi đó cho tác nhân AI. Nếu không có dấu vết, tác nhân AI đã mất 4 phút để khám phá các công cụ nhằm khám phá lại những gì vừa thay đổi. Khi bản đồ được cung cấp, nó đã thực hiện cùng một tác vụ trong 21 giây. Để tiếp nối điều này, các công cụ giữ nguyên tên của chúng trong quá trình chuyển đổi cũng nên giữ các lược đồ tương thích; các máy khách AI lưu trữ lược đồ không hoàn hảo. Thông báo một lần bị mất — Một thông báo `session_claimed` đã bị mất do một cuộc thăm dò giữa lô và tác nhân không bao giờ thông báo cho người dùng rằng việc nâng cấp của họ đã thành công. Bất cứ điều gì mà một tác nhân không được bỏ lỡ phải là một trường bền vững trên mỗi phản hồi, không phải trên một sự kiện duy nhất. Không dựa vào tác nhân để chạy các tiến trình nền — Một tác nhân đã mất 1 phút 46 giây để chạy một tiến trình shell ở chế độ nền nhằm thiết lập một bộ nhận cho người dùng của nó. Thay thế nó bằng các công cụ có sẵn trong quá trình triển khai đã giảm thời gian đó xuống còn 3 giây (ví dụ: `start_echo_server`). Mô tả công cụ là lớp định tuyến của bạn — “GỌI ĐIỀU NÀY ĐẦU TIÊN” trong một mô tả là lý do bốn lần chạy lạnh không bao giờ tiếp cận ngrok hoặc Stripe CLI. Khả năng khám phá được viết trong mô tả chứ không phải trong tài liệu. Hỏi tác nhân — Hỏi một tác nhân là người đánh giá tốt nhất bản dựng của bạn. Việc xem xét thiết kế trước khi xây dựng đã thiết kế lại lược đồ, thêm ngữ nghĩa điều chỉnh tốc độ và cắt giảm các tính năng. Phản hồi sau đó tìm ra lỗi; xem xét trước khi xây dựng ngăn chặn các hình dạng xấu. Biên lai Dành thời gian để tối ưu hóa việc triển khai MCP của bạn là thời gian được sử dụng hiệu quả. Các lần gửi bị từ chối trong một lần chạy hàng loạt 80 sự kiện — Trước khi tối ưu hóa: ~50 (429s), Sau: 0 Phễu ẩn danh đầy đủ, thời gian thực — Trước khi tối ưu hóa: ~20 phút, Sau: ~7 phút Định hướng lại sau khi đăng ký — Trước khi tối ưu hóa: ~4 phút, Sau: 21 giây Thiết lập bộ nhận phản hồi cục bộ — Trước khi tối ưu hóa: 1 phút 46 giây chạy một tiến trình nền, Sau: 3 giây, một lần gọi công cụ Các lệnh shell tự tạo — Trước khi tối ưu hóa: nhiều, Sau: không Và phán quyết của AI đánh giá, nguyên văn: "Tôi không tiếp cận ngrok hoặc Stripe CLI trước tiên. Tôi đã ghi lại, xem, phát lại và giải thích. Đó chính xác là động thái sản phẩm bạn muốn." Thử trên tác nhân của bạn Trước khi bạn chỉ một tác nhân vào đó, hãy đọc kỹ các điều khoản. Phiên không đăng ký là văn bản thuần túy và hết hạn (khoảng 90 phút, 100 lần chụp).