# Serwery MCP środowiska deweloperskiego: Next.js DevTools, MobileBuildMCP i Hugging Face

URL: https://developertoolkit.ai/pl/ecosystem/mcp/framework-devtools-mcp/
Description: Podłącz Next.js DevTools MCP, MobileBuildMCP i Hugging Face MCP do Claude Code, Codeksa i Cursora, aby błędy buildu, testów i runtime trafiały do agenta.

Serwery MCP środowiska deweloperskiego łączą agenta z narzędziami, które już uruchamiają twoją aplikację. `next-devtools-mcp` czyta bieżące błędy, trasy i logi z endpointu `/_next/mcp` wbudowanego w serwery deweloperskie Next.js 16+. MobileBuildMCP buduje, uruchamia i testuje aplikacje iOS w symulatorach. Serwer Hugging Face przeszukuje Hub. Każdy z nich pozwala agentowi sprawdzić własne zmiany w prawdziwym toolchainie.

Ta strona jest dla programistów, którzy budują aplikacje webowe lub iOS z agentem, i dla tech leadów, którzy decydują, jakie serwery instaluje zespół. Agent zmienia Server Component, melduje „gotowe”, a błąd hydracji znajdujesz dopiero w przeglądarce. Albo poprawia widok SwiftUI, a to ty odpalasz Xcode, żeby się dowiedzieć, że test UI właśnie pada. W obu przypadkach to ty jesteś pętlą między toolchainem a agentem. Te serwery cię z niej wyjmują. Jeśli nie podłączałeś jeszcze serwera MCP do agenta, zacznij od strony [jak działa MCP w Claude Code, Codeksie i Cursorze](/pl/ecosystem/mcp/).

**Sprawdzone 26 września 2026**

Polecenia instalacji uruchomiono w Claude Code 2.1.283 i codex-cli 0.157.1 w projekcie testowym (`claude mcp add -s project` oraz `codex mcp add` na jednorazowym `CODEX_HOME`), a powstałe pliki odczytano. Serwery `next-devtools-mcp` 0.4.0 i `mobilebuildmcp` 2.7.1 uruchomiono przez stdio i zapisano ich odpowiedzi `tools/list`. Zachowanie serwerów pochodzi z repozytoriów dostawców: `vercel/next-devtools-mcp`, `getsentry/MobileBuildMCP` (wraz ze źródłami dokumentacji w `getsentry/xcodebuildmcp.com`) i `huggingface/hf-mcp-server`. Endpoint Hugging Face był niedostępny ze środowiska autora, a Cursora nie było tam wcale, więc JSON dla Cursora odpowiada instrukcjom dostawców i nie był w nim testowany.

## Co zyskujesz dzięki serwerom MCP środowiska deweloperskiego

- Sprawdzone polecenia instalacji trzech serwerów w Claude Code, Codeksie i Cursorze
- Gotowy prompt, który buduje aplikację iOS na symulator iPhone 16, uruchamia testy UI i naprawia pierwszą awarię
- Workflow „serwer deweloperski w pętli” dla Next.js: każda zmiana jest sprawdzana na działającym serwerze, zanim agent pójdzie dalej
- Zmierzony rozmiar schematów narzędzi każdego lokalnego serwera i wskazówkę, kiedy tańsza jest ścieżka przez CLI
- Pułapki: przemianowany pakiet MobileBuildMCP, 60-sekundowy limit czasu w Codeksie i niezacytowany URL z `?login`

## Który serwer MCP odpowiada na które pytanie?

Instaluj serwer dla stosu, który już uruchamiasz. Żaden z nich nie zastępuje testów; każdy daje agentowi dowody, których wcześniej nie widział.

| Serwer | Na jakie pytanie odpowiada agentowi | Transport | Wymagania | Popularność (2026-09-26) |
| --- | --- | --- | --- | --- |
| **Next.js DevTools MCP** (`next-devtools-mcp`, Vercel) | Jakie błędy pokazuje teraz działająca aplikacja i jakie trasy istnieją? | Lokalny stdio (npm 0.4.0), pośredniczy do `/_next/mcp` serwera deweloperskiego | Node.js 20.19+; Next.js 16+ z uruchomionym `npm run dev` | ★823 |
| **MobileBuildMCP** (`mobilebuildmcp`, Sentry; wcześniej XcodeBuildMCP) | Czy aplikacja iOS buduje się, uruchamia i przechodzi testy na tym symulatorze? | Lokalny stdio (npm 2.7.1), także CLI | macOS 14.5+, Xcode 16+, Node.js 18+ (niepotrzebny przy instalacji przez Homebrew) | ★6,4 tys. |
| **Hugging Face MCP** (Hugging Face) | Który model, zbiór danych lub Space na Hubie pasuje do zadania? | Zdalny HTTP, `https://huggingface.co/mcp` | Konto Hugging Face dla narzędzi wymagających uwierzytelnienia | ★298 |

