Kết nối Claude Desktop tới Dureach qua MCP nghĩa là đăng ký OAuth client, hoàn tất đồng ý workspace, thêm máy chủ HTTP dạng stream, và chạy tìm kiếm giới hạn đầu tiên. Dự kiến khoảng 20 phút cộng thời gian phê duyệt cho scope ghi.
Nên chuẩn bị gì trước khi mở Claude Desktop?
Chọn workspace, xác nhận năng lực nền tảng agent, và xác định công việc: quyền truy cập chỉ nghiên cứu cần workspace:read, companies:read và trade:read; tra cứu liên hệ thêm contacts:read. Không đưa leads:create, campaigns:create và các scope gửi vào lượt cấp quyền đầu tiên. Chỉ định một chủ sở hữu để xem xét dữ liệu ứng viên trước khi dữ liệu làm thay đổi hồ sơ có thẩm quyền.
Cách đăng ký và đồng ý client?
- Đăng ký OAuth client cho workspace với các scope đã chọn.
- Bắt đầu lượt cấp quyền ủy quyền và hoàn tất đồng ý trong trình duyệt với tư cách thành viên workspace.
- Lưu thông tin xác thực trong kho được bảo vệ của ứng dụng hoặc trình quản lý bí mật phía máy chủ. Không dán mã thông báo vào hội thoại, tài liệu chung, ảnh chụp hoặc phiếu hỗ trợ.
- Xác nhận audience của token là tài nguyên
/mcpvà ID workspace khớp với workspace dự kiến.
Bảng trường đầy đủ có trong Kết nối client AI qua MCP.
Cách thêm máy chủ trong Claude Desktop?
- Thêm máy chủ MCP HTTP dạng stream với URL
https://app.dureach.com/mcp. - Chọn xác thực OAuth và nhập các giá trị đăng ký client; dùng URL metadata tài nguyên MCP khi connector yêu cầu phát hiện tự động.
- Hoàn tất đồng ý và xác nhận danh sách công cụ gồm
dureach.workspace.context,dureach.workspace.capabilitiesvà các công cụ đọc được cấp. - Gọi
dureach.workspace.contexttrước và kiểm tra ID workspace, vai trò và scope trả về.
Cách chạy tìm kiếm giới hạn đầu tiên?
Dùng tools/list để xem các công cụ khả dụng cho kết nối. Phạm vi sử dụng phụ thuộc vào quyền đã cấp và quyền truy cập của không gian làm việc. Bắt đầu với quyền đọc; nhờ quản trị viên xem xét quyền còn thiếu thay vì yêu cầu quyền rộng.
Những kiểm tra nào kết thúc thiết lập?
Xem lại quyền đã cấp, thay đổi chính sách và nhật ký hoạt động hiện có trước khi mở rộng truy cập. Chỉ giữ mã yêu cầu đã loại bỏ dữ liệu nhạy cảm và siêu dữ liệu vận hành trong ghi chú chung. Gỡ kết nối khi dự án kết thúc hoặc không còn cần truy cập; thu hồi và thay thế thông tin xác thực có thể đã bị lộ.
Những câu hỏi thường gặp về thiết lập Claude Desktop?
Thiết lập mất bao lâu?
Đăng ký và đồng ý mất vài phút; dành thêm thời gian khi scope ghi cần chủ sở hữu xem xét.
Vì sao danh sách công cụ trống?
Dùng tools/list để xem các công cụ khả dụng cho kết nối. Phạm vi sử dụng phụ thuộc vào quyền đã cấp và quyền truy cập của không gian làm việc. Bắt đầu với quyền đọc; nhờ quản trị viên xem xét quyền còn thiếu thay vì yêu cầu quyền rộng.
Một connector có thể phục vụ hai workspace không?
Không. Token gắn với workspace đã cấp quyền. Đăng ký và đồng ý riêng cho từng workspace.
Có nên cấp scope gửi cho connector ngay ngày đầu không?
Không. Chỉ thêm lượt gửi sau khi hành vi đọc, chạy thử và xem xét chính sách thường trực hoàn tất.
Điều gì chứng minh thiết lập thành công?
workspace.context trả về workspace dự kiến, capabilities liệt kê các công cụ dự kiến, và tìm kiếm giới hạn trả về các dòng kết quả có thể xem xét.
Các lệnh gọi lỗi đi đâu để xem xét?
Giữ request_id, dấu thời gian, tên công cụ và mã lỗi; không bao giờ lưu token cùng các dòng kết quả trong ghi chú dùng chung.