{"id":17825,"date":"2026-09-13T19:45:00","date_gmt":"2026-09-13T17:45:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=17825"},"modified":"2026-09-09T21:29:30","modified_gmt":"2026-09-09T19:29:30","slug":"claude-code-integracje-gtm-serwer-mcp-koszt-kontekstu","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/cloud-ai-pl\/claude-code-integracje-gtm-serwer-mcp-koszt-kontekstu\/","title":{"rendered":"Integracje GTM dla Claude Code: trzy serwery MCP, liczba narz\u0119dzi i koszt kontekstu"},"content":{"rendered":"

Kontener Google Tag Managera to dokument JSON, kt\u00f3ry rozstrzyga, jakie skrypty \u0142aduje witryna i kiedy. Zmiana takiego kontenera przez prompt oznacza przekazanie modelowi j\u0119zykowemu prawa zapisu do tego dokumentu. Ciekawe pytanie nie brzmi, czy to dzia\u0142a \u2014 dzia\u0142a \u2014 lecz czego dok\u0142adnie model mo\u017ce dotkn\u0105\u0107 i ile kosztuje samo pod\u0142\u0105czenie, zanim powstanie pierwszy tag.<\/p>\n

Na potrzeby tego artyku\u0142u zmierzono 9 wrze\u015bnia 2026 roku trzy integracje: trzy serwery MCP, ka\u017cdy uruchomiony przez npx<\/code> po stdio na Raspberry Pi 5 z Node 20.19.2 i zapytany o list\u0119 narz\u0119dzi, a do tego API Tag Managera v2, na kt\u00f3rym wszystkie trzy si\u0119 opieraj\u0105. Liczby poni\u017cej pochodz\u0105 z tych uruchomie\u0144 oraz z dokumentu discovery samego API, nie z plik\u00f3w README.<\/p>\n

\n\"Droga
Droga zmiany, rozmiar trzech zmierzonych list narz\u0119dzi oraz rozk\u0142ad 106 metod API na siedem zakres\u00f3w.<\/figcaption><\/figure>\n

Trzy drogi, kt\u00f3rymi kontener trafia do modelu<\/h2>\n

Claude Code sam z siebie nie wie nic o Tag Managerze. Wszystko, co da si\u0119 zrobi\u0107 z kontenerem, przychodzi jedn\u0105 z trzech dr\u00f3g, a tylko dwie z nich dok\u0142adaj\u0105 jak\u0105kolwiek zdolno\u015b\u0107.<\/p>\n

Serwer MCP<\/strong> to proces, kt\u00f3ry Claude Code uruchamia i z kt\u00f3rym rozmawia po stdio albo HTTP. Serwer publikuje list\u0119 narz\u0119dzi, a ka\u017cde z nich pojawia si\u0119 w sesji pod nazw\u0105 mcp__<serwer>__<narz\u0119dzie><\/code>. Na t\u0119 w\u0142a\u015bnie nazw\u0119 reaguj\u0105 p\u00f3\u017aniej regu\u0142y uprawnie\u0144 i haki \u2014 dlatego warto j\u0105 zna\u0107.<\/p>\n

Droga przez wiersz polece\u0144<\/strong> nie wymaga \u017cadnego serwera. Wystarczy token dost\u0119pu i curl<\/code>, a zapytanie model uk\u0142ada sam. Nic nie l\u0105duje wcze\u015bniej w kontek\u015bcie, ale te\u017c nic nie znika za obudow\u0105 \u2014 wymiana brzmi: wygoda za przejrzysto\u015b\u0107.<\/p>\n

Skill albo polecenie ze slashem<\/strong> nie dok\u0142ada \u017cadnej zdolno\u015bci. Zawiera przepis: konwencj\u0119 nazewnicz\u0105, list\u0119 kontroln\u0105, kolejno\u015b\u0107, w jakiej regu\u0142a musi istnie\u0107, zanim tag b\u0119dzie m\u00f3g\u0142 si\u0119 do niej odwo\u0142a\u0107. To zmienia, co model robi na dw\u00f3ch pozosta\u0142ych drogach, nigdy za\u015b to, co mu wolno. Mylenie jednego z drugim jest najcz\u0119stszym nieporozumieniem wok\u00f3\u0142 s\u0142owa \u201eintegracja”.<\/p>\n

Co le\u017cy pod spodem: 106 metod, siedem zakres\u00f3w, jedna przestrze\u0144 robocza<\/h2>\n

Wszystkie drogi ko\u0144cz\u0105 si\u0119 w tym samym miejscu. Dokument discovery API Tag Managera v2, wersja 20260902 o rozmiarze 270 858 bajt\u00f3w, opisuje 106 metod w 18 zasobach<\/strong>: 38 GET, 38 POST, 15 PUT i 15 DELETE.<\/p>\n

Dziesi\u0119\u0107 z tych zasob\u00f3w mie\u015bci si\u0119 wewn\u0105trz przestrzeni roboczej \u2014 tagi, regu\u0142y, zmienne, zmienne wbudowane, foldery, szablony, klienty, transformacje, strefy i konfiguracja gtag. Przestrze\u0144 robocza to szkic. To, co zostanie tam zapisane, nie dociera do \u017cadnego odwiedzaj\u0105cego, cho\u0107by by\u0142o zupe\u0142nie b\u0142\u0119dne.<\/p>\n

Mi\u0119dzy szkicem a stron\u0105 na \u017cywo stoj\u0105 jeszcze dwa kroki. workspaces.create_version<\/code> zamra\u017ca przestrze\u0144 robocz\u0105 w wersj\u0119 kontenera, a versions.publish<\/code> czyni t\u0119 wersj\u0119 aktywn\u0105. Zakres tagmanager.publish<\/code> obejmuje dok\u0142adnie dwie ze 106 metod<\/strong>: wywo\u0142anie publikacji i environments.reauthorize<\/code>. Wszystko inne, co integracja potrafi zrobi\u0107, pozostaje z za\u0142o\u017cenia niewidoczne dla odwiedzaj\u0105cych, dop\u00f3ki osobne wywo\u0142anie nie postanowi inaczej.<\/p>\n

# Odczyt tagow: sciezka niesie konto, kontener i przestrzen robocza.\n# Identyfikator przestrzeni jest obowiazkowy - do tagow na zywo\n# nie prowadzi zadna trasa.\nACC=6012345678; CONT=123456789; WS=42\ncurl -s -H \"Authorization: Bearer $TOKEN\" \\\n  \"https:\/\/tagmanager.googleapis.com\/tagmanager\/v2\/accounts\/$ACC\/containers\/$CONT\/workspaces\/$WS\/tags\"\n\n# Bez tokenu kazda metoda odpowiada tak samo:\n# {\"error\":{\"code\":401,\"status\":\"UNAUTHENTICATED\",\n#   \"details\":[{\"reason\":\"CREDENTIALS_MISSING\"}]}}<\/code><\/pre>\n
Pi\u0119tna\u015bcie schemat\u00f3w API prowadzi pole fingerprint<\/code>, kt\u00f3rego warto\u015b\u0107 zmienia si\u0119 przy ka\u017cdej zmianie obiektu. Aktualizacja z nieaktualnym odciskiem zostaje odrzucona, zamiast nadpisa\u0107 zmian\u0119, kt\u00f3r\u0105 w mi\u0119dzyczasie wprowadzi\u0142 kto\u015b w przegl\u0105darce.<\/p>\n
Trzy serwery MCP, trzy sposoby poci\u0119cia tego samego API<\/h2>\n\n\n\n\n\n
Serwer<\/th>\nNarz\u0119dzia<\/th>\ntools\/list<\/th>\n\u2248 tokeny<\/th>\nKr\u00f3j<\/th>\n<\/tr>\n
google-tag-manager-mcp-server<\/code> 5.1.1<\/td>\n18<\/td>\n108 201 B<\/td>\n27 000<\/td>\njedno narz\u0119dzie na rodzaj obiektu, akcja jako parametr<\/td>\n<\/tr>\n
gtm-mcp<\/code> 1.0.0<\/td>\n104<\/td>\n49 656 B<\/td>\n12 400<\/td>\nmniej wi\u0119cej jedno narz\u0119dzie na metod\u0119 API<\/td>\n<\/tr>\n
@theethosteam\/gtm-mcp<\/code> 1.1.1<\/td>\n33<\/td>\n19 797 B<\/td>\n4 900<\/td>\nbli\u017cej zadania, pi\u0119\u0107 przepis\u00f3w i wywo\u0142anie surowe<\/td>\n<\/tr>\n<\/table>\n
Pierwszy pakuje ca\u0142e API za 18 narz\u0119dzi. Siedemna\u015bcie z nich przyjmuje parametr action<\/code>, kt\u00f3ry niesie \u0142\u0105cznie 101 akcji, z czego 38 tylko czyta; samo gtm_tag<\/code> obejmuje create, get, list, update, remove i revert. Osiemnaste, gtag_destination<\/code>, jedynie wypisuje list\u0119.<\/p>\n
Drugi odwzorowuje API niemal jeden do jednego: 104 narz\u0119dzia wobec 106 metod, 37 z nich nosi nazw\u0119 get_\u2026<\/code> lub list_\u2026<\/code>.<\/p>\n
Trzeci nie idzie za krojem API w og\u00f3le. Obok zwyk\u0142ych wywo\u0142a\u0144 prowadzi pi\u0119\u0107 przepis\u00f3w \u2014 gtm_recipe_ga4_config<\/code>, gtm_recipe_ga4_event<\/code>, gtm_recipe_meta_pixel<\/code> i dwa przepisy na regu\u0142y \u2014 oraz licz\u0105ce 215 bajt\u00f3w wyj\u015bcie awaryjne o nazwie gtm_raw<\/code> na wszystko, czego pozosta\u0142e 32 narz\u0119dzia nie si\u0119gaj\u0105.<\/p>\n
Czwarty kandydat w og\u00f3le nie wystartowa\u0142. @yoryoboy\/gtm-mcp<\/code> 4.1.0 przerwa\u0142 komunikatem Missing required configuration: DATABASE_URL, DB_ENCRYPTION_KEY<\/code>, poniewa\u017c zbudowano go jako hostowan\u0105 us\u0142ug\u0119 wielodost\u0119pn\u0105 z baz\u0105 PostgreSQL za plecami, a nie jako proces lokalny. Publikacja w npm z dopiskiem \u201eMCP server” nie m\u00f3wi nic o tym, czy pakiet uruchomi si\u0119 na stacji roboczej.<\/p>\n
Koszt kontekstu nie kryje si\u0119 w liczbie narz\u0119dzi<\/h2>\n
Trzy listy narz\u0119dzi r\u00f3\u017cni\u0105 si\u0119 rozmiarem o wsp\u00f3\u0142czynnik 5,5, a kolejno\u015b\u0107 nie idzie za liczb\u0105 narz\u0119dzi. Serwer z 18 narz\u0119dziami wysy\u0142a 108 201 bajt\u00f3w definicji, ten z 33 tylko 19 797.<\/p>\n
Dwa narz\u0119dzia odpowiadaj\u0105 za blisko po\u0142ow\u0119 najwi\u0119kszej listy: gtm_version<\/code> z 28 212 bajtami i gtm_workspace<\/code> z 24 594, razem 48,8 procent ze 108 201. Powodem jest zas\u00f3b ContainerVersion. Mieszcz\u0105 si\u0119 w nim tagi, regu\u0142y, zmienne, klienty, foldery, strefy, szablony, transformacje i konfiguracja gtag, wi\u0119c w pe\u0142ni otypowany schemat tego zasobu musi by\u0107 du\u017cy \u2014 i jedzie w komplecie niezale\u017cnie od tego, czy jakakolwiek wersja zostanie kiedykolwiek tkni\u0119ta.<\/p>\n
To nie jest jednorazowy wydatek przy \u0142\u0105czeniu. Definicje narz\u0119dzi nale\u017c\u0105 do zapytania, jad\u0105 wi\u0119c z ka\u017cd\u0105 tur\u0105 sesji. Wynikaj\u0105 z tego dwie rzeczy. Pod\u0142\u0105czenie kilku serwer\u00f3w tego kroju naraz wype\u0142nia spor\u0105 cz\u0119\u015b\u0107 okna kontekstu, zanim praca si\u0119 zacznie. A serwer z lu\u017aniejszymi schematami nie jest z automatu wyborem s\u0142abszym: b\u0142\u0119dny typ pola API wy\u0142apuje w sekund\u0119, podczas gdy dok\u0142adny schemat op\u0142aca si\u0119 w ka\u017cdej pojedynczej turze.<\/p>\n
O tym, co integracja mo\u017ce zmieni\u0107, rozstrzyga token<\/h2>\n
Wszystkie trzy serwery loguj\u0105 si\u0119 u Google tak samo, a w\u0142a\u015bciw\u0105 barierk\u0105 jest zakres OAuth. Ustawienie domy\u015blne najwi\u0119kszego z nich \u017c\u0105da wszystkich siedmiu, wraz z publikacj\u0105 i usuwaniem kontener\u00f3w \u2014 wida\u0107 to w jego src\/constants\/scopes.ts<\/code> jako zwyk\u0142\u0105 list\u0119.<\/p>\n
Ten zbi\u00f3r da si\u0119 zaw\u0119zi\u0107. Serwer czyta GTM_SCOPES<\/code> ze zmiennych \u015brodowiskowych i dzieli po spacjach lub przecinkach. Zaw\u0119\u017cenie dzia\u0142a jednak tylko w jednym z trzech tryb\u00f3w logowania<\/strong>. W kodzie createAuthFromEnv<\/code> przekazuje odczytane zakresy wy\u0142\u0105cznie do ga\u0142\u0119zi kont us\u0142ugowych; ga\u0142\u0105\u017a tokenu od\u015bwie\u017caj\u0105cego dostaje identyfikator klienta, sekret i token, a ga\u0142\u0105\u017a tokenu dost\u0119pu dostaje sam token. Token od\u015bwie\u017caj\u0105cy niesie w sobie zakresy, z kt\u00f3rymi go wystawiono, a postawione obok GTM_SCOPES<\/code> niczego nie zmienia i niczego nie zg\u0142asza.<\/p>\n
{\n  \"mcpServers\": {\n    \"gtm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"google-tag-manager-mcp-server\"],\n      \"env\": {\n        \"GOOGLE_SERVICE_ACCOUNT_KEY\": \"{...}\",\n        \"GTM_SCOPES\": \"https:\/\/www.googleapis.com\/auth\/tagmanager.readonly\"\n      }\n    }\n  }\n}<\/code><\/pre>\n
Druga brama siedzi w samym Tag Managerze. Konto us\u0142ugowe si\u0119gnie kontenera dopiero po wpisaniu jego adresu jako u\u017cytkownika, a to uprawnienie jest stopniowane osobno dla ka\u017cdego kontenera: odczyt, edycja, zatwierdzanie, publikacja. Konto z prawem edycji i zakresem publikacji i tak nie opublikuje.<\/p>\n
Trzecia brama stoi po stronie Claude Code i chwyta za nazw\u0119 narz\u0119dzia. Regu\u0142a blokuj\u0105ca mcp__gtm__gtm_version<\/code> wyjmuje narz\u0119dzie publikacji z zasi\u0119gu nawet tam, gdzie token pozwoli\u0142by na wywo\u0142anie, a hak PreToolUse<\/code> na t\u0119 sam\u0105 nazw\u0119 mo\u017ce zamiast tego za\u017c\u0105da\u0107 potwierdzenia. S\u0105 to wi\u0119c trzy niezale\u017cne bramy, a rozs\u0105dnie jest domkn\u0105\u0107 najbardziej zewn\u0119trzn\u0105 \u2014 token \u2014 bo tylko ona trzyma r\u00f3wnie\u017c wtedy, gdy do kontenera kto\u015b si\u0119gnie spoza tej sesji.<\/p>\n
Gdzie si\u0119 to psuje<\/h2>\n
Update zast\u0119puje, nie uzupe\u0142nia.<\/strong> Pi\u0119tna\u015bcie z 18 opis\u00f3w narz\u0119dzi m\u00f3wi to wprost: ka\u017cde pole nieobecne w \u0142adunku zostaje usuni\u0119te. Model, kt\u00f3ry wysy\u0142a tylko zmieniane pole, sprz\u0105ta reszt\u0119 tagu. Jedena\u015bcie narz\u0119dzi \u017c\u0105da dodatkowo odcisku ostatnio odczytanego stanu, co wymusza odczyt przed ka\u017cdym zapisem i zamienia nieuwa\u017cn\u0105 zmian\u0119 w komunikat b\u0142\u0119du zamiast w strat\u0119.<\/p>\n
Tag nie jest obiektem p\u0142askim.<\/strong> Jego ustawienia le\u017c\u0105 w tablicy parameter<\/code> z\u0142o\u017conej z klucza, typu i warto\u015bci, z o\u015bmioma typami w wyliczeniu \u2014 template<\/code>, integer<\/code>, boolean<\/code>, list<\/code>, map<\/code>, triggerReference<\/code>, tagReference<\/code> i typem nieokre\u015blonym \u2014 przy czym list<\/code> i map<\/code> zagnie\u017cd\u017caj\u0105 w sobie kolejne parametry. To na tej strukturze, a nie na nazwie tagu, wyk\u0142adaj\u0105 si\u0119 generowane \u0142adunki.<\/p>\n
{\n  \"name\": \"GA4 - purchase\",\n  \"type\": \"gaawe\",\n  \"parameter\": [\n    { \"type\": \"template\", \"key\": \"eventName\", \"value\": \"purchase\" },\n    { \"type\": \"tagReference\", \"key\": \"measurementId\",\n      \"value\": \"GA4 Configuration\" },\n    { \"type\": \"list\", \"key\": \"eventParameters\", \"list\": [\n      { \"type\": \"map\", \"map\": [\n        { \"type\": \"template\", \"key\": \"name\",  \"value\": \"value\" },\n        { \"type\": \"template\", \"key\": \"value\", \"value\": \"{{DLV - value}}\" }\n      ]}\n    ]}\n  ],\n  \"firingTriggerId\": [\"17\"]\n}<\/code><\/pre>\n
\u201eGTM” jest w rejestrze pakiet\u00f3w niejednoznaczne.<\/strong> Wyszukanie gtm-mcp<\/code> zwraca obok serwer\u00f3w do Tag Managera tak\u017ce te dla framework\u00f3w go-to-market; @shashwatgtmalpha\/craft-gtm-mcp<\/code> ma go-to-market<\/code> w\u015br\u00f3d s\u0142\u00f3w kluczowych, a growth-mcp<\/code> okre\u015bla si\u0119 jako \u201eopen-source GTM MCP server”, nie maj\u0105c Tag Managera na my\u015bli w og\u00f3le. Lista s\u0142\u00f3w kluczowych rozdziela jedno od drugiego szybciej ni\u017c opis.<\/p>\n
Czego to nie rozwi\u0105zuje<\/h2>\n
\u017badna z tych integracji nie stwierdzi, czy tag rzeczywi\u015bcie si\u0119 uruchamia. quick_preview<\/code> przek\u0142ada przestrze\u0144 robocz\u0105 na wersj\u0119 podgl\u0105dow\u0105; strony nie \u0142aduje i o sp\u00f3\u017anionym data layerze nie powie nic. Ocena poprawno\u015bci zostaje przy sesji podgl\u0105du w przegl\u0105darce, dok\u0142adnie jak wcze\u015bniej.<\/p>\n
API nie zapisuje te\u017c, dlaczego co\u015b zmieniono. Wersja kontenera niesie nazw\u0119 i opis, a oba pozostaj\u0105 puste, o ile nie zostan\u0105 wype\u0142nione w tym samym wywo\u0142aniu \u2014 co czyni opis wersji najta\u0144szym miejscem na odnotowanie, kt\u00f3ry prompt wywo\u0142a\u0142 kt\u00f3r\u0105 zmian\u0119, a zarazem pierwsz\u0105 rzecz\u0105, jakiej brakuje przy tagu zak\u0142adanym w po\u015bpiechu.<\/p>\n
Droga plikowa te\u017c si\u0119 nie zestarza\u0142a. Wyeksportowany kontener to jeden plik JSON, a jego przejrzenie w postaci diffa nie potrzebuje ani tokenu, ani zakresu, ani serwera. Dla zmiany, kt\u00f3r\u0105 pisze model, a czyta cz\u0142owiek, eksport pozostaje drog\u0105 kr\u00f3tsz\u0105 \u2014 przewaga API zaczyna si\u0119 tam, gdzie zmian\u0119 trzeba zastosowa\u0107, a nie tam, gdzie trzeba j\u0105 zrozumie\u0107.<\/p>\n
\n
\u0179r\u00f3d\u0142a<\/h2>\n