Popularność to gwiazdki GitHuba odczytane przez GitHub search API 2026-09-26 (6427, 823 i 298). Gwiazdki mierzą uwagę poświęconą repozytorium, a nie użycie serwera. Czwarty serwer z tej rodziny, do rejestrów komponentów, to [shadcn/ui MCP](/pl/ecosystem/mcp/shadcn-ui-mcp/), który ma własną stronę.

## Instalacja Next.js DevTools MCP

`next-devtools-mcp` to cienki łącznik. Skanuje typowe porty w poszukiwaniu serwerów deweloperskich Next.js 16+, wypisuje narzędzia runtime, które każdy z nich wystawia pod `/_next/mcp`, i je wywołuje. Next.js 16+ włącza ten endpoint domyślnie, więc serwer deweloperski nie wymaga konfiguracji.

**Claude Code**

```bash
# Terminal, repo root. Project scope writes .mcp.json so the team reviews it
claude mcp add -s project next-devtools -- npx -y next-devtools-mcp@latest
```

**Codex**

```bash
codex mcp add next-devtools -- npx -y next-devtools-mcp@latest
```
W Windows 11 README dostawcy dodaje do bloku serwera w `config.toml` wpisy `env = { SystemRoot="C:\\Windows", PROGRAMFILES="C:\\Program Files" }` i `startup_timeout_ms = 20_000`.

**Cursor**

```json
// .cursor/mcp.json
{ "mcpServers": { "next-devtools": { "command": "npx", "args": ["-y", "next-devtools-mcp@latest"] } } }
```

Serwer ma cztery narzędzia. Pracę wykonują dwa: `nextjs_index` wykrywa działające serwery deweloperskie i ich narzędzia, a `nextjs_call` uruchamia jedno z nich. Narzędzia runtime pochodzą z samego Next.js i zależą od wersji; README wymienia `get_errors` (błędy buildu, runtime i typów), `get_logs` (ścieżka do logu z konsolą przeglądarki i wyjściem serwera), `get_page_metadata`, `get_project_metadata` i `get_server_action_by_id`. Dwa pozostałe to bramki, które tylko kierują agenta dalej: `nextjs_docs` wskazuje dokumentację zgodną z wersją, dołączoną przez Next.js w `node_modules/next/dist/docs/`, a `browser_eval` mówi agentowi, jak zainstalować i uruchomić CLI [agent-browser](/pl/ecosystem/skills/agent-browser/).

Serwer zbiera anonimową telemetrię użycia (nazwy narzędzi, bez argumentów i kodu). Aby z niej zrezygnować, ustaw `NEXT_TELEMETRY_DISABLED=1` w profilu powłoki.

## Instalacja MobileBuildMCP

MobileBuildMCP to jeden pakiet z dwoma trybami: serwerem MCP (`mobilebuildmcp mcp`) i CLI do terminala. Wersja 2.7.1 (2026-09-23) zmieniła nazwę projektu z XcodeBuildMCP. Pakiet, pliki binarne, zmienne środowiskowe `MOBILEBUILDMCP_*` i plik projektu `.mobilebuildmcp/config.yaml` używają już nowej nazwy.

**Claude Code**

```bash
claude mcp add -s project mobilebuild -- npx -y mobilebuildmcp@latest mcp
```

**Codex**

```bash
codex mcp add mobilebuild -- npx -y mobilebuildmcp@latest mcp
```
Buildy i przebiegi testów trwają dłużej niż domyślny limit czasu narzędzia w Codeksie. Dodaj limit do bloku samego serwera; dokumentacja dostawcy zaznacza, że Codex ignoruje `tool_timeout_sec` na najwyższym poziomie dla wywołań MCP:
```toml
# ~/.codex/config.toml
[mcp_servers.mobilebuild]
command = "npx"
args = ["-y", "mobilebuildmcp@latest", "mcp"]
tool_timeout_sec = 600
```

