Połącz GSC przez MCP

Jak połączyć dane z Google Search Console przez MCP?

Skieruj dowolnego asystenta obsługującego MCP na https://mcp.gscwizard.com/mcp, uwierzytelnij się logowaniem lub kluczem API, a będzie czytać Twoje prawdziwe dane z Search Console. Analizy działają po stronie serwera, więc asystent dostaje gotowe odpowiedzi zamiast surowych wierszy.

Działa z ChatGPT, Claude, Grok, Gemini CLI, Cursor, VS Code, Windsurf i każdym innym klientem MCP.

Krótka odpowiedź

Połączenie wymaga trzech rzeczy, niezależnie od klienta:

  1. Połącz Search Console raz w GSC Wizard. Autoryzacja jest tam, a nie w asystencie.
  2. Dodaj endpoint https://mcp.gscwizard.com/mcp do swojego klienta.
  3. Uwierzytelnij się: zaloguj się przez OAuth 2.1, jeśli klient to obsługuje, albo wyślij Authorization: Bearer gscw_live_...

Serwer obsługuje streamable HTTP, więc większość klientów nie potrzebuje lokalnej instalacji, procesu Node ani mostka stdio.

Endpoint streamable HTTP

https://mcp.gscwizard.com/mcp

Logowanie OAuth 2.1

Dla ChatGPT, interfejsu Claude Connectors, konektorów Grok i Gemini CLI. Klient rejestruje się sam i prowadzi Cię przez logowanie Google. Nie trzeba niczego kopiować ani przechowywać.

Nagłówek z kluczem API

Dla klientów z plikiem konfiguracyjnym, takich jak Claude Code, Cursor, VS Code i Windsurf, oraz dla Meta Muse: wyślij Authorization: Bearer gscw_live_...

Wideo

Zobacz całą konfigurację od początku do końca

Konfiguracja i pierwsze pytanie od początku do końca: dodanie konektora, logowanie i powrót gotowej analizy zamiast surowych wierszy.

Konfiguracja

Trzy kroki do połączenia

Te same trzy kroki dotyczą każdego klienta. Zmienia się tylko składnia konfiguracji.

  1. 1

    Podłącz swoje usługi

    Zaloguj się na tool.gscwizard.com przez Google i wybierz usługi Search Console, które mają być dostępne. To jedyne miejsce, w którym przyznaje się autoryzację.

  2. 2

    Utwórz klucz API albo zaplanuj logowanie

    Utwórz klucz w Account → API keys dla klientów z plikiem konfiguracyjnym. Klienci obsługujący zdalny OAuth (ChatGPT, interfejs Claude Connectors, konektory Grok, Gemini CLI) potrzebują tylko adresu URL.

  3. 3

    Dodaj serwer do swojego klienta

    Wskaż klientowi https://mcp.gscwizard.com/mcp. Nazwy kluczy różnią się między klientami, ale adres URL i nagłówek bearer nigdy się nie zmieniają.

Kopiuj i wklej

Konfiguracja dla każdego klienta

Zamień gscw_live_... na klucz utworzony w Account → API keys.

Claude Code

Jedno polecenie, nagłówek z kluczem API.

claude mcp add --transport http gsc-wizard \
  https://mcp.gscwizard.com/mcp \
  --header "Authorization: Bearer gscw_live_..."

Claude w przeglądarce i aplikacja desktopowa

Settings → Connectors → Add custom connector. Wklej adres URL i zostaw puste pola OAuth client ID i secret: Claude rejestruje się sam i loguje Cię.

https://mcp.gscwizard.com/mcp

ChatGPT

Settings → Apps, tryb dewelopera, dodaj aplikację z Authentication ustawionym na OAuth. Wymaga płatnego planu. Nie ma pola na klucz API: ChatGPT nie potrafi wysyłać statycznych tokenów bearer. Możesz też pominąć to wszystko i zainstalować aplikację GSC Wizard z App Store ChatGPT.

https://mcp.gscwizard.com/mcp

Grok

Wejdź na grok.com/connectors, kliknij New Connector i wybierz Custom. Wklej adres URL i dokończ logowanie: Grok rejestruje się sam przez OAuth 2.1, więc nie ma client ID ani secret do wypełnienia. Potem Grok wykrywa narzędzia i oferuje je w Twoich rozmowach. Pełny przewodnik: połącz GSC z Grok.

