# Context7: aktualna dokumentacja bibliotek dla agenta (MCP, CLI i tryb skills)

URL: https://developertoolkit.ai/pl/ecosystem/mcp/context7/
Description: Context7 w Claude Code, Codex i Cursorze: przypinanie ID bibliotek, wybór między MCP a trybem skills i dowód, że agent pisał pod aktualne API.

Context7 to usługa dokumentacyjna Upstash dla agentów kodujących: na żądanie zwraca dokumentację i przykłady kodu dla konkretnej wersji biblioteki, przez zdalny serwer MCP, pakiet `@upstash/context7-mcp` albo CLI `ctx7` ze skillem, bez MCP. Ogranicza błędy wynikające z przestarzałego API, ale dowodem poprawności kodu pozostają type check i testy.

Prosisz agenta o przechwytywanie żądań w Next.js, a on pisze `middleware.ts`. Kod się kompiluje, tylko że framework już to wycofał: od Next.js 16.0.0 konwencja pliku to `proxy.ts` (dokumentacja API `proxy.js` Next.js, odczyt 2026-09-26). Model nie jest niedbały. Jego dane treningowe kończą się przed wydaniem, które masz zainstalowane, a nic w sesji nie powiedziało mu, że jest inaczej.

Ta strona jest dla programistów, którzy chcą, żeby agent pisał pod wersję biblioteki z lockfile'a, i dla tech leadów, którzy chcą, żeby to był domyślny standard zespołu, a nie nawyk jednej osoby.

## Co daje ci dobrze skonfigurowany Context7

- Context7 zainstalowany w Claude Code, Codex i Cursorze, z kluczem API poza commitowanymi plikami.
- Wybór między trybem MCP a trybem CLI + Skills, z jasno opisanym kompromisem.
- Prompty, które przypinają ID biblioteki i wersję, żeby agent nie zgadywał, o który pakiet ci chodzi.
- Proces aktualizacji zależności: Context7 dla nowego API, potem codemod, testy i review.
- Krótką listę innych serwerów dokumentacji i skilli dostawców na przypadki, których Context7 nie pokrywa.
- Siedem typowych awarii i sposób wyjścia z każdej.

## Jak działa Context7: dwa narzędzia, dwa kroki

Serwer MCP w wersji `@upstash/context7-mcp` 4.1.1 (npm, sprawdzone 2026-09-26) udostępnia dokładnie dwa narzędzia:

| Narzędzie | Argumenty | Co robi |
| --- | --- | --- |
| `resolve-library-id` | `libraryName`, `query` | Zamienia nazwę, np. „next.js”, na ID biblioteki w Context7, np. `/vercel/next.js`, z rankingiem względem twojego zadania |
| `query-docs` | `libraryId`, `query` | Zwraca fragmenty dokumentacji i przykłady kodu tej biblioteki pasujące do zadania |

Typowe wyszukanie to dwa wywołania: najpierw resolve, potem query. Gdy podasz ID w prompcie („use library `/vercel/next.js`”), agent pomija pierwsze wywołanie. To szybsze i eliminuje najczęstszy błąd: trafienie w fork albo pakiet o podobnej nazwie.

CLI odwzorowuje te same dwa kroki: `ctx7 library <name> [query]` i `ctx7 docs <libraryId> <query>` (`ctx7` 0.5.12, `--help`, sprawdzone 2026-09-26).

**Starsze artykuły używają innej nazwy narzędzia**

Wersja 1.x pakietu (np. 1.0.14 z czerwca 2025) nazywała drugie narzędzie `get-library-docs`. Wersja 4.1.1 rejestruje zamiast niego `query-docs`. Jeśli jakiś prompt albo reguła w twoim repozytorium wspomina `get-library-docs`, zaktualizuj je.

## Tryb MCP czy tryb CLI + Skills?

Upstash daje dwa sposoby podłączenia tej samej usługi. CLI `ctx7`, które przeprowadza konfigurację i obsługuje tryb skills, wymaga Node.js 18 lub nowszego.

