Chuyển đến nội dung chính
Model Context Protocol (MCP) cho phép CloudThinker kết nối với các công cụ và dịch vụ tùy chỉnh. Sử dụng MCP để mở rộng khả năng của agent với các kết nối của riêng bạn.

​
MCP là gì?

MCP (Model Context Protocol) là giao thức mở để kết nối các AI agent với các công cụ và nguồn dữ liệu bên ngoài. Nó cung cấp cách thức chuẩn hóa để:
  • Cung cấp các công cụ mà agent có thể gọi
  • Cung cấp ngữ cảnh và dữ liệu cho agent
  • Cho phép tích hợp tùy chỉnh với bất kỳ dịch vụ nào

​
Thiết lập

1

Chuẩn bị MCP server

Đảm bảo MCP server của bạn đang chạy và có thể truy cập:
  • Hỗ trợ transport Server-Sent Events (SSE)
  • Có endpoint có thể truy cập công khai (hoặc qua VPN)
  • Trả về phản hồi MCP protocol đúng chuẩn
2

Tạo kết nối

Điều hướng đến Connections → MCP và nhấp Add MCP Connection.
3

Cấu hình thông tin cơ bản

Nhập chi tiết kết nối:
  • Name: tên mô tả cho kết nối
  • Prefix: tiền tố công cụ (ví dụ: mytools → mytools_function_name)
4

Cấu hình transport

Thiết lập transport của kết nối:
  • Transport Type: Server-Sent Events
  • URL: endpoint của MCP server
  • Timeout: thời gian chờ kết nối (mặc định: 5 giây)
  • SSE Read Timeout: thời gian chờ luồng sự kiện (mặc định: 30 giây)
5

Thêm biến môi trường

Cấu hình các biến môi trường cần thiết:
  • API key
  • Token xác thực
  • Cấu hình tùy chỉnh
6

Kiểm tra & tạo

Kiểm tra kết nối và lưu. CloudThinker hiển thị trạng thái Connected khi máy chủ phản hồi đúng.

​
Chi tiết kết nối

TrườngMô tảBắt buộc
NameTên hiển thị của kết nốiCó
PrefixTiền tố tên công cụCó
URLEndpoint của MCP serverCó
TimeoutThời gian chờ kết nối (giây)Không (mặc định: 5)
SSE Read TimeoutThời gian chờ luồng sự kiện (giây)Không (mặc định: 30)
Environment VariablesCác cặp key-value cho cấu hìnhKhông

​
MCP server mẫu

Một MCP server đơn giản cung cấp công cụ tra cứu thời tiết: 
from mcp import Server, Tool

server = Server("weather-tools")

@server.tool()
async def get_weather(location: str) -> str:
    """Get current weather for a location."""
    # Your implementation here
    return f"Weather for {location}: Sunny, 72°F"

if __name__ == "__main__":
    server.run()
Sau khi kết nối với tiền tố weather, các agent có thể gọi: 
weather_get_weather(location="San Francisco")

​
Các trường hợp sử dụng

​
Nguồn dữ liệu tùy chỉnh

Kết nối với cơ sở dữ liệu hoặc API độc quyền:
  • Hệ thống số liệu nội bộ
  • Công cụ giám sát tùy chỉnh
  • Nền tảng business intelligence

​
Công cụ chuyên biệt

Thêm các khả năng theo lĩnh vực:
  • Kiểm tra tuân thủ tùy chỉnh
  • Script tự động hóa nội bộ
  • Tích hợp hệ thống cũ

​
Dịch vụ bên ngoài

Tích hợp dịch vụ của bên thứ ba:
  • Nền tảng giao tiếp
  • Hệ thống ticket
  • Dịch vụ đám mây chưa được tích hợp sẵn

​
Thực hành tốt nhất

  • Endpoint HTTPS — chỉ cung cấp MCP server qua HTTPS.
  • Xoay vòng API key — xoay vòng thông tin xác thực được lưu trong biến môi trường theo lịch thông thường của bạn.
  • Triển khai xác thực — xác minh các yêu cầu đến từ CloudThinker trước khi xử lý.
  • Đặt timeout phù hợp — tinh chỉnh Timeout và SSE Read Timeout để phù hợp với đặc tính phản hồi của máy chủ.
  • Giám sát sức khỏe máy chủ — theo dõi tỷ lệ lỗi và độ trễ để phát hiện sớm khi kết nối bị gián đoạn.
  • Xử lý lỗi đúng cách — trả về phản hồi lỗi MCP có cấu trúc thay vì để máy chủ bị crash.

​
Xử lý sự cố

Xác minh MCP server đang chạy, kiểm tra kết nối mạng, tăng giá trị timeout và xác nhận tường lửa cho phép lưu lượng truy cập.
Xác minh tiền tố được đặt đúng, kiểm tra MCP server trả về định nghĩa công cụ, đảm bảo phiên bản protocol tương thích và xem log máy chủ để tìm lỗi.
Xác minh biến môi trường được đặt đúng, kiểm tra API key còn hợp lệ và đảm bảo máy chủ xác thực thông tin xác thực đúng cách.
Tăng SSE read timeout, kiểm tra proxy có gây cản trở không, xác minh máy chủ gửi sự kiện keepalive và xem xét sự ổn định của mạng.

​
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.
  • Endpoint HTTPS — chỉ cung cấp MCP server qua HTTPS và xác minh nguồn gốc yêu cầu từ CloudThinker.
  • Thông tin xác thực có phạm vi — lưu API key và token trong biến môi trường thay vì hardcode chúng trong code máy chủ.

​
Liên quan

Tổng quan

Tất cả các loại kết nối

Agents

Cách agent sử dụng kết nối