https://mcp.gscwizard.com/mcp

Microsoft Copilot Studio

Dodaj do swojego agenta narzędzie Model Context Protocol z OAuth 2.0 i typem konfiguracji Manual. Utwórz client ID i secret w Account → MCP API keys → Microsoft Copilot Studio, gdzie znajdziesz też listę wszystkich adresów URL do wklejenia, a potem zapisz adres przekierowania, który Copilot Studio poda dla tego połączenia. Pełny przewodnik: dane SEO w Microsoft Copilot Studio.

https://mcp.gscwizard.com/mcp

Meta Muse

Muse nie ma ekranu ustawień dla własnych konektorów: poproś go w rozmowie o zbudowanie własnej integracji z poniższym adresem URL, zdalny HTTP z uwierzytelnianiem tokenem Bearer. Utwórz klucz API tylko do odczytu i wklej go do bezpiecznego okna na dane uwierzytelniające w Muse, nigdy do czatu. Pełne przewodniki: konektor Muse Search Console SEO i konektor Muse Google Analytics.

URL:  https://mcp.gscwizard.com/mcp
Auth: Bearer gscw_live_... (read-only key)

Gemini CLI

Dodaj do ~/.gemini/settings.json. Gemini CLI używa httpUrl dla streamable HTTP.

{
  "mcpServers": {
    "gsc-wizard": {
      "httpUrl": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

OpenAI Codex

Dodaj do ~/.codex/config.toml (współdzielonego przez Codex CLI, rozszerzenie IDE i aplikację) z kluczem w zmiennej środowiskowej albo uruchom codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp i zaloguj się poleceniem codex mcp login gsc-wizard. Pełny przewodnik: GSC MCP dla Codex.

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

Cursor

Dodaj do ~/.cursor/mcp.json (globalnie) lub .cursor/mcp.json w projekcie.

{
  "mcpServers": {
    "gsc-wizard": {
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

VS Code (tryb agenta Copilot)

Dodaj do .vscode/mcp.json. VS Code używa servers, a nie mcpServers, i może poprosić o klucz, dzięki czemu nie trafia on do kontroli wersji.

{
  "inputs": [
    { "id": "gscw-key", "type": "promptString", "description": "GSC Wizard MCP key", "password": true }
  ],
  "servers": {
    "gsc-wizard": {
      "type": "http",
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer ${input:gscw-key}" }
    }
  }
}

Windsurf

Dodaj do ~/.codeium/windsurf/mcp_config.json. Windsurf używa serverUrl dla serwerów zdalnych.

{
  "mcpServers": {
    "gsc-wizard": {
      "serverUrl": "https://mcp.gscwizard.com/mcp",
      "headers": { "Authorization": "Bearer gscw_live_..." }
    }
  }
}

Dowolny inny klient MCP

Wskaż mu endpoint streamable HTTP i wyślij swój klucz jako token bearer. Nazwy kluczy w konfiguracji się różnią (transport albo type, url albo serverUrl), ale adres URL i nagłówek są zawsze takie same.

URL:    https://mcp.gscwizard.com/mcp
Header: Authorization: Bearer gscw_live_...

Poradniki krok po kroku: ChatGPT, Claude, Gemini, Grok, Meta Muse. ChatGPT ma własne dodatkowe zasady (tylko serwery zdalne, OAuth zamiast kluczy API, tryb dewelopera dostępny dopiero w płatnym planie), które opisuje artykuł Konektory ChatGPT dla danych z Search Console w 2026 roku. Jeśli korzystasz z Claude, szczegóły protokołu, które ta strona tylko streszcza, znajdziesz w opisie serwera MCP do Search Console dla Claude.

Uwierzytelnianie i zakresy uprawnień

Każdy klucz ma zakres wybierany przy tworzeniu, więc to Ty decydujesz, ile może zrobić asystent.

Tylko odczyt

Odpytywanie danych i uruchamianie raportów. Klucz tylko do odczytu fizycznie nie może wywołać narzędzia zapisu, więc połączenie jest z założenia tylko do odczytu. To właściwy wybór dla współdzielonego agenta lub wdrożenia udostępnianego klientom.

Odczyt i zapis

Wszystko, co potrafi klucz do odczytu, a do tego zmiany: dodawanie witryn, zgłaszanie adresów URL do IndexNow, zarządzanie klastrami tematycznymi, grupami treści i adnotacjami. Każda zmiana trafia do dziennika audytu na Twoim koncie.

Klucze są pokazywane tylko raz, przy tworzeniu, można je w każdej chwili unieważnić, a ich zasięg ogranicza się do usług Search Console, które są już połączone z Twoim kontem GSC Wizard.

Czym wyróżnia się to MCP

Analiza odbywa się, zanim model cokolwiek zobaczy

Większość serwerów MCP dla SEO oddaje asystentowi surowe wiersze. Modele językowe nie są stworzone do arytmetyki na dużych tabelach: jest to wolne, zużywa tokeny, a błędy trudno wychwycić.

Znacznie mniej tokenów

Jedno wywołanie narzędzia zwraca zwartą, gotową odpowiedź zamiast dziesiątek tysięcy wierszy, które model musiałby przeczytać, przechować w kontekście i za które trzeba by zapłacić.

Dużo szybciej

Agregacje działają w hurtowni danych w milisekundach: pełny raport SEO na zbiorze danych 4 GB w około 4,4 sekundy, zamiast stronicowania API GSC partia po partii.

Odporne na błędy

Obliczenia są deterministyczne. Liczby pochodzą z prawdziwych zapytań, więc model nie może się pomylić w rachunkach ani wymyślić sum.

Większe zbiory danych w zasięgu

Ponieważ ciężka praca nigdy nie trafia do okna kontekstu, serwer może analizować miesiące danych i miliony wierszy, które nigdy nie zmieściłyby się w prompcie.

Co może wywołać asystent

Pełny katalog, z przykładowymi argumentami dla każdego narzędzia, znajdziesz na mcp.gscwizard.com.

Analityka wyszukiwania Najczęstsze zapytania i strony Zmiany pozycji Kanibalizacja słów kluczowych Wykrywanie spadków treści Frazy w zasięgu ręki / przejmowanie pozycji Analiza krzywej CTR Ocena okazji Zbiorcze sprawdzanie adresów URL Tracker indeksowania Zgłoszenia do IndexNow Grupy treści i klastry tematyczne Podział według krajów i urządzeń Skuteczność map witryn Automatyczne raporty SEO Podział na zapytania brandowe i niebrandowe Rozkład pozycji Porównanie migracji Raporty do udostępniania klientom Google Analytics 4 Podstawowe wskaźniki internetowe (CrUX) Prognozowanie i wykrywanie anomalii Bing Webmaster Tools

Jeśli połączenie nie działa

Narzędzia w ogóle się nie pojawiają

Większość klientów odczytuje ustawienia MCP tylko przy uruchomieniu. Po edycji pliku konfiguracyjnego całkowicie zamknij aplikację (nie tylko okno) i otwórz ją ponownie.

401 Unauthorized

Sprawdź, czy nagłówek ma dokładnie postać Authorization: Bearer gscw_live_..., czy klucz nie został unieważniony i czy konto nadal ma aktywną subskrypcję lub okres próbny.

Claude Desktop uznaje konfigurację za nieprawidłową

Jego plik konfiguracyjny uruchamia wyłącznie lokalne serwery stdio, dlatego wpis "type": "http" jest odrzucany. Skorzystaj z interfejsu Connectors albo połącz się przez mcp-remote: zajrzyj do poradnika dla Claude lub do opisu MCP do Search Console dla Claude, gdzie wyjaśniam, dlaczego plik konfiguracyjny odrzuca wpis HTTP.

Narzędzie zapisu zwraca 403

Klucz jest tylko do odczytu. Utwórz klucz do odczytu i zapisu, jeśli asystent naprawdę musi zmieniać dane, albo zostaw klucz do odczytu i wprowadź zmianę w aplikacji.

Brakuje usługi

MCP widzi tylko usługi, które są już połączone w GSC Wizard. Najpierw dodaj ją w aplikacji, a potem poproś asystenta o ponowne wylistowanie witryn. Usługi domenowe mają prefiks sc-domain:.

Te same dane, inni asystenci

Łączysz inne narzędzie AI?

Jedno połączenie z Search Console, każdy asystent. Wybierz swojego klienta i postępuj zgodnie z poradnikiem krok po kroku.

Zobacz też przegląd Google Search Console MCP, GA4 MCP, Yandex Webmaster MCP, Merchant Center MCP, aplikację ChatGPT (zainstaluj ją w ChatGPT), konektory Meta Muse dla Search Console i Google Analytics, nasze zestawienie najlepszych serwerów MCP dla SEO oraz artykuł o tym, dlaczego GSC Wizard to najlepsze MCP do Search Console w 2026 roku.

Najczęściej zadawane pytania

Czym jest serwer MCP?

Serwer MCP (Model Context Protocol) to standardowy konektor, dzięki któremu asystent AI może odczytywać dane na żywo i wywoływać narzędzia. Google Search Console MCP udostępnia asystentowi Twoje usługi Search Console, więc może on pobierać prawdziwe wartości kliknięć, wyświetleń, pozycji i CTR zamiast je wymyślać.

Którzy klienci mogą się połączyć?

Każdy klient obsługujący zdalne serwery MCP: ChatGPT, Claude i Claude Code, Grok, Gemini CLI, Cursor, VS Code w trybie agenta Copilot, Windsurf, Gemini Enterprise oraz własne agenty zbudowane na SDK OpenAI, Anthropic lub Google. Endpoint obsługuje streamable HTTP.

Klucz API czy OAuth: co mi jest potrzebne?

Klienci konfigurowani plikiem (Claude Code, Cursor, VS Code, Windsurf, Gemini CLI) wysyłają klucz API w nagłówku Authorization: Bearer. Klienci z interfejsem konektorów (ChatGPT, Claude w przeglądarce i aplikacja desktopowa, Grok) używają OAuth 2.1 i dynamicznej rejestracji klienta, więc wystarczy się zalogować, a pola identyfikatora klienta i sekretu zostawić puste.

Czy mogę ustawić połączenie tylko do odczytu?

Tak. Każdy klucz API ma zakres wybierany przy tworzeniu. Klucz tylko do odczytu w ogóle nie może wywołać narzędzia zapisu, więc połączenie jest z założenia tylko do odczytu. Klucze do odczytu i zapisu dodają zmiany, takie jak dodawanie witryn, zgłaszanie adresów URL do IndexNow i zarządzanie klastrami, a każda z nich trafia do dziennika audytu.

Jak aktualne są dane?

Odczyty z hurtowni danych są opóźnione o około dwa dni względem samego Search Console, a każda odpowiedź podaje datę, do której dane są już ustabilizowane. Zapytania, których hurtownia nie obsłuży, automatycznie trafiają do API GSC na żywo, a każda odpowiedź informuje, z jakiego źródła pochodzi.

Dlaczego nie pozwolić modelowi czytać surowego API GSC?

Większość MCP do Search Console stronicuje API GSC powoli, partia po partii, i wrzuca surowe wiersze do kontekstu modelu. Jest to wolne, uderza w próbkowanie i limity wierszy oraz zostawia miejsce na halucynacje. GSC Wizard liczy każdą analizę w SQL po stronie serwera i zwraca gotowy wynik: pełny raport SEO na zbiorze danych 4 GB w około 4,4 sekundy.

Narzędzie nie pojawia się w moim kliencie. Co robić?

Po edycji konfiguracji całkowicie zrestartuj klienta, bo większość klientów odczytuje ustawienia MCP tylko przy uruchomieniu. Następnie sprawdź, czy klucz jest nadal ważny i nie został unieważniony, czy w adresie URL użyłeś ścieżki /mcp i czy szukane narzędzie nie jest narzędziem zapisu zablokowanym przez klucz tylko do odczytu.

Czy jest zwykła opcja HTTP?

Tak. Ten sam serwer udostępnia interfejs REST pod adresem https://mcp.gscwizard.com/v1, z tymi samymi kluczami, zakresami, limitami zapytań i dziennikiem audytu, a dokument OpenAPI 3,1 pod /v1/openapi.json jest generowany z tych samych schematów, według których serwer waliduje dane.

Połącz dane z Search Console z dowolnym klientem AI

Jeden endpoint, dwa sposoby uwierzytelniania i gotowe odpowiedzi zamiast surowych wierszy. Konfiguracja zajmuje około dwóch minut.

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.