GSC MCP dla Codex

Google Search Console w OpenAI Codex

Codex już czyta Twój kod. Daj mu też swoje dane z wyszukiwarki. Serwer GSC Wizard MCP to hostowany endpoint Model Context Protocol, który przekazuje Codex Twoje dane z Search Console, Bing Webmaster i GA4, dzięki czemu agent edytujący Twoje szablony widzi też, które strony tracą kliknięcia, na jakie zapytania rankuje dana strona i czy dany adres URL jest zindeksowany.

Jedno polecenie, bez lokalnego serwera i bez projektu w Google Cloud. Działa w Codex CLI, rozszerzeniu IDE i aplikacji desktopowej, które czytają ten sam plik ~/.codex/config.toml.

codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp
codex mcp login gsc-wizard
Endpoint
https://mcp.gscwizard.com/mcp
Transport
Streamable HTTP
Uwierzytelnianie
OAuth (codex mcp login) or Bearer key
Narzędzia
112 · GSC, Bing, GA4

Darmowy okres próbny, bez karty kredytowej. Dostęp do MCP jest w każdym planie.

01

Dlaczego Search Console powinno być w Codex

Większość poprawek SEO kończy się zmianą w kodzie: szablonem tytułu, tagiem canonical, mapą przekierowań, generatorem mapy witryny, blokiem linkowania wewnętrznego. W asystencie czatowym analizujesz dane, a potem przenosisz wniosek do edytora. W Codex analiza i zmiana odbywają się w tej samej sesji, na tym samym repozytorium.

Dane obok diffa

Zanim Codex przepisze tytuł strony, może sprawdzić, na jakie zapytania ta strona zdobywa kliknięcia, zamiast zgadywać słowa kluczowe.

Analiza działa po stronie serwera

Spadki treści, kanibalizację, krzywe CTR i ocenę okazji liczy serwer. Codex dostaje wnioski i wiersze, na których się opierają, a nie surowy eksport do liczenia na własną rękę.

Więcej historii niż w API

Większość odczytów pochodzi z hurtowni GSC Wizard z Twoimi zapisanymi danymi, która sięga poza 16-miesięczne okno Google i omija próbkowanie wierszy w API.

02

Konfiguracja w trzech krokach

  1. 1

    Podłącz swoje usługi

    Załóż konto GSC Wizard, zaloguj się przez Google i wybierz usługi Search Console, które ma widzieć Codex. Codex może odczytywać tylko usługi podłączone tutaj.

  2. 2

    Dodaj serwer do Codex

    W dowolnym terminalu:

    codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp

    To polecenie zapisuje tabelę [mcp_servers.gsc-wizard] w pliku ~/.codex/config.toml. Możesz też napisać ten blok ręcznie.

  3. 3

    Zaloguj się i sprawdź

    Uruchom logowanie OAuth, które otworzy w przeglądarce ekran zgody GSC Wizard. Potem uruchom Codex i wpisz /mcp, aby sprawdzić, czy narzędzia są na liście.

    codex mcp login gsc-wizard
    codex
    > /mcp
    > List my Search Console sites and show clicks for the last 28 days.
03

Blok w config.toml

Jeśli trzymasz konfigurację Codex w repozytorium z dotfiles albo chcesz ograniczyć to, do czego agent ma dostęp, edytuj ~/.codex/config.toml bezpośrednio.

Minimalna (OAuth)

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"

Klucz API ze zmiennej środowiskowej

bearer_token_env_var wskazuje nazwę zmiennej; Codex wysyła jej wartość jako Authorization: Bearer. Sam klucz nigdy nie trafia do pliku konfiguracyjnego.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
export GSCW_API_KEY="gscw_live_..."

Zawężona: tylko narzędzia potrzebne do zadania

Definicja każdego narzędzia zajmuje kontekst w każdej turze. Dla agenta programistycznego, który ma tylko sprawdzać skuteczność i indeksowanie, lista dozwolonych narzędzi odchudza sesję i zawęża to, do czego mógłby dotrzeć prompt injection ukryty w pobranej treści.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
enabled_tools = [
  "list_sites",
  "get_site_summary",
  "query_top_pages",
  "get_page_performance",
  "get_query_performance",
  "find_decaying_content",
  "analyze_cannibalization",
  "inspect_url",
  "list_sitemaps"
]
tool_timeout_sec = 120

Narzędzia analityczne przy długich zakresach dat mogą trwać dłużej niż zwykłe wyszukanie, więc wysoka wartość tool_timeout_sec chroni przed porzuceniem przez Codex wywołania, na które serwer wciąż odpowiada. Ustaw enabled = false, aby wyłączyć serwer bez usuwania bloku.

04

OAuth czy klucz API

