Điều kiện tiên quyết
- Một MCP server hỗ trợ Streamable HTTP hoặc Server-Sent Events (SSE), truy cập được từ internet. Để giới hạn ai có thể truy cập server, hãy đưa các egress IP của CloudThinker vào allowlist. Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối liên hệ CloudThinker của bạn, hoặc liên hệ với chúng tôi.
- URL endpoint của server, ví dụ
https://mcp.example.com/mcp. - Thông tin xác thực cho server, nếu server yêu cầu. Chỉ cấp riêng cho CloudThinker (xem Quyền yêu cầu).
- Quyền chỉnh sửa kết nối trong workspace của bạn.
Authorization chứa token mà server kiểm tra. Form MCP không có đăng nhập OAuth, nên không thể kết nối server chỉ chấp nhận OAuth.Thiết lập
Mở form MCP
Điền Basic Information
- Connection Name: tên mà nhóm bạn dễ nhận ra, ví dụ
Internal metrics. - Description: không bắt buộc, tối đa 500 ký tự.
- Prefix: tên ngắn cho server này, ví dụ
metrics. Công cụ hiển thị dưới dạngmetrics__tool_name, và bạn sẽ thấy prefix này trong các yêu cầu phê duyệt và Rules. - Transport Type: Streamable HTTP hoặc Server-Sent Events, tùy server của bạn dùng giao thức nào.
Thêm header
Authorization và Bearer <your-token>. CloudThinker gửi các header này trong mọi request. Key của header không được trùng nhau.Điền Connection Configuration
- URL: endpoint của server, ví dụ
https://mcp.example.com/mcp. Xem Quy tắc URL của server. - Timeout (seconds): thời gian chờ server phản hồi. Mặc định 30, cho phép từ 0.1 đến 300. Giữ 30, trừ khi công cụ của bạn chạy truy vấn lâu thì hãy tăng lên.
- SSE Read Timeout (seconds): thời gian chờ trên luồng sự kiện. Mặc định 300, cho phép từ 1 đến 600.
Tạo kết nối
Chi tiết kết nối
Quy tắc URL của server
Thêm HTTPS bằng reverse proxy
Nếu server chỉ hỗ trợ HTTP, hãy đặt một reverse proxy phía trước. Với Caddy:Trỏ DNS về server
A, ví dụ mcp.example.com, trỏ về IP công khai của server.Cấu hình Caddy
Caddyfile, thay port bằng port mà MCP server của bạn đang lắng nghe:Khởi động Caddy
https://mcp.example.com mở được trên trình duyệt với chứng chỉ hợp lệ. Nhập https://mcp.example.com/mcp vào URL.Quyền yêu cầu
Server của bạn quyết định kết nối được làm gì. CloudThinker chỉ giữ các giá trị header bạn cung cấp.Khả năng của agent
Sau khi kết nối, CloudThinker tải danh sách công cụ của server. Mỗi công cụ có sẵn cho agent dưới dạngprefix__tool_name, với prefix là giá trị bạn đặt trên kết nối. Server có prefix weather cung cấp get_forecast sẽ cho agent một công cụ tên weather__get_forecast.
Agent chỉ gọi được công cụ mà server của bạn cung cấp. Kết nối MCP không có công tắc Allow writes, nên hãy chọn Manual để mọi lần gọi công cụ ghi đều cần một người phê duyệt. Gỡ công cụ khỏi server là cách kiểm soát còn lại luôn có hiệu lực, và cũng là cách duy nhất để chặn một thao tác đọc: thao tác đọc luôn chạy mà không hỏi.
Khi CloudThinker bật Rule enforcement cho workspace của bạn, một Rule Deny có thể từ chối hẳn một công cụ ghi trong khi các công cụ ghi khác vẫn hỏi phê duyệt.
Cách phân loại đọc và ghi
CloudThinker xếp mỗi công cụ vào nhóm đọc hoặc ghi khi tải danh sách công cụ:_ và -, nên list_tickets và get-status là công cụ đọc, còn listTickets (một từ) và close_ticket là công cụ ghi. Thao tác đọc chạy mà không hỏi. Thao tác ghi đi qua Rules và Approval mode của bạn.
CloudThinker tải lại danh sách công cụ và phân loại lại mọi công cụ khi bạn nhấn Edit và lưu thay đổi ở URL, header hoặc transport. Chỉ đổi tên hoặc mô tả thì danh sách không được tải lại.
Xác minh kết nối
Mở một cuộc chat, gõ# để chọn kết nối, rồi hỏi:
prefix__tool_name và trả về kết quả từ một công cụ đọc, không có yêu cầu phê duyệt nào.
Ví dụ prompt
Thay#Internal metrics bằng tên kết nối của bạn.
Khắc phục sự cố
This connection did not respond in time. Try connecting again.
This connection did not respond in time. Try connecting again.
This server does not use HTTPS on this port.
This server does not use HTTPS on this port.
https://, nhưng server dùng HTTP thường trên port đó. Đổi URL thành http://, hoặc thêm HTTPS.This server's TLS certificate is not trusted: it is self-signed, expired, or issued for another name.
This server's TLS certificate is not trusted: it is self-signed, expired, or issued for another name.
This server refused the connection.
This server refused the connection.
URL points to a private or metadata IP address / URL resolves to a private or metadata IP address
URL points to a private or metadata IP address / URL resolves to a private or metadata IP address
localhost. Hãy dùng host name hoặc địa chỉ IP công khai.Could not resolve hostname
Could not resolve hostname
The provider rejected these credentials. Update them, then connect again.
The provider rejected these credentials. Update them, then connect again.
Bearer hay một header tùy chỉnh).The provider endpoint was not found. Check the connection settings.
The provider endpoint was not found. Check the connection settings.
/mcp hoặc /sse. Xem tài liệu của server để biết path chính xác.Connected, but tools are missing
Connected, but tools are missing
SSE connection drops
SSE connection drops
Bảo mật
- Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
- Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
- Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
- Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
- Dùng HTTPS. Qua
http://, header (kể cả token) và kết quả công cụ đều được truyền dưới dạng văn bản thường. - Đánh dấu hint cho công cụ. Đặt
readOnlyHintvàdestructiveHintđể CloudThinker xử lý từng công cụ đúng như bạn muốn. - Xoay vòng thông tin xác thực trong header. Thay token trên server, sau đó chỉnh sửa kết nối và cập nhật giá trị header.