# Используйте документацию с ИИ
{% columns %}
{% column width="41.66666666666667%" %}
На каждой странице в документации Navixy есть встроенные ярлыки для работы с ИИ-ассистентами. Используйте их, чтобы копировать содержимое, открывать страницы напрямую в ChatGPT или Claude, либо подключать документацию напрямую к вашим ИИ-инструментам через MCP.
{% endcolumn %}
{% column width="58.33333333333333%" %}
{% endcolumn %}
{% endcolumns %}
## Встроенные ярлыки страницы
| Ярлык | Что он делает | Когда его использовать |
| --------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Копировать страницу** | Копирует всю страницу в формате Markdown | Вставить полный контекст в любой ИИ-ассистент |
| **Просмотреть как Markdown** | Открывает страницу как обычный текст в новой вкладке | Просмотреть исходный текст или вручную скопировать отдельные разделы |
| **Копировать** (в кодовых блоках) | Копирует кодовый блок напрямую | Используйте для `curl` команд, JSON-полей и фрагментов конфигурации, чтобы избежать ошибок при выделении |
| **Открыть в ChatGPT** | Открывает страницу в ChatGPT с предварительно загруженным содержимым | Задавать вопросы или делать краткое изложение, ничего не вставляя |
| **Открыть в Claude** | Открывает страницу в Claude с предварительно загруженным содержимым | Задавать вопросы или делать краткое изложение, ничего не вставляя |
| **Экспортировать в PDF** | Скачивает страницу в формате PDF | Сохранить снимок для автономного использования или для передачи вне документации |
### Использование Open in ChatGPT и Open in Claude
Оба ярлыка автоматически передают текущую страницу в качестве контекста. Вы можете сразу начинать вводить запросы, без копирования и вставки. Это полезно, когда вам нужен быстрый ответ по конкретной странице без ручного переключения между инструментами.
{% columns %}
{% column %}
**Хорошие запросы для начала:**
* Кратко изложи эту страницу, прежде чем я прочитаю её полностью.
* Преврати это в чек-лист предварительных требований.
* Сгенерируй крайние случаи и идеи для тестов на основе этого материала.
* Объясни, что делает \[parameter] и когда я бы изменил его.
{% endcolumn %}
{% column %}
**Как получить лучший результат:**
Добавьте ограничение, чтобы сформировать ответ. Попросите только «шаги», «вернуть JSON» или «сначала предположения». Если страница длинная, уточните, на каком разделе ассистент должен сосредоточиться.
{% endcolumn %}
{% endcolumns %}
## Подключение MCP-сервера к вашим ИИ-инструментам
Встроенные ярлыки страницы выше хорошо работают, когда нужная страница уже открыта. MCP (Model Context Protocol) идёт дальше: он позволяет вашему ИИ-инструменту по запросу находить и извлекать любую страницу из документации Navixy, без необходимости сначала искать и открывать её вручную. Это особенно полезно во время активной разработки, когда вы за одну сессию переходите между несколькими API-справочниками, конфигурациями устройств и руководствами по интеграции.
После подключения ваш ИИ-инструмент получает ответы напрямую из опубликованной документации и может ссылаться на конкретные использованные разделы.
### MCP-эндпоинт
MCP-сервер публичный и не требует аутентификации:
```
https://navixy.com/docs/~gitbook/mcp
```
Вы также можете скопировать этот URL прямо из **Подключить через MCP** пункта в меню ярлыков страницы.
### Подключить MCP-сервер
Используйте приведённую ниже конфигурацию для большинства распространённых инструментов. MCP работает с любым клиентом, который поддерживает `mcpServers` конфигурацию.
{% tabs %}
{% tab title="Claude Desktop" %}
{% hint style="info" %}
См. [официальную документацию Claude](https://code.claude.com/docs/en/mcp) для получения актуальной информации об использовании MCP с Claude.
{% endhint %}
1. В Claude перейдите в **Настройки** и выберите **Developer**.
2. Выберите **Edit Config** чтобы открыть `claude_desktop_config.json`, затем добавьте следующее:
```json
{
"mcpServers": {
"navixy-docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://navixy.com/docs/~gitbook/mcp"
]
}
}
}
```
3. Полностью закройте Claude и запустите его снова. Простого обновления окна недостаточно.
{% endtab %}
{% tab title="Cursor" %}
{% hint style="info" %}
См. [официальную документацию Cursor](https://cursor.com/docs/mcp) для получения актуальной информации об использовании MCP с Cursor.
{% endhint %}
1\. Перейдите в **Настройки**, откройте вкладку **MCP** и выберите **Add new global MCP server**. Это откроет `~/.cursor/mcp.json`. Для настройки на уровне проекта создайте или отредактируйте `.cursor/mcp.json` в корне вашего проекта.
2. Вставьте в файл следующее:
```json
{
"mcpServers": {
"navixy-docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://navixy.com/docs/~gitbook/mcp"
]
}
}
}
```
3. Полностью закройте Cursor и запустите его снова. Простого обновления окна недостаточно.
{% endtab %}
{% tab title="VS Code" %}
{% hint style="info" %}
См. [официальную документацию VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) для получения актуальной информации об использовании MCP с VS Code.
{% endhint %}
Если вы используете VS Code, это самый быстрый путь настройки. Выберите **Connect to VSCode** в меню ярлыков страницы. Откроется запрос на установку MCP-сервера напрямую в вашу среду VS Code без ручной конфигурации.
1. Откройте VS Code и перейдите к настройкам расширения вашего ИИ-ассистента.
* Если расширение поддерживает `mcpServers` конфигурацию, вставьте:
```json
{
"mcpServers": {
"navixy-docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://navixy.com/docs/~gitbook/mcp"
]
}
}
}
```
* Если расширение поддерживает прямые HTTP MCP-эндпоинты, вместо этого используйте URL:
```
https://www.navixy.com/docs/~gitbook/mcp
```
Используйте тот способ, который описан в документации вашего расширения.
2. Полностью закройте VS Code и запустите его снова.
{% endtab %}
{% tab title="Другие IDE" %}
Если ваш инструмент поддерживает MCP через локальную команду, вставьте следующую конфигурацию:
```json
{
"mcpServers": {
"navixy-docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://navixy.com/docs/~gitbook/mcp"
]
}
}
}
```
Если он напрямую поддерживает MCP по HTTP, вместо этого используйте URL эндпоинта:
```
https://www.navixy.com/docs/~gitbook/mcp
```
В обоих случаях после добавления сервера полностью перезапустите инструмент.
{% endtab %}
{% endtabs %}
### Проверьте подключение MCP
После настройки выполните этот запрос, чтобы убедиться, что сервер отвечает:
```
Используйте docs MCP server navixy-docs.
Какие страницы охватывают потоки IoT Logic?
Перечислите найденные страницы и добавьте ссылку на каждую.
```
Если ответ содержит ссылки на конкретные страницы документации Navixy, подключение работает. После подтверждения вы можете попросить ассистента получить любую страницу, найти эндпоинты или проследить полный рабочий процесс по нескольким разделам документации.
## Устранение неполадок
**После добавления сервера ничего не изменилось.** Полностью перезапустите инструмент. Закройте приложение и откройте его снова. Простого обновления окна недостаточно.
**Ассистент отвечает, но не указывает источники.** Попросите ссылки явно. Вы также можете попросить его процитировать короткую фразу из раздела, на который он сослался, чтобы подтвердить, что был получен правильный контент.
**Вставленный контент выглядит повреждённым.** Проверьте наличие перенесённых строк. Чаще всего это происходит с `curl` командами и длинными API-путями, скопированными из документации.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://navixy.com/docs/home/ru/dokumentaciya-navixy/ispolzuite-dokumentaciyu-s-ii.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.