Claude Code và Cloud MCP
Phân biệt cấu hình ứng dụng khách, cấp quyền Cloud và thao tác đọc tệp đã lưu thành công.
Cloud MCP sử dụng điểm cuối HTTP từ xa https://mcp.altifigence.com/cloud-mcp. Máy chủ đã cấu hình, tài khoản đã cấp quyền và thao tác đọc công cụ thành công là các bước kiểm tra riêng biệt. Tính khả dụng phụ thuộc vào ứng dụng khách và chính sách công cụ của tổ chức Cloud của bạn.
Kiểm tra ứng dụng khách và điểm cuối
Khi Claude Code CLI đã cài đặt hỗ trợ máy chủ MCP HTTP từ xa, lệnh cấu hình của nó có dạng như sau. Hãy kiểm tra phần trợ giúp của CLI đã cài đặt và phạm vi cấu hình dự kiến trước khi sử dụng.
claude mcp add --transport http altifigence https://mcp.altifigence.com/cloud-mcpKhi máy chủ đã cấu hình xuất hiện trong giao diện /mcp của Claude Code, ứng dụng khách có thể cung cấp bước cấp quyền tài khoản. Tài khoản, tổ chức và các phạm vi (scopes) được yêu cầu thuộc về quy trình cấp quyền đó. Trang thiết lập DDS không chứng minh rằng ứng dụng khách này đã hoàn tất cấp quyền. Bản thân lệnh gọi lại (callback) không xác lập quyền truy cập công cụ Cloud thành công.
Kiểm tra tính khả dụng của kết nối trong DDS
Dùng QUOTA để mở thiết lập DDS rồi chọn Developer access.
Đọc dự án được chọn trong Overview cùng yêu cầu về đăng nhập tài khoản, sự đồng ý của tổ chức và quyền hạn.
Chọn Open setup để mở Developer tools. Đọc thông tin thiết lập được cung cấp và liên kết Documentation.
Mở rộng Details. Đọc MCP endpoint, Transport, Authentication và các nhãn quyền hạn. Phương thức truyền tải hiển thị là Streamable HTTP.
Bảng Details là tài liệu tham chiếu về tên công cụ và danh mục quyền hạn. Các công cụ thực tế được khám phá của kết nối và quyền được cấp hiện tại mới quyết định quyền truy cập; riêng bảng tham chiếu không kích hoạt công cụ.
Context, search & connections là một trang thiết lập riêng cho ngữ cảnh, Web search và các kết nối AI. Những điều khiển này không phải là màn hình đồng ý cấp quyền của Cloud MCP. Developer tools có thể hiển thị thông tin thiết lập mà không mở phiên cấp quyền bên ngoài trên máy chủ này.
Khi kết nối hiển thị các công cụ đọc
Một tài khoản Cloud đã kết nối có thể hiển thị định danh, các dự án có thể truy cập và thao tác đọc tệp đã lưu dưới quyền cloud.read. Việc đọc thành công một tệp nhỏ không nhạy cảm từ dự án do kết nối đó trả về xác nhận nhiều hơn là chỉ cấu hình máy chủ. Định danh dự án/tệp, phân trang, hoàn tất các phần dữ liệu (chunk) và phiên bản xác định nội dung đã được đọc. Một công cụ bị từ chối sẽ vẫn không khả dụng nếu thiếu chính sách hiện tại của tổ chức và sự đồng ý bắt buộc.
Giữ tách biệt với DX dành cho nhân viên
Điểm cuối DX dành cho nhân viên kết thúc bằng /dx-mcp. Plugin tổ chức và quy trình đăng nhập thiết bị dành cho nhân viên của điểm cuối này không cấu hình quyền truy cập Cloud của khách hàng. Không được dùng quy trình mã thiết bị DX để thay thế cho bước cấp quyền Cloud, và không được trộn lẫn các phạm vi quyền nhân viên với các phạm vi cloud.*.
Nếu kết nối thất bại
Nếu ứng dụng khách từ chối một tùy chọn lệnh, hãy xem phần trợ giúp của phiên bản đã cài đặt. Lệnh gọi lại bị từ chối, thiếu công cụ hoặc thao tác đọc bị từ chối có nguyên nhân khác với việc không gian làm việc DDS không khả dụng. Hãy giữ lại thông báo lỗi đã lược bỏ thông tin nhạy cảm và dùng hướng dẫn khắc phục sự cố MCP. Không đưa các token, cookie trình duyệt và mã cấp quyền vào cấu hình dự án dùng chung.
Hướng dẫn liên quan
Hướng dẫn kết nối · Authentication · Tham chiếu công cụ · Khắc phục sự cố