Подключение Grok Build

Вход в браузере (OAuth)

Для автоматической регистрации OAuth добавьте URL сервера без переопределения oauth, затем войдите через /mcps. Grok зарегистрирует свой адрес обратного вызова и обработает возврат из браузера.

Для варианта с предварительно зарегистрированным клиентом добавьте эту конфигурацию в ~/.grok/config.toml:

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

В Grok Build откройте /mcps, нажмите r для перезагрузки конфигурации, выберите reconstruct и нажмите i для входа. Адрес обратного вызова — http://127.0.0.1:58234/callback. Порт 58234 должен быть свободен. Секрет клиента не нужен. Grok запускает локальный обработчик обратного вызова и автоматически завершает подключение после входа в браузере. Этот публичный клиент использует код авторизации с PKCE S256 и запрашивает согласие на MCP. Grok также запрашивает offline_access для продления токенов после входа; для этого клиента область необязательна. Нужна учётная запись с доступом к платформе.

Вложенные параметры OAuth используют camelCase (clientId, callbackPort). Если указан только URL сервера, поддерживаемые клиенты используют автоматическую динамическую регистрацию со своим точным URI обратного вызова. См. настройку MCP OAuth.

Персональный токен доступа

Используйте этот вариант, когда вход через браузер недоступен. Не добавляйте заголовок Authorization в запись OAuth выше.

Скопируйте токен доступа MCP в настройках учётной записи Reconstruct Platform. Требования описаны в разделе Персональный токен доступа. Задайте CR_RECONSTRUCT_MCP_TOKEN в окружении запуска Grok Build.

Добавьте это в пользовательский файл ~/.grok/config.toml. Если там уже есть другие серверы MCP, сохраните их и добавьте только раздел reconstruct:

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

При загрузке конфигурации Grok Build подставляет ${CR_RECONSTRUCT_MCP_TOKEN} из окружения. Не храните токен открытым текстом в файлах проекта.

Запустите Grok Build командой grok. Если он уже работает, после правки конфигурации откройте /mcps и нажмите r для обновления.

Проверьте регистрацию и подключение:

grok mcp doctor reconstruct

Попросите Grok Build вызвать list_products инструментами reconstruct для подтверждения доступа.

Инструкции навыков

Ресурсы MCP и инструменты MCP — отдельные возможности. Некоторые версии Grok Build предоставляют агенту инструменты захвата через search_tool и use_tool, но не предоставляют resources/read. Вызов resources/list как инструмента не загрузит навык.

Если клиент не поддерживает ресурсы, попросите Grok вызвать list_skills, затем get_skill с URI ресурса каталога (skill://reconstruct/ и возвращённый путь). Это получает те же упакованные инструкции через обычные инструменты MCP; отдельная установка не нужна. Вспомогательные шаблоны также доступны через get_skill.

Для старых серверов без этих инструментов установите навыки отдельно или прочитайте инструкции публичного сайта перед началом. Для реконструкции используйте reconstruct-inspect, reconstruct-build и reconstruct-verify из https://reconstruct.dev/.well-known/agent-skills/<skill-name>/SKILL.md. Публичный каталог обнаружения — https://reconstruct.dev/.well-known/agent-skills/index.json. Данные захватов по-прежнему поступают через аутентифицированное подключение MCP. Варианты установки описаны в Навыках Reconstruct.

Для реконструкции текущий процесс предпочитает get_interface_scene, если подключённый сервер заявляет его поддержку. Он экспортирует единый нейтральный контракт сцены для адаптеров платформ с измеренными, объявленными и выведенными фактами и явными пробелами в свидетельствах. DOM/CSS — необязательная веб-диагностика. Загрузите опубликованный справочник Build через get_skill; успешный экспорт не означает подтверждённую точность настольного, мобильного интерфейса, взаимодействий или анимации. Старые серверы используют заявленные устаревшие инструменты свидетельств и должны раскрывать возникающие пробелы.

См. официальное руководство MCP Grok Build. Затем попробуйте примеры запросов.