Client MCP chung¶
Trang này mô tả kịch bản “Client MCP chung” và giữ cấu trúc Runtime/Client chung của trang tài liệu.
Tổng quan¶
Runtime xác định tiến trình server chạy như thế nào và điều khiển workspace nào. Client xác định ChatGPT hoặc client MCP khác kết nối như thế nào. Docker, tiện ích VS Code, tệp nhị phân độc lập, cài đặt Python/pipx/mã nguồn và stdio là lựa chọn Runtime; trình kết nối ChatGPT, client MCP HTTP chung và client MCP stdio là kết nối Client.
Khi nào dùng¶
- Dùng trang này khi đường dẫn Runtime hoặc Client đã chọn khớp với tiêu đề.
- Giữ nhất quán workspace root, public base URL, MCP endpoint, chế độ xác thực và các công cụ host khả dụng.
- Với ChatGPT web/app, hãy công bố MCP endpoint HTTPS kết thúc bằng
/mcp. - Với client MCP cục bộ, dùng HTTP localhost hoặc
local-shell-mcp --mode stdiotùy khả năng hỗ trợ của client.
Các bước¶
- Trước tiên chọn trang cài đặt Runtime.
- Khởi động Runtime và kiểm tra
/healthzkhi dùng chế độ HTTP. - Sau đó chọn trang kết nối Client.
- Đăng ký MCP endpoint hoặc lệnh stdio trong Client.
- Gọi
environment_infođể kiểm tra workspace và cấu hình thực tế.
Runtime: Docker / VS Code extension / binary / Python / stdio
Client: ChatGPT connector / generic HTTP MCP / generic stdio MCP
Endpoint: https://your-host.example.com/mcp
Xác minh¶
environment_infoxác nhận cấu hình Runtime và workspace.tree_viewxác nhận các tệp nhìn thấy được.run_shell_toolxác nhận môi trường lệnh.
Ghi chú¶
Ưu tiên các bước nhỏ và có thể xác minh: kiểm tra, chỉnh sửa, diff, test, scan và commit. Tác vụ lớn cũng nên được chia thành các lời gọi công cụ có thể audit.