# Pokud to mluví MCP, mluví to i Maguyva.

Canonical source: https://maguyva.ai/cs/for-anything

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Integrace není per nástroj — je to protokol. Maguyva je standardní MCP server na jedné URL, takže ať váš agent běží v čemkoli (Claude Code, Codex, Cursor, Gemini, Devin Desktop, Antigravity, Zed, Cline, nebo v něčem, co jste si postavili sami), dostane stejnou prohledávatelnou mapu vašeho repozitáře. Indexujte jednou a každý klient, který připojíte, dostane na stejné otázky podložené odpovědi.

> Jeden MCP server. Každý klient. Žádný plugin per nástroj, žádný lock-in.

## Co dělá každá vrstva

Čtyři části. Každá má svůj úkol.

### Jakýkoli MCP klient

23 zdokumentovaných klientů, včetně Claude Code, Codex CLI, Gemini CLI, Cursor, Devin Desktop, Antigravity, nebo váš vlastní agent.

### MCP

Otevřený standard, kterým už mluví úplně každý z nich.

### Maguyva

Jeden MCP server. Podložená fakta o repozitáři, vrácená s file:line.

### Pracovní prostory, ne uživatelské licence

Za agenty se neplatí samostatné licenční poplatky. [Zobrazit ceník](https://maguyva.ai/cs/pricing)

## MCP je integrace. Používejte ho jako standard.

Otevřený protokol je správná volba, ne provizorní řešení. Stavět na [MCP](https://modelcontextprotocol.io/docs/getting-started/intro) místo pluginu pro každý nástroj je přesně způsob, jak se vyhnout opětovné integraci pokaždé, když vyjde lepší agent. Je to správné místo pro:

- Jeden konfigurační blok serveru, který zapadne do jakéhokoli kompatibilního klienta.
- Nástroje a zdroje, které jsou přenositelné napříč editory, CLI a agenty.
- Hranici, kterou váš bezpečnostní tým prověří jednou, ne u každého dodavatele zvlášť.
- Svobodu přepínat klienty bez přestavování celého kontextového stacku.

Pokračujte v tom. Zvolit MCP jako standard je ten správný tah.

Ale protokol je jen trubka. Nese otázku a odpověď — ale *nezná* vaši codebase. Na druhém konci musí být něco, co skutečně mapuje vaše symboly, místa volání a závislosti.

## Kde přestává škálovat kontext oddělený pro každý nástroj

Čtyři selhání, která nevyřeší soubor s pravidly žádného jednotlivého agenta.

### // každý nástroj začíná znovu od nuly

Vyberte nového agenta a on zase začíná ve vašem repozitáři naslepo. Znovu vkládáte stejné soubory, znovu připínáte stejný kontext, znovu píšete stejná pravidla. Práce se nepřenáší, protože nikdy nebyla sdílenou vrstvou.

### // soubory s pravidly necestují

`CLAUDE.md`, `.cursor/rules`, `AGENTS.md` — každý je specifický pro daný nástroj a žádný z nich není prohledávatelný index vašeho kódu. Přepnete klienty a mapa, kterou jste postavili ručně, zůstane vzadu.

### // integrační lock-in je daň

Napojit hluboký kontext codebase do pluginu jednoho dodavatele znamená, že v den, kdy zkusíte jiného agenta, to musíte postavit znovu. Čím lepší máte kontext, tím víc stojí odejít.

### // protokol je trubka, ne mapa

MCP přesouvá nástroje a kontext mezi klientem a serverem. Nezná vaše symboly, místa volání ani graf závislostí. Na druhém konci musí být něco, co na otázku skutečně odpoví.

## Maguyva je vrstva na druhém konci protokolu

Není to další agent. Je to server s kontextem repozitáře, který může volat jakýkoli MCP klient:

- **Jeden endpoint, každý klient**: stejný `https://maguyva.tools/mcp` obsluhuje Claude Code, Codex CLI, Gemini CLI, Cursor, Devin Desktop, Antigravity, nebo skript, který jste napsali dnes ráno.
- **Sémantika + AST + graf + text**: hledejte podle významu, struktury, závislosti nebo doslovného textu. Každý zásah vrátí cestu k souboru a číslo řádku, ať se ptá jakýkoli klient.
- **Vnímá větve, napříč balíčky**: Maguyva vidí tu verzi kódu, kterou agent zrovna edituje, napříč všemi balíčky v monorepu.
- **Žádný lock-in**: přepněte agenty, kdykoli chcete; vrstva kontextu zůstává na místě. Platí se za pracovní prostor, ne za uživatele — indexujte 1 repozitář nebo 50.

> Váš klient mluví MCP.
> Maguyva je to, co odpoví, *když se zeptá na váš kód.*

## Tři workflow, identické z každého klienta

Napříč balíčky, napříč jazyky. Klient se mění; podložená odpověď ne.

### 01. Najděte auth flow napříč balíčky, z jakéhokoli agenta

```text
agent> kde se v tomhle monorepu řeší autentizace?

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       middleware
  packages/api/src/auth/jwt.ts:88           token verify
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  rbac gate

→ 4 vstupní body napříč 4 balíčky, seřazené podle hustoty míst volání.
[exit 0]
```

Claude Code, Cursor, nebo váš vlastní skript — nezáleží na tom, který klient dotaz poslal. Vrátí se stejné čtyři soubory ve stejném pořadí, podložené skutečným grafem.

### 02. Najděte skutečnou implementaci, ne testovací stub

```text
agent> jak normalizePhoneNumber zachází s E.164?

semantic::query("normalize phone E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← skutečná impl
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← stub
[exit 0]
```

Jména lžou. Mocky zastiňují skutečný kód. Maguyva řadí skutečnou implementaci nad testovací mock — stejným způsobem pro každého klienta, který se zeptá.

### 03. Zkontrolujte rozsah dopadu před refaktoringem

```text
agent> co volá QueueDispatcher.publish napříč monorepem?

graph::callers(QueueDispatcher.publish)
  3 in packages/billing/*
  1 in packages/audit/*
  1 in packages/notifications/*
  1 in services/python-worker/*  ← napříč jazyky přes gRPC stub
[exit 0]
```

Napříč balíčky, a napříč jazyky na polyglotním repozitáři, se místa volání objeví přímo v textu. Zítra přepněte agenty a rozsah dopadu tam pořád bude, protože žije v serveru, ne v klientovi.

## Nastavení s jakýmkoli MCP klientem

Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.

### 01. Indexujte repozitář na maguyva.ai

Vyberte si repozitář, který dobře znáte, abyste mohli ověřit odpovědi. Free tarif pokrývá 3 repozitáře, Až 50K zaindexovaných řádků repa.

### 02. Přidejte Maguyva jako MCP server do jakéhokoli klienta, který používáte

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
```

### 03. Položte jednu otázku, jejíž odpověď už znáte

Začněte jedním repozitářem a jednou ověřitelnou otázkou, třeba „co volá `formatInvoice` napříč balíčky?“ Pokud odpověď sedí s tím, co byste řekli vy, každý další klient, který na to namíříte, dostane stejný podložený výsledek.

Instrukce pro jednotlivé klienty (Claude Code, Codex, Cursor, Gemini, Devin Desktop, Antigravity a další) najdete v [dokumentaci kompatibility Maguyva](https://maguyva.ai/cs/docs/compatibility).

## Indexujte jeden repozitář, který už znáte.

Připojte jakéhokoli MCP klienta. Položte jednu otázku, jejíž odpověď dokážete ověřit.

## Zdroje

- [MCP: oficiální úvod](https://modelcontextprotocol.io/docs/getting-started/intro)
- [MCP: ukázkoví klienti](https://modelcontextprotocol.io/clients)
- [Maguyva: kompatibilita a klienti](https://maguyva.ai/cs/docs/compatibility)
- [Maguyva: stack a bezpečnost](https://maguyva.ai/cs/stack)
- [Maguyva: ceník (za pracovní prostor, ne za uživatele)](https://maguyva.ai/cs/pricing)
