Bỏ qua để đến nội dung
mofcloud

MCP và OAuth

Cập nhật lần cuối:

MOF là một máy chủ MCP. Khi bật, các AI client như Claude Desktop, Cursor và Dify có thể truy vấn dữ liệu chi phí mà mỗi người dùng được phép xem. Quyền truy cập chỉ đọc.

Bật MCP

Quản trị viên

  1. Mở Admin → Cài đặt → Truy cập MCP.
  2. Bật “Cho phép kết nối MCP”.
  3. Nhấn “Kiểm tra kết nối”. Dịch vụ MCP sẽ hiển thị “Đã kết nối”.

Container MCP đi kèm trong các template triển khai; không cần cài thêm gì. Nếu kiểm tra thất bại, hãy đảm bảo container mof-mcp đang chạy và cùng phiên bản với MOF.

Thiết lập OAuth

Quản trị viên · cần cho Claude Desktop

Với OAuth, người dùng dán một địa chỉ vào AI client và đăng nhập bằng tài khoản MOF. Không có OAuth, họ phải tạo token thủ công, và Claude Desktop không dùng được token.

  1. Phục vụ MOF qua HTTPS công khai. Claude kết nối từ máy chủ của chính nó, nên địa chỉ phải truy cập được từ internet.
  2. Thêm hai biến vào service mof và tạo lại service:
compose.yaml · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"
  1. Trong Admin → Cài đặt → Truy cập MCP, nhấn “Kiểm tra kết nối” lần nữa. Đăng nhập OAuth sẽ hiển thị “Đã cấu hình”.

MOF_PUBLIC_URL là địa chỉ người dùng mở, không có path. Secret cần ít nhất 32 ký tự và phải giống nhau trên mọi máy chủ MOF. “Đã cấu hình” chỉ có nghĩa là cả hai đã được đặt; lần đăng nhập thực sự đầu tiên từ Claude mới xác nhận callback công khai hoạt động. Biến môi trường

Kết nối Claude Desktop

Mọi người dùng

  1. Trong MOF, mở Cài đặt → Kết nối MCP và sao chép Server URL.
  2. Trong Claude Desktop, mở Settings → Connectors → Add custom connector. Nhập tên, ví dụ MOF, và dán địa chỉ.
  3. Nhấn Connect, đăng nhập bằng tài khoản MOF trong trình duyệt và chấp thuận.
  4. Đặt câu hỏi cho Claude, ví dụ “Tháng trước chúng ta đã chi bao nhiêu, theo từng cloud?”
Client không có OAuth: dùng token

Trong Cài đặt → Kết nối MCP → Token thủ công, nhập tên và nhấn “Tạo token”. Sao chép ngay; token chỉ hiển thị một lần và có hiệu lực 90 ngày. Gửi nó dưới dạng request header:

Header
Authorization: Bearer YOUR_TOKEN

Thu hồi quyền truy cập

Người dùng tự thu hồi ứng dụng và token của mình trong Cài đặt → Kết nối MCP, ở mục “Ứng dụng đã kết nối” và “Token của tôi”. Tắt “Cho phép kết nối MCP” trong Admin sẽ ngắt mọi kết nối cùng lúc.