**Cursor**

```json
// .cursor/mcp.json in the workspace root
{ "mcpServers": { "mobilebuild": { "command": "npx", "args": ["-y", "mobilebuildmcp@latest", "mcp"] } } }
```
W globalnym `~/.cursor/mcp.json` dokumentacja dostawcy dodaje `"env": { "MOBILEBUILDMCP_CWD": "${workspaceFolder}" }`, żeby serwer startował w otwartym workspace'ie. Strona dokumentacji wciąż pisze tę zmienną jako `XCODEBUILDMCP_CWD`; zmiana nazwy objęła wszystkie zmienne `XCODEBUILDMCP_*`.

**Fragmenty dla klientów zostały dostosowane, a nie skopiowane**

Strona klientów dostawcy (`clients.mdx` w `getsentry/xcodebuildmcp.com`) nadal pokazuje stary pakiet, `npx -y xcodebuildmcp@latest mcp`. Powyższe polecenia podstawiają `mobilebuildmcp`, którego README MobileBuildMCP używa w tym samym poleceniu. `xcodebuildmcp` zostaje w npm w wersji 2.7.0 i od 2026-07-23 nie ma nowych wydań, więc poprawki po zmianie nazwy trafiają tylko do `mobilebuildmcp`.

Przy instalacji przez Homebrew (`brew tap getsentry/xcodebuildmcp && brew install mobilebuildmcp`) zastąp polecenie `npx` przez `mobilebuildmcp`, a argumenty przez `mcp`. Pomijasz wtedy sprawdzanie pobrania przez npx przy każdym starcie.

Zapisz kontekst buildu raz, żeby każda sesja i każdy członek zespołu celowali w ten sam schemat i symulator. Uruchom interaktywny kreator `mobilebuildmcp setup` albo napisz plik samodzielnie:

```yaml
# .mobilebuildmcp/config.yaml, committed at the workspace root
schemaVersion: 1
enabledWorkflows: ["simulator"]
sessionDefaults:
  projectPath: "./Shop.xcodeproj"
  scheme: "Shop"
  simulatorName: "iPhone 16"
sentryDisabled: true
```

`simulatorName` to przenośny selektor: UUID symulatorów różnią się między maszynami, nazwy nie. `enabledWorkflows` ma domyślnie wartość `["simulator"]`, co daje 20 narzędzi, w tym `build_sim`, `build_run_sim`, `test_sim`, `screenshot` i `snapshot_ui`. Dodaj `"ui-automation"` tylko wtedy, gdy agent ma stukać, przesuwać i pisać w działającej aplikacji. `sentryDisabled: true` wyłącza wewnętrzną telemetrię błędów serwera, którą dostawca ogranicza do usterek samego serwera.

## Zbuduj na symulator iPhone 16, uruchom testy UI, napraw pierwszą awarię

Od tego przykładu zacznij. Używa samego MobileBuildMCP i kończy się zielonym przebiegiem testów, którego nie musiałeś pilnować.

**Prompt do skopiowania: od awarii testu UI w iOS do poprawki**

```text
Use the mobilebuild MCP server. Project Shop.xcodeproj, scheme Shop.
1. Call list_sims. If no "iPhone 16" simulator exists, stop and tell me which iPhone simulators are installed. Do not create one.
2. Set session defaults for this project, scheme and simulator, boot it, and run build_sim. If the build fails, fix the first compiler error only, rebuild, and report.
3. Run test_sim with extraArgs ["-only-testing:ShopUITests"]. List every failure with its test name, assertion message and file:line.
4. Take the FIRST failure only. Read the test and the code under test, explain the cause in two sentences, and decide whether the app or the test is wrong. If the test encodes the intended behaviour, fix the app. Never delete, skip or weaken an assertion.
5. Rerun test_sim with -only-testing for that one test, then for the whole ShopUITests target. Report pass/fail counts before and after, and the path of the .xcresult bundle from the final run.
```

Czego się spodziewać: `session_set_defaults`, `boot_sim`, `build_sim`, potem `test_sim`. Wynik testu wypisuje każdą awarię jako nazwę testu, komunikat asercji i linię źródła, a za nimi ścieżki do logu buildu, pakietu wyników `.xcresult` i produktów testowych w `~/Library/Developer/MobileBuildMCP/workspaces/`. Potem krótka diagnoza, jeden diff i dwa ponowne przebiegi. Jeśli agent proponuje zmianę asercji, złamał regułę 4; odrzuć ten diff.

