# Jeśli mówi w MCP, mówi też w Maguyva.

Canonical source: https://maguyva.ai/pl/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).

Integracja nie zależy od konkretnego narzędzia — opiera się na protokole. Maguyva to standardowy serwer MCP pod jednym adresem URL, więc bez względu na to, w czym działa Twój agent (Claude Code, Codex, Cursor, Gemini, Devin Desktop, Antigravity, Zed, Cline albo coś, co sam zbudowałeś), dostaje tę samą przeszukiwalną mapę Twojego repo. Zaindeksuj raz, a każdy podłączony klient zadaje te same ugruntowane pytania.

> Jeden serwer MCP. Każdy klient. Bez wtyczki per narzędzie, bez uzależnienia od dostawcy.

## Co robi każda warstwa

Cztery elementy. Każdy ma swoje zadanie.

### Dowolny klient MCP

23 klientów z instrukcjami konfiguracji, w tym Claude Code, Codex CLI, Gemini CLI, Cursor, Devin Desktop, Antigravity, albo Twój własny agent.

### MCP

Otwarty standard, którym już mówią wszyscy z nich.

### Maguyva

Jeden serwer MCP. Ugruntowane fakty o repozytorium, zwracane z file:line.

### Workspace'y, nie użytkownicy

Bez osobnych opłat za każdego agenta. [Zobacz cennik](https://maguyva.ai/pl/pricing)

## MCP to integracja. Postaw na nią jako standard.

Otwarty protokół to trafna decyzja, nie obejście. Budowanie na [MCP](https://modelcontextprotocol.io/docs/getting-started/intro) zamiast wtyczki per narzędzie to dokładnie sposób, by uniknąć ponownej integracji za każdym razem, gdy pojawi się lepszy agent. To dobre miejsce na:

- Jeden blok konfiguracji serwera, który wpina się w dowolnego zgodnego klienta.
- Narzędzia i zasoby przenośne między edytorami, CLI i agentami.
- Granicę, którą Twój zespół bezpieczeństwa przejrzy raz, a nie osobno dla każdego dostawcy.
- Swobodę zmiany klienta bez przebudowy całego stosu kontekstu.

Rób tak dalej. Postawienie na MCP jako standard to dobry ruch.

Ale protokół to rura. Przenosi pytanie i odpowiedź — nie *zna* Twojej bazy kodu. Coś musi być po drugiej stronie, co faktycznie mapuje Twoje symbole, miejsca wywołań i zależności.

## Gdzie kontekst per narzędzie przestaje się skalować

Cztery tryby awarii, których nie naprawi żaden pojedynczy plik reguł agenta.

### // każde narzędzie zaczyna wdrożenie od zera

Wybierz nowego agenta, a on znów zaczyna ślepy na Twoim repo. Ponownie wklejasz te same pliki, ponownie przypinasz ten sam kontekst, ponownie piszesz te same reguły. Praca się nie przenosi, bo nigdy nie była wspólną warstwą.

### // pliki reguł nie podróżują

`CLAUDE.md`, `.cursor/rules`, `AGENTS.md` — każdy jest specyficzny dla narzędzia i żaden nie jest przeszukiwalnym indeksem Twojego kodu. Zmień klienta, a mapa, którą zbudowałeś ręcznie, zostaje w tyle.

### // uzależnienie od integracji to podatek

Wpięcie głębokiego kontekstu kodu we wtyczkę jednego dostawcy oznacza, że w dniu, w którym spróbujesz innego agenta, musisz zbudować to od nowa. Im lepszy Twój kontekst, tym więcej kosztuje odejście.

### // protokół to rura, nie mapa

MCP przenosi narzędzia i kontekst między klientem a serwerem. Nie zna Twoich symboli, miejsc wywołań ani grafu zależności. Coś musi być po drugiej stronie, co faktycznie odpowiada na pytanie.

## Maguyva to warstwa po drugiej stronie protokołu

To nie kolejny agent. Serwer kontekstu repo, który może wywołać dowolny klient MCP:

- **Jeden endpoint, każdy klient**: ten sam `https://maguyva.tools/mcp` obsługuje Claude Code, Codex CLI, Gemini CLI, Cursor, Devin Desktop, Antigravity albo skrypt, który napisałeś dziś rano.
- **Semantyczne + AST + graf + tekst**: szukaj po znaczeniu, strukturze, zależności albo dosłownie. Każdy wynik zwraca ścieżkę pliku i numer linii, niezależnie od tego, który klient pytał.
- **Świadomy branchy, między pakietami**: Maguyva widzi tę wersję kodu, którą edytuje agent, we wszystkich pakietach w monorepo.
- **Bez uzależnienia od dostawcy**: zmieniaj agentów, kiedy chcesz; warstwa kontekstu się nie rusza. Opłata za workspace, nie za użytkownika — zindeksuj 1 repo albo 50.

> Twój klient mówi w MCP.
> Maguyva odpowiada, *gdy pyta o Twój kod.*

## Trzy przepływy pracy, identyczne z każdego klienta

Między pakietami, między językami. Klient się zmienia; ugruntowana odpowiedź — nie.

### 01. Znajdź przepływ uwierzytelniania między pakietami, z dowolnego agenta

```text
agent> gdzie w tym monorepo odbywa się uwierzytelnianie?

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

→ 4 punkty wejścia w 4 pakietach, uszeregowane wg gęstości wywołań.
[exit 0]
```

Claude Code, Cursor czy Twój własny skrypt — nie ma znaczenia, który klient wysłał zapytanie. Te same cztery pliki wracają w tej samej kolejności, ugruntowane na rzeczywistym grafie.

### 02. Znajdź prawdziwą implementację, nie atrapę testową

```text
agent> jak normalizePhoneNumber obsługuje E.164?

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

Nazwy kłamią. Atrapy przesłaniają prawdziwy kod. Maguyva stawia prawdziwą implementację wyżej niż atrapę testową — tak samo dla każdego klienta, który pyta.

### 03. Sprawdź zasięg wpływu przed refaktoryzacją

```text
agent> co wywołuje QueueDispatcher.publish w całym monorepo?

graph::callers(QueueDispatcher.publish)
  3 w packages/billing/*
  1 w packages/audit/*
  1 w packages/notifications/*
  1 w services/python-worker/*  ← między językami przez stub gRPC
[exit 0]
```

Między pakietami, a przy poliglotycznym repo — także między językami, miejsca wywołań pojawiają się od razu. Zmień agenta jutro, a informacje o zasięgu wpływu nadal będą dostępne, bo są przechowywane na serwerze, nie w kliencie.

## Konfiguracja z dowolnym klientem MCP

Trzy kroki. Plan Free: 3 repozytoria, Do 50 tys. zindeksowanych linii repo, bez karty kredytowej.

### 01. Zaindeksuj repo na maguyva.ai

Wybierz takie, które dobrze znasz, żeby móc zweryfikować odpowiedzi. Plan Free obejmuje 3 repozytoria, Do 50 tys. zindeksowanych linii repo.

### 02. Dodaj Maguyva jako serwer MCP w dowolnym używanym kliencie

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

### 03. Zadaj jedno pytanie, na które już znasz odpowiedź

Zacznij od jednego repo i jednego sprawdzalnego pytania, np. „co wywołuje `formatInvoice` w różnych pakietach?” Jeśli odpowiedź zgadza się z tym, co byś powiedział, każdy inny klient, którego podłączysz do tego serwera, dostanie ten sam ugruntowany wynik.

Instrukcje dla poszczególnych klientów (Claude Code, Codex, Cursor, Gemini, Devin Desktop, Antigravity i inne) znajdziesz w [dokumentacji zgodności Maguyva](https://maguyva.ai/pl/docs/compatibility).

## Zaindeksuj jedno repo, które już znasz.

Podłącz dowolnego klienta MCP. Zadaj jedno pytanie, którego odpowiedź możesz zweryfikować.

## Źródła

- [MCP: oficjalne wprowadzenie](https://modelcontextprotocol.io/docs/getting-started/intro)
- [MCP: przykładowi klienci](https://modelcontextprotocol.io/clients)
- [Maguyva: zgodność i klienci](https://maguyva.ai/pl/docs/compatibility)
- [Maguyva: stack i bezpieczeństwo](https://maguyva.ai/pl/stack)
- [Maguyva: cennik (workspace, nie za użytkownika)](https://maguyva.ai/pl/pricing)