СмыслоКод

Astro Docs

Astro · официальный сервер

Сайт на Astro по текущей документации: агент сам находит нужный раздел и пример кода

Удалённый сервис: Astro·Без ключа·Бесплатно·1 инструмент·проверено 01.10.2026

Другие способы ↓Что можно сделать ↓

Что сможет агент

  • Найдёт в официальной документации Astro раздел под твою задачу и отдаст агенту до 10 кусков текста с примерами кода и ссылками на страницы docs.astro.build.
  • Держит агента на текущей версии Astro: в нашей проверке поиск нашёл разделы из Astro 7, например фоновый запуск сервера разработки для агентов.
  • Заранее подскажет, что задача потребует от проекта и хостинга: например, что форме заявки нужна отрисовка страницы по запросу и адаптер сервера.
  • Найдёт официальную инструкцию по выкладке сайта на твою площадку или общий порядок для любого хостинга, а ещё страницы о переносе сайта с WordPress и других движков.
  • Сверит код сайта со страницами обновления Astro: что поменялось в каждой версии и как переписать устаревшее.
Кто сделал
Astro
Проверено
01.10.2026, Claude Code
Лицензия
MIT (указана в package.json)
Код
github.com/withastro/docs-mcp
Документация
docs.astro.build/ru/guides/build-with-ai/

Подключить

Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.

Промпт для агента
Подключи MCP-сервер «Astro Docs». Работай по шагам и после каждого коротко говори, что сделал.