Gdy awaria jest wizualna, dodaj drugi krok:

**Prompt do skopiowania: pokaż ekran, na którym padł test**

```text
For the failing UI test, run build_run_sim, navigate to the screen the test exercises, and call snapshot_ui and screenshot.
Compare the accessibility identifiers in the snapshot with the ones the test queries. Report any identifier the test expects that is missing on screen, and the view that should carry it.
```

Skryptową stronę tej samej pracy, przygotowaną pod CI (jeden skrypt build-and-test na platformę, przypięte symulatory, przycięte logi), opisują [przepisy dla natywnego iOS i Androida](/pl/cookbook/mobile-development/native-ios-android/).

## Instalacja Hugging Face MCP

Serwer Hugging Face jest hostowany. Łączy agenta z Hubem „and thousands of Gradio AI Applications” (README). Wybierz OAuth, gdy przy klawiaturze siedzi człowiek, a token do przebiegów bez interakcji.

**Claude Code**

```bash
# OAuth: quote the URL, or zsh treats ? as a glob and stops with "no matches found"
claude mcp add -s project --transport http huggingface "https://huggingface.co/mcp?login"
```
Token zamiast OAuth. Pojedyncze cudzysłowy zostawiają zmienną nierozwiniętą w `.mcp.json`; Claude Code rozwija ją przy starcie:
```bash
claude mcp add -s project --transport http huggingface https://huggingface.co/mcp \
  -H 'Authorization: Bearer ${HF_TOKEN}'
```

**Codex**

```bash
codex mcp add huggingface --url https://huggingface.co/mcp --bearer-token-env-var HF_TOKEN
```
To polecenie zapisuje `bearer_token_env_var = "HF_TOKEN"`. README nie podaje wiersza dla Codeksa. Dla OAuth dodanie URL-a z `?login` i uruchomienie `codex mcp login huggingface` idzie tym samym wzorcem co w Claude Code, ale nie zostało przetestowane.

**Cursor**

```json
// .cursor/mcp.json; the same config the README's one-click Cursor install link adds
{ "mcpServers": { "huggingface": { "url": "https://huggingface.co/mcp?login" } } }
```
Wariant z tokenem w README używa `"url": "https://huggingface.co/mcp"` z nagłówkiem `Authorization: Bearer`. Trzymaj token w zmiennej środowiskowej, a nie w pliku.

Po instalacji wybierz narzędzia i Space'y wystawiane przez serwer na `huggingface.co/settings/mcp`. Dodaj `?no_image_content=true` do URL-a, żeby usunąć bloki obrazów zwracane przez Space'y Gradio. Przy tokenie utwórz token tylko do odczytu: narzędzia, które tworzą repozytoria, uruchamiają Jobs lub startują sandboksy, wymagają uwierzytelnienia, a token z prawem zapisu pozwala agentowi ich użyć.

**Prompt do skopiowania: krótka lista modeli przed wdrożeniem**

```text
Use the huggingface MCP server, read-only. I need a sentence-embedding model for semantic search over English support tickets, running on CPU in under 100 ms per ticket.
Search the Hub for candidates. For the five most downloaded, report: repo ID, parameter count, embedding size, licence exactly as the model card states it, and last update date.
Do not recommend any model whose card has no licence. Then write eval/embeddings_eval.py that scores each shortlisted model on tests/fixtures/tickets_sample.jsonl (recall@5 against the labelled duplicates) and times it on CPU. Do not download any model until I approve the shortlist.
```

Hub odpowiada na pytanie „co istnieje”, a twoja ewaluacja na pytanie „co działa u nas”. Sprawdzenie licencji ma znaczenie, bo licencja wag jest na karcie modelu i może różnić się od licencji repozytorium kodu. Hugging Face publikuje też skille, które obsługują CLI `hf` (w Claude Code: `/plugin marketplace add huggingface/skills`, potem `/plugin install hf-cli@huggingface-skills`). To lepszy wybór, gdy agent ma pobierać, wysyłać albo uruchamiać Jobs, a nie tylko szukać. Wpis `huggingface-skills` w katalogu Claude Marketplace pokazywał 34 575 instalacji 2026-09-26.

## Uruchom serwer deweloperski w pętli

Wzorzec wspólny dla wszystkich trzech serwerów: agent nigdy nie melduje „gotowe” na podstawie samego diffa. Najpierw pyta działający toolchain. Oto on dla Next.js.

