Thiên Kiến Đường Hạnh Phúc
Đọc hầu hết các README của MCP server và bạn sẽ biết chính xác cách thiết lập server và những gì nó có thể làm trong điều kiện lý tưởng. "Truy vấn bất kỳ cơ sở dữ liệu SQL nào." "Đọc và ghi tệp." "Tìm kiếm web." Những mô tả khả năng này chính xác nhưng không đầy đủ. Chúng không cho bạn biết điều gì xảy ra khi mọi thứ đi chệch hướng.
Điều gì xảy ra khi bạn truy vấn một bảng có 10 triệu hàng? Điều gì xảy ra khi kết nối cơ sở dữ liệu bị ngắt giữa truy vấn? Kích thước tệp nào quá lớn để xử lý? Phương ngữ SQL nào thực sự được hỗ trợ? Câu trả lời cho những câu hỏi này thường được khám phá thông qua thử và sai đau đớn.
Tài Liệu Thất Bại Nên Bao Gồm Những Gì
Các giới hạn đã biết: "Kích thước tập kết quả tối đa là 10.000 hàng. Các truy vấn lớn hơn sẽ bị cắt ngắn." "Tệp nhị phân không được hỗ trợ và sẽ trả về lỗi." Những điều này đặt kỳ vọng để người dùng không lãng phí thời gian khám phá giới hạn thông qua thất bại.
Các tình huống lỗi phổ biến: "Nếu bạn thấy 'connection timeout,' server cơ sở dữ liệu có thể không truy cập được. Hãy kiểm tra xem host và port trong cấu hình của bạn có đúng không." Điều này tiết kiệm thời gian gỡ lỗi bằng cách cung cấp lời giải thích có khả năng nhất cho các lỗi phổ biến.
Các trường hợp biên: "Truy vấn với cột BLOB sẽ thất bại vì dữ liệu nhị phân không thể được tuần tự hóa thành JSON." "Đường dẫn tệp với ký tự Unicode có thể không hoạt động trên Windows." Những điều này ngăn chặn các bất ngờ cụ thể gây thất vọng nhất.
Hiệu Ứng Niềm Tin
Một cách nghịch lý, việc ghi lại các thất bại xây dựng niềm tin. Khi một README trung thực nói "server này hoạt động tốt cho các truy vấn dưới 10.000 hàng nhưng gặp khó khăn với các tập kết quả lớn hơn," bạn tin tưởng tác giả hơn so với một README tuyên bố khả năng không giới hạn. Bạn cũng đưa ra quyết định áp dụng có thông tin tốt hơn.
Tài liệu thất bại tốt là một khoản đầu tư trải nghiệm lập trình viên. Người dùng hiểu giới hạn của công cụ sử dụng nó trong giới hạn đó và có trải nghiệm tốt. Người dùng khám phá giới hạn thông qua thất bại có trải nghiệm tệ và có thể chuyển sang lựa chọn thay thế.
Đọc Thêm
- Tại Sao Việc Khám Phá MCP Server Khó Hơn Vẻ Bề Ngoài
- Cách Thông Báo Lỗi Từ MCP Servers Ảnh Hưởng Đến Hành Vi Của Agent
- Tại Sao Trải Nghiệm Lập Trình Viên Quan Trọng Đối Với Việc Áp Dụng Công Cụ AI
Duyệt MCP servers trên Skillful.sh. Tìm kiếm hơn 137.000 công cụ AI.