withastro · yanthomasdev · Jun 23, 2026 · May 27, 2026 · Jun 23, 2026 · Jun 23, 2026
diff --git a/src/content/docs/ru/guides/build-with-ai.mdx b/src/content/docs/ru/guides/build-with-ai.mdx
@@ -9,9 +9,11 @@ i18nReady: true
 description: Ресурсы и советы по созданию сайтов на Astro с помощью ИИ
 ---
 
+import Since from '~/components/Since.astro';
+import ReadMore from '~/components/ReadMore.astro';
 import { Steps, LinkButton, Card, Tabs, TabItem } from '@astrojs/starlight/components';
 
-Редакторы с поддержкой ИИ и инструменты агентного программирования обычно хорошо знакомы с основными API и концепциями Astro. Однако некоторые из них могут использовать устаревшие API и не знать о новых функциях или последних изменениях в фреймворке.
+Редакторы с поддержкой ИИ и инструменты агентного программирования обычно хорошо знакомы с основными API и концепциями Astro. Однако некоторые из них могут использовать устаревшие API и не знать о новых функциях или последних изменениях во фреймворке.
 
 Это руководство описывает, как улучшить инструменты ИИ с помощью актуальных знаний об Astro и предоставляет лучшие практики для создания сайтов на Astro с использованием ИИ.
 