1. **Uruchom serwer deweloperski samodzielnie.** Odpal `npm run dev` w drugim terminalu i zostaw go włączonego. Next.js 16+ serwuje `/_next/mcp` na tym samym porcie. Własny start daje jeden serwer na worktree i port, który znasz.

2. **Najpierw napisz kryterium akceptacji.** Agent dodaje lub wskazuje test, który dowodzi zmiany: test Playwright dla trasy, test jednostkowy dla Server Action. Uruchamia go i potwierdza, że pada. Zobacz [kryteria akceptacji, które agent potrafi sprawdzić](/pl/workflows/plan/acceptance-criteria/).

3. **Edytuj, potem pytaj serwer.** Po każdej edycji agent wywołuje `nextjs_call` z `get_errors` na twoim porcie. Zero błędów buildu, runtime i typów to warunek przejścia dalej. Nowy błąd wraca do tej samej tury razem z plikiem i linią podanymi przez serwer.

   **Prompt do skopiowania: zmiana w Next.js z serwerem deweloperskim jako bramką**

   ```text
   The Next.js dev server is running on port 3000. Use the next-devtools MCP server.
   Task: add an "Order history" page at /account/orders that lists the signed-in user's orders from getOrders() in lib/orders.ts, newest first, 20 per page.
   Before editing, call nextjs_index and nextjs_call get_page_metadata to see the existing routes, and call nextjs_docs and read the docs it points to in node_modules/next/dist/docs/ rather than relying on memory.
   First write tests/e2e/orders.spec.ts and run it; it must fail.
   After EVERY file edit, call nextjs_call with toolName get_errors on port 3000. If it returns any error, fix it before the next edit.
   When get_errors is empty, request /account/orders, check the dev log from get_logs for new warnings, then run the e2e test and npm run typecheck.
   Report the final get_errors output, the test result and the typecheck result. Do not start or stop the dev server.
   ```

4. **Sprawdź stronę, nie tylko serwer.** Błędy po stronie serwera to połowa obrazu; niezgodności hydracji i wyjątki klienta widać w przeglądarce. `browser_eval` kieruje agenta do agent-browser, albo użyj [Playwright MCP](/pl/ecosystem/mcp/playwright-mcp/), żeby załadować trasę i odczytać konsolę.

5. **Przekaż dowody.** Pull request zawiera test, który najpierw padał, a potem przeszedł, pusty wynik `get_errors` i wynik sprawdzania typów, jak w [pakiecie dowodów](/pl/workflows/ship/evidence-bundle/). CI ponownie uruchamia testy, typy i lint; sprawdzenie na serwerze deweloperskim nigdy ich nie zastępuje.

Pętla jest identyczna we wszystkich trzech agentach. Różni się tym, jak utrzymać ją bezpieczną i szybką:

**Claude Code**

Wpisz regułę do `CLAUDE.md`, żeby nie powtarzać jej w każdym prompcie: „After editing files under `app/`, call `nextjs_call get_errors` on the dev server before reporting.” Gdy zadanie dotyka więcej niż kilku tras, zacznij w trybie planowania, żeby zatwierdzić listę plików przed edycjami.

**Codex**

Wpisz tę samą regułę do `AGENTS.md`. Dla MobileBuildMCP trzymaj `tool_timeout_sec` w bloku serwera; bez tego długi przebieg `test_sim` kończy się przekroczeniem czasu, które agent może wziąć za awarię testu.

**Cursor**

Wpisz regułę do reguły projektu w `.cursor/rules/`. Przeglądaj każdy diff w edytorze jak zwykle; wynik `get_errors` w transkrypcie agenta mówi ci, czy serwer widział czysty build.

## Skąd wiesz, że zmiana agenta działa?

- **Test najpierw padł, potem przeszedł.** Dla Next.js test e2e lub jednostkowy; dla iOS przebieg `test_sim` przed zmianą i po niej. Test, który tylko przechodzi, niczego nie dowodzi o tej zmianie.
- **Zgadza się toolchain, a nie agent.** Ostatni wynik `get_errors` jest pusty albo ostatni `test_sim` zgłasza zero awarii i podaje swój pakiet `.xcresult`. W raporcie żądaj surowego wyniku, nie jego streszczenia.
- **Asercje się nie ruszyły.** W review najpierw porównaj pliki testów. Poprawka, która zmienia asercję, dodaje skip albo wydłuża timeout, potrzebuje uzasadnienia w pull requeście.
- **CI pozostaje bramką merge'a.** Testy, `npm run typecheck`, lint i skrypt buildu iOS działają w CI dla każdej zmiany. Serwery MCP czynią wewnętrzną pętlę agenta uczciwą; niczego nie zatwierdzają.
- **Zatwierdza człowiek.** Właściciel kodu przegląda dowody i scala zmianę. Listę kontrolną review znajdziesz na stronie [jak przeglądać pull request agenta](/pl/workflows/ship/agent-pr-review/).