Данные сервера (каталог smyslokod.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». Попроси меня перезапустить сессию. Перечисли инструменты сервера, их около 1. Сделай пробный запрос: «Через astro-docs найди в документации Astro, как сделать форму заявки на сайте, и покажи пример кода». Покажи результат.
4. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove astro-docs --scope user` (в Codex: `codex mcp remove astro-docs`).

Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.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, создаст проект официальной командой и соберёт страницу визитки. Ставить что-то будет только после твоего «да».

  1. search_astro_docs по запросу «install Astro with create astro CLI wizard template» вернул страницу Install Astro: требования к Node.js, флаги команды create astro и ссылку на витрину тем.
  2. Новый проект из шаблона 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 7.3.5 из нашей проверки: код формы агент написал по найденным разделам документации. Короткое имя и короткое сообщение сервер отклонил с подсказками «Укажите имя» и «Опишите задачу подробнее»
Та же тестовая форма после правильной заявки: сервер принял её и перевёл на страницу «Спасибо, заявка принята»

Форма заявки на сайте на Astro

Агент найдёт в документации, как принимать форму на сервере, и соберёт форму с проверкой полей. Заранее скажет главное: странице с формой нужна отрисовка по запросу и адаптер сервера, на хостинге только с готовыми файлами так она не заработает.

  1. В нашей проверке Claude Code получил этот вопрос по-русски и сам сделал два английских запроса к search_astro_docs: «form submission POST request handling» и «Astro Actions form».
  2. Из найденных разделов агент взял два официальных способа, Actions и API-маршрут, и предупредил: страница с формой должна отрисовываться по запросу, а в проекте нужен адаптер сервера. Это же написано на странице Actions на docs.astro.build.
  3. Код агента мы собрали на тестовой странице с формой заявки: 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 7.3.5: коллекцию постов, страницы и RSS-ленту агент собрал по разделам документации, найденным через search_astro_docs. Новый пост стоит выше старого
Страница тестового поста: дата публикации и обновления, метка и цитата. Метки и цитата получили оформление после пометки is:global в обёртке страниц

Блог на Astro: посты в Markdown и RSS-лента

Агент соберёт блог по текущему способу Astro: коллекцию постов с проверкой полей, список постов, страницу каждого поста и RSS-ленту. Новые посты ты потом пишешь обычными Markdown-файлами.

  1. В нашей проверке Claude Code сделал пять запросов к search_astro_docs: коллекции и загрузчик glob(), RSS, страницы из коллекции, выборка и сортировка постов, статические файлы.
  2. Код вышел на текущем способе Astro: файл src/content.config.ts, загрузчик glob() и render() из astro:content. Тестовый сайт на Astro 7.3.5 собрался с первого раза: /blog, две страницы постов и /rss.xml с постами от новых к старым.
  3. Для 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. Скажет, нужно ли что-то поменять в проекте, например адаптер для формы.

  1. У документации Astro есть отдельные страницы для нескольких десятков площадок, среди них GitHub Pages, Netlify, Vercel, Cloudflare и Hostinger.
  2. Для хостинга без своей страницы запрос «build site locally and upload dist folder to any static host» первым вернул раздел Building Your Site Locally: собрать сайт командой npm run build и загрузить готовые файлы из папки dist.
  3. На той же странице раздел Adding an Adapter: если на сайте есть страницы, которые отрисовываются по запросу, например форма, нужен адаптер.
Промпт
Мой сайт на Astro нужно выложить на [хостинг: например, GitHub Pages, Netlify или хостинг с загрузкой файлов]. Через astro-docs (инструмент search_astro_docs) найди официальную инструкцию Astro для этой площадки, а если её нет, общий порядок для любого хостинга. Запросы к поиску пиши по-английски. Скажи, что нужно поменять в проекте, собери сайт командой из документации и объясни по шагам, что и куда загрузить. Ничего не загружай и не публикуй без моего «да».

Бесплатно: почта или сразу Телеграм-канал клуба

  • Совет. Отдельных страниц для российских хостингов в документации Astro нет: для них подходит общий порядок, собрать сайт и загрузить содержимое папки dist.
  • Совет. Если хостинг умеет собирать сайт сам из репозитория, в настройках обычно хватает двух строк из документации: команда сборки npm run build и папка dist.

Перенести сайт с WordPress на Astro

Агент найдёт официальную страницу Astro о переносе с WordPress и составит план под твой сайт: что переносится как есть, что придётся переделать и чем заменить плагины.

  1. search_astro_docs по запросу «migrate from WordPress» первым вернул страницу Migrating from WordPress, а рядом раздел о WordPress как источнике записей для сайта на Astro (Headless WordPress & Astro).
  2. Официальные страницы переноса есть для 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 и покажет, что устарело: файл, что не так, ссылку на раздел документации и как исправить.

  1. search_astro_docs по запросу «upgrade to Astro v7 breaking changes» вернул разделы Breaking Changes страниц обновления на v7, v6, v5 и более старые версии.
  2. Полезно, когда сайт писала модель, которая помнит 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, как сделать форму заявки на сайте, и покажи пример кода
Что сделал агент
  1. Claude Code 2.1.235 сам перевёл русский вопрос в два английских запроса к search_astro_docs: «form submission POST request handling» и «Astro Actions form». Каждый ответ - 10 кусков документации, около 22-25 тысяч знаков.
  2. Агент предложил два официальных способа, Actions и API-маршрут, и сразу предупредил: страница с формой должна отрисовываться по запросу, в проекте нужен адаптер сервера. Это совпадает со страницей Actions на docs.astro.build.
  3. Код агента мы собрали на тестовой странице с формой заявки: Astro 7.3.5, адаптер Node 11.1.6. Сборка прошла с первого раза.
  4. Короткое имя и короткое сообщение сервер отклонил с подсказками «Укажите имя» и «Опишите задачу подробнее», правильная заявка дошла до сервера и перевела на страницу «Спасибо».
Результат
Рабочая форма с проверкой полей на сервере за один вопрос агенту, ответ пришёл за 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: текст совпадает.
Версия
Сервер удалённый, версию держит владелец сервиса. Изменения ловим сверкой отпечатка.
Проверить самому
агент прочитает код подключения как недоверенный

Полезные материалы

Журнал проверок

  • 01.10.2026·удалённый·Claude Code, macOS·работает21465bab932515b2

Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.

Похожие подключения

Context7Свежая документация библиотек в агенте: он пишет код по текущей версии, а не по памятиUpstashудалённыйбез ключаNext.js DevToolsАгент сам видит ошибки твоего сайта на Next.js 16 - с файлом и строкой, без копированияVercelна компьютеребез ключа

Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.