Что сможет агент
- Найдёт в официальной документации Astro раздел под твою задачу и отдаст агенту до 10 кусков текста с примерами кода и ссылками на страницы docs.astro.build.
- Держит агента на текущей версии Astro: в нашей проверке поиск нашёл разделы из Astro 7, например фоновый запуск сервера разработки для агентов.
- Заранее подскажет, что задача потребует от проекта и хостинга: например, что форме заявки нужна отрисовка страницы по запросу и адаптер сервера.
- Найдёт официальную инструкцию по выкладке сайта на твою площадку или общий порядок для любого хостинга, а ещё страницы о переносе сайта с WordPress и других движков.
- Сверит код сайта со страницами обновления Astro: что поменялось в каждой версии и как переписать устаревшее.
- Кто сделал
- Astro
- Проверено
- 01.10.2026, Claude Code
- Лицензия
- MIT (указана в package.json)
- Документация
- docs.astro.build/ru/guides/build-with-ai/
Подключить
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Подключи MCP-сервер «Astro Docs». Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог code.tarasovweb.ru, проверено 01.10.2026):
- имя в конфиге: astro-docs
- официальный источник: https://github.com/withastro/docs-mcp
- удалённый адрес: https://mcp.docs.astro.build/mcp, вход: без входа
Правила:
1. Ставь только пакет или адрес из этого промпта. Никаких установочных скриптов из README без моего подтверждения.
2. Перед правкой конфига сделай его резервную копию.
Шаги:
0. Определи, кто ты (Claude Code, Codex или другой агент) и какая у меня система.
1. Проверь, нет ли уже сервера с таким именем: `claude mcp get astro-docs` (в Codex: `codex mcp list`).
2. Подключи сервер:
Claude Code: claude mcp add --scope user --transport http astro-docs https://mcp.docs.astro.build/mcp
Codex: codex mcp add astro-docs --url https://mcp.docs.astro.build/mcp
Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
3. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. У сервера один инструмент, назови его. Сделай пробный запрос: «Через astro-docs найди в документации Astro, как сделать форму заявки на сайте, и покажи пример кода». Покажи результат.
4. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove astro-docs --scope user` (в Codex: `codex mcp remove astro-docs`).
Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://code.tarasovweb.ru/mcp/astro-docs#problemy- Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.
Что нужно на компьютере: Ничего: сервер удалённый.
Ключ: не нужен.
Ставить ничего не нужно: сервер удалённый, ключ и аккаунт не нужны. Поиск ищет по английской документации, поэтому запросы к нему агент должен писать по-английски. В документации Astro для Codex, Windsurf и Warp подключение идёт через программу mcp-remote командой npx без номера версии. Codex умеет подключать адрес напрямую: команда для него есть на этой странице. Не путай с MCP-серверами компании Astronomer: у них свой продукт Astro для Apache Airflow.
Проверь, что работает
Через astro-docs найди в документации Astro, как сделать форму заявки на сайте, и покажи пример кода
Что должно получиться: Агент вызовет search_astro_docs с английским запросом и покажет код формы на Astro Actions или на API-маршруте со ссылками на docs.astro.build. В ответе будет оговорка, что странице с формой нужна отрисовка по запросу и адаптер сервера. Ответ без ссылок на docs.astro.build значит, что агент к серверу не обращался.
Что можно сделать
6 сценариевСайт-визитка на Astro с нуля
Агент проверит по документации, подходит ли твоя версия Node.js, создаст проект официальной командой и соберёт страницу визитки. Ставить что-то будет только после твоего «да».
- search_astro_docs по запросу «install Astro with create astro CLI wizard template» вернул страницу Install Astro: требования к Node.js, флаги команды create astro и ссылку на витрину тем.
- Новый проект из шаблона minimal (create-astro 5.2.4) уже содержит AGENTS.md и CLAUDE.md со ссылками на главные разделы документации и советом запускать сервер разработки в фоне.
Сделай мне сайт-визитку на Astro: [кто ты и чем занимаешься, какие блоки нужны: о себе, услуги, контакты]. Перед началом найди в документации через astro-docs (инструмент search_astro_docs), как создать проект официальной командой create astro, какие требования к Node.js и какой стартовый шаблон подойдёт. Запросы к поиску пиши по-английски. Проверь мою версию Node.js и скажи, подходит ли она. Перед каждой командой, которая что-то ставит, спроси моё «да». Код страниц пиши по документации, а в конце перечисли разделы, которые использовал.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Готовые темы для посадочных страниц, портфолио и блогов есть на astro.build/themes: можно попросить агента взять одну из них за основу.
- Совет. Нечётные версии Node.js Astro не поддерживает, так написано на странице установки: если агент скажет, что версия не подходит, поставь рекомендованную.
Форма заявки на сайте на Astro
Агент найдёт в документации, как принимать форму на сервере, и соберёт форму с проверкой полей. Заранее скажет главное: странице с формой нужна отрисовка по запросу и адаптер сервера, на хостинге только с готовыми файлами так она не заработает.
- В нашей проверке Claude Code получил этот вопрос по-русски и сам сделал два английских запроса к search_astro_docs: «form submission POST request handling» и «Astro Actions form».
- Из найденных разделов агент взял два официальных способа, Actions и API-маршрут, и предупредил: страница с формой должна отрисовываться по запросу, а в проекте нужен адаптер сервера. Это же написано на странице Actions на docs.astro.build.
- Код агента мы собрали на тестовой странице с формой заявки: Astro 7.3.5 и адаптер Node. Форма отправляется без JavaScript в браузере, поля проверяет сервер.
Сделай на моём сайте на Astro форму заявки: имя, телефон или почта, сообщение и согласие на обработку данных. Заявка должна [куда: приходить мне на почту, в Telegram или в таблицу]. Перед кодом найди в документации через astro-docs (инструмент search_astro_docs), как принимать форму в текущей версии Astro, и пиши код по ней. Запросы к поиску пиши по-английски. Скажи, что форме нужно от проекта и хостинга, и если мой сайт целиком статический, предложи варианты. Ключи и пароли для отправки бери только из переменных окружения: в код их не пиши и меня в чат не проси.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Если хостинг отдаёт только готовые файлы, форма на Actions там не заработает: нужен хостинг с Node.js или адаптер под твою площадку. Официальные адаптеры у Astro есть для Node.js, Netlify, Vercel и Cloudflare, их список агент найдёт запросом on-demand rendering server adapters.
- Совет. Короткое имя и короткое сообщение в нашей проверке сервер отклонил и показал подсказки у полей, правильная заявка дошла до сервера и перевела на страницу «Спасибо».
Блог на Astro: посты в Markdown и RSS-лента
Агент соберёт блог по текущему способу Astro: коллекцию постов с проверкой полей, список постов, страницу каждого поста и RSS-ленту. Новые посты ты потом пишешь обычными Markdown-файлами.
- В нашей проверке Claude Code сделал пять запросов к search_astro_docs: коллекции и загрузчик glob(), RSS, страницы из коллекции, выборка и сортировка постов, статические файлы.
- Код вышел на текущем способе Astro: файл src/content.config.ts, загрузчик glob() и render() из astro:content. Тестовый сайт на Astro 7.3.5 собрался с первого раза: /blog, две страницы постов и /rss.xml с постами от новых к старым.
- Для RSS агент сам прописал адрес сайта в astro.config.mjs: без него лента не соберёт полные ссылки, так сказано в рецепте документации.
Добавь на мой сайт на Astro блог: посты в Markdown в папке src/content/blog, страница со списком постов /blog, страница каждого поста и RSS-лента /rss.xml. Перед кодом найди в документации через astro-docs (инструмент search_astro_docs), как это делается в текущей версии Astro, и пиши код по ней. Запросы к поиску пиши по-английски. Сделай [сколько] тестовых поста. Адрес сайта для RSS: [твой домен]. В конце перечисли, какие разделы документации ты использовал.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Проверь адрес сайта (site) в astro.config.mjs: если домена в промпте нет, агент поставит заглушку, в нашей проверке это был example.com. Полные ссылки в RSS берутся оттуда.
- Совет. Если оформление из общей обёртки страниц не дошло до текста поста (метки, цитаты), дело в правилах Astro: стили компонента действуют только на его разметку. В нашей проверке помогла пометка <style is:global> в обёртке, об этом раздел документации Styles and CSS.
Выложить сайт на Astro на хостинг
Агент найдёт официальную инструкцию Astro для твоей площадки или общий порядок для любого хостинга: собрать сайт и загрузить папку dist. Скажет, нужно ли что-то поменять в проекте, например адаптер для формы.
- У документации Astro есть отдельные страницы для нескольких десятков площадок, среди них GitHub Pages, Netlify, Vercel, Cloudflare и Hostinger.
- Для хостинга без своей страницы запрос «build site locally and upload dist folder to any static host» первым вернул раздел Building Your Site Locally: собрать сайт командой npm run build и загрузить готовые файлы из папки dist.
- На той же странице раздел Adding an Adapter: если на сайте есть страницы, которые отрисовываются по запросу, например форма, нужен адаптер.
Мой сайт на Astro нужно выложить на [хостинг: например, GitHub Pages, Netlify или хостинг с загрузкой файлов]. Через astro-docs (инструмент search_astro_docs) найди официальную инструкцию Astro для этой площадки, а если её нет, общий порядок для любого хостинга. Запросы к поиску пиши по-английски. Скажи, что нужно поменять в проекте, собери сайт командой из документации и объясни по шагам, что и куда загрузить. Ничего не загружай и не публикуй без моего «да».Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Отдельных страниц для российских хостингов в документации Astro нет: для них подходит общий порядок, собрать сайт и загрузить содержимое папки dist.
- Совет. Если хостинг умеет собирать сайт сам из репозитория, в настройках обычно хватает двух строк из документации: команда сборки npm run build и папка dist.
Перенести сайт с WordPress на Astro
Агент найдёт официальную страницу Astro о переносе с WordPress и составит план под твой сайт: что переносится как есть, что придётся переделать и чем заменить плагины.
- search_astro_docs по запросу «migrate from WordPress» первым вернул страницу Migrating from WordPress, а рядом раздел о WordPress как источнике записей для сайта на Astro (Headless WordPress & Astro).
- Официальные страницы переноса есть для WordPress и для движков вроде Gatsby, Hugo, Jekyll, Next.js и Docusaurus. Для конструкторов вроде Tilda и Wix отдельной страницы нет: на такой запрос поиск вернул WordPress и Builder.io.
Хочу перенести мой сайт с WordPress на Astro. Через astro-docs (инструмент search_astro_docs) найди официальную страницу о переносе с WordPress. Запросы к поиску пиши по-английски. Составь план для моего сайта: [что на сайте: страницы, записи блога, формы, плагины]. Скажи, что переносится как есть, что придётся переделать и чем заменить плагины. Код пока не пиши, сначала план со ссылками на разделы документации.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Если сайт сделан на конструкторе, проси агента опираться на общую страницу Migrate an existing project to Astro и на разделы о страницах и компонентах.
Проверить код сайта на устаревшие приёмы Astro
Агент сверит код твоего сайта со страницами обновления Astro и покажет, что устарело: файл, что не так, ссылку на раздел документации и как исправить.
- search_astro_docs по запросу «upgrade to Astro v7 breaking changes» вернул разделы Breaking Changes страниц обновления на v7, v6, v5 и более старые версии.
- Полезно, когда сайт писала модель, которая помнит Astro прошлых версий: например, по странице обновления на v5 коллекции постов описываются в файле src/content.config.ts.
Проверь мой сайт на Astro. Посмотри, какая версия Astro стоит в package.json, и через astro-docs (инструмент search_astro_docs) найди страницы обновления (Upgrade to Astro v...) от моей версии до текущей. Запросы к поиску пиши по-английски. Сверь код с этими страницами. Ничего не меняй, сначала покажи список: файл, что не так, ссылка на раздел документации, как исправить.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Если версий между твоей и текущей несколько, проси агента идти по страницам обновления по очереди и проверять сборку после каждой.
Пример работы
редакция, прогон при проверке 01.10.2026- Задача
- Сделать форму заявки на сайте на Astro по текущей документации и убедиться, что она работает
- Промпт
- Через astro-docs найди в документации Astro, как сделать форму заявки на сайте, и покажи пример кода
- Что сделал агент
- Claude Code 2.1.235 сам перевёл русский вопрос в два английских запроса к search_astro_docs: «form submission POST request handling» и «Astro Actions form». Каждый ответ - 10 кусков документации, около 22-25 тысяч знаков.
- Агент предложил два официальных способа, Actions и API-маршрут, и сразу предупредил: страница с формой должна отрисовываться по запросу, в проекте нужен адаптер сервера. Это совпадает со страницей Actions на docs.astro.build.
- Код агента мы собрали на тестовой странице с формой заявки: Astro 7.3.5, адаптер Node 11.1.6. Сборка прошла с первого раза.
- Короткое имя и короткое сообщение сервер отклонил с подсказками «Укажите имя» и «Опишите задачу подробнее», правильная заявка дошла до сервера и перевела на страницу «Спасибо».
- Результат
- Рабочая форма с проверкой полей на сервере за один вопрос агенту, ответ пришёл за 50 секунд. Код написан по разделам документации текущей версии Astro, ссылки на них агент привёл в ответе.
Инструменты
1 · описания около 0,1 тыс. токеновЖёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.
Когда не нужен
Если сайт не на Astro, это подключение не поможет: оно ищет только по документации Astro. Если в проекте несколько библиотек (Astro, Tailwind, React), удобнее Context7 из каталога: одно подключение знает документацию тысяч библиотек, в том числе Astro. Его индекс пополняет кто угодно, а ссылки ведут на исходные файлы документации на GitHub; вопрос по-русски в нашей проверке он тоже понял плохо. Если агент сам открывает страницы в интернете, он может читать docs.astro.build и без подключения: новый проект Astro кладёт в папку файлы AGENTS.md и CLAUDE.md со ссылками на главные разделы. Подключение нужно, чтобы находить нужный раздел по вопросу. Чтобы посмотреть, как готовый сайт выглядит в браузере, возьми Playwright или Chrome DevTools: этот сервер только ищет в документации.
Частые проблемы
4Агент получает пустой ответ {"search_results": []}
Поиск сервера ищет по словам в английской документации. В нашей проверке запросы «форма заявки на сайте», «блог» и даже «формы» ничего не нашли. Английский запрос «contact form» вернул 10 разделов. Попроси агента писать запросы к search_astro_docs по-английски, терминами Astro: contact form, content collections, deploy. Claude Code в нашей проверке сам переводил русский вопрос в английский запрос.
claude mcp add отвечает «Invalid name Astro docs. Names can only contain letters, numbers, hyphens, and underscores»
В README репозитория сервера команда для Claude Code дана с именем «Astro docs» через пробел, а Claude Code пробелов в имени не принимает. Возьми имя astro-docs, как в документации Astro и в команде на этой странице.
Просил инструкцию для своего хостинга или конструктора, а агент принёс страницы про Hostinger, WordPress или Builder.io
Поиск всегда возвращает 10 ближайших кусков, даже если нужной страницы в документации нет. Отдельных страниц для российских хостингов и для конструкторов вроде Tilda и Wix у Astro нет. Смотри на заголовки и адреса страниц в ответе. Если твоей площадки среди них нет, попроси агента идти по общему разделу: для выкладки это Building Your Site Locally на странице Deploy your Astro Site, для переноса - Migrate an existing project to Astro.
Агент не видит инструментов сервера
Клиент не перезапущен после подключения: Claude Code читает подключения при старте сессии. Закрой и открой сессию, потом проверь: claude mcp list.
Безопасность и данные
- Кто сделал
- Astro (официальный). Исходный код: github.com/withastro/docs-mcp, лицензия MIT (указана в package.json).
- Что видит агент
- Только текст запроса, который агент пишет в search_astro_docs: о чём ты спрашиваешь документацию Astro. Твой код, файлы и сайт сервер не видит. Запросы уходят в поиск kapa.ai, который ведёт для Astro индекс документации; по описанию kapa.ai вопросы сохраняются для статистики владельца проекта, то есть команды Astro. Не пиши в запросах ключи, пароли и данные клиентов.
- Куда уходят данные
- Данные уходят: Astro и kapa.ai, США.
- Что может изменить
- Ничего: единственный инструмент только ищет в документации.
- Наша проверка
- Адрес и команда для Claude Code указаны на официальной странице документации Astro «Создание сайтов на Astro с помощью инструментов ИИ». Исходный код - репозиторий withastro/docs-mcp: одна функция на Netlify, которая передаёт запрос в поиск kapa.ai и возвращает ответ как есть; лицензия MIT указана в package.json, отдельного файла лицензии в репозитории нет. Страница и значок на mcp.docs.astro.build побайтно совпадают с репозиторием, а ответы сервера - с его кодом. В официальном реестре MCP сервера нет. Описание единственного инструмента прочитано, инструкций, подсказок и ресурсов у сервера нет, скрытых указаний агенту нет; снимок под разными именами клиента одинаковый. Пометок «только чтение» автор не ставил: уровень проставлен по живым вызовам. У библиотеки MCP внутри сервера (@modelcontextprotocol/sdk 1.15.1) в базе OSV три записи, по коду ни одна не применима: сервер создаётся заново на каждый запрос, ресурсов у него нет, и работает он на стороне Astro. Твой компьютер соединяется только с mcp.docs.astro.build через Cloudflare. Ответы сверены со страницами docs.astro.build: текст совпадает.
- Версия
- Сервер удалённый, версию держит владелец сервиса. Изменения ловим сверкой отпечатка.
- Проверить самому
- агент прочитает код подключения как недоверенный
Полезные материалы
- ИнструкцияСоздание сайтов на Astro с помощью инструментов ИИОфициальная страница Astro о сервере: адрес, подключение в Claude Code, Codex, Cursor и других клиентах, фоновый запуск сервера разработки для агентов.
- Инструкция · на английскомwithastro/docs-mcp: исходный код сервераВесь сервер - одна функция, которая передаёт запрос в поиск kapa.ai. Здесь же сообщения об ошибках.
- ИнструкцияУстановка и настройка AstroТребования к Node.js, команда create astro, шаблоны и ручная установка.
- Инструкция · на английскомDeploy your Astro SiteИнструкции для нескольких десятков площадок и общий порядок для любого хостинга: собрать сайт и загрузить папку dist.
- Инструкция · на английскомActionsКак принимать формы на сервере: проверка полей, ошибки, отрисовка страницы по запросу.
- Инструкция · на английскомContent collectionsТекущий способ хранить посты блога: файл src/content.config.ts и загрузчик glob().
Журнал проверок
- 01.10.2026·удалённый·Claude Code, macOS·работает21465bab932515b2
Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.
Похожие подключения
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
