# Maguyva

Krótkie przepisy na typowe przepływy pracy Maguyva MCP: instalacja klienta, wyszukiwanie przed edycją, puste wyniki i praca z wieloma 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/pl/docs/quickstart.md) or send `Accept: text/markdown`.

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

## Możliwości językowe

Poniżej znajdują się liczby dotyczące możliwości, które napędzają wyszukiwanie strukturalne, wyszukiwanie symboli, analizę uwzględniającą graf oraz podstawowe indeksowanie.

Te oznaczenia pokazują funkcje włączone w bieżącej konfiguracji języków, a nie wyniki oceny jakości całego procesu. Dostępność grafu wymaga włączenia parsera, ekstrakcji symboli i ekstrakcji grafu. Obsługiwane typy relacji i głębokość ekstrakcji różnią się zależnie od języka.

- Pokrycie indeksowania: **284**. Każdy wymieniony język jest indeksowany pod kątem kontekstu plikowego, tekstowego i repozytorium.
- Wyszukiwanie strukturalne AST: **247**. Języki z obsługą struktury opartej na parserze do przepływów pracy AST i wyszukiwania strukturalnego.
- Ekstrakcja symboli: **282**. Języki z metadanymi symboli do definicji i wyszukiwania.
- Relacje w grafie: **151**. Języki z działającą ekstrakcją relacji na potrzeby wyszukiwania uwzględniającego graf. Głębokość zależy od języka i typu relacji.

- `ast_structural=false`: Indeksowanie oparte głównie na tekście, z ograniczoną analizą struktury.
- `symbol_extraction=false`: Wyodrębnianie symboli jest ograniczone, więc nawigacja opiera się bardziej na kontekście pliku i struktury.
- `relationship_extraction=false`: Ten język jest indeksowany na potrzeby wyszukiwania, ale nie jest obecnie utrwalany w grafie kodu.

[Znajdź swój język](/llms-full.txt)

## Przepisy

