Tổng quan#
MCP (Model Context Protocol) là một giao thức mở để thiết lập giao tiếp được tiêu chuẩn hóa giữa các ứng dụng mô hình ngôn ngữ lớn (LLM) và các nguồn dữ liệu cũng như công cụ bên ngoài. Apidog có MCP Client tích hợp, hỗ trợ gỡ lỗi và kiểm thử MCP Servers.MCP Servers cung cấp ba tính năng chính, tất cả đều được Apidog MCP Client hỗ trợ gỡ lỗi:Tools: Các hàm phía máy chủ có thể thực thi
Prompts: Các mẫu prompt được định nghĩa sẵn
Resources: Tài nguyên dữ liệu do máy chủ cung cấp
STDIO: Giao tiếp qua đầu vào/đầu ra tiêu chuẩn, phù hợp với các tiến trình cục bộ
HTTP: Giao tiếp qua Streamable HTTP, phù hợp với máy chủ từ xa
Vui lòng sử dụng phiên bản web hoặc tải xuống phiên bản mới nhất của ứng dụng desktop từ trang chủ.
Tạo MCP Client#
Tạo một endpoint mới trong dự án HTTP và chọn MCP.
Kết nối với MCP Server#
Nhập địa chỉ máy chủ#
Apidog hỗ trợ nhiều cách để nhập thông tin kết nối MCP Server:Nhập trực tiếp lệnh hoặc URLKhi dán một lệnh terminal, giao thức sẽ tự động chuyển sang STDIO:Khi dán một URL, giao thức sẽ tự động chuyển sang HTTP:https://example-server.modelcontextprotocol.io/mcp
{
"mcpServers": {
"Everything Server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-everything"],
"env": {}
}
}
}
{
"type": "streamable-http",
"url": "https://example-server.modelcontextprotocol.io/mcp"
}
Thiết lập kết nối#
Nhấp vào nút Connect để khởi tạo kết nối.Vì cần thực thi lệnh cục bộ, Apidog sẽ hiển thị hộp thoại xác nhận bảo mật. Sau khi xác nhận, Apidog sẽ khởi động tiến trình cục bộ và thiết lập kết nối.Gửi yêu cầu kết nối trực tiếp đến URL đã chỉ định.Đối với MCP Servers có xác thực OAuth 2.0, Apidog sẽ tự động truy xuất cấu hình xác thực và hiển thị cửa sổ xác thực
Các phương thức xác thực khác (API Key, Bearer Token, Basic Auth, v.v.) cũng có thể được cấu hình thủ công trong tab Auth
Tính năng gỡ lỗi#
Tools là các hàm có thể thực thi do máy chủ cung cấp. Sau khi chọn một Tool, bạn có thể cấu hình tham số qua biểu mẫu hoặc trình chỉnh sửa JSON.Sau khi cấu hình tham số, nhấp Run để thực thi. Kết quả sẽ được hiển thị trong khu vực phản hồi.Prompts#
Prompts là các mẫu prompt được định nghĩa sẵn. Sau khi chọn một Prompt, hãy cấu hình tham số (nếu có) và nhấp Run để nhận prompt được tạo.Resources#
Resources là các tài nguyên dữ liệu do máy chủ cung cấp. Sau khi chọn một Resource, nhấp Run để truy xuất nội dung tài nguyên.
Tùy chọn cấu hình#
Môi trường#
Chỉ khả dụng ở chế độ STDIO. Được sử dụng để cấu hình các biến môi trường khi khởi động tiến trình MCP Server.| Khóa | Giá trị |
|---|
| ACCESS_TOKEN | your-token-here |
| NODE_ENV | production |
Auth#
Chỉ khả dụng ở chế độ HTTP. Hỗ trợ nhiều phương thức xác thực:Đối với MCP Servers hỗ trợ OAuth 2.0, Apidog có thể tự động truy xuất và điền cấu hình xác thực.Chỉ khả dụng ở chế độ HTTP. Được sử dụng để cấu hình các header yêu cầu HTTP tùy chỉnh.
Xem phản hồi#
Sau khi nhấp Run, kết quả thực thi công cụ sẽ được hiển thị trong bảng Response. Apidog phân loại tương tác thành hai loại: Messages và Notifications.Messages#
Một Message đại diện cho một tương tác yêu cầu-phản hồi tiêu chuẩn (ví dụ: thực thi một công cụ và nhận kết quả).Đối với mỗi message, Apidog cung cấp ba chế độ xem để giúp bạn trực quan hóa dữ liệu. Bạn có thể chuyển đổi giữa chúng bằng các tab ở phía trên khu vực phản hồi:Content: Chế độ xem mặc định. Hiển thị đầu ra văn bản gọn gàng. Apidog phân tích cú pháp message JSON-RPC và chỉ trích xuất nội dung cốt lõi do công cụ trả về (ví dụ: trường text), loại bỏ các chi tiết giao thức để dễ đọc hơn.
Preview: Kết xuất nội dung phong phú do công cụ trả về. Nếu phản hồi chứa Markdown, hình ảnh hoặc các tài nguyên đa phương tiện khác, tab này sẽ tự động kết xuất chúng thành định dạng trực quan (ví dụ: văn bản đã định dạng, biểu đồ hoặc hình ảnh Base64 đã giải mã). Điều này loại bỏ nhu cầu giải mã thủ công hoặc phân tích cú pháp văn bản thô.
Raw: Hiển thị toàn bộ message tương tác JSON-RPC, bao gồm tất cả chi tiết giao thức (chẳng hạn như cấu trúc jsonrpc, id và result). Sử dụng chế độ này khi gỡ lỗi MCP servers để xác minh tính tuân thủ giao thức.
Notifications#
Một Notification đại diện cho message một chiều từ MCP server (ví dụ: ghi log, cập nhật tiến độ hoặc thay đổi tài nguyên) không yêu cầu phản hồi.Notifications được liệt kê riêng trong dòng thời gian phản hồi.
Chúng thường hiển thị các mức log (ví dụ: info, debug, error) và văn bản message đi kèm.
Hỗ trợ biến#
Các biến {{variable_name}} được hỗ trợ tại các vị trí sau:Địa chỉ hoặc lệnh máy chủ
Lưu và chia sẻ#
Các MCP client đã cấu hình có thể được lưu vào dự án để sử dụng sau này và cộng tác nhóm.Lưu ý: Cây thư mục MCP (danh sách Tools, Prompts, Resources) chỉ được lưu trữ cục bộ và tự động làm mới trong mỗi lần kết nối.
FAQ#
Kết nối STDIO thất bại với lỗi "command not found"#
Đảm bảo runtime cần thiết (chẳng hạn như Node.js) đã được cài đặt và kiểm tra đường dẫn lệnh là chính xác.Kết nối HTTP trả về lỗi 401#
Apidog sẽ tự động cố gắng truy xuất cấu hình OAuth 2.0. Nếu không thành công, hãy cấu hình thủ công thông tin xác thực trong tab Auth.Kết nối thành công nhưng cây thư mục trống#
Kiểm tra cấu hình máy chủ là chính xác và xem tab Notifications để xác nhận liệu máy chủ đã trả về danh sách công cụ hay chưa.Loại tham số không khớp#
Khi sử dụng chế độ biểu mẫu, Apidog sẽ tự động xác thực loại tham số. Trong chế độ trình chỉnh sửa JSON, hãy cẩn thận không thêm dấu ngoặc kép quanh số và sử dụng true/false cho các giá trị boolean.