Na wstępie możesz wybrać ścieżkę odpowiadającą temu, co chcesz zrobić.
- Pracuję w Claude lub ChatGPT i chcę przeanalizować SEO.
- Pracuję z kodem strony i chcę użyć Claude Code lub Codex.
Wspólne podstawy opisuję poniżej, a szczegóły parametrów i limitów znajdziesz na końcu artykułu.
Czym jest Senuto MCP i czego potrzebujesz do podłączenia?
Senuto jest jednym z podstawowych narzędzi SEO na polskim rynku o bardzo dużej użyteczności podczas pracy analitycznej. Pokazuje widoczność domeny, pozycje fraz, konkurencję czy historię zmian, ale posiada to samo ograniczenie co Ahrefs czy Semrush: opisuje pewien stan, ale nie przedstawia konkretnego planu działania. Żeby zdecydować, co zmienić w treści w najbliższym tygodniu, trzeba jeszcze nałożyć filtry, wyeksportować dane, porównać się z konkurencją i przeczytać własną podstronę. Proces jest więc wydłużony i opiera się na różnych czynnościach, które wykonujemy ręcznie.
MCP to standard łączenia aplikacji AI z zewnętrznymi narzędziami. Po podłączeniu Senuto asystent może pobierać dane o widoczności domen, frazach i konkurencji na podstawie Twojego polecenia. W związku z powyższym nie musisz już eksportować tabeli i wklejać jej do rozmowy. Wszystko odbywa się automatycznie i jest niezwykle wygodne. Z drugiej strony zastrzegam, że połączenie udostępnia dane, ale nie gwarantuje poprawnej interpretacji. Model może potencjalnie wybrać niewłaściwy zakres albo wyciągnąć zbyt daleko idący wniosek i dlatego właśnie w przykładach proszę o źródła, daty i oddzielenie danych od ocen. Więcej o samym standardzie znajdziesz w przewodniku po MCP.
By zacząć właściwą integrację, potrzebujesz konta Senuto z dostępem do MCP oraz aplikacji AI, która pozwala dodać taki serwer. Pamiętaj, że we wszystkich czterech narzędziach używasz tego samego adresu:
Serwer działa po stronie Senuto, a logowanie odbywa się przez , czyli ekran autoryzacji konta, bez ręcznego generowania klucza REST API.
Ile kosztuje Senuto MCP i w których planach jest dostępny?
Według dokumentacji Senuto z końca września 2026 MCP jest w cenie planów Advanced i Prime, natomiast w Lite i Basic dostępny jest dodatek „Dostęp do MCP” za 69 zł netto miesięcznie. Ten dodatek nie obejmuje REST API, którego potrzebujesz dopiero do własnych integracji programistycznych. Wywołania MCP zużywają przy tym limity konta, które omawiam w sekcji o limitach. Podsumowując temat kosztów, by zacząć, potrzebujesz około 200 zł minimum po stronie narzędzia Senuto.
Senuto MCP w Claude i ChatGPT: analiza SEO bez programowania
Ta ścieżka jest dla osób, które chcą dostać sam raport, porównać konkurentów albo ustalić priorytety treści. Wybierz narzędzie, z którym pracujesz — omawiam przykłady dwóch najpopularniejszych, czyli Claude i ChatGPT.
Jak podłączyć Senuto MCP do Claude?
- Otwórz Claude w przeglądarce lub aplikacji desktopowej i przejdź do Ustawienia → Konektory (Settings → Connectors).
- Wybierz Dodaj własny konektor (Add custom connector), nazwij go „Senuto” i wklej adres
https://mcp.senuto.com/mcp. - Zapisz połączenie i przejdź logowanie do Senuto, gdy pojawi się prośba o autoryzację — może nastąpić przy łączeniu lub pierwszym użyciu.
- W rozmowie upewnij się, że konektor Senuto jest włączony, i wykonaj test z następnej sekcji.
W sytuacji, kiedy nie widzisz opcji dodania własnego konektora, sprawdź uprawnienia konta, a w wypadku przestrzeni organizacji może być potrzebne działanie administratora.
Jak podłączyć Senuto MCP do ChatGPT?
Konfigurację należy rozpocząć z poziomu przeglądarki internetowej. Oficjalna dokumentacja instalacyjna Senuto wskazuje, że do nawiązania połączenia wymagany jest aktywny plan ChatGPT Pro lub Business. Aktualne wytyczne OpenAI kierują użytkownika przez dedykowany tryb deweloperski bezpośrednio do ekranu zarządzania wtyczkami i integracjami:
- Otwórz Settings → Security and login i włącz Developer mode, jeśli jest dostępny na Twoim koncie.
- Przejdź do Plugins, wybierz przycisk + i podaj nazwę „Senuto” oraz krótki opis połączenia.
- W sekcji Connection wpisz adres
https://mcp.senuto.com/mcpjako publiczny adres serwera MCP. - Utwórz połączenie, przejdź autoryzację konta Senuto i sprawdź listę udostępnionych narzędzi.
- Rozpocznij rozmowę i dodaj połączenie Senuto z menu narzędzi.
Układ ekranów w ChatGPT zmienia się dość często, więc nazwy opcji na Twoim koncie mogą się różnić, ale adres serwera pozostaje ten sam. Dodam jeszcze, że opisany w instrukcji tryb deweloperski służy wyłącznie do skonfigurowania połączenia i nie wymaga samodzielnego pisania kodu.
Jak sprawdzić połączenie z Senuto i ustalić zasady analizy?
Zastąp example.pl swoją domeną i wyślij:
Przed przystąpieniem do dalszych prac warto dołączyć zwięzły profil firmy oraz wytyczne analityczne — najlepiej zamieszczając je bezpośrednio na samym początku konwersacji:
Nazwy baz mogą wyglądać technicznie, ale wpływają na zgodność z panelem Senuto. Ich znaczenie i numery parametrów opisuję w sekcji o bazach danych.
Analiza widoczności domeny w Senuto przez AI
Po ustaleniu kontekstu poproś o pierwszy raport:
Raport tego typu precyzyjnie wskazuje, które podstrony są uwzględnione w badanej bazie fraz kluczowych oraz jak kształtowała się ich widoczność na przestrzeni czasu. Sam spadek pozycji nie wskazuje jednak bezpośredniej przyczyny problemu i dlatego jego diagnoza wymaga dalszego sprawdzenia pod kątem stanu indeksacji, niedawnych zmian w treści, czynników sezonowych czy działań konkurencji. Trzeba też pamiętać, że brak danego adresu URL w zestawieniu nie jest równoznaczny z brakiem jego indeksacji w Google ani brakiem generowanego ruchu.
Frazy na pozycjach 11–20 i priorytety optymalizacji treści
Co więcej, zestawienie to stanowi wartościowy punkt wyjścia do audytu istniejących podstron. Przy czym trzeba pamiętać, że pozycje tuż za pierwszą dziesiątką wyników wyszukiwania nie gwarantują automatycznego, szybkiego wzrostu — z tego powodu stały monitoring pozycji należy bezwzględnie zestawić z dokładną intencją zapytania oraz realną ofertą biznesową firmy:
Pamiętaj, że niszowa fraza usługowa o niskim wolumenie wyszukiwań ma dla firmy często wyższą wartość biznesową niż popularne zapytanie informacyjne. Asystent AI powinien wyczerpująco uzasadnić taki wybór, a w przypadku posiadania wewnętrznych danych o konwersjach lub zapytaniach ofertowych od klientów — bezwzględnie włączyć je do analizy. Same narzędzia SEO, takie jak Senuto, pokazują wyłącznie szacowany ruch, nie rozstrzygając o rzeczywistym potencjale sprzedażowym danej frazy.
Analiza konkurencji i tematy do sprawdzenia na danych Senuto
Trzeba przy tym wszystkim pamiętać, że konkurent obecny w wynikach wyszukiwania nie zawsze pokrywa się z realnym konkurentem biznesowym — w zestawieniach widoczności często pojawiają się duże portale informacyjne, agregatory branżowe oraz wielobranżowe e-commerce o odmiennym profilu oferty. Z tego powodu wygenerowana lista tematów powinna służyć przede wszystkim jako punkt wyjścia do weryfikacji, czy serwis posiada już dopasowaną podstronę oraz czy dana tematyka odpowiada na rzeczywiste potrzeby grupy docelowej.
Na tym etapie dysponujesz kompletnym materiałem do podjęcia decyzji redakcyjnych. Wyznaczone zadania możesz przekazać bezpośrednio autorowi treści lub osobie odpowiedzialnej za obsługę serwisu. W celu wdrożenia przygotowanych zmian bezpośrednio w plikach projektowych należy przejść do kolejnej części. Do dalszej pracy w czacie wystarczą jeszcze zasady interpretacji wyników.
Senuto MCP w Claude Code i Codex: praca na plikach strony
Teraz wchodzimy w nieco inną sytuację, czyli opieramy się na uruchomionym narzędziu programistycznym i lokalnym projekcie strony — przykładowo Visual Studio Code, który osobiście najbardziej preferuję. Poniższe przykłady zakładają, że treści lub szablony są w repozytorium. W sytuacji, kiedy treścią zarządzasz w zewnętrznym CMS, agent potrzebuje osobnego dostępu do tych danych lub ich eksportu.
Oczywiście zarówno Claude, jak i ChatGPT mogą analizować dostarczone pliki lub treść stron, jeśli mają odpowiednie narzędzia, ale praca w repozytorium daje jednak możliwość odczytu powiązanych plików, przygotowania zmian i sprawdzenia ich w środowisku projektu.
Jak podłączyć Senuto MCP do Claude Code?
W terminalu dodaj zdalny serwer:
Zakres user udostępnia konfigurację we wszystkich Twoich projektach. Domyślny local ogranicza ją do bieżącego projektu, a project zapisuje w repozytorium plik .mcp.json. Przy współdzieleniu konfiguracji Senuto każda osoba przechodzi własną autoryzację OAuth.
Uruchom Claude Code w katalogu projektu, wpisz /mcp, wybierz Senuto i dokończ logowanie w przeglądarce. W aktualnych wersjach możesz również autoryzować serwer z terminala za pomocą komendy:
Sprawdź status połączenia i poproś o widoczność swojej domeny tak jak w pierwszym teście, a jeśli pojawi się błąd autoryzacji, sprawdź dostęp do MCP na koncie Senuto i ponów logowanie z /mcp. Więcej szczegółów opisuje dokumentacja MCP w Claude Code (link w źródłach na końcu artykułu).
Jak podłączyć Senuto MCP do Codex?
W Codex CLI dodaj serwer i zaloguj się do Senuto:
Konfiguracja jest zapisywana domyślnie w ~/.codex/config.toml. Możesz też użyć .codex/config.toml dla zaufanego projektu, natomiast odpowiedni wpis wygląda tak:
Ręczne utworzenie wpisu stanowi alternatywę dla polecenia add, ale wciąż wymaga przejścia pełnego procesu uwierzytelnienia OAuth. W celu weryfikacji należy otworzyć sesję Codex bezpośrednio w katalogu projektu i wykonać testowe pobranie danych o widoczności domeny, postępując zgodnie z dokumentacją konfiguracji MCP w Codex (link w źródłach na końcu artykułu).
Warto przy tym pamiętać, że integrację w interfejsie ChatGPT oraz konfigurację lokalnego środowiska Codex należy testować niezależnie. Innymi słowy, nawet gdy połączymy Senuto w przeglądarce, nie oznacza to, że te same narzędzia są prawidłowo dostępne w sesji operującej na lokalnym repozytorium kodu.
Stałe instrukcje dla agenta w CLAUDE.md i AGENTS.md
Zapisanie parametrów oraz kontekstu biznesowego bezpośrednio w plikach konfiguracyjnych — CLAUDE.md dla środowiska Claude Code lub AGENTS.md dla Codex — pozwala wyeliminować konieczność ich ponownego wprowadzania przy każdej kolejnej analizie. Poniżej znajdziesz wzorzec, który może być uniwersalnym szablonem i jest gotowy do wdrożenia w obu tych środowiskach. Zmień jedynie domenę, ścieżki projektu i opis oferty, by odpowiadały Twoim potrzebom.
Plik opisuje sposób pracy i oczywiście jest tylko przykładem. Eksperymentuj, modyfikuj wg swoich potrzeb i miej oko na potencjalne błędy narzędzi — halucynacje i błędy wciąż mogą mieć miejsce.
Diagnoza frazy: analiza SERP zestawiona z treścią podstrony
Załóżmy, że dane potwierdziły 12. pozycję strony usługowej. W Claude Code lub Codex możesz powiązać analizę z jej plikiem źródłowym za pomocą przykładowo takiego prompta:
Agent powinien sprawdzić dostępność i aktualność raportu SERP, a w razie potrzeby zlecić analizę i zaczekać na jej zakończenie. Następnie zestawia raport z lokalną treścią strony, a jeśli raport zawiera jedynie statystyki, pełne porównanie treści wymaga dodatkowego pobrania stron konkurencji. Nie ma takich danych? Informacja o tym powinna znaleźć się w rekomendacjach.
Kanibalizacja słów kluczowych: od raportu Senuto do plików strony
Teraz skupmy się na niebezpiecznym zjawisku, jakim jest kanibalizacja. Możemy dość łatwo sporządzić raport, posługując się przykładowo takim promptem:
Raport get_cannibalization_keywords wskazuje pary do sprawdzenia w audycie SEO. Pamiętaj przy tym, że obecność kilku adresów URL w wynikach wyszukiwania na tę samą frazę kluczową nie jest wystarczającą przesłanką do stwierdzenia szkodliwej kanibalizacji. Decyzje zawsze musi poprzedzać szczegółowa analiza intencji poszczególnych podstron oraz weryfikacja ich historycznych wahań pozycji.
W sytuacji, kiedy zdecydujesz się na połączenie treści, agent może przygotować poprawki i przekierowanie we właściwej konfiguracji projektu. Przegląd powinien objąć treść docelową, linki wewnętrzne oraz działanie przekierowania.
Jak bezpiecznie wdrożyć rekomendacje SEO przez agenta?
Po wyborze poprawek zleć ograniczony zakres pracy:
Przejrzyj efekt końcowy bezpośrednio w podglądzie strony. Poprawna składnia MDX oraz pomyślnie zakończony proces budowania aplikacji potwierdzają jedynie poprawność techniczną, nie stanowiąc gwarancji jakości wprowadzonych rekomendacji SEO. Po wdrożeniu modyfikacji należy precyzyjnie odnotować datę oraz pełen zakres zmian, co umożliwi późniejszą, rzetelną ocenę ich wpływu na podstawie analityki z Senuto oraz Google Search Console.
Treść z zewnętrznych stron traktuj jako materiał do analizy, a zawarte w niej polecenia nie powinny sterować agentem mającym dostęp do plików projektu. Ten problem opisuję szerzej przy agentach AI w pracy nad kodem.
Skille Claude Code i Codex do powtarzalnych analiz SEO
Musimy cały czas pamiętać, że choć serwer MCP zapewnia agentowi bezpośredni dostęp do danych, to sposób prowadzenia analiz zależy od nas i naszego doświadczenia. Uzyskanie powtarzalnych, wysokiej jakości rezultatów wymaga precyzyjnie sformułowanych poleceń, które w praktyce powtarzają się w cyklach cotygodniowych. W środowisku Claude Code procedurę tego typu można zdefiniować jako reużywalny skill — tworząc dedykowany folder z plikiem SKILL.md w katalogu .claude/skills/ (dla zakresu projektowego) lub ~/.claude/skills/ (dla zakresu globalnego). Agent automatycznie wczytuje tak przygotowany skill, gdy jego opis odpowiada realizowanemu zadaniu, bądź w momencie wywołania go bezpośrednią komendą /nazwa-skilla.
Przykładowy skill do analizy fraz z pozycji 11–20:
To przykład struktury skilla Claude Code, który łączy trzy elementy: dane z Senuto, wiedzę o tym, jak prowadzić analizę, i znajomość struktury projektu. Na tej samej zasadzie możesz zbudować skille do miesięcznego raportu widoczności, analizy konkurencji albo planowania treści pod frazy pytające.
Z kolei Codex obsługuje skille w tym samym formacie (SKILL.md z polami name i description), ale szuka ich w .agents/skills/ w repozytorium lub w ~/.agents/skills/ dla wszystkich projektów, a jawnie wywołujesz je przez $nazwa-skilla.
Dlaczego wyniki z Senuto MCP różnią się od panelu?
Po podłączeniu integracji częstym zjawiskiem są rozbieżności pomiędzy liczbą fraz w przedziałach TOP3, TOP10 i TOP50 wykazywaną przez agenta a danymi widocznymi w panelu Senuto dla tej samej domeny — sięgające np. sześciu słów kluczowych w TOP10 według agenta przy zaledwie trzech w panelu.
Główną przyczyną tego stanu rzeczy jest domyślna konfiguracja parametru country_id. Dla rynku polskiego serwer MCP obsługuje dwie osobne bazy danych: bazę 1.0 (1) oraz bazę 2.0 (200). Choć Senuto rekomenduje korzystanie z wersji 2.0 jako najbardziej aktualnej i precyzyjnej, to wersja 1.0 oferuje dłuższą historię pomiarów. W przypadku braku jawnie zdefiniowanego parametru country_id API automatycznie odwołuje się do bazy 1.0, co sprawia, że agent przeprowadzający analizę operuje na innym zbiorze danych niż panel graficzny.
Warto kontrolować jeszcze dwa kluczowe parametry konfiguracyjne:
-
fetch_mode— określa zakres analizowanej struktury serwisu:topLevelDomain— ogranicza analizę wyłącznie do wskazanego hosta z wyłączeniem subdomen.subdomain— uwzględnia domenę wraz ze wszystkimi jej subdomenami.
Uwaga: Serwer MCP stosuje domyślnie tryb
topLevelDomain, podczas gdy panel graficzny Senuto operuje na trybiesubdomaini zgodnie z dokumentacją jest to najczęstsze źródło rozbieżności w prezentowanych danych. Wybrane końcówki API obsługują ponadto trybycatalog(dla konkretnych katalogów, np./blog) orazurl(dla pojedynczych adresów podstron). -
detail_level(summary,standard,extended) — steruje objętością zwracanego obiektu odpowiedzi. Wariantsummaryjest w pełni wystarczający dla przeważającej większości zadań analitycznych, pozwalając na optymalne zarządzanie oknem kontekstowym modelu.
W interfejsach konwersacyjnych powyższe wytyczne ustal na samym początku sesji, a w środowiskach projektowych zapisz je na stałe w pliku CLAUDE.md lub AGENTS.md. Zestawiając ze sobą gotowe raporty, zweryfikuj dodatkowo znacznik czasowy pobranych danych oraz zestaw zastosowanych filtrów.
Limity Senuto MCP: jedna pula dla panelu, API i agenta
Wywołania przez MCP zużywają te same liczniki co praca w panelu i zapytania do REST API. Nie istnieje osobny limit dla MCP, a zasady naliczania według dokumentacji Senuto są następujące:
| Narzędzia | Kiedy zużywają limit |
|---|---|
narzędzia analizy widoczności (get_domain_statistics, get_positions_data, get_urls i pokrewne) | jedna jednostka za nową kombinację domeny, fetch_mode i country_id; kolejne raporty z tą samą kombinacją w ciągu 24 godzin nie zużywają kolejnej jednostki tego limitu |
get_keywords, get_questions | jedna jednostka za każdą nową frazę, domenę lub URL podany jako punkt wyjścia; ten sam punkt wyjścia powtórzony w ciągu 24 godzin nie zużywa limitu |
get_keyword_statistics | jedna jednostka za wywołanie, niezależnie od liczby fraz (do 500) |
serp_create | jedna jednostka limitu analizy SERP za nową frazę; istniejące zadanie nie jest naliczane |
narzędzia monitoringu (rt_*), get_groups, serp_list, serp_check, serp_get_report, get_limits | nie zużywają limitów |
Wnioski praktyczne:
Zmiana bazy z 1.0 na 2.0 w trakcie analizy to nowa jednostka. To kolejny powód, żeby ustalić parametry na początku rozmowy lub w instrukcjach projektu.
Wolumeny dla wielu fraz pobieraj jednym wywołaniem
get_keyword_statistics, a nie frazą po frazie.- Przed dużą analizą poproś agenta o
get_limits. Błąd
418w trakcie rozmowy najczęściej oznacza wyczerpany limit modułu. Agent, który wpadnie w pętlę, może zużyć limit potrzebny Ci później w panelu.
Najważniejsze narzędzia serwera Senuto MCP
Nie musisz uczyć się ich nazw, żeby używać MCP. Ta tabela pomaga sprawdzić, czy asystent pobrał właściwy typ danych.
Narzędzia, z których korzysta się najczęściej:
| Narzędzie | Co zwraca |
|---|---|
get_domain_statistics | widoczność domeny, liczbę fraz w TOP3, TOP10 i TOP50, ekwiwalent Ads, frazy z AI Overviews i cytowania domeny |
get_positions_data | frazy, na które rankuje domena, z pozycjami i widocznością |
get_competitors | konkurentów domeny z porównaniem metryk |
get_urls | pojedyncze adresy URL rankujące w wynikach |
get_cannibalization_keywords | frazy, o które konkuruje kilka URL-i tej samej domeny |
get_keyword_statistics | wolumen, CPC i trend dla podanych fraz, do 500 na jedno wywołanie |
serp_create, serp_get_report | analizę dla frazy: rankujące URL-e, statystyki treści, pytania, frazy powiązane |
rt_get_position_data | dzienną historię pozycji z projektów w module Monitoring |
get_limits | stan wszystkich limitów konta |
Pełna lista wraz z odpowiednikami w REST API jest w dokumentacji serwera MCP Senuto (link w źródłach na końcu artykułu).
Jak interpretować dane z Senuto MCP i łączyć je z Search Console?
Pozycje i wskaźniki w Senuto opisują obecność domeny w bazie fraz tego narzędzia. Google Search Console dostarcza danych o wyświetleniach i kliknięciach w wyszukiwarce. Jeśli udostępnisz oba źródła, możesz zestawić wzrost widoczności z kliknięciami, zachowując ich różne zakresy i metodologie.
Do rzetelnej oceny zaleceń treściowych niezbędny jest bezpośredni dostęp do samej zawartości podstrony — w interfejsie czatu można przekazać ją w postaci pliku lub pobrać za pomocą dedykowanego narzędzia sieciowego. Z kolei w środowisku repozytorium agent automatycznie odczytuje pliki lokalne, jednak pobieranie danych z zewnętrznych systemów CMS bądź serwisów konkurencji wciąż wymaga osobnej integracji. Przy pracy trzeba też pamiętać, że same polecenia np. o porównaniu treści nie stanowią gwarancji, że model przeanalizował wskazane materiały, dlatego dobrą praktyką jest wykazanie źródeł w odpowiedzi agenta.
W przypadku obszernych raportów konieczne jest ograniczenie zakresu analizy do wybranych adresów URL lub priorytetowych fraz kluczowych. Należy przy tym pamiętać, że obcięta odpowiedź API nie reprezentuje pełnego zbioru danych — narzędzia Senuto zwracają maksymalnie 100 rekordów w pojedynczym wywołaniu, natomiast dane o pozycjach z modułu monitoringu ograniczają się do 50 wyników. Praca na kompletnych zestawieniach wymaga od agenta bezwzględnej weryfikacji parametrów paginacji, zastosowanych filtrów oraz faktycznej liczby pobranych rekordów.