| | Tryb MCP | Tryb CLI + Skills |
| --- | --- | --- |
| Co się instaluje | Wpis serwera wskazujący na `https://mcp.context7.com/mcp` (albo lokalny proces stdio) | Skill, który każe agentowi uruchamiać w powłoce `ctx7 library` i `ctx7 docs` |
| Kiedy agent z tego korzysta | Gdy sam zdecyduje się wywołać narzędzie albo gdy napiszesz „use context7” | Gdy opis skilla pasuje do zadania; skill uruchamia się przy pytaniach o biblioteki |
| Gdzie działa | W każdym kliencie MCP: Claude Code, Codex, Cursor i ponad 30 innych (README Upstash) | W agentach, które ładują skille i mogą uruchamiać polecenia powłoki |
| Kiedy wybrać | Zespół już centralnie zarządza serwerami MCP | Chcesz krótkiej listy serwerów MCP albo agent nie obsługuje MCP |

`npx ctx7 setup` pyta o tryb, loguje cię przez OAuth, generuje klucz API i zapisuje konfigurację. Dodaj `--mcp` albo `--cli`, żeby pominąć pytanie, oraz `--claude`, `--codex` lub `--cursor`, żeby wskazać jednego agenta. `-p` konfiguruje bieżący projekt zamiast profilu użytkownika. `npx ctx7 remove` cofa zmiany.

## Instalacja Context7 w Claude Code, Codex i Cursorze

Najszybsza ścieżka jest wszędzie ta sama: uruchom w terminalu `npx ctx7 setup` i odpowiedz na pytania. Ścieżki ręczne poniżej są dla zespołów, które chcą trzymać konfigurację w repozytorium albo kontrolować, gdzie leży klucz.

Darmowy klucz API z panelu Context7 podnosi limity zapytań. Hostowany serwer działa też bez klucza.

**Claude Code**

Zdalny serwer, zakres projektu, klucz czytany ze zmiennej środowiskowej (przetestowane na Claude Code 2.1.283):

```bash
claude mcp add --scope project --transport http context7 https://mcp.context7.com/mcp \
  --header 'Authorization: Bearer ${CONTEXT7_API_KEY}'
```

Pojedyncze cudzysłowy są tu istotne. Claude Code zapisuje w `.mcp.json` dosłownie `"Authorization": "Bearer ${CONTEXT7_API_KEY}"` i rozwija zmienną w czasie działania, więc możesz zacommitować plik bez klucza.

Alternatywy:

```bash
# Local stdio process, user scope; the server reads CONTEXT7_API_KEY from its environment
claude mcp add --scope user context7 -e CONTEXT7_API_KEY=YOUR_API_KEY -- npx -y @upstash/context7-mcp@4.1.1

# Official plugin (listed in claude-plugins-official with 417,801 installs on claude.com/plugins, checked 2026-09-26)
claude plugin install context7@claude-plugins-official

# CLI + Skills mode, no MCP server
npx ctx7 setup --cli --claude
```

Nazwę serwera podaj przed `-e`: flaga przyjmuje wiele wartości, więc w zapisie `-e KEY=value context7` Claude Code potraktuje `context7` jako drugą zmienną i zgłosi `Invalid environment variable format`. Jeśli `claude plugin install` zgłasza brak marketplace'u, użyj w sesji marketplace'u samego Upstash: `/plugin marketplace add upstash/context7`, a potem `/plugin install context7@context7-marketplace`.

**Codex**

Zdalny serwer z kluczem ze zmiennej środowiskowej (przetestowane na codex-cli 0.157.1):

```bash
codex mcp add context7 --url https://mcp.context7.com/mcp --bearer-token-env-var CONTEXT7_API_KEY
```

To polecenie zapisuje w `~/.codex/config.toml` poniższy blok, a `codex mcp list` pokazuje potem uwierzytelnianie jako „Bearer token”:

```toml
[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"
bearer_token_env_var = "CONTEXT7_API_KEY"
```

Alternatywy:

```bash
# Local stdio process
# writes the key into ~/.codex/config.toml; prefer the --url + --bearer-token-env-var form above
codex mcp add context7 --env CONTEXT7_API_KEY=YOUR_API_KEY -- npx -y @upstash/context7-mcp@4.1.1

# CLI + Skills mode, no MCP server
npx ctx7 setup --cli --codex
```

