> ## Documentation Index
> Fetch the complete documentation index at: https://veriqa.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Для ИИ-агентов

> Как агент для разработки читает эту документацию: файл навыка, llms.txt, Markdown-версии всех страниц и MCP-сервер документации.

Документация написана для людей и так же доступна агентам для разработки — Claude Code, Cursor,
Copilot и другим. Агенту не нужно разбирать HTML: у каждой страницы есть Markdown-версия, а вся
документация доступна в формах, рассчитанных на загрузку в контекст.

## Что может прочитать агент

| Ресурс | Адрес | Что это |
| - | - | - |
| Файл навыка | [`/docs/skill.md`](https://veriqa.app/docs/skill.md) | Читать первым: что такое Veriqa, как выбрать между двумя механизмами, рецепты типовых задач, ключи конфигурации, частые ошибки и чек-лист перед сдачей работы |
| Оглавление | [`/docs/llms.txt`](https://veriqa.app/docs/llms.txt) | Все страницы с описанием в одну строку, в порядке навигации |
| Полный текст | [`/docs/llms-full.txt`](https://veriqa.app/docs/llms-full.txt) | Вся документация одним файлом |
| Любая страница в Markdown | добавьте `.md` к адресу страницы, например [`/docs/ru/quickstart/dotnet.md`](https://veriqa.app/docs/ru/quickstart/dotnet.md) | Страница без обвязки сайта |
| Поиск по документации | `https://veriqa.app/docs/mcp` | MCP-сервер, который ищет по этой документации |

Файл навыка, оглавление и полный текст — на английском: русских страниц в них нет. Markdown-версия
есть у каждой русской страницы — по её адресу под `/docs/ru/`.

## Подключить MCP-сервер документации

С MCP-сервером агент сам ищет по документации по ходу работы, а не полагается на то, что помнит.

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http veriqa-docs https://veriqa.app/docs/mcp
    ```

    Добавьте `--scope project`, чтобы сервер достался всей команде через `.mcp.json`.
  </Tab>

  <Tab title="Cursor и VS Code">
    Откройте меню в верхней части любой страницы и выберите пункт Cursor или VS Code — редактор
    установит сервер.
  </Tab>

  <Tab title="Другие инструменты">
    Скопируйте адрес MCP-сервера из меню в верхней части любой страницы и вставьте его в настройки
    MCP своего инструмента.
  </Tab>
</Tabs>

## Отдать агенту одну страницу

То же меню в верхней части каждой страницы копирует её в Markdown, открывает Markdown-версию или
начинает разговор в Claude или ChatGPT с этой страницей в контексте. Это самый быстрый способ дать
агенту ровно ту страницу, о которой задача.

## Что сказать агенту

Агент работает лучше, когда в задаче названы механизм и режим развёртывания. Несколько отправных
точек:

* *«Прочитай [https://veriqa.app/docs/skill.md](https://veriqa.app/docs/skill.md) и добавь в это приложение ASP.NET Core вход через
  встроенную Veriqa. Включи только Telegram».*
* *«Прочитай [https://veriqa.app/docs/skill.md](https://veriqa.app/docs/skill.md). Это приложение впускает пользователей через
  self-hosted Veriqa — подключи его как обычный клиент OpenID Connect, пакеты Veriqa не добавляй».*
* *«По [https://veriqa.app/docs/reference/confirmation-api.md](https://veriqa.app/docs/reference/confirmation-api.md) перед выполнением `DeleteProject` попроси
  владельца аккаунта подтвердить удаление и удаляй, только если подтвердил владелец».*

<Note>
  Приложению, которое только впускает пользователей, не нужны ни пакет Veriqa, ни SDK — это обычная
  проверяющая сторона OpenID Connect. Пакеты Veriqa нужны только там, где приложение само *является*
  издателем или вызывает API подтверждений со своего сервера. Агенты часто ошибаются именно здесь —
  если ваше приложение клиент, скажите это в задаче.
</Note>

## См. также

* [Примеры](/docs/ru/samples) — запускаемые проекты, из которых агент может брать код
* [Справочник конфигурации](/docs/ru/reference/configuration)
* [Известные ограничения](/docs/ru/reference/limitations)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.