Praktyczne przepisy na codzienną pracę z Maguyva MCP. Każdy przepis podaje narzędzia i kolejność ich użycia, a nie pełną dokumentację parametrów. Parametry narzędzi opisuje sekcja „[Dokumentacja API MCP](https://maguyva.ai/pl/docs/mcp-api)”. Przy pierwszej konfiguracji skorzystaj z sekcji „[Szybki start](https://maguyva.ai/pl/docs/quickstart)”.

### Wybierz odpowiednie narzędzie

Większość pytań wymaga na początek jednego wywołania. Sięgaj po kolejne narzędzia dopiero wtedy, gdy pierwsza odpowiedź jest zbyt ogólna lub zawiera za mało informacji.

- `intelligent_search` — zacznij tutaj, gdy pytasz o kod w języku naturalnym. Domyślnie auto/balanced kieruje zapytania z wysoką pewnością rozpoznane jako pytania o definicje do wyszukiwania strukturalnego, pytania o odwołania lub wpływ do grafu, a pytania o dokładne dopasowanie do wyszukiwania tekstowego. Pozostałe pytania korzystają ze znaczenia semantycznego i zindeksowanego tekstu. Użyj mode=hybrid albo auto z quality=thorough, aby zażądać wszystkich czterech modalności wyszukiwania; jawnie wybrany tryb ma pierwszeństwo przed quality.
- `find_symbol` — znasz już nazwę funkcji, klasy lub zmiennej.
- `dependency_search` — zasięg wpływu: kod wywołujący, kod zależny od symbolu lub skutki przed edycją i po niej.
- `get_task_context` — nieznany obszar; jeden ograniczony pakiet plików, symboli i zależności dla opisu zadania.
- `repository_context` — wyświetla listę dostępnych repozytoriów lub sprawdza, jak nazwa repozytorium jest rozpoznawana.
- `ask_maguyva` z `operation="guidance"` — lokalna pomoc dotycząca wyboru narzędzia i użycia Maguyva (bez mutacji repo).

## Tools -- Search

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

## Kolejne kroki

- [Szybki start](https://maguyva.ai/pl/docs/quickstart)
- [Przewodnik instalacji](https://maguyva.ai/pl/docs/installation)
- [Dokumentacja API MCP](https://maguyva.ai/pl/docs/mcp-api)
- [Rozwiązywanie problemów](https://maguyva.ai/pl/docs/troubleshooting)
- [Jak to działa](https://maguyva.ai/pl/docs/how-it-works)
- [Zgodność i specyfikacja techniczna](https://maguyva.ai/pl/docs/compatibility)

## Agent integrations

- [Maguyva dla Cursor: kontekst kodu przez MCP](https://maguyva.ai/pl/for-cursor): Cursor edytuje otwarty plik; Maguyva indeksuje całe monorepo i udostępnia je z powrotem przez MCP — wyszukiwanie semantyczne, AST, grafowe i tekstowe z file:line, dzięki czemu agent znajduje pliki, których nie przypiąłeś.
- [Maguyva dla Windsurf: kontekst kodu przez MCP](https://maguyva.ai/pl/for-windsurf): Windsurf i Cascade edytują otwarty plik; Maguyva indeksuje całe monorepo i udostępnia je przez MCP — semantyczne, AST, grafowe i tekstowe z file:line, dzięki czemu Cascade znajduje pliki, o których nie wspomniałeś.
- [Maguyva dla Antigravity: kontekst kodu przez MCP](https://maguyva.ai/pl/for-antigravity): Antigravity uruchamia autonomiczne agenty w edytorze, terminalu i przeglądarce; Maguyva daje im przeszukiwalną mapę monorepo przez MCP — zasięg wpływu z góry, a nie po tym, jak CI zaświeci na czerwono.
- [Maguyva dla Codex: kontekst kodu przez MCP](https://maguyva.ai/pl/for-codex): AGENTS.md to umowa robocza. Maguyva to serwer MCP, który daje Codex CLI przeszukiwalną mapę repozytorium, aby pierwsza edycja nie była zgadywaniem.
- [Maguyva dla dowolnego klienta MCP: kontekst kodu przez MCP](https://maguyva.ai/pl/for-anything): MCP to otwarty protokół. Maguyva to standardowy serwer MCP, więc klienci obsługujący MCP, tacy jak Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity, dostają ten sam ugruntowany kontekst bazy kodu.
- [Maguyva dla Gemini CLI: kontekst kodu przez MCP](https://maguyva.ai/pl/for-gemini): GEMINI.md ustala kontekst roboczy; MCP to kanał. Maguyva to serwer MCP, który daje Gemini CLI przeszukiwalną mapę twojego repo — wyszukiwanie semantyczne, AST i grafowe, dzięki czemu pierwsza edycja nie jest zgadywaniem.
- [Maguyva dla Claude Code: kontekst kodu przez MCP](https://maguyva.ai/pl/for-claude-code): CLAUDE.md mówi Claude'owi, jak się zachowywać. Maguyva indeksuje repozytorium i udostępnia je przez MCP, aby Claude Code edytował na podstawie przeszukiwalnej mapy.
- [Maguyva dla GitHub Copilot CLI: kontekst kodu przez MCP](https://maguyva.ai/pl/for-copilot): Niestandardowe instrukcje mówią Copilotowi, jak się zachowywać. Maguyva indeksuje repozytorium i udostępnia je przez MCP, aby GitHub Copilot CLI edytował na podstawie mapy.

## Company

- [O Maguyva: inteligencja kodu przez MCP](https://maguyva.ai/pl/about): Inteligencja kodu dla agentów kodujących: wyszukiwanie semantyczne, AST, grafowe i pełnotekstowe, wyszukiwanie symboli, analiza zależności i kontekst zadania w jednym wywołaniu w ponad 284 językach.
- [Poznaj zespół: 2 ludzi + rój agentów AI](https://maguyva.ai/pl/team)
- [Jak pracujemy: bez VC, bez opłat za użytkownika, bez dopłat za funkcje](https://maguyva.ai/pl/how): Żadnego zewnętrznego kapitału. Żadnych opłat za użytkownika. Twoje dane nie są produktem. Jak zbudowana jest Maguyva i dlaczego wyceniona jest właśnie tak.
- [Stos technologiczny: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/pl/stack): Stos technologiczny napędzający Maguyva. PostgreSQL, embeddingi Voyage AI, skwantyzowane wyszukiwanie wektorowe, AST tree-sitter oraz protokół MCP.
- [Changelog](https://maguyva.ai/pl/changelog): Co zostało wydane w Maguyva: zmiany produktu, aktualizacje indeksu i narzędzi MCP oraz notatki z prac rozwojowych. Najnowsze na górze.
- [Na żywo: Maguyva buduje samą siebie, w czasie rzeczywistym](https://maguyva.ai/pl/live): Żadnego przygotowanego demo. To prawdziwy dziennik zdarzeń — każde wywołanie narzędzia, awaria i commit zespołu agentów AI budujących Maguyva, na żywo.

## Guides

- [To nie wyszukiwanie pełnotekstowe w przebraniu. Pięć połączonych trybów wyszukiwania.](https://maguyva.ai/pl/beyond-rag): Kod potrzebuje czegoś więcej niż semantycznych fragmentów. Maguyva łączy pięć trybów wyszukiwania w jedną uszeregowaną odpowiedź, ugruntowaną w prawdziwym repozytorium przez MCP, w 284 językach. Plan Free, bez karty kredytowej.
- [Pliki instrukcji to nie mapa twojego kodu. Maguyva nią jest.](https://maguyva.ai/pl/beyond-rules-files): CLAUDE.md i AGENTS.md mówią agentowi, jak się zachowywać. Nie mówią mu, co jest w kodzie. Maguyva to warstwa kontekstu kodu przez MCP, w 284 językach. Plan Free, bez karty kredytowej.
- [Edycja jest łatwa. Wiedza, co się zepsuje, jest trudna. Maguyva to mapuje.](https://maguyva.ai/pl/know-what-breaks): Przed refaktoryzacją twój agent powinien znać każdy element, który wywołuje ten kod, importuje go lub od niego zależy. Maguyva odpowiada na to na podstawie prawdziwego grafu wywołań przez MCP, a nie grepa. Plan Free, bez karty kredytowej.
- [Zacznij za darmo: warstwa kontekstu kodu dla agentów kodujących AI](https://maguyva.ai/pl/map-then-change): Najpierw mapa. Potem zmiana. Maguyva daje twojemu agentowi kodującemu AI przeszukiwalną mapę kodu przez MCP, jeszcze przed pierwszą edycją. 11 narzędzi w 284 językach. Plan Free, bez karty kredytowej.
- [Twój agent zaczyna na ślepo na twoim repozytorium. Maguyva daje mu mapę.](https://maguyva.ai/pl/stop-flying-blind): Agenci kodujący skanują niewłaściwe pliki i edytują, zanim zrozumieją kod. Maguyva daje twojemu agentowi przeszukiwalną mapę kodu przez MCP, w 284 językach. Plan Free, bez karty kredytowej.