Codex po cichu ignoruje nieznane klucze konfiguracji. Blok z `headers = { … }` parsuje się bez błędu, a nagłówek nigdy nie jest wysyłany. Właściwe klucze to `bearer_token_env_var`, `http_headers` i `env_http_headers` (codex-cli 0.157.1).

**Cursor**

Wpisz zdalny serwer do `~/.cursor/mcp.json` (globalnie), żeby klucz nigdy nie trafił do repozytorium (kształt konfiguracji z README Upstash; nie testowano w samym Cursorze):

```json
{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

Projektowy `.cursor/mcp.json` też zadziała; nie wpisuj do niego nagłówka i niech każdy programista doda klucz globalnie.

Możesz też zlecić zapis konfiguracji CLI:

```bash
npx ctx7 setup --cursor          # asks for MCP or CLI + Skills mode
```

Zastąp `YOUR_API_KEY` kluczem z panelu Context7 albo pomiń nagłówek, żeby działać anonimowo z niższymi limitami.

### Sprawdź, czy agent widzi Context7

Uruchom `/mcp` w sesji Claude Code lub Codex albo `codex mcp list` w terminalu (w Cursorze otwórz listę MCP w ustawieniach) i sprawdź, czy `context7` jest połączony i ma dwa narzędzia. Potem wklej pierwszy prompt poniżej i obserwuj, czy pojawia się wywołanie `resolve-library-id`, a po nim `query-docs`. W trybie CLI + Skills szukaj zamiast tego `ctx7 library` i `ctx7 docs` w wyjściu powłoki.

## Aktualna dokumentacja na żądanie: przykład z Next.js

Dobrym pierwszym testem jest prompt oparty na przykładzie z README Upstash, bo poprawna odpowiedź zmieniła się w niedawnym wydaniu:

**Prompt do skopiowania: pierwszy test Context7**

```text
Create Next.js request interception that checks for a valid JWT in the "session" cookie and redirects unauthenticated users to /login. Read the installed Next.js version from package.json first, then use context7 with library /vercel/next.js for that version. Tell me which file convention the docs specify for this version and quote the doc section you used.
```

Czego oczekiwać na Next.js 16: agent rozwiązuje albo przyjmuje `/vercel/next.js`, wywołuje `query-docs` i pisze `proxy.ts` z eksportowaną funkcją `proxy`, a nie `middleware.ts`. Na Next.js 15 powinien napisać `middleware.ts`. Jeśli na 16 bez komentarza tworzy `middleware.ts`, odpowiedział z danych treningowych; sprawdź w logu narzędzi, czy w ogóle odpytał dokumentację.

Przypinanie ID to nawyk, który warto zbudować. Format z README to „use library `/owner/repo`”:

**Prompt do skopiowania: przypięte ID biblioteki**

```text
Implement email/password sign-up and sign-in with Supabase in src/lib/auth.ts. use library /supabase/supabase for API and docs. Match the @supabase/supabase-js version in package.json, handle the error cases the docs show, and do not call any function that does not appear in the docs you retrieved.
```

Gdy nie znasz jeszcze ID, każ agentowi pokazać kandydatów, zanim napisze kod, żeby to ty wybrał bibliotekę, a nie ranking:

**Prompt do skopiowania: najpierw resolve, potem kod**

```text
Use context7 resolve-library-id for drizzle-kit and show me the top candidates with their IDs. Stop and wait for me to pick one. Then query that ID for the current way to push schema changes to a development database at the drizzle-kit version in package.json, list any command or flag that changed since the previous major version, and update the db:push script to match.
```

To samo wyszukanie zrobisz sam poleceniem `npx ctx7 library drizzle "push schema"`.

**Prompt do skopiowania: komponent zbudowany z aktualnej dokumentacji**

```text
Use context7 to look up the shadcn/ui Dialog component docs. Create src/components/ui/confirm-delete-dialog.tsx that follows the documented composition exactly: trigger button, a warning message, and Cancel and Delete actions. After writing it, list every import and prop you used and the doc snippet each one came from.
```

### Context7 domyślnie, a nie na hasło

Dopisywanie „use context7” do każdego promptu nie skaluje się na zespół. Wpisz regułę do pliku, który agent czyta na starcie sesji. README Upstash proponuje takie brzmienie:

```text
Always use Context7 when I need library/API documentation, code generation, setup or configuration steps without me having to explicitly ask.
```

Umieść ją w `CLAUDE.md` dla Claude Code, w `AGENTS.md` dla Codex i jako regułę (**Cursor Settings > Rules**) w Cursorze. Tryb CLI + Skills nie potrzebuje reguły: `ctx7 setup` instaluje skill, który sam uruchamia się przy pytaniach o biblioteki. Jak utrzymać te pliki na tyle krótkie, żeby agent nadal je czytał, opisuje strona o [dokumentacji jako kontekście dla AI](/pl/workflows/context/documentation-as-context/).

## Aktualizacja zależności: Context7, codemod i testy

Aktualizacja do nowej wersji głównej to miejsce, gdzie przestarzałe dane treningowe kosztują najwięcej i gdzie Context7 się zwraca. Nie zastępuje codemodu ani testów; dostarcza nowe API, żeby agent mógł poprawić to, czego codemod nie ruszył. Prompty są takie same we wszystkich trzech narzędziach.

Przykład poniżej to aktualizacja aplikacji z Next.js 15 do 16. Ten sam schemat pasuje do każdej biblioteki z changelogiem i codemodem.

1. **Zapisz stan wyjściowy.** Na świeżej gałęzi uruchom pełną bramkę (type check, lint, testy, build) i zapisz wynik. Zanotuj zainstalowaną wersję poleceniem `npm ls next`. Jeśli testy słabo pokrywają kod, który zmienisz, najpierw je wzmocnij; zobacz, [jak ocenić siłę wyroczni testowej](/pl/workflows/test/oracle-strength/).

2. **Weź listę zmian z aktualnej dokumentacji, nie z pamięci modelu.**

   **Prompt do skopiowania: plan aktualizacji z aktualnej dokumentacji**

   ```text
   We are upgrading next from the version in package-lock.json to 16. Use library /vercel/next.js and query the upgrade guide and the API reference one concept at a time. Produce docs/upgrade-next-16.md with: each breaking change that affects files in this repo (with file paths), the official codemod for it if one exists, and the doc section you took it from. Do not edit code yet.
   ```

   Przejrzyj ten plik. To kontrakt na resztę aktualizacji i jest na tyle krótki, że da się go przeczytać w całości.

3. **Uruchom codemody, zanim agent dotknie kodu.** Codemody są deterministyczne i dają jeden mechaniczny diff do przejrzenia. Dla zmiany nazwy middleware dokumentacja Next.js podaje `npx @next/codemod@canary middleware-to-proxy .`, które zmienia nazwę pliku i funkcji. Zacommituj wynik codemodu osobno.

4. **Resztę niech poprawi agent, jedno pojęcie na zapytanie.** Poproś go, żeby przeszedł przez pozostałe punkty z `docs/upgrade-next-16.md`, odpytując Context7 osobno dla każdego i kończąc, gdy bramka jest zielona. Pomoc `ctx7 docs` mówi to wprost: jedno pytanie o jeden temat na wywołanie i osobne zapytanie dla każdego odrębnego pojęcia.

5. **Uruchom bramkę i porównaj ze stanem wyjściowym.** Type check, lint, testy i build muszą przejść. Każde nowe ostrzeżenie o wycofaniu API (deprecation) w wyjściu buildu traktuj jak błąd.

6. **Przegląd na podstawie dowodów.** Pull request zawiera plik planu, commit z codemodem, commit z poprawkami agenta i wynik bramki. Recenzent sprawdza, czy każdy punkt planu jest zamknięty i czy żaden test nie został osłabiony; zobacz [code review PR-a agenta bez czytania każdej linii](/pl/workflows/ship/agent-pr-review/).

## Jak udowodnić, że agent użył właściwego API?

Context7 zwiększa szansę, że agent wybierze aktualne API. Sam niczego nie dowodzi: dokumentację tworzy społeczność, a README Upstash zastrzega, że nie gwarantuje jej dokładności ani kompletności. Dowodem są bramki, które sprawdzają kod względem zainstalowanego pakietu, a człowiek zatwierdza wynik tych bramek.

| Kontrola | Co wyłapuje | Kto za nią odpowiada |
| --- | --- | --- |
| Type check względem typów zainstalowanego pakietu | Wymyślone funkcje, usunięte opcje, złe sygnatury | CI, blokująca |
| Testy i build na zaktualizowanym lockfile'u | Zmiany zachowania, których typy nie widzą | CI, blokująca |
| Ostrzeżenia o wycofaniu API w wyjściu buildu i testów | Kod, który działa dziś na API zaplanowanym do usunięcia | CI, blokująca, gdy stan wyjściowy jest czysty |
| ID biblioteki i wersja, o które pytał agent, wypisane w PR | Dokumentacja pobrana dla złej biblioteki lub wersji | Autor (agent), weryfikuje recenzent |
| Nowe lub zmienione zależności w diffie lockfile'a | Pakiet dodany przez agenta, bo wspominała o nim dokumentacja | CI; zobacz [kontrolę zależności w zmianach agentów](/pl/workflows/test/dependency-verification/) |

Tech lead zatwierdza na podstawie tych dowodów, a nie czytając każdą zmienioną linię. Strona o [pakiecie dowodów](/pl/workflows/ship/evidence-bundle/) zawiera szablon PR, który czyni te pozycje obowiązkowymi.

**Prompt do skopiowania: samokontrola przed otwarciem PR**

```text
Before opening the PR: list every third-party API call you added or changed in this branch. For each one, give the Context7 library ID and version you queried and confirm that the symbol exists in the type definitions under node_modules for the installed version. Flag anything you wrote from memory rather than from a doc lookup. Then run the type check, tests and build, and paste the summary.
```

## Ile kontekstu zużywa Context7?

Claude Code i Codex ładują schematy narzędzi MCP na żądanie (wyszukiwanie narzędzi (tool search) jest domyślnie włączone w Claude Code 2.1.283 i codex-cli 0.157.1), więc dwie definicje narzędzi kosztują niewiele. Prawdziwym kosztem jest wynik `query-docs`, który przy każdym wywołaniu trafia do kontekstu. Szerokie pytanie w stylu „przeczytaj dokumentację Expressa” zwraca dużo więcej niż „sekcja o middleware uwierzytelniania”.

Zmierz to, zamiast zgadywać. W Claude Code uruchom `/context` przed jednym wyszukaniem i po nim; dla pluginu `claude plugin details context7` pokazuje przewidywany koszt w tokenach, choć ta liczba pomija schematy narzędzi MCP. Ograniczaj zapytania do jednego pojęcia, a dłuższe poszukiwania przenieś do subagenta, żeby do głównej sesji wróciło tylko podsumowanie. Ogólny wzorzec opisuje strona o [obniżaniu kosztu tokenów MCP](/pl/ecosystem/mcp/reducing-mcp-token-cost/).

## Jak popularny jest Context7?

Stan na 2026-09-26: 62,4 tys. gwiazdek repozytorium `upstash/context7` na GitHubie, wpis `io.github.upstash/context7` 4.1.1 w oficjalnym MCP Registry i 417 801 instalacji pluginu `context7` w katalogu pluginów Claude (`claude.com/plugins`). Nie podajemy liczby pobrań z npm, bo jej nie odczytano.

## Inne serwery dokumentacji i kiedy lepszy jest skill dostawcy

Context7 szeroko pokrywa biblioteki open source. Dla platformy jednego dostawcy jego własny serwer albo skill jest zwykle pełniejszy.

| Źródło | Do czego | Instalacja (pokazano Claude Code) | Uwierzytelnianie | Dowód |
| --- | --- | --- | --- | --- |
| **Microsoft Learn MCP** | Dokumentacja i przykłady kodu dla Azure, .NET i Microsoft 365. Narzędzia: `microsoft_docs_search`, `microsoft_docs_fetch`, `microsoft_code_sample_search`. `?maxTokenBudget=2000` w adresie ogranicza rozmiar odpowiedzi | `claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp` | Brak | Zweryfikowane; 1,9 tys. gwiazdek; plugin `microsoft-docs` |
| **AWS Knowledge MCP** | Dokumentacja i wytyczne AWS | `claude mcp add --transport http aws-knowledge https://knowledge-mcp.global.api.aws` | Brak; limitowane | Zweryfikowane |
| **Hugging Face MCP** | Modele, zbiory danych i Spaces na Hubie | `claude mcp add hf-mcp-server -t http "https://huggingface.co/mcp?login"` | Logowanie lub token HF | Zweryfikowane (README dostawcy) |
| **DeepWiki MCP** | Pytania o budowę publicznego repozytorium na GitHubie. Narzędzia: `read_wiki_structure`, `read_wiki_contents`, `ask_question` | `claude mcp add --transport http deepwiki https://mcp.deepwiki.com/mcp` | Brak; tylko publiczne repozytoria | **Źródło wtórne**: z dokumentacji i bloga Cognition przez fragmenty wyszukiwarki, bez pobrania strony |
| **Fetch (serwer referencyjny)** | Pojedyncza strona, której Context7 nie zaindeksował, np. changelog | `claude mcp add fetch -- uvx mcp-server-fetch` | Brak | Zweryfikowane; pakiet Pythona, uruchamiany przez `uvx`, nie `npx` |