OAuth przez codex mcp login

Najlepsze do pracy interaktywnej na własnym komputerze. Codex wykrywa serwer autoryzacji, rejestruje się i otwiera logowanie w przeglądarce. Nie trzeba kopiować, przechowywać ani rotować żadnego klucza. Przyznany dostęp obejmuje narzędzia odczytu i zapisu i możesz go cofnąć ze swojego konta GSC Wizard.

Klucz gscw_live_ z ograniczonym zakresem

Najlepszy do codex exec, potoków CI, zadań w chmurze i wszystkiego, co działa bez przeglądarki. Utworzysz go w GSC Wizard w Konto → Klucze API; jest pokazywany raz i przechowywany wyłącznie jako skrót.

Dla agentów używaj klucza z zakresem odczytu. Klucz do odczytu nie może wywołać żadnego z 32 narzędzi modyfikujących, takich jak submit_sitemap, submit_indexnow_urls czy add_site. Sprawdzenie odbywa się na serwerze przed wykonaniem narzędzia, więc agenta nie da się namówić do jego obejścia. Poświadczenia Google w ogóle nie trafiają do Codex: trzyma je serwer, a Codex ma wyłącznie poświadczenie GSC Wizard.

05

O co pytać Codex

Najbardziej przydatne prompty łączą dane z wyszukiwarki z repozytorium, które Codex ma otwarte.

Popraw tytuły na podstawie prawdziwych zapytań

„Znajdź strony w example.com na pozycjach od 4 do 15 z CTR poniżej krzywej. Dla każdej znajdź w tym repozytorium szablon lub plik z treścią, który ustawia jej tytuł, i zaproponuj tytuł zawierający jej najważniejsze zapytanie.”

Sprawdź migrację przed wdrożeniem

„Porównaj adresy URL, które ta gałąź usuwa lub zmienia, z 500 stronami o największej liczbie kliknięć w ostatnich 90 dniach. Wypisz każdy adres URL z ruchem, który nie ma przekierowania w redirects.json.”

Znajdź treści do odświeżenia

„Uruchom analizę spadków dla sekcji /blog/, potem otwórz w content/ pięć wpisów, które tracą najwięcej, i przygotuj dla każdego plan aktualizacji na podstawie zapytań, które utraciły.”

Rozwiąż kanibalizację w kodzie

„Znajdź zapytania, na które konkuruje co najmniej dwie nasze strony. Dla każdej pary sprawdź w szablonach linki wewnętrzne i tagi canonical i zasugeruj, która strona powinna wygrać.”

Sprawdź indeksowanie po wdrożeniu

„Sprawdź dziesięć adresów URL dodanych w ostatnim commicie i powiedz mi, które nie są jeszcze zindeksowane, wraz z powodem podanym przez Google.”

Powiedz to Codex raz, w AGENTS.md

Codex czyta AGENTS.md na początku sesji. Kilka linijek tam pozwala nie powtarzać usługi i zasad obowiązujących w projekcie w każdym prompcie.

## Search data
- Search Console property: sc-domain:example.com (use the gsc-wizard MCP tools).
- Before changing a title, meta description or URL, look up the page's
  current queries with get_page_performance and keep its top query in the title.
- Treat the last 3 days as incomplete; report settledThrough with any numbers.
- Never call submit_sitemap or submit_indexnow_urls without asking first.
06

Narzędzia, które Codex może wywoływać

128 narzędzi jest dostępnych dla każdego konta. Każde udostępnia adnotacje MCP, takie jak readOnlyHint i destructiveHint, więc Codex odróżnia odczyty od zapisów, gdy decyduje, czy poprosić o zatwierdzenie.

Grupa Przykładowe narzędzia Zakres
Analityka wyszukiwaniaquery_search_analytics, query_top_queries, query_top_pages, get_page_performanceodczyt
Analizafind_decaying_content, analyze_cannibalization, analyze_ctr_curve, score_opportunitiesodczyt
Wykrywaniedetect_anomalies, detect_change_points, get_ranking_changes, forecast_trafficodczyt
Indeksowanie i on-pageinspect_url, bulk_inspect_urls, list_sitemaps, audit_onpage_seoodczyt
Inne źródłaBing Webmaster, GA4 (w tym ruch z poleceń LLM), Core Web Vitalsodczyt
Mutacjesubmit_sitemap, submit_indexnow_urls, create_annotation, create_topic_clusterzapis

Daty są opcjonalne w każdym narzędziu: pominięty zakres oznacza ostatnie 28 pełnych dni, więc Codex nie musi znać dzisiejszej daty. Narzędzia z limitem wierszy zwracają blok stronicowania informujący, czy są kolejne wiersze, więc agent nie pomyli uciętej listy z pełną. Pełny katalog z argumentami jest pod adresem mcp.gscwizard.com, a szczegóły protokołu w dokumentacji serwera.

