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

Kết nối Grok Build

Đăng nhập bằng trình duyệt (OAuth)​

Để đăng ký OAuth tự động, thêm URL máy chủ mà không ghi đè oauth, rồi đăng nhập qua /mcps. Grok đăng ký địa chỉ gọi lại và xử lý việc trở về từ trình duyệt.

Để dùng máy khách đã đăng ký trước, thêm cấu hình này vào ~/.grok/config.toml:

[mcp_servers.reconstruct]
url = "https://reconstruct.dev/mcp"
oauth = { clientId = "reconstruct-mcp", scopes = ["openid", "aud-mcp", "offline_access"], callbackPort = 58234 }

Trong Grok Build, mở /mcps, nhấn r để tải lại, chọn reconstruct rồi nhấn i để đăng nhập. Địa chỉ gọi lại là http://127.0.0.1:58234/callback. Giữ cổng 58234 khả dụng. Không cần bí mật máy khách. Grok khởi tạo bộ lắng nghe cục bộ và tự hoàn tất kết nối sau đăng nhập. Máy khách công khai dùng Mã ủy quyền với PKCE S256 và xin chấp thuận MCP. Grok còn yêu cầu offline_access để gia hạn token; đây là phạm vi tùy chọn. Cần tài khoản có quyền truy cập nền tảng.

Thông số OAuth lồng nhau dùng camelCase (clientId, callbackPort). Khi chỉ có URL máy chủ, máy khách tương thích tự đăng ký động bằng URI gọi lại chính xác của mình. Xem thiết lập MCP OAuth.

Token truy cập cá nhân​

Dùng phương án này khi không đăng nhập được bằng trình duyệt. Không thêm tiêu đề Authorization vào mục OAuth ở trên.

Sao chép token MCP từ cài đặt tài khoản Reconstruct Platform. Xem yêu cầu trong Token truy cập cá nhân. Đặt CR_RECONSTRUCT_MCP_TOKEN trong môi trường khởi chạy Grok Build.

Thêm nội dung sau vào ~/.grok/config.toml của người dùng. Nếu đã có máy chủ MCP khác, giữ chúng và chỉ thêm phần reconstruct:

[mcp_servers.reconstruct]
url = "https://reconstruct.dev/mcp"
headers = { "Authorization" = "Bearer ${CR_RECONSTRUCT_MCP_TOKEN}" }

Grok Build thay ${CR_RECONSTRUCT_MCP_TOKEN} bằng giá trị môi trường khi tải cấu hình. Không đặt token nguyên văn trong tệp dự án.

Khởi chạy Grok Build bằng grok. Nếu đang chạy, mở /mcps và nhấn r để làm mới sau khi sửa cấu hình.

Kiểm tra đăng ký và kết nối:

grok mcp doctor reconstruct

Yêu cầu Grok Build gọi list_products bằng công cụ reconstruct để xác nhận quyền truy cập.

Hướng dẫn kỹ năng​

Tài nguyên MCP và công cụ MCP là hai khả năng riêng. Một số phiên bản Grok Build cung cấp công cụ thu thập qua search_tool và use_tool, nhưng không cung cấp resources/read. Gọi resources/list như công cụ sẽ không tải kỹ năng.

Nếu máy khách không có tài nguyên, yêu cầu Grok gọi list_skills, rồi get_skill với URI tài nguyên danh mục (skill://reconstruct/ cộng đường dẫn trả về). Cách này lấy cùng gói hướng dẫn qua công cụ MCP thông thường; không cần cài riêng. Các mẫu hỗ trợ cũng đọc được qua get_skill.

Với máy chủ cũ thiếu các công cụ kỹ năng, cài riêng kỹ năng hoặc đọc hướng dẫn trang công khai trước khi bắt đầu. Để tái dựng, dùng reconstruct-inspect, reconstruct-build, reconstruct-verify từ https://reconstruct.dev/.well-known/agent-skills/<skill-name>/SKILL.md. Danh mục công khai là https://reconstruct.dev/.well-known/agent-skills/index.json. Dữ liệu vẫn đến từ kết nối MCP đã xác thực. Xem kỹ năng Reconstruct để biết cách cài.

Khi tái dựng, quy trình hiện tại ưu tiên get_interface_scene nếu máy chủ đã kết nối công bố công cụ này. Công cụ xuất cùng hợp đồng cảnh trung lập cho bộ điều hợp nền tảng, với dữ kiện đo được/khai báo/suy luận và bằng chứng thiếu rõ ràng. DOM/CSS là chẩn đoán web tùy chọn. Tải tài liệu Build đã công bố qua get_skill; xuất thành công không đồng nghĩa đã xác minh độ trung thực desktop, mobile, tương tác hay hoạt ảnh. Máy chủ cũ dùng công cụ bằng chứng cũ đã công bố và phải nêu các khoảng trống phát sinh.

Xem hướng dẫn MCP chính thức của Grok Build. Tiếp theo, thử ví dụ câu lệnh.