W Codex zdalne serwery dodasz poleceniem `codex mcp add <name> --url <url>`, a w Cursorze formą z `url` w `mcp.json` pokazaną wyżej. Linie dla Microsoft Learn i AWS złożono z adresu podanego przez dostawcę i zweryfikowanej składni `claude mcp add`.

**Skille dostawców, które zastępują wyszukiwanie w dokumentacji.** Część frameworków dostarcza dziś wiedzę razem z samym frameworkiem:

- **Next.js**: skille workflow są w repozytorium frameworka (`npx skills add vercel/next.js`), a od Next.js 16.3 wiedza referencyjna trafia do dokumentacji dołączonej do pakietu oraz do `AGENTS.md`/`CLAUDE.md` generowanego przez `next dev`. Na Next.js 16.1 lub starszym `npx @next/codemod@canary agents-md` pobiera dokumentację dopasowaną do wersji. Starsze repozytorium `vercel-labs/next-skills` jest wycofane.
- **Stripe**: `npx skills add https://docs.stripe.com` instaluje skille Stripe prosto z jego strony z dokumentacją.
- **Skille z indeksu Context7**: `npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev` instaluje skill dostawcy przez CLI `ctx7`.

Reguła decyzyjna: gdy dokumentacja jest dołączona do zainstalowanego pakietu, wybierz ją, bo z definicji pasuje do wersji z lockfile'a. Context7 stosuj, gdy biblioteka takiej dokumentacji nie ma, a Fetch, gdy Context7 jej nie zaindeksował. Instalację i aktualizację skilli opisuje strona o [instalowaniu i zarządzaniu skillami](/pl/ecosystem/skills/installing-managing/).

