# Maguyva

Krátké recepty pro běžné pracovní postupy Maguyva MCP: instalace klienta, vyhledávání před úpravou, prázdné výsledky a práce s více repo.

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

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

## Možnosti jazyků

Níže jsou počty schopností, které pohánějí strukturální vyhledávání, vyhledávání symbolů, analýzu využívající graf a základní indexování.

Tyto příznaky ukazují schopnosti povolené v aktuální konfiguraci jazyků, nikoli výsledky hodnocení kvality celého zpracování. Dostupnost grafu vyžaduje povolený parser, extrakci symbolů a extrakci grafu. Podporované typy vztahů a hloubka extrakce se liší podle jazyka.

- Indexované pokrytí: **284**. Každý uvedený jazyk je indexován pro kontext souboru, textu a repozitáře.
- Strukturální vyhledávání AST: **247**. Jazyky se strukturou podloženou parserem pro workflow AST a strukturálního vyhledávání.
- Extrakce symbolů: **282**. Jazyky s metadaty symbolů pro definice a vyhledávání.
- Grafové vztahy: **151**. Jazyky s funkční extrakcí vztahů pro vyhledávání využívající graf. Hloubka se liší podle jazyka a typu vztahu.

- `ast_structural=false`: Indexace orientovaná na text s lehčím strukturálním povědomím.
- `symbol_extraction=false`: Extrakce symbolů je omezená, takže navigace se víc opírá o kontext souboru a struktury.
- `relationship_extraction=false`: Tento jazyk je indexován pro vyhledávání, ale v současnosti se neukládá do grafu kódu.

[Najděte svůj jazyk](/llms-full.txt)

## Praktické návody