## Ile kontekstu kosztują serwery MCP środowiska deweloperskiego?

Zmierzone 2026-09-26 jako liczba znaków tablicy narzędzi w odpowiedzi `tools/list` każdego serwera. Wartości są zaokrąglone, bo dokładny wynik zmienia się o kilka procent zależnie od serializacji (zwarty JSON albo pełna odpowiedź JSON-RPC):

| Serwer | Narzędzia | Rozmiar odpowiedzi `tools/list` |
| --- | --- | --- |
| `next-devtools-mcp` 0.4.0 | 4 | Około 6 tys. znaków |
| `mobilebuildmcp` 2.7.1, domyślny workflow `simulator` | 24 (20 narzędzi symulatora i 4 narzędzia domyślnych ustawień sesji) | Około 115 tys. znaków; około 16 tys. bez bloków `outputSchema` |
| `mobilebuildmcp` 2.7.1, `simulator` i `ui-automation` | 36 | Około 235 tys. znaków; około 28 tys. bez bloków `outputSchema` |

Serwer Next.js jest na tyle mały, że można go zostawić włączonego. Nazwy, opisy i schematy wejścia MobileBuildMCP są umiarkowane, ale schematy wyjścia są duże. Claude Code 2.1.283 i codex-cli 0.157.1 mają włączone wyszukiwanie narzędzi MCP, które odracza schematy do chwili, gdy narzędzie jest potrzebne; uruchom `/context` w Claude Code przed dodaniem serwera i po nim, żeby zobaczyć, ile faktycznie płaci twoja sesja. Ogranicz `enabledWorkflows` do tego, czego wymaga zadanie: samo dodanie `ui-automation` mniej więcej podwaja odpowiedź.

Tańszą drogą dla iOS jest CLI: `npx -y mobilebuildmcp@latest init` instaluje opcjonalny skill CLI, który uczy agenta uruchamiać polecenia `mobilebuildmcp` (na przykład `mobilebuildmcp simulator build --scheme Shop --project-path ./Shop.xcodeproj`) przez powłokę. Używaj serwera MCP, gdy chcesz stanowych ustawień sesji i ustrukturyzowanych wyników testów; skilla CLI, gdy brakuje kontekstu. Więcej technik opisuje strona [ograniczanie kosztu tokenów MCP](/pl/ecosystem/mcp/reducing-mcp-token-cost/).

## Co się psuje w serwerach MCP środowiska deweloperskiego i jak to naprawić?

**`[error] No server info found` z `nextjs_index`.** Nie działa żaden serwer deweloperski Next.js 16+ albo nie wystartował. Uruchom go przez `npm run dev`, potwierdź, że Next.js ma wersję 16 lub nowszą (starsze wersje nie mają `/_next/mcp`), i sprawdź terminal pod kątem błędów startu. `nextjs_docs` i `browser_eval` działają bez serwera.

**Agent czyta błędy z niewłaściwej aplikacji.** `nextjs_index` skanuje typowe porty, więc przy dwóch uruchomionych worktree znajduje dwa serwery. Podaj port w prompcie, tak jak robi to prompt pętli deweloperskiej powyżej.

**`ERR_MODULE_NOT_FOUND` wskazujący na `next-devtools-mcp/dist`.** Nieaktualna pamięć podręczna npx. Wyczyść cache npx i uruchom agenta ponownie; według README serwer zainstaluje się wtedy od nowa.

**Codex zgłasza `timed out awaiting tools/call after 60s` przy buildzie.** Dodaj `tool_timeout_sec = 600` wewnątrz `[mcp_servers.mobilebuild]`, a nie na najwyższym poziomie `config.toml`, i zrestartuj sesję.

