Инструкция для агента
Передайте агенту:
Подключись к MCP-шлюзу моего сайта по инструкции:
https://webco.one/docs/bitrix/modules/native.mcp/agents/instruction/Агент спросит адрес сервера и токен и проверит настройки. Что нужно подготовить на сайте — в разделе «Ручное подключение» → «Подготовка на сайте».
Правила для агента
- Идите по разделам по порядку; к следующему — после подтверждения пользователя.
- Токен пользователь вводит в настройки клиента сам. Если без чата не обойтись, предупредите, что токен останется в истории.
- Не записывайте токен в URL и в файлы репозитория.
- Не подключайтесь от имени администратора сайта.
- Меняйте настройки клиента только с согласия пользователя.
Выбор клиента
Определите свой клиент. Если вы не можете изменить его настройки сами, их вносит пользователь по вашим указаниям.
| Клиент | Настройка |
|---|---|
| Claude: веб-версия и приложения | Claude |
| Claude Desktop | Claude Desktop |
| ChatGPT: чат | Не подключается, используйте Codex: ChatGPT |
| Codex в приложении ChatGPT | ChatGPT |
| VS Code | VS Code |
| Cursor | Cursor |
| Claude Code | Claude Code |
| Codex CLI | Codex |
| Gemini CLI | Gemini CLI |
Адрес сервера
Адрес сервера — адрес сайта, путь интерфейса и /mcp, например https://example.com/api/mcp. Спросите у пользователя:
- Адрес сайта.
- Путь интерфейса: «Сервисы → API-платформа → Настройки модуля», вкладка «Основные». См. «Основные настройки» → «Путь интерфейса».
- Включён ли флажок MCP-шлюза на вкладке «Роуты». См. «Настройки роутов» → «MCP-шлюз».
Покажите собранный адрес и получите подтверждение.
Проверьте шлюз запросом GET без токена: https://example.com/api/up/mcp. Ответ 200 означает, что шлюз включён. Остальные ответы и их причины — в разделе «Сервисные роуты» → «GET up/mcp».
Если вместо JSON открылась страница сайта с ошибкой 404, путь интерфейса указан неверно.
Пользователь и токен
Попросите пользователя подтвердить:
- Пользователь агента входит в группу «MCP: Клиенты» (NATIVE_MCP_CLIENT) и в группы нужных инструментов. См. «Доступ и группы».
- У пользователя есть действующий access-токен. См. «Доступ и группы» → «Токен».
Подключение
Настройте клиент по его разделу, указав адрес сервера и access-токен. Если настройки меняете вы, берите токен из переменной окружения, например MCP_SITE_TOKEN.
Если клиенту нужен перезапуск, попросите пользователя после него прислать ссылку на эту страницу с текстом «Проверь подключение к MCP-шлюзу» и продолжайте с раздела «Проверка».
Проверка
Проверку выполняет агент сам, пользователю ничего открывать не нужно.
- Найдите среди своих инструментов встроенные
project_infoиmodule_info. Если их нет, сервер не подключился. - Вызовите
project_infoи сообщите пользователю название сайта из ответа. Пользователь подтверждает, что это его сайт. - Если сервер не подключился или вызов вернул ошибку, разберите её по «Ручное подключение» → «Ошибки подключения».
Итог
Сообщите пользователю адрес сервера, доступные инструменты и дату окончания токена. Если доступны только встроенные инструменты, роуты сайта для агента не опубликованы: см. «Инструменты».