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

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

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

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

С MCP-сервером агент сам ищет по документации по ходу работы, а не полагается на то, что помнит.
Добавьте --scope project, чтобы сервер достался всей команде через .mcp.json.

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

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

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

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

См. также