## Gdy Context7 zwraca złą dokumentację albo żadnej

**Agent trafił w złą bibliotekę.** Fork albo pakiet o podobnej nazwie wygrywa ranking, a kod używa API, którego w twojej bibliotece nie ma. Wyjście: przypnij ID (`use library /owner/repo`) i dopisz przypięte ID głównych zależności do `CLAUDE.md` lub `AGENTS.md`.

**Dokumentacja dotyczy złej wersji.** Agent pobrał dokumentację najnowszego wydania, a lockfile przypina starsze. Wyjście: każ mu najpierw odczytać wersję z `package.json` lub lockfile'a i podać ją w zapytaniu, tak jak robią to prompty powyżej; według README Context7 dopasowuje wersję wymienioną w prompcie. Jeśli podejrzewasz, że indeks nie nadąża za wydaniem, podaj agentowi adres changeloga biblioteki przez serwer Fetch i poproś o porównanie obu źródeł.

**Context7 nie zna biblioteki.** Wyjście: potwierdź to poleceniem `npx ctx7 library <name>`, a potem podaj agentowi adres dokumentacji przez serwer Fetch albo zainstaluj skill dostawcy. Autorzy bibliotek mogą zgłosić swoją dokumentację do Context7.

**Agent w ogóle go nie wywołuje.** Odpowiada z danych treningowych, bo nic mu nie kazało sprawdzać. Wyjście: dopisz regułę z tej strony do pliku instrukcji agenta albo przejdź na tryb CLI + Skills, którego skill sam uruchamia się przy pytaniach o biblioteki.

