# Maguyva

Краткие рецепты типичных рабочих процессов с Maguyva MCP: установка клиента, поиск перед правкой, работа с пустыми результатами и несколькими репозиториями.

[llms-full.txt — English documentation and MCP schemas](/llms-full.txt)

Markdown representation of any docs page or blog post: append `.md` to its URL (https://maguyva.ai/ru/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/ru/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/ru/changelog.json).

## Возможности по языкам

Ниже — количественные показатели возможностей, которые обеспечивают структурный поиск, поиск символов, анализ с учётом графа и базовую индексацию.

Эти отметки показывают возможности, включённые в текущей конфигурации языков, а не сквозные оценки качества. Для работы с графом должны быть включены парсер, извлечение символов и извлечение графа. Поддерживаемые типы связей и глубина извлечения зависят от языка.

- Покрытие индексацией: **284**. Каждый указанный язык индексируется для файлового, текстового контекста и контекста репозитория.
- Структурный поиск по AST: **247**. Языки со структурой на основе парсера для AST и рабочих процессов структурного поиска.
- Извлечение символов: **282**. Языки с метаданными символов для определений и поиска.
- Связи графа: **151**. Языки с работающим извлечением связей для поиска с учётом графа. Глубина зависит от языка и типа связи.

- `ast_structural=false`: Текстово-ориентированная индексация с ограниченным учётом структуры.
- `symbol_extraction=false`: Извлечение символов ограничено, поэтому навигация больше опирается на контекст файла и структуры.
- `relationship_extraction=false`: Этот язык индексируется для поиска, но сейчас не сохраняется в графе кода.

[Найдите свой язык](/llms-full.txt)

## Сборник рецептов

Практические рецепты повседневной работы с Maguyva MCP. В каждом рецепте указаны инструменты и последовательность действий — это не полный справочник параметров. Параметры инструментов описаны в разделе «[Справочник MCP API](https://maguyva.ai/ru/docs/mcp-api)». Для первоначальной настройки используйте раздел «[Быстрый старт](https://maguyva.ai/ru/docs/quickstart)».

### Выберите правильный инструмент

Для большинства вопросов начните с одного вызова. Переходите к более сложному поиску, только если первый ответ слишком общий или в нём недостаточно информации.

- `intelligent_search` — начните здесь, чтобы задать вопрос о кодовой базе на естественном языке. По умолчанию auto/balanced направляет вопросы об определениях с уверенно распознанным намерением в структурный поиск, вопросы о ссылках или влиянии — в граф, а запросы на точное совпадение — в текстовый поиск. Для остальных вопросов используются семантический поиск и индексированный текст. Чтобы запросить все четыре поисковые модальности, используйте mode=hybrid или auto с quality=thorough. Явно заданный mode имеет приоритет над quality.
- `find_symbol` — вы уже знаете имя функции, класса или переменной.
- `dependency_search` — область влияния: вызывающий код, код, зависящий от символа, или последствия до и после правки.
- `get_task_context` — незнакомая область кода; один ограниченный набор файлов, символов и зависимостей по описанию задачи.
- `repository_context` — список доступных репозиториев или проверка разрешения имени репозитория.
- `ask_maguyva` с `operation="guidance"` — локальная справка по выбору инструмента и использованию Maguyva (без мутации репо).

## Tools -- Search

- [intelligent_search](https://maguyva.ai/ru/docs/mcp-api#intelligent-search): Start here for any codebase question. Default auto/balanced routes confident definition queries to structural search, reference/impact queries to graph, and exact-match queries to text; other queries use semantic plus text.
- [semantic_search](https://maguyva.ai/ru/docs/mcp-api#semantic-search): Find code by meaning, not exact text. Use for conceptual queries like "retry logic" or "user onboarding flow" when you don't know the keyword or symbol name.
- [text_pattern_search](https://maguyva.ai/ru/docs/mcp-api#text-pattern-search): Search indexed content. Exact and regex modes grep the full file/blob corpus; fuzzy content mode searches the bounded semantic chunk corpus.

## Tools -- Structural & Graph

- [structural_search](https://maguyva.ai/ru/docs/mcp-api#structural-search): Prefer preset=functions|classes|methods|imports|variables (or free pattern=). Find code by AST shape (not text).
- [dependency_search](https://maguyva.ai/ru/docs/mcp-api#dependency-search): Primary blast-radius / graph surface. Answer "what calls this?" / "what does this use?" via the real call/import graph.

## Tools -- Code Analysis

- [find_symbol](https://maguyva.ai/ru/docs/mcp-api#find-symbol): Jump to where a function, class, or variable is defined and used. Use when you know the name (e.g. "getCurrentUser") — faster and more precise than Grep, and it spans the whole indexed repo.
- [analyze_dependencies](https://maguyva.ai/ru/docs/mcp-api#analyze-dependencies): Analyze blast radius using the same traversal as dependency_search (dependents/incoming). Prefer dependency_search with analysis_type="dependents" or "impact" for impact analysis.
- [get_task_context](https://maguyva.ai/ru/docs/mcp-api#get-task-context): Starting work in an unfamiliar area? Describe the task (e.g. "add SSO support", "fix the billing webhook") and get a bounded one-call bundle of relevant files, code, symbols, and dependencies.
- [get_file](https://maguyva.ai/ru/docs/mcp-api#get-file): Read a file from the indexed repo by path. Prefer local file tools for files on disk; use this for remote indexed snapshots.

## Tools -- Utility

- [repository_context](https://maguyva.ai/ru/docs/mcp-api#repository-context): List the repositories you can search, or get identity info on one (namespace/branch, indexed_commit_sha / index freshness). Use action:"list" when the repo slug is unknown; searches accept a known slug directly or default to your key's single repo.
- [ask_maguyva](https://maguyva.ai/ru/docs/mcp-api#ask-maguyva): Get Maguyva tool guidance, or submit a bug report / feature request stored for Maguyva's maintainers. Never include secrets or sensitive personal data in feedback.

## Следующие шаги

- [Быстрый старт](https://maguyva.ai/ru/docs/quickstart)
- [Руководство по установке](https://maguyva.ai/ru/docs/installation)
- [Справочник MCP API](https://maguyva.ai/ru/docs/mcp-api)
- [Устранение неполадок](https://maguyva.ai/ru/docs/troubleshooting)
- [Как это работает](https://maguyva.ai/ru/docs/how-it-works)
- [Совместимость и технические характеристики](https://maguyva.ai/ru/docs/compatibility)

## Agent integrations

- [Maguyva для Cursor: контекст кодовой базы через MCP](https://maguyva.ai/ru/for-cursor): Cursor редактирует открытый файл; Maguyva индексирует весь монорепозиторий и предоставляет этот контекст через MCP — семантический, AST, графовый и текстовый поиск с указанием file:line, так что агент находит файлы, которые вы не закрепили.
- [Maguyva для Windsurf: контекст кодовой базы через MCP](https://maguyva.ai/ru/for-windsurf): Windsurf и Cascade редактируют открытый файл; Maguyva индексирует весь монорепозиторий и предоставляет этот контекст через MCP — семантический, AST, графовый и текстовый поиск с file:line, так что Cascade находит файлы, которые вы не упомянули.
- [Maguyva для Antigravity: контекст кодовой базы через MCP](https://maguyva.ai/ru/for-antigravity): Antigravity запускает автономных агентов в редакторе, терминале и браузере; Maguyva даёт им карту монорепозитория с возможностью запроса через MCP — радиус влияния известен заранее, а не после того, как CI покраснеет.
- [Maguyva для Codex: контекст кодовой базы через MCP](https://maguyva.ai/ru/for-codex): AGENTS.md — это рабочее соглашение. Maguyva — это MCP-сервер, который даёт Codex CLI доступную для запросов карту репозитория, чтобы первое изменение не было догадкой.
- [Maguyva для любого MCP-клиента: контекст кодовой базы через MCP](https://maguyva.ai/ru/for-anything): MCP — открытый протокол. Maguyva — стандартный MCP-сервер, поэтому клиенты с поддержкой MCP, такие как Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity, получают один и тот же контекст, основанный на реальной кодовой базе.
- [Maguyva для Gemini CLI: контекст кодовой базы через MCP](https://maguyva.ai/ru/for-gemini): GEMINI.md задаёт рабочий контекст; MCP — это канал связи. Maguyva — это MCP-сервер, который даёт Gemini CLI карту вашего репозитория с возможностью поиска — семантический, AST и графовый поиск, чтобы первая правка не была догадкой.
- [Maguyva для Claude Code: контекст кодовой базы через MCP](https://maguyva.ai/ru/for-claude-code): CLAUDE.md сообщает Claude, как себя вести. Maguyva индексирует репозиторий и предоставляет его через MCP, чтобы Claude Code редактировал на основе доступной для запросов карты.
- [Maguyva для GitHub Copilot CLI: контекст кода через MCP](https://maguyva.ai/ru/for-copilot): Пользовательские инструкции сообщают Copilot, как себя вести. Maguyva индексирует репозиторий и предоставляет его через MCP, чтобы GitHub Copilot CLI редактировал на основе карты.

## Company

- [О Maguyva: интеллект кода через MCP](https://maguyva.ai/ru/about): Интеллект кода для кодирующих агентов: семантический, AST-, графовый и полнотекстовый поиск, поиск символов, анализ зависимостей и контекст задачи за один вызов на более чем 284 языках.
- [Знакомьтесь с командой: 2 человека + рой ИИ-агентов](https://maguyva.ai/ru/team)
- [Как мы работаем: без венчурных денег, без платы за пользователя, без платной разблокировки функций](https://maguyva.ai/ru/how): Никакого стороннего капитала. Никакой платы за пользователя. Ваши данные — не товар. Как устроен Maguyva и почему цены именно такие.
- [Технологический стек: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/ru/stack): Технический стек, на котором работает Maguyva. PostgreSQL, эмбеддинги Voyage AI, квантованный векторный поиск, AST на основе tree-sitter и протокол MCP.
- [Список изменений](https://maguyva.ai/ru/changelog): Что вышло в Maguyva: изменения продукта, обновления индекса и инструментов MCP, а также заметки о разработке. Сначала новые.
- [В прямом эфире: Maguyva строит себя в реальном времени](https://maguyva.ai/ru/live): Никакой постановочной демонстрации. Это реальный журнал диспетчеризации — каждый вызов инструмента, сбой и коммит команды ИИ-агентов, которые в прямом эфире строят Maguyva.

## Guides

- [Не полнотекстовый поиск под прикрытием. Пять слитых воедино режимов поиска.](https://maguyva.ai/ru/beyond-rag): Коду нужно больше, чем семантические фрагменты. Maguyva объединяет пять режимов поиска в один ранжированный ответ, с опорой на реальный код репозитория — через MCP, на 284 языках. Тариф Free, без банковской карты.
- [Файлы с инструкциями — не карта вашего кода. Maguyva — карта.](https://maguyva.ai/ru/beyond-rules-files): CLAUDE.md и AGENTS.md говорят агенту, как себя вести. Они не говорят, что находится в кодовой базе. Maguyva — это слой контекста кодовой базы поверх MCP, на 284 языках. Тариф Free, без банковской карты.
- [Внести правку легко. Понять, что сломается, — сложно. Maguyva строит карту.](https://maguyva.ai/ru/know-what-breaks): Перед рефакторингом ваш агент должен знать все места вызова и импорта, а также весь код, зависящий от изменяемого кода. Maguyva отвечает на это по реальному графу вызовов через MCP, а не через grep. Тариф Free, без банковской карты.
- [Начните бесплатно: слой контекста кодовой базы для ИИ-агентов разработки](https://maguyva.ai/ru/map-then-change): Сначала карта. Потом изменения. Maguyva даёт вашему ИИ-агенту карту кодовой базы с возможностью поиска через MCP ещё до первой правки. 11 инструментов на 284 языках. Тариф Free, без банковской карты.
- [Ваш агент начинает работу с репозиторием вслепую. Maguyva даёт ему карту.](https://maguyva.ai/ru/stop-flying-blind): Агенты для разработки сканируют не те файлы и правят код раньше, чем успевают его понять. Maguyva даёт вашему агенту карту кодовой базы с возможностью поиска через MCP на 284 языках. Тариф Free, без банковской карты.