# 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/uk/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/uk/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/uk/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/uk/docs/mcp-api)». Для першого налаштування скористайтеся розділом «[Швидкий старт](https://maguyva.ai/uk/docs/quickstart)».

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

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

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

## Tools -- Search

- [intelligent_search](https://maguyva.ai/uk/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/uk/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/uk/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/uk/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/uk/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/uk/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/uk/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/uk/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/uk/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/uk/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/uk/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/uk/docs/quickstart)
- [Посібник зі встановлення](https://maguyva.ai/uk/docs/installation)
- [Довідник MCP API](https://maguyva.ai/uk/docs/mcp-api)
- [Усунення несправностей](https://maguyva.ai/uk/docs/troubleshooting)
- [Як це працює](https://maguyva.ai/uk/docs/how-it-works)
- [Сумісність і технічні характеристики](https://maguyva.ai/uk/docs/compatibility)

## Agent integrations

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

## Company

- [Про Maguyva: інтелект коду через MCP](https://maguyva.ai/uk/about): Інтелект коду для кодуючих агентів: семантичний, AST-, графовий та повнотекстовий пошук, пошук символів, аналіз залежностей та контекст завдання за один виклик у понад 284 мовах.
- [Знайомтеся з командою: 2 людини + рій AI-агентів](https://maguyva.ai/uk/team)
- [Як ми працюємо: без венчурного капіталу, оплати за користувача й доплат за функції](https://maguyva.ai/uk/how): Без зовнішнього капіталу. Без оплати за користувача. Ваші дані — не товар. Як створено Maguyva і чому ціни саме такі.
- [Технологічний стек: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/uk/stack): Технічний стек, на якому працює Maguyva. PostgreSQL, ембединги Voyage AI, квантований векторний пошук, AST від tree-sitter та протокол MCP.
- [Журнал змін](https://maguyva.ai/uk/changelog): Що вийшло в Maguyva: зміни продукту, оновлення індексу та інструментів MCP, а також нотатки з розробки. Спочатку новіші.
- [Наживо: Maguyva будує сама себе в реальному часі](https://maguyva.ai/uk/live): Це не постановочне демо. Це справжній журнал диспетчеризації — кожен виклик інструмента, збій і коміт від команди AI-агентів, які будують Maguyva, наживо.

## Guides

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