**Żądania kończą się błędem 403 lub 429.** Użycie anonimowe ma niższe limity, a firmowe proxy może blokować `mcp.context7.com`. Wyjście: dodaj klucz API; poproś o dopuszczenie hosta; dla prywatnego wdrożenia `ctx7 setup` przyjmuje `--base-url`.

**Klucz trafił do Gita.** Ktoś wkleił go do `.mcp.json` albo `.cursor/mcp.json`. Wyjście: unieważnij i wygeneruj klucz na nowo w panelu Context7, a potem używaj `${CONTEXT7_API_KEY}` w Claude Code, `bearer_token_env_var` w Codex albo globalnego `~/.cursor/mcp.json` w Cursorze.

**Zła nazwa pakietu.** `@context7/mcp`, `@upstash/context7` i `context7-mcp` zwracają w npm 404. Serwer to `@upstash/context7-mcp`, a CLI to `ctx7`. Wyjście: zainstaluj `@upstash/context7-mcp` jako serwer albo uruchom `npx ctx7` jako CLI, a każdą nazwę sprawdź poleceniem `npm view <name> version`, zanim dopiszesz ją do konfiguracji.

**Pułapki: nazwy i flagi, których nie ma**

Nie kopiuj tych zapisów ze starszych artykułów ani z podpowiedzi agenta (sprawdzone 2026-09-26 w npm, Claude Code 2.1.283 i codex-cli 0.157.1):