07

Rozwiązywanie problemów

/mcp nie pokazuje gsc-wizard

Uruchom codex mcp list, aby sprawdzić, czy wpis istnieje, i upewnij się, że blok w ~/.codex/config.toml to wpis url, a nie command. Po edycji pliku uruchom Codex ponownie; konfigurację czyta przy starcie.

Każde wywołanie zwraca 401 unauthorized

Przy kluczu: zmienna wskazana w bearer_token_env_var musi być wyeksportowana w powłoce, z której uruchomiono Codex, i musi zawierać pełny klucz gscw_live_. Przy OAuth: uruchom ponownie codex mcp login gsc-wizard. W obu przypadkach konto potrzebuje aktywnego okresu próbnego lub subskrypcji i co najmniej jednej podłączonej usługi Search Console.

Narzędzie zapisu zostaje odrzucone

To zakres odczytu robi swoje. Jeśli chcesz, aby Codex zgłaszał mapy witryn lub adresy URL do IndexNow, utwórz klucz z zakresem zapisu albo użyj logowania OAuth, i nie używaj tego poświadczenia w uruchomieniach bez nadzoru.

Wywołania przekraczają limit czasu w dużych usługach

Zwiększ tool_timeout_sec dla serwera i zawęź żądanie: filtr ścieżki lub krótszy zakres dat daje odpowiedź szybciej niż zapytanie o całą witrynę z szesnastu miesięcy.

Liczby różnią się od tych w interfejsie Search Console

Sprawdź pola settledThrough i dataSource w odpowiedzi. Domyślny zakres kończy się na ostatnim pełnym dniu, a interfejs obejmuje też niepełne, najnowsze dni.

08

Najczęściej zadawane pytania

Czy Codex obsługuje zdalne serwery MCP, takie jak GSC Wizard?

Tak. Codex obsługuje serwery MCP przez Streamable HTTP skonfigurowane przez url w ~/.codex/config.toml lub dodane poleceniem codex mcp add --url. Serwer GSC Wizard działa pod adresem https://mcp.gscwizard.com/mcp, więc nie trzeba niczego instalować ani uruchamiać lokalnie.

Czy w Codex używać OAuth, czy klucza API?

Do pracy interaktywnej codex mcp login uruchamia przepływ OAuth w przeglądarce i nie wymaga obsługi kluczy. Do codex exec, zadań CI i innych uruchomień bez nadzoru użyj klucza API gscw_live_ z zakresem odczytu, zapisanego w zmiennej środowiskowej i wskazanego przez bearer_token_env_var, dzięki czemu sekret nigdy nie trafia do config.toml.

Czy Codex CLI, rozszerzenie IDE i aplikacja mają wspólną konfigurację MCP?

Tak. Czytają ten sam plik ~/.codex/config.toml, więc jednorazowe dodanie gsc-wizard udostępnia go w terminalu, w rozszerzeniu IDE i w aplikacji desktopowej.

Czy Codex może cokolwiek zmienić w moim Search Console?

Tylko z poświadczeniem o zakresie zapisu. Klucz API z zakresem odczytu nie może wywołać żadnego z 32 narzędzi modyfikujących (takich jak submit_sitemap czy submit_indexnow_urls); sprawdzenie odbywa się na serwerze przed wykonaniem narzędzia. Listę narzędzi możesz też zawęzić po stronie klienta przez enabled_tools w config.toml.

Ile narzędzi dostaje Codex?

128 narzędzi jest dostępnych dla każdego konta i obejmuje skuteczność w Search Console, analizę, indeksowanie, Bing Webmaster, Yandex Webmaster, GA4 i Google Merchant Center. Wysyłanie wszystkich zajmuje kontekst w każdej turze, więc w większości konfiguracji Codex w enabled_tools wymienia się tylko narzędzia potrzebne do zadania.

Czy to coś kosztuje?

Dostęp do MCP jest w planach GSC Wizard i w darmowym okresie próbnym, który nie wymaga karty kredytowej. Korzystanie z Codex jest rozliczane przez OpenAI jak zwykle. Zobacz cennik.

Powiązane

Daj Codex swoje dane z wyszukiwarki

Podłącz usługę, uruchom jedno polecenie i pozwól agentowi, który edytuje Twoją witrynę, zobaczyć, jak radzi sobie w wyszukiwarce.

Porady o Search Console prosto do Twojej skrzynki

Praktyczne sposoby pracy z GSC i GA4, nowości w produkcie i eksperymenty SEO. Bez spamu, wypisać się możesz w każdej chwili.