@intlayer/docs 5.5.11 → 5.6.0

package/docs/ru/intlayer_with_vite+solid.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-solid
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-solid-template
 ---
 
 # Начало работы с интернационализацией (i18n) с Intlayer, Vite и Solid
@@ -43,17 +44,17 @@ slugs:
 
 ```bash packageManager="npm"
 npm install intlayer solid-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer solid-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer solid-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**

package/docs/ru/intlayer_with_vite+svelte.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-svelte
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-solid-template
 ---
 
 # Начало работы с интернационализацией (i18n) с Intlayer, Vite и Svelte
@@ -43,17 +44,17 @@ slugs:
 
 ```bash packageManager="npm"
 npm install intlayer svelte-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer svelte-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer svelte-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**

package/docs/ru/intlayer_with_vite+vue.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-vue
+applicationTemplate: https://github.com/aymericzip/intlayer-vite-vue-template
 ---
 
 # Начало работы с интернационализацией (i18n) с Intlayer, Vite и Vue
@@ -41,17 +42,17 @@ slugs:
 
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**
@@ -976,7 +977,7 @@ Intlayer поддерживает рендеринг Markdown-контента
 
 > Чтобы узнать, как объявлять markdown-контент с использованием пакета `intlayer`, смотрите [документацию по markdown](https://github.com/aymericzip/intlayer/tree/main/docs/ru/dictionary/markdown.md).
 
-```ts filename="main.ts"
+```ts fileName="main.ts"
 import MarkdownIt from "markdown-it";
 import { createApp, h } from "vue";
 import { installIntlayer, installIntlayerMarkdown } from "vue-intlayer";

package/docs/ru/mcp_server.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2025-06-07
+updatedAt: 2025-07-11
 title: Документация MCP сервера
-description: Изучите функции и настройку MCP сервера для оптимизации управления и работы вашего сервера.
+description: Изучите возможности и настройку MCP сервера для оптимизации управления и работы вашего сервера.
 keywords:
   - MCP сервер
   - Управление сервером
@@ -10,7 +10,7 @@ keywords:
   - Intlayer
   - Документация
   - Настройка
-  - Функции
+  - Возможности
 slugs:
   - doc
   - mcp-server
@@ -18,31 +18,58 @@ slugs:
 
 # MCP сервер Intlayer
 
-**MCP (Model Context Protocol) сервер Intlayer** предоставляет помощь в IDE с поддержкой ИИ, адаптированную для экосистемы Intlayer. Разработанный для современных сред разработки, таких как **Cursor**, **GitHub Copilot workspace** и любые IDE, поддерживающие протокол MCP, этот сервер обеспечивает контекстную поддержку в реальном времени на основе настроек вашего проекта.
+**MCP сервер Intlayer (Model Context Protocol)** предоставляет помощь в IDE с поддержкой ИИ, адаптированную для экосистемы Intlayer.
 
-## Зачем использовать MCP сервер Intlayer?
+## Где можно использовать?
+
+- В современных средах разработки, таких как **Cursor**, **VS Code** и любой IDE, поддерживающей протокол MCP.
+- В вашем любимом AI-ассистенте, таком как **Claude Desktop**, **Gemini**, **ChatGPT** и др.
+
+## Почему использовать MCP сервер Intlayer?
 
 Включив MCP сервер Intlayer в вашей IDE, вы получаете:
 
-- **Интеллектуальная интеграция CLI**
-  Доступ и запуск команд Intlayer CLI непосредственно из интерфейса вашей IDE. Полный список команд и опций доступен в [документации Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_cli.md).
+- **Контекстно-зависимая документация**  
+  MCP сервер загружает и предоставляет документацию Intlayer. Это ускоряет вашу настройку, миграции и прочее.  
+  Это гарантирует, что предложения кода, параметры команд и объяснения всегда актуальны и релевантны.
+
+- **Умная интеграция CLI**  
+  Получайте доступ и запускайте команды Intlayer CLI прямо из интерфейса вашей IDE. Используя MCP сервер, вы можете позволить вашему AI-ассистенту выполнять команды, такие как `intlayer dictionaries build` для обновления словарей или `intlayer dictionaries fill` для заполнения отсутствующих переводов.
+
+  > Полный список команд и опций смотрите в [документации Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_cli.md).
+
+## Локальный сервер (stdio) против удалённого сервера (SSE)
+
+MCP сервер можно использовать двумя способами:
+
+- Локальный сервер (stdio)
+- Удалённый сервер (SSE)
+
+### Локальный сервер (stdio) (рекомендуется)
+
+Intlayer предоставляет пакет NPM, который можно установить локально на вашем компьютере. Его можно установить в вашей любимой IDE, такой как VS Code, Cursor, а также в вашем локальном помощнике, например ChatGPT, Claude Desktop и др.
 
-- **Контекстно-зависимая документация**
-  MCP сервер загружает и предоставляет документацию, соответствующую версии Intlayer, которую вы используете в своем проекте. Это гарантирует, что предложения кода, параметры команд и объяснения всегда актуальны и релевантны.
+Этот сервер является рекомендуемым способом использования MCP сервера, так как он интегрирует все функции MCP сервера, включая инструменты CLI.
 
-- **Разработка с поддержкой ИИ**
-  С учетом контекста проекта и автозаполнения, ИИ-ассистент может объяснять ваш код, рекомендовать использование CLI или предлагать, как использовать конкретные функции Intlayer на основе текущих файлов.
+### Удалённый сервер (SSE)
 
-- **Легкая и мгновенная настройка**
-  Не требуется обслуживание сервера или тяжелая установка. Просто настройте файл `.cursor/mcp.json` или эквивалентную конфигурацию MCP, и вы готовы к работе.
+MCP сервер также можно использовать удалённо, используя транспортный метод SSE. Этот сервер размещён Intlayer и доступен по адресу https://mcp.intlayer.org. К этому серверу можно получить публичный доступ без аутентификации, и он бесплатен для использования.
+
+Обратите внимание, что удалённый сервер не интегрирует инструменты CLI, автозаполнение AI и т.д. Удалённый сервер предназначен только для взаимодействия с документацией, чтобы помочь вашему AI помощнику с экосистемой Intlayer.
+
+> Из-за затрат на хостинг сервера доступность удалённого сервера не гарантируется. Мы ограничиваем количество одновременных подключений. Рекомендуем использовать локальный сервер (stdio) для наиболее стабильной работы.
 
 ---
 
-## Настройка Cursor
+## Настройка в Cursor
+
+Следуйте [официальной документации](https://docs.cursor.com/context/mcp) для настройки MCP сервера в Cursor.
 
 В корне вашего проекта добавьте следующий конфигурационный файл `.cursor/mcp.json`:
 
-```json
+### Локальный сервер (stdio) (рекомендуется)
+
+```json fileName=".cursor/mcp.json"
 {
   "mcpServers": {
     "intlayer": {
@@ -53,19 +80,36 @@ slugs:
 }
 ```
 
-Это указывает вашей IDE запускать MCP сервер Intlayer с помощью `npx`, гарантируя, что всегда используется последняя доступная версия, если вы явно не зафиксировали другую.
+### Удалённый сервер (SSE)
+
+Для подключения к удалённому MCP серверу Intlayer с использованием Server-Sent Events (SSE) вы можете настроить ваш MCP клиент для подключения к размещённому сервису.
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "transport": "sse"
+    }
+  }
+}
+```
+
+Это указывает вашей IDE запускать MCP сервер Intlayer с помощью `npx`, гарантируя, что всегда используется последняя доступная версия, если вы её не зафиксировали.
 
 ---
 
-## Настройка VS Code
+## Настройка в VS Code
+
+Следуйте [официальной документации](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) для настройки MCP сервера в VS Code.
 
 Чтобы использовать MCP сервер Intlayer с VS Code, необходимо настроить его в настройках рабочего пространства или пользователя.
 
-### Конфигурация рабочего пространства
+### Локальный сервер (stdio) (рекомендуется)
 
 Создайте файл `.vscode/mcp.json` в корне вашего проекта:
 
-```json
+```json fileName=".vscode/mcp.json"
 {
   "servers": {
     "intlayer": {
@@ -77,98 +121,88 @@ slugs:
 }
 ```
 
-### Использование MCP сервера в VS Code
-
-1. **Включите режим агента**: Откройте окно чата (⌃⌘I на Mac, Ctrl+Alt+I на Windows/Linux) и выберите режим **Agent** в выпадающем списке.
-
-2. **Доступ к инструментам**: Нажмите кнопку **Инструменты**, чтобы просмотреть доступные инструменты Intlayer. Вы можете выбирать или отменять выбор конкретных инструментов по необходимости.
+### Удалённый сервер (SSE)
 
-3. **Прямое обращение к инструментам**: Ссылайтесь на инструменты напрямую в ваших запросах, вводя `#`, за которым следует имя инструмента.
+Для подключения к удалённому MCP серверу Intlayer с использованием Server-Sent Events (SSE) вы можете настроить ваш MCP клиент для подключения к размещённому сервису.
 
-4. **Подтверждение запуска инструмента**: По умолчанию VS Code запрашивает подтверждение перед запуском инструментов. Используйте опции кнопки **Продолжить**, чтобы автоматически подтверждать запуск инструментов для текущей сессии, рабочего пространства или всех будущих вызовов.
-
-### Управление сервером
-
-- Выполните команду **MCP: List Servers** через Палитру команд, чтобы просмотреть настроенные серверы
-- Запускайте, останавливайте или перезапускайте MCP сервер Intlayer по мере необходимости
-- Просматривайте логи сервера для устранения неполадок, выбрав сервер и нажав **Показать вывод**
-
-Для получения более подробной информации о интеграции MCP в VS Code смотрите [официальную документацию VS Code MCP](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "type": "sse"
+    }
+  }
+}
+```
 
 ---
 
-## Использование MCP сервера через CLI
+## Настройка в ChatGPT
 
-Вы также можете запускать MCP сервер Intlayer напрямую из командной строки для тестирования, отладки или интеграции с другими инструментами.
+### Удалённый сервер (SSE)
 
-### Установка MCP сервера
+Следуйте [официальной документации](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) для настройки MCP сервера в ChatGPT.
 
-Сначала установите пакет MCP сервера глобально или используйте его через npx:
+1. Перейдите в [панель промптов](https://platform.openai.com/prompts)
+2. Нажмите `+ Create`
+3. Нажмите `Tools (Create or +)`
+4. Выберите `MCP Server`
+5. Нажмите `Add new`
+6. Заполните следующие поля:
 
-```bash
-# Установить глобально
-npm install -g @intlayer/mcp
-
-# Или использовать напрямую через npx (рекомендуется)
-npx @intlayer/mcp
-```
+   - URL: `https://mcp.intlayer.org`
+   - Label: `Intlayer MCP Server`
+   - Name: `intlayer-mcp-server`
+   - Authentication: `None`
 
-### Запуск сервера
+7. Нажмите `Save`
 
-Чтобы запустить MCP сервер с инспектором для отладки и тестирования:
-
-```bash
-# Использование встроенной команды запуска
-npm run start
-
-# Или напрямую через npx
-npx @modelcontextprotocol/inspector npx @intlayer/mcp
-```
-
-Это запустит MCP сервер с интерфейсом инспектора, который позволяет вам:
+---
 
-- Тестировать коммуникации по протоколу MCP
-- Отлаживать ответы сервера
-- Проверять реализации инструментов и ресурсов
-- Мониторить производительность сервера
+## Настройка в Claude Desktop
 
-### Использование в разработке
+Следуйте [официальной документации](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server), чтобы настроить MCP сервер в Claude Desktop.
 
-Для целей разработки и тестирования вы можете запускать сервер в различных режимах:
+Путь к файлу конфигурации:
 
-```bash
-# Сборка и запуск в режиме разработки
-npm run dev
+- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-# Запуск с пользовательской конфигурацией
-node dist/cjs/index.cjs
+### Локальный сервер (stdio) (рекомендуется)
 
-# Тестирование функциональности сервера
-npm test
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
 ```
 
-Сервер будет предоставлять инструменты и ресурсы, специфичные для Intlayer, которые могут использоваться любым клиентом, совместимым с MCP, а не только Cursor или другими IDE.
-
 ---
 
-## Обзор возможностей
+## Использование MCP Server через CLI
 
-| Feature                       | Description                                                                                       |
-| ----------------------------- | ------------------------------------------------------------------------------------------------- |
-| Поддержка CLI                 | Выполняйте команды `intlayer`, получайте подсказки по использованию и аргументам прямо в строке   |
-| Версионированная документация | Автоматическое определение и загрузка документации, соответствующей вашей текущей версии Intlayer |
-| Автозаполнение                | Интеллектуальные предложения команд и конфигураций по мере ввода                                  |
-| Готовность к плагинам         | Совместимость с IDE и инструментами, поддерживающими стандарт MCP                                 |
+Вы также можете запустить сервер Intlayer MCP напрямую из командной строки для тестирования, отладки или интеграции с другими инструментами.
 
----
-
-## Полезные ссылки
+```bash
+# Установить глобально
+npm install -g @intlayer/mcp
 
-- [Документация Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_cli.md)
-- [Репозиторий Intlayer на GitHub](https://github.com/aymericzip/intlayer)
+# Или использовать напрямую через npx (рекомендуется)
+npx @intlayer/mcp
+```
 
 ---
 
 ## История документации
 
-- 5.5.10 - 2025-06-29: Инициализация истории
+| Версия | Дата       | Изменения                                 |
+| ------ | ---------- | ----------------------------------------- |
+| 5.5.12 | 2025-07-11 | Добавлена настройка ChatGPT               |
+| 5.5.12 | 2025-07-10 | Добавлена настройка Claude Desktop        |
+| 5.5.12 | 2025-07-10 | Добавлен SSE транспорт и удалённый сервер |
+| 5.5.10 | 2025-06-29 | Инициализация истории                     |

package/docs/zh/intlayer_CMS.md

@@ -16,6 +16,7 @@ slugs:
   - doc
   - concept
   - cms
+youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
 # Intlayer 内容管理系统 (CMS) 文档