- **`@context7/mcp`, `@upstash/context7`, `context7-mcp`**: wszystkie zwracają w npm 404. Serwer to `@upstash/context7-mcp`.
- **`get-library-docs`**: nazwa narzędzia tylko w serwerze 1.x. Wersja 4.1.1 udostępnia `resolve-library-id` i `query-docs`.
- **`headers = {…}` w pliku `config.toml` Codex**: parsuje się i jest po cichu ignorowane, więc serwer działa bez twojego klucza. Użyj `bearer_token_env_var`, `http_headers` albo `env_http_headers`.
- **`claude mcp add -e KEY=value context7 …`**: gdy `-e` stoi przed nazwą serwera, nazwa zostaje odczytana jako kolejna zmienna środowiskowa i polecenie kończy się błędem. Najpierw podaj nazwę: `claude mcp add context7 -e KEY=value -- …`.

**Co opuszcza twój komputer**

Argument `query` to opis twojego zadania i trafia do hostowanego backendu Context7, który nie jest open source. Nie umieszczaj w zapytaniu sekretów, danych klientów ani kodu objętego tajemnicą. Zwrócona dokumentacja to tekst osób trzecich w kontekście agenta, więc traktuj ją jak niezaufane dane wejściowe, tak jak każdy inny wynik narzędzia. Zobacz [zabezpieczanie serwerów MCP](/pl/ecosystem/mcp/mcp-security/).

## Dokąd dalej z serwerami dokumentacji

- [Niezbędne serwery MCP](/pl/ecosystem/mcp/essential-servers/) — Gdzie Context7 pasuje wśród serwerów, które zespoły instalują najpierw.
- [Dokumentacja jako kontekst dla AI](/pl/workflows/context/documentation-as-context/) — Reguły w CLAUDE.md i AGENTS.md, dzięki którym sprawdzanie dokumentacji staje się domyślne.
- [Kontrola zależności w zmianach agentów](/pl/workflows/test/dependency-verification/) — Wyłapuj wymyślone lub nieprzypięte pakiety, zanim trafią do main.
- [Serwery MCP Microsoft i Azure](/pl/ecosystem/mcp/cloud-platform-mcp/) — Serwer Microsoft Learn obok zarządzania zasobami Azure.
- [Problemy z połączeniem serwera MCP](/pl/ecosystem/mcp/mcp-connection-issues/) — Gdy /mcp pokazuje serwer jako niedziałający albo bez narzędzi.
- [Przegląd MCP](/pl/ecosystem/mcp/) — Jak MCP działa w Claude Code, Codex i Cursorze.
