Kết nối tác nhân AI
Reconstruct cung cấp dữ liệu giao diện qua MCP. Chọn tác nhân để xem thiết lập:
- Codex
- Claude
- Cursor
- Cline
- GitHub Copilot trong VS Code
- Gemini CLI
- MiMo
- Muse Code
- Grok Build
- Hermes Agent
- OpenClaw
- OpenMausBot
- Máy khách MCP khác
Trước khi bắt đầu
Endpoint là https://reconstruct.dev/mcp, dùng Streamable HTTP. Kết nối bằng OAuth trình duyệt hoặc token cá nhân.
| Cách thức | Cơ chế | Khi dùng |
|---|---|---|
| Đăng nhập OAuth qua trình duyệt | Máy khách mở đăng nhập Reconstruct. Đăng nhập, chấp thuận rồi quay lại; không cần tạo/sao chép token nền tảng. | Tác nhân tương tác và trình soạn thảo có OAuth. |
| Token truy cập cá nhân | Tạo token MCP trong nền tảng, thêm vào thông tin xác thực máy khách. | Máy khách không OAuth hoặc tự động hóa không có trình duyệt đăng nhập. |
Hai cách cùng máy chủ, dùng đăng ký/hạn mức tài khoản Reconstruct.
Đăng nhập OAuth qua trình duyệt
Không cần cấp token cá nhân trước khi OAuth.
- Thêm
https://reconstruct.dev/mcplàm máy chủ HTTP MCP từ xa. - Chọn OAuth/đăng nhập trình duyệt. Nếu hỏi thông số, dùng dưới đây.
- Chọn Sign in (Đăng nhập), Connect (Kết nối), hoặc lệnh MCP của máy khách. Cụ thể tùy máy khách.
- Đăng nhập tài khoản và chấp thuận. Nếu không mở đăng ký, liên hệ hỗ trợ để có tài khoản.
- Quay lại và làm mới công cụ; yêu cầu gọi
list_productsđể xác nhận.
| Thông số | Giá trị |
|---|---|
| URL máy chủ | https://reconstruct.dev/mcp |
| Giao thức | Streamable HTTP |
| ID máy khách OAuth | reconstruct-mcp cho cấu hình sẵn; Claude Desktop tự đăng ký |
| Phạm vi | openid aud-mcp |
| Bí mật máy khách | Để trống |
| Bên phát hành OAuth | https://reconstruct.dev/sso/realms/reconstruct |
| Endpoint ủy quyền | https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/auth |
| Endpoint token | https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/token |
Sau đăng nhập, máy khách lưu thông tin OAuth để gọi MCP. Không cần sao chép token hay đặt CR_RECONSTRUCT_MCP_TOKEN. Xóa Authorization/bearer thủ công khi chuyển kết nối sang OAuth.
Xem OAuth cho Codex, Claude Code, Cursor, Cline, OpenMausBot, máy khách khác. Dùng gọi lại theo tài liệu. Nếu hỏi đăng nhập lại, lặp luồng MCP.
Tính tương thích máy khách
Ví dụ trình duyệt gồm Claude, Cursor, Claude Code, Codex, Grok Build, Muse Code với địa chỉ đã đăng ký. Gemini CLI, VS Code, MiMo Code/Desktop, Hermes, OpenClaw dùng token; VS Code còn cài một lần nhấn với đăng ký tự động. Claude Desktop/web hỗ trợ tự đăng ký với HTTPS chính xác đã chấp thuận. Máy khách khác có phát hiện OAuth/DCR cũng chỉ cần URL, tự đăng ký/xử lý HTTPS hoặc loopback chính xác. Cấu hình công khai đăng ký sẵn vẫn dùng khi thiếu DCR.
Endpoint OAuth lấy từ siêu dữ liệu, dưới realm SSO, không /authorize//token ở gốc. Nếu mở gốc, tải lại cấu hình và đăng nhập để cập nhật bộ nhớ phát hiện.
Claude đám mây theo hướng dẫn Desktop. Trước tích hợp đám mây khác, gửi hỗ trợ URI chính xác. Không nhập bí mật cho reconstruct-mcp.
Phát hiện tác nhân và đăng nhập thiết bị
Bắt đầu tại https://reconstruct.dev/mcp/server-card. /.well-known/api-catalog liệt kê tài liệu công khai, /.well-known/agent-skills/index.json liệt kê quy trình/gói cài. Xem kỹ năng Reconstruct cho chín quy trình, tài nguyên MCP không cài riêng, cài web/GitHub CLI, tải thủ công, plugin từng máy khách. Kết nối từ xa không cần .NET SDK trên máy người dùng.
Trang/tài liệu công bố nhận Accept: text/markdown; workspace vẫn cần quyền tài khoản.
Máy khách OAuth Device Authorization có thể đọc https://reconstruct.dev/auth.md và POST {"type":"anonymous"} tới https://reconstruct.dev/agent/register. Trả ủy quyền chờ, URL/mã xác minh, hết hạn, chu kỳ hỏi và PKCE code_verifier riêng. Hiển thị hướng dẫn cho người dùng; họ phải đăng nhập/chấp thuận. Tác nhân hỏi endpoint token bằng device-code grant và code_verifier. Tuân thủ chu kỳ/slow_down. Đăng ký không tự cấp token hay tạo tài khoản. Vai trò, giới hạn và đồng ý hiện có vẫn áp dụng.
Giữ mã thiết bị, verifier, token bí mật. Không chấp thuận thay người dùng. Luồng chỉ cho máy khách triển khai nó, không thay Mã ủy quyền + PKCE của trình soạn thảo.
Token truy cập cá nhân
- Vào Reconstruct Platform, mở Settings → API tokens (Cài đặt → Token API).
- Tạo token phạm vi MCP (
mcp), sao chép bí mật khi hiện. - Gửi
Authorization: Bearer <token>. Nếu lấy từ biến, dùngCR_RECONSTRUCT_MCP_TOKEN. - Kết nối, yêu cầu gọi
list_products.
Lưu trong bí mật cục bộ/kho máy khách. Hết hạn/thu hồi thì tạo token mới và cập nhật.
Chọn dữ liệu thu thập
Bắt đầu list_products, list_platforms, list_versions. Chọn loại/môi trường từ list_platforms.options.platforms[], dùng ID trả về. list_platforms.platforms[] chứa cặp có dữ liệu. Dùng khóa view chính xác list_pages.views[]. Truyền environment rõ nếu nhiều môi trường. Công cụ ngữ cảnh cần hạn mức, tốn một lượt đọc khi được nhận, kể cả cache; lỗi sau vẫn tính. Phát hiện, ảnh, tải tài nguyên không tốn. Xem giới hạn.
Khắc phục sự cố
| Triệu chứng | Kiểm tra |
|---|---|
401 Unauthorized | Hoàn tất OAuth hoặc kiểm tra token; thay hết hạn/đã thu hồi. |
/authorize trả 404 | Làm mới siêu dữ liệu, đăng nhập lại; endpoint dưới https://reconstruct.dev/sso/realms/reconstruct. |
invalid_scope | Yêu cầu openid aud-mcp; Grok có thể thêm offline_access tùy chọn. |
| Vẫn cần xác thực sau đăng nhập | Làm mới máy chủ, đăng nhập OAuth lại; xóa bearer thủ công xung đột. |
| Chuyển hướng OAuth không khớp | Dùng cổng theo hướng dẫn; nếu còn lỗi, gửi URI hiển thị cho hỗ trợ. |
| Đăng ký động bị từ chối | Chọn tự đăng ký và thử sau một phút. Cần HTTPS/loopback chính xác, PKCE S256. Không tự đăng ký được thì dùng cấu hình sẵn. |
| Máy chủ không kết nối | Xác nhận máy tác nhân truy cập được https://reconstruct.dev/mcp. |
| Công cụ từ chối truy cập | Đăng nhập và kiểm tra đăng ký; liên hệ hỗ trợ nếu vẫn thiếu quyền. |
| Hạn mức/sử dụng không có | Kiểm tra cài đặt và trạng thái; thử khi có quyền. |
| Nhiều môi trường thu thập | Cung cấp environment từ list_versions. |
| Nền tảng/view yêu cầu không có | Dùng cặp đã thu thập và khóa list_pages.views[] chính xác; hỗ trợ không bảo đảm dữ liệu. |
| Không thấy công cụ | Khởi động lại tác nhân hoặc làm mới MCP, kiểm tra trạng thái máy chủ. |
Kết nối xong, thử ví dụ câu lệnh hoặc danh mục MCP.
Yêu cầu bản mới/cập nhật
Máy chủ có get_request_options, create_product_request, get_product_request, list_product_requests, wait_product_request. OAuth hoặc token MCP; đăng ký phải hỗ trợ yêu cầu, chỉ xem yêu cầu tài khoản mình gửi. Yêu cầu tác nhân gửi URL mới hoặc cập nhật khóa đã công bố, giữ requestId và chờ thay đổi xét duyệt. Chấp thuận không nghĩa đã sẵn sàng. Xem tham số công cụ yêu cầu.