Praktické návody pro každodenní práci s Maguyva MCP. Každý popisuje nástroje a pořadí kroků — nenahrazuje úplnou referenční příručku parametrů. Parametry nástrojů najdete v [Referenční příručka MCP API](https://maguyva.ai/cs/docs/mcp-api). Při prvním nastavení použijte [Rychlý start](https://maguyva.ai/cs/docs/quickstart).

### Vyberte si správný nástroj

Většina otázek začíná jedním voláním nástroje. Eskalujte pouze tehdy, když je první odpověď příliš široká nebo příliš stručná.

- `intelligent_search` — zde začněte s otázkou o kódu položenou přirozeným jazykem. Výchozí auto/balanced směruje dotazy, u nichž s vysokou jistotou rozpozná hledání definice, na strukturální vyhledávání, dotazy na reference nebo dopady do grafu a dotazy na přesnou shodu na textové vyhledávání. Ostatní dotazy využívají sémantický význam a indexovaný text. Pomocí mode=hybrid nebo auto s quality=thorough požádejte o všechny čtyři modality vyhledávání. Výslovně zvolený režim má přednost před nastavením quality.
- `find_symbol` — již znáte název funkce, třídy nebo proměnné.
- `dependency_search` — rozsah dopadu: volající, závislé části nebo dopad před (a po) úpravě.
- `get_task_context` — neznámá oblast; jeden ohraničený svazek souborů, symbolů a závislostí pro popis úlohy.
- `repository_context` — seznam přístupných úložišť nebo kontrola, jak se překládá název úložiště.
- `ask_maguyva` s `operation="guidance"` — místní nápověda k výběru nástroje a použití Maguyva (žádná změna repozitáře).

## Tools -- Search

- [intelligent_search](https://maguyva.ai/cs/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/cs/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/cs/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/cs/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/cs/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/cs/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/cs/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/cs/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/cs/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/cs/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/cs/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.

## Další kroky

- [Rychlý start](https://maguyva.ai/cs/docs/quickstart)
- [Průvodce instalací](https://maguyva.ai/cs/docs/installation)
- [Referenční příručka MCP API](https://maguyva.ai/cs/docs/mcp-api)
- [Řešení problémů](https://maguyva.ai/cs/docs/troubleshooting)
- [Jak to funguje](https://maguyva.ai/cs/docs/how-it-works)
- [Kompatibilita a technické specifikace](https://maguyva.ai/cs/docs/compatibility)

## Agent integrations

- [Maguyva pro Cursor: kontext codebase přes MCP](https://maguyva.ai/cs/for-cursor): Cursor edituje otevřený soubor; Maguyva indexuje celé monorepo a vrací ho přes MCP — sémantické, AST, grafové a textové vyhledávání s file:line, aby agent našel soubory, které jsi nepřipnul.
- [Maguyva pro Windsurf: kontext codebase přes MCP](https://maguyva.ai/cs/for-windsurf): Windsurf a Cascade editují otevřený soubor; Maguyva indexuje celé monorepo a vrací ho přes MCP — sémantika, AST, graf a text s file:line, aby Cascade našel soubory, které jsi nezmínil.
- [Maguyva pro Antigravity: kontext codebase přes MCP](https://maguyva.ai/cs/for-antigravity): Antigravity spouští autonomní agenty napříč editorem, terminálem a prohlížečem; Maguyva jim přes MCP dává prohledávatelnou mapu monorepa — dosah dopadu předem, ne až po tom, co CI zčervená.
- [Maguyva pro Codex: kontext codebase přes MCP](https://maguyva.ai/cs/for-codex): AGENTS.md je pracovní dohoda. Maguyva je MCP server, který dává Codex CLI prohledávatelnou mapu repozitáře, aby první úprava nebyla odhad.
- [Maguyva pro jakéhokoli MCP klienta: kontext codebase přes MCP](https://maguyva.ai/cs/for-anything): MCP je otevřený protokol. Maguyva je standardní MCP server, takže klienti s podporou MCP jako Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity dostávají stejný podložený kontext codebase.
- [Maguyva pro Gemini CLI: kontext codebase přes MCP](https://maguyva.ai/cs/for-gemini): GEMINI.md nastavuje pracovní kontext; MCP je kanál. Maguyva je MCP server, který Gemini CLI dává prohledávatelnou mapu tvého repozitáře — sémantické, AST a grafové vyhledávání, aby první edit nebyl odhad.
- [Maguyva pro Claude Code: kontext codebase přes MCP](https://maguyva.ai/cs/for-claude-code): CLAUDE.md říká Claudovi, jak se má chovat. Maguyva indexuje repozitář a poskytuje ho přes MCP, aby Claude Code upravoval na základě prohledávatelné mapy.
- [Maguyva pro GitHub Copilot CLI: kontext kódu přes MCP](https://maguyva.ai/cs/for-copilot): Vlastní instrukce říkají Copilotu, jak se má chovat. Maguyva indexuje repozitář a poskytuje ho přes MCP, aby GitHub Copilot CLI upravoval na základě mapy.

## Company

- [O Maguyva: inteligence kódu přes MCP](https://maguyva.ai/cs/about): Inteligence kódu pro kódovací agenty: sémantické, AST, grafové a fulltextové vyhledávání, vyhledávání symbolů, analýza závislostí a kontext úkolu na jeden dotaz napříč více než 284 jazyky.
- [Poznejte tým: 2 lidé + roj AI agentů](https://maguyva.ai/cs/team)
- [Jak pracujeme: žádné VC, žádné poplatky za uživatele, žádné zamčené funkce](https://maguyva.ai/cs/how): Žádný externí kapitál. Žádné poplatky za uživatele. Vaše data nejsou produkt. Jak je Maguyva postavená a proč má takové ceny.
- [Technologický stack: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/cs/stack): Technický stack, na kterém běží Maguyva. PostgreSQL, Voyage AI embeddingy, kvantizované vektorové vyhledávání, tree-sitter AST a protokol MCP.
- [Changelog](https://maguyva.ai/cs/changelog): Co vyšlo v Maguyva: změny produktu, aktualizace indexu a MCP nástrojů a poznámky z vývoje. Nejnovější první.
- [Live: Maguyva staví sama sebe, v reálném čase](https://maguyva.ai/cs/live): Žádné nahrané demo. Toto je skutečný protokol přidělených úloh — každé volání nástroje, chyba a commit od týmu AI agentů, kteří staví Maguyva, naživo.

## Guides

- [Není to fulltextové vyhledávání v převleku. Pět sloučených režimů vyhledávání.](https://maguyva.ai/cs/beyond-rag): Kód potřebuje víc než sémantické úseky textu. Maguyva sloučí pět režimů vyhledávání do jedné seřazené odpovědi, podložené skutečným repozitářem přes MCP napříč 284 jazyky. Free tarif, bez kreditní karty.
- [Instrukční soubory nejsou mapou vašeho kódu. Maguyva ano.](https://maguyva.ai/cs/beyond-rules-files): CLAUDE.md a AGENTS.md říkají agentovi, jak se má chovat. Neříkají mu, co je v kódové základně. Maguyva je vrstva kontextu kódové základny přes MCP napříč 284 jazyky. Free tarif, bez kreditní karty.
- [Úprava je snadná. Vědět, co se rozbije, je těžké. Maguyva to zmapuje.](https://maguyva.ai/cs/know-what-breaks): Před refaktoringem by měl váš agent znát všechna místa volání a importů i závislé části. Maguyva na to odpoví ze skutečného grafu volání přes MCP, ne z grepu. Free tarif, bez kreditní karty.
- [Začněte zdarma: vrstva kontextu kódové základny pro AI kódovací agenty](https://maguyva.ai/cs/map-then-change): Nejdřív mapa. Pak změna. Maguyva dá vašemu AI kódovacímu agentovi dotazovatelnou mapu kódové základny přes MCP, ještě před první úpravou. 11 nástrojů napříč 284 jazyky. Free tarif, bez kreditní karty.
- [Váš agent začíná na vašem repozitáři naslepo. Maguyva mu dá mapu.](https://maguyva.ai/cs/stop-flying-blind): Kódovací agenti prohledávají špatné soubory a upravují je dřív, než kódu porozumí. Maguyva dá vašemu agentovi dotazovatelnou mapu kódové základny přes MCP napříč 284 jazyky. Free tarif, bez kreditní karty.