**MobileBuildMCP ignoruje zmienne środowiskowe lub konfigurację.** Nadal mają starą nazwę. Zmień `XCODEBUILDMCP_*` na `MOBILEBUILDMCP_*` i przenieś `.xcodebuildmcp/` do `.mobilebuildmcp/`. Potem sprawdź pakiet: `xcodebuildmcp` jest zamrożony na 2.7.0.

**`list_sims` nie ma iPhone 16.** Dostępne urządzenia symulatora zależą od zainstalowanych runtime'ów Xcode. Wybierz zainstalowane urządzenie i zaktualizuj `simulatorName` w zacommitowanej konfiguracji albo utwórz urządzenie samodzielnie w Xcode. Nie pozwól agentowi pobierać runtime'ów przy okazji zadania testowego.

**Buildy na urządzenie padają na podpisywaniu.** Narzędzia urządzeń wymagają wcześniej skonfigurowanego podpisywania kodu w Xcode. Trzymaj przebiegi agenta na symulatorach, dopóki podpisywanie nie jest gotowe.

**`claude mcp add … https://huggingface.co/mcp?login` kończy się `no matches found`.** zsh potraktował `?` jako glob. Weź URL w cudzysłów.

**Agent wykonuje polecenia znalezione w karcie modelu lub w wyniku Space'a.** Treści na Hubie pisze każdy, a trafiają do modelu jako tekst, który może uznać za instrukcje. Trzymaj token tylko do odczytu, nie łącz serwera Hugging Face z serwerami z prawem zapisu w tej samej sesji i przeczytaj [bezpieczeństwo MCP](/pl/ecosystem/mcp/mcp-security/), zanim go podłączysz. Problemy z połączeniem w ogóle opisuje strona [problemy z połączeniem serwerów MCP](/pl/ecosystem/mcp/mcp-connection-issues/).

**Pułapki, które wyglądają dobrze, a są błędne (sprawdzone 2026-09-26)**

- `xcodebuildmcp` i nazwa serwera `XcodeBuildMCP` w starszych poradnikach: stary pakiet, zamrożony na 2.7.0. Używaj `mobilebuildmcp` (2.7.1).
- Narzędzia `upgrade_nextjs_16`, `enable_cache_components` i `init` w `next-devtools-mcp`: usunięte w 0.4.0. Workflowy aktualizacji i Cache Components są teraz dystrybuowane jako skille agentów.
- `@vercel/mcp`: nie istnieje w npm. Serwer platformy Vercel (projekty, wdrożenia, logi) to osobny, zdalny serwer; `next-devtools-mcp` rozmawia tylko z twoim lokalnym serwerem deweloperskim.
- `claude mcp add --url …`: `--url` to flaga Codeksa. Claude Code używa `--transport http <name> <url>`.
- `-H "Authorization: Bearer hf_…"` wklejone z prawdziwym tokenem: trafia do `.mcp.json` i historii powłoki. Odwołuj się do `${HF_TOKEN}`.
- `tool_timeout_sec` na najwyższym poziomie `config.toml` w Codeksie: ignorowany dla wywołań narzędzi MCP. Należy do bloku serwera.
- `/plugin install hf-cli@huggingface/skills`, jak zapisują to niektóre instrukcje Hugging Face: w Claude Code 2.1.283 kończy się błędem `Plugin "hf-cli" not found`. Marketplace nazywa się `huggingface-skills`.
- `claude mcp add -e KEY=value mobilebuild -- …`: `-e` przyjmuje kilka wartości, więc połyka nazwę serwera. Podaj `-e` po nazwie, tak jak pokazuje `claude mcp add --help`.

## Dokąd dalej po serwerach MCP środowiska deweloperskiego

- [shadcn/ui MCP](/pl/ecosystem/mcp/shadcn-ui-mcp/) — Dodawaj komponenty z shadcn i własnych rejestrów do aplikacji Next.js, którą sprawdza ta pętla.
- [agent-browser](/pl/ecosystem/skills/agent-browser/) — CLI, do którego kieruje browser_eval: agent otwiera stronę i sprawdza ją jak użytkownik.
- [Przepisy dla natywnego iOS i Androida](/pl/cookbook/mobile-development/native-ios-android/) — Skryptowa pętla build-and-test dla CI obok MobileBuildMCP w wewnętrznej pętli agenta.
- [Najlepsze serwery MCP](/pl/ecosystem/mcp/top-mcp-servers/) — Gdzie te trzy serwery plasują się wśród serwerów, które zespoły instalują najpierw.
