Chuyển tới nội dung chính

Kết nối máy khách MCP khác

Các bước áp dụng cho tác nhân AI/trình soạn thảo hỗ trợ MCP từ xa nhưng chưa có hướng dẫn riêng. Trước tiên chọn OAuth hoặc token theo Trước khi bắt đầu.

Thêm máy chủ​

  1. Mở cài đặt MCP và thêm máy chủ reconstruct.
  2. Chọn Streamable HTTP, đôi khi tên HTTP hoặc remote HTTP.
  3. Đặt URL máy chủ thành https://reconstruct.dev/mcp.

Đăng nhập OAuth qua trình duyệt​

Nếu hỗ trợ phát hiện OAuth và đăng ký động (DCR), chỉ thêm https://reconstruct.dev/mcp, chọn OAuth rồi kết nối. Máy khách đăng ký gọi lại, mở đăng nhập và tự nhận gọi lại sau khi bạn chấp thuận. Không cần nhập ID/cổng thủ công.

Ứng dụng được lưu trữ có thể đăng ký gọi lại HTTPS chính xác trên tên miền công khai, như https://app.example.com/mcp/callback. Ứng dụng gốc có thể dùng HTTP chính xác trên 127.0.0.1/localhost với cổng rõ ràng. Máy khách sở hữu/xử lý gọi lại, không phải máy chủ MCP. Cần PKCE S256, đồng ý người dùng và phạm vi chỉ MCP. Ký tự đại diện, HTTP ngoài loopback, fragment và URL khóa từ xa bị từ chối.

Máy khách không tự đăng ký​

Dùng máy khách công khai đăng ký trước nếu ứng dụng không tự đăng ký:

  1. Đặt ID reconstruct-mcp, phạm vi openid aud-mcp, để trống bí mật.
  2. Đặt cổng OAuth cục bộ 58234, đường dẫn /callback.
  3. Lưu/kết nối, hoàn tất đăng nhập, chấp thuận và quay lại máy khách.

Gọi lại cục bộ cho máy khách tùy chỉnh​

Cấu hình máy khách lắng nghe cổng 58234 trên máy bạn và dùng một URI chuyển hướng chính xác sau:

  • http://127.0.0.1:58234/callback
  • http://localhost:58234/callback

Máy khách phải hỗ trợ Mã ủy quyền với PKCE (S256). Dùng ID reconstruct-mcp, phạm vi openid aud-mcp, không có bí mật. URI khi đăng nhập/đổi token phải khớp chính xác cấu hình.

Cổng 58234 chỉ dành cho gọi lại trình duyệt cục bộ. URL từ xa vẫn là https://reconstruct.dev/mcp qua HTTPS. Gắn bộ lắng nghe vào loopback, không mở ra mạng. Chỉ một luồng lắng nghe được cùng lúc; kết thúc đăng nhập hiện có trước khi bắt đầu luồng khác.

Tự quay lại máy khách​

Máy khách phải chạy bộ lắng nghe trước khi mở trình duyệt. Sau đăng nhập/đồng ý, Keycloak chuyển hướng tới đó; máy khách nhận phản hồi, đổi mã bằng PKCE và tiếp tục MCP. Người dùng không cần tự sao chép URL hay mã ủy quyền.

Muse Code, Grok Build, Codex, Claude Code dùng cổng chung theo hướng dẫn. Máy khách có gọi lại cố định riêng, như Cursor/Claude Desktop, giữ địa chỉ được hỗ trợ.

Với ứng dụng C# tùy chỉnh, cấu hình ClientOAuthOptions.RedirectUri, triển khai AuthorizationCallbackHandler để mở trình duyệt và lấy code, state, iss. Chỉ đặt URI không tạo bộ lắng nghe; handler mặc định SDK yêu cầu nhập URL thủ công. Xem tùy chọn OAuth SDK C# chính thức.

Bên phát hành là https://reconstruct.dev/sso/realms/reconstruct; dùng endpoint ủy quyền/token được phát hiện thay vì tự tạo /authorize và /token tại gốc.

Xóa Authorization thủ công khi chọn OAuth. Nếu lỗi gọi lại, gửi hỗ trợ URI máy khách hiển thị.

Token truy cập cá nhân​

Không hỗ trợ OAuth thì tạo token MCP trong nền tảng và đặt Authorization thành Bearer <your MCP token>. Dùng kho bí mật hoặc CR_RECONSTRUCT_MCP_TOKEN nếu hỗ trợ.

Kiểm tra kết nối​

Kết nối lại/khởi động lại. Xác nhận list_products trong danh sách rồi yêu cầu tác nhân gọi.

Không có định dạng JSON chung. Có máy khách dùng mcpServers, servers hoặc mcp; một số yêu cầu type. Theo tài liệu cho tên trường và cú pháp thay token chính xác. Máy khách chỉ SSE cũ không thể dùng HTTP /mcp của Reconstruct như SSE.

Nếu lỗi, xem bảng khắc phục. Kết nối xong, thử ví dụ câu lệnh.