@@ -43,7 +45,7 @@ MCP-сервер Astro Docs использует API [kapa.ai](https://www.kapa.
 
 <Tabs>
   <TabItem label="Потоковый HTTP">
-    ```json title="mcp.json" {3-6}
+    ```json title="Конфигурация MCP" {3-6}
     {
       "mcpServers": {
         "Astro docs": {
@@ -55,7 +57,7 @@ MCP-сервер Astro Docs использует API [kapa.ai](https://www.kapa.
     ```
   </TabItem>
   <TabItem label="Локальный прокси">
-    ```json title="mcp.json" {3-7}
+    ```json title="Конфигурация MCP" {3-7}
     {
       "mcpServers": {
         "Astro docs": {
@@ -105,6 +107,20 @@ Claude Code также предоставляет GitHub Action, который
 
 [Подробнее об использовании MCP-серверов с Claude Code GitHub Action](https://github.com/anthropics/claude-code-action?tab=readme-ov-file#using-custom-mcp-configuration)
 
+#### Codex CLI
+
+Codex CLI — это инструмент для программирования с ИИ, работающий в командной строке, который может использовать MCP сервер Astro Docs для доступа к документации при генерации кода Astro.
+
+Вы можете настроить MCP-сервера глобально в файле `~/.codex/config.toml` или в файле `.codex/config.toml` в корне проекта.
+
+```toml title="~/.codex/config.toml"
+[mcp_servers.astro-docs]
+command = "npx"
+args = ["-y", "mcp-remote", "https://mcp.docs.astro.build/mcp"]
+```
+
+[Подробнее об использовании MCP-серверов с Codex CLI](https://developers.openai.com/codex/mcp)
+
 #### Cursor
 
 [Cursor](https://cursor.com/) — это редактор кода с ИИ. Добавление MCP-сервера Astro Docs позволяет Cursor использовать последнюю документацию Astro при выполнении задач разработки.
@@ -205,31 +221,51 @@ Gemini CLI — это инструмент командной строки дл
 {
   "mcpServers": {
     "Astro docs": {
-      "httpUrl": "https://mcp.docs.astro.build/mcp",
+      "serverUrl": "https://mcp.docs.astro.build/mcp",
     }
   }
 }
 ``` 
 
 [Подробнее об использовании MCP-серверов с Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md)
 
+#### Google Antigravity
+
+[Google Antigravity](https://antigravity.google/) — это агентная платформа для разработки.
+
+<Steps>
+
+1. Откройте `~/.gemini/antigravity/mcp_config.json` следуя инструкциям [руководства по подключению пользовательских MCP-серверов](https://antigravity.google/docs/mcp#connecting-custom-mcp-servers).
+2. Добавьте следующую конфигурацию в `mcp_config.json`:
+   ```json title="mcp_config.json" {3-5}
+   {
+     "mcpServers": {
+       "astro-docs": {
+         "serverUrl": "https://mcp.docs.astro.build/mcp"
+       }
+     }
+    }
+    ```
+3. Сохраните файл и нажмите "Refresh" во вкладке "Manage MCPs".
+
+</Steps>
+
 #### Zed
 
 [Zed](https://zed.dev/) поддерживает MCP-серверы при использовании его ИИ-возможностей. Он может использовать MCP-сервер Astro Docs для доступа к документации при выполнении задач программирования.
 
-Zed не поддерживает потоковый HTTP, поэтому требуется конфигурация локального прокси:
-
 <Steps>
 
 1. Откройте файл `~/.config/zed/settings.json` в вашем редакторе.
 2. Добавьте следующую конфигурацию в настройки MCP Zed:
 
-   ```json title="Конфигурация MCP" {3-6}
+   ```json title="Конфигурация MCP" {3-7}
    {
      "context_servers": {
        "Astro docs": {
-         "command": "npx",
-         "args": ["-y", "mcp-remote", "https://mcp.docs.astro.build/mcp"]
+         "settings": {},
+         "enabled": true,
+         "url": "https://mcp.docs.astro.build/mcp"
        }
      }
    }
@@ -242,22 +278,61 @@ Zed не поддерживает потоковый HTTP, поэтому тре
 
 #### ChatGPT
 
-:::caution[Ограниченная доступность]
-Интеграция с MCP-сервером доступна только для пользователей ChatGPT Pro, Team и Enterprise. Процесс настройки сложнее, чем для других инструментов.
-:::
-
 Обратитесь к [документации OpenAI по MCP](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) для получения конкретных инструкций по настройке.
 
 #### Raycast
 
-[Raycast](https://www.raycast.com/) может подключаться к MCP-серверам для улучшения своих ИИ-возможностей. Для использования ИИ-функций, таких как MCP, требуется аккаунт [Raycast Pro](https://www.raycast.com/pro), поэтому убедитесь, что вы обновили аккаунт перед установкой. Добавление MCP-сервера Astro Docs позволяет Raycast использовать последнюю документацию Astro при ответах на вопросы.
+[Raycast](https://www.raycast.com/) может подключаться к MCP-серверам для улучшения своих ИИ-возможностей. Для использования ИИ-функций, таких, как MCP, требуется аккаунт [Raycast Pro](https://www.raycast.com/pro), поэтому убедитесь, что вы обновили аккаунт перед установкой. Добавление MCP-сервера Astro Docs позволяет Raycast использовать последнюю документацию Astro при ответах на вопросы.
 
 Установка по кнопке ниже:
 
 <LinkButton href="raycast://mcp/install?%7B%22name%22%3A%22Astro%20docs%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%20%22mcp-remote%22%2C%20%22https%3A%2F%2Fmcp.docs.astro.build%2Fmcp%22%5D%7D">Добавить в Raycast</LinkButton>
 
 [Подробнее об использовании MCP-серверов с Raycast](https://manual.raycast.com/model-context-protocol)
 
+#### Opencode AI
+
+[Opencode AI](https://opencode.ai/) — это консольный инструмент программирования с ИИ с открытым исходным кодом, который может использовать MCP сервер Astro Docs для доступа к документации при генерации кода Astro.
+
+Вы можете настроить MCP-сервера в своём конфигурационном файле Opencode, обычно с названием `opencode.json`, расположенном в корне вашего проекта или вашем каталоге глобальной конфигурации (например, `~/.config/opencode/opencode.json`).
+
+```json title="MCP Configuration"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "Astro docs": {
+      "type": "remote",
+      "url": "https://mcp.docs.astro.build/mcp",
+      "enabled": true
+    }
+  }
+}
+
+```
+
+[Подробнее об использовании Opencode AI](https://opencode.ai/)
+
+#### GitHub Copilot Coding Agent
+
+[GitHub Copilot](https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent) можно использовать как coding agent на базе GitHub Actions. Включение MCP-сервера Astro Docs позволяет ему получать доступ к актуальной документации Astro при ответах на вопросы или выполнении задач по программированию.
+
+Вы можете настроить его на использование MCP-сервера Astro Docs для доступа к документации, добавив следующее в настройки Copilot coding agent вашего репозитория, доступные по адресу `https://github.com/<your-org>/<your-repo>/settings/copilot/coding_agent`:
+
+```json title="MCP Configuration"
+{
+  "mcpServers": {
+    "astro-docs": {
+      "type": "http",
+      "url": "https://mcp.docs.astro.build/mcp",
+      "tools": ["mcp__astro-docs__search_astro_docs"]
+    }
+  }
+}
+```
+
+Подробнее о [расширении GitHub Copilot coding agent с помощью MCP-серверов](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp).
+
+
 ### Использование
 
 После настройки вы можете задавать своему инструменту ИИ вопросы об Astro, и он будет получать информацию непосредственно из последней документации. Агенты программирования смогут обращаться к актуальной документации при выполнении задач, а чат-боты смогут точно отвечать на вопросы о функциях, API и лучших практиках Astro.
@@ -284,9 +359,31 @@ MCP-сервер Astro Docs предоставляет доступ к теку
 
 **Беседы с чат-ботом публичны и подчиняются тем же правилам сервера относительно языка и поведения, что и другие каналы**, но волонтёры поддержки не посещают их активно. Для помощи от сообщества создайте тред в обычном канале `#support`.
 
+## Фоновый режим
+
+<p><Since v="7.0.0" /></p>
+
+При обнаружении ИИ-агента для программирования, `astro dev` автоматически запускает dev-сервер как отдельный фоновый процесс. Это предотвращает блокировку dev-сервером терминала агента и позволяет ему продолжать работу во время работы сервера.
+
+При запуске dev-сервера создаётся lock-файл (`.astro/dev.json`), в который записываются URL-адрес сервера, порт и PID. Это предотвращает запуск нескольких серверов для одного и того же проекта.
+
+Если вы не используете ИИ-агента для программирования, то `astro dev` запускается как приоритетный процесс и выводится в терминале.
+
+Для того, чтобы отключить фоновый режим, установите переменную окружения `ASTRO_DEV_BACKGROUND` перед запуском `astro dev`:
+
+```shell
+ASTRO_DEV_BACKGROUND=0 astro dev
+```
+
+<ReadMore>См. [справочник по CLI](/ru/reference/cli-reference/#astro-dev) с полным списком флагов и подкомманд для `astro dev`.</ReadMore>
+
+### Health эндпойнт
+
+Dev-сервер добавляет эндпойнт `/_astro/status`, который возвращает JSON-ответ `{"ok": true}`. Он позволяет агентам и другим инструментам проверять готов ли dev-сервер принимать запросы. Этот эндпойнт доступен только в dev-сервере и не присутствует в продакшен-сборках.
+
 ## Советы по разработке на Astro с использованием ИИ
 
 - **Начинайте с шаблонов**: Вместо создания с нуля просите инструменты ИИ использовать существующий [шаблон Astro](https://astro.build/themes/) или команду `npm create astro@latest` с опцией `template`.
 - **Используйте `astro add` для интеграций**: Просите инструменты ИИ использовать `astro add` для официальных интеграций (например, `astro add tailwind`, `astro add react`). Для других пакетов используйте команду вашего менеджера пакетов вместо прямого редактирования `package.json`.
-- **Проверяйте актуальные API**: Инструменты ИИ могут использовать устаревшие шаблоны. Просите их проверять последнюю документацию, особенно для новых функций, таких как сессии и действия. Это также важно для функций, которые значительно изменились с момента их выпуска, например, коллекции контента, или ранее экспериментальных функций, которые больше не являются экспериментальными.
+- **Проверяйте актуальные API**: Инструменты ИИ могут использовать устаревшие шаблоны. Просите их проверять последнюю документацию, особенно для новых функций, таких как сессии и действия. Это также важно для функций, которые значительно изменились с момента их выпуска. Например, коллекции контента, или ранее экспериментальных функций, которые больше не являются экспериментальными.
 - **Используйте правила проекта**: Если ваш инструмент ИИ поддерживает это, настройте правила проекта для соблюдения лучших практик и стандартов кодирования, таких как указанные выше.