Skip to Content
Serwer MCP

Serwer MCP Senuto

MCP (Model Context Protocol) to standard, którym asystenci AI łączą się z zewnętrznymi źródłami danych. Serwer MCP Senuto wystawia dane Senuto jako narzędzia, po które model sięga sam: pytasz w Claude, ChatGPT czy Cursorze o widoczność domeny, a asystent pobiera liczby z Senuto, zamiast je zgadywać.

Serwer jest zdalny — nie instalujesz niczego lokalnie:

https://mcp.senuto.com/mcp

Transport: HTTP. Uwierzytelnienie: OAuth przy pierwszym użyciu — nie pobierasz i nie wklejasz żadnego tokena.

MCP prowadzi do tych samych danych co REST API — różni się tym, kto pisze integrację: przy REST Ty w kodzie, przy MCP model na podstawie Twojego polecenia. Porównanie trzech dróg (API, MCP, no-code): API, MCP czy no-code.

Czego potrzebujesz

MCP i REST API to osobne uprawnienia na koncie:

Plan / dodatekREST APISerwer MCP
Advanced, Primew cenie planuw cenie planu
Dodatek „Dostęp do API + MCP” (Basic, Lite)taktak
Dodatek „Dostęp do MCP” — 69 zł/mies. (Basic, Lite)nietak

Dodatek włączasz samodzielnie w aplikacji: app.senuto.com/user/user-package. Ceny: stan na 2026-09-06, aktualne w cenniku Senuto. Warunki dodatku API (rozliczenie miesięczne, rezygnacja przez nieprzedłużenie) opisuje strona Dostęp do API — dodatek MCP działa tak samo.

Sam dodatek MCP nie odblokowuje REST API. Serwer MCP uwierzytelnia się w API Senuto po swojemu; Twoje własne żądanie wysłane wprost na api.senuto.com z takim kontem dostanie 403 z pustą treścią ({"success": false, "message": ""}). Jeśli obok asystenta chcesz pisać własne integracje, potrzebujesz dodatku obejmującego API.

Podłączenie

Dodaj serwer w swoim kliencie

claude mcp add senuto --transport http https://mcp.senuto.com/mcp

Zaloguj się przez OAuth

Klient wyświetli monit przy pierwszym użyciu i przeprowadzi Cię przez logowanie do Senuto. Nie generujesz tu żadnego tokena ręcznie i nie używasz tokena REST API — to dwie różne rzeczy.

Sprawdź, że działa

Poproś asystenta o coś, czego nie wie z głowy — np. „sprawdź w Senuto widoczność zalando.pl”. Powinien wywołać narzędzie get_domain_statistics i pokazać liczby. Jeśli odpowiada bez wywołania narzędzia, patrz Gdy coś nie działa.

Co potrafi serwer MCP

26 narzędzi pokrywających cztery moduły plus odczyt limitów. Poniżej mapa: narzędzie MCP → odpowiadający mu endpoint REST, gdybyś chciał to samo zrobić we własnym kodzie.

Stan na 2026-09-15. Źródłem prawdy jest lista narzędzi, którą serwer zgłasza Twojemu klientowi — zestaw może się zmieniać częściej niż ta strona.

Analiza widoczności

Narzędzie MCPCo zwracaOdpowiednik w REST API
get_domain_statisticswidoczność domeny, TOP3/10/50, ranking, ekwiwalent Ads oraz liczba fraz z AI Overview i cytowań domeny w nimdashboard/getDomainStatistics
get_positions_datafrazy, na które rankuje domena, z pozycjami i widocznościąpositions/getData
get_competitorskonkurenci domeny z porównaniem metrykcompetitors/getData
get_cannibalization_keywordsfrazy, o które konkuruje kilka własnych URL-icannibalization/getKeywords
get_characteristics_tablerozkład fraz wg cech (długość, trendy, wyszukiwania, trudność)keywords/getCharacteristicsTable
get_keyword_historyhistoria pozycji pojedynczej frazypositions/getKeywordHistory
get_positions_history_charthistoria rozkładu pozycji (dane do wykresu)— (poza zakresem tej dokumentacji)
get_subdomainswidoczność w podziale na subdomenysections/getSubdomains
get_urlspojedyncze URL-e rankujące w wynikachsections/getUrls
suggest_domainspodpowiedzi domen do wyszukiwarki— (poza zakresem tej dokumentacji)
get_countries_listlista obsługiwanych rynkówKraje i country_id

Baza słów kluczowych

Narzędzie MCPCo zwracaOdpowiednik w REST API
get_keyword_statisticswyszukiwania, CPC i trend dokładnie tych fraz, które podasz — do 500 na wywołanietools/statistics/createcheckDatagetKeywords
get_keywordspropozycje fraz dla frazy, domeny albo URL-akeywords/getKeywords
get_groupsgrupy semantyczne dla frazykeywords/getGroups
get_questionsfrazy pytające powiązane z fraząkeywords/getQuestions

get_keywords nie zwraca wyszukiwań frazy, którą podasz — zwraca inne frazy do niej dopasowane, a sam seed często nie ma w wynikach własnego wiersza. Wyszukiwania konkretnych fraz daje get_keyword_statistics: jeden wiersz na frazę, found: false, gdy Senuto nie ma dla niej danych, i searches: 0, gdy fraza jest znana, ale bez wolumenu.

Narzędzia Bazy słów kluczowych obsługują country_id: 1 (PL), 50 (CZ), 53 (DK), 82 (HU), 134 (NL), 153 (RO), 160 (SE), 164 (SK).

Monitoring (Rank Tracker)

Narzędzie MCPCo zwracaOdpowiednik w REST API
rt_get_active_projectsTwoje aktywne projektyprojects/getMyActiveProjects
rt_get_projects_listlista projektów z rozszerzonymi danymiprojects/getListWithExtendedData
rt_list_groupswszystkie grupy fraz w projekcie (pobiera każdą stronę)groups/list
rt_get_project_keywordsfrazy monitorowane w projekcie (id + treść, bez pozycji)keywords/getProjectKeywords
rt_get_position_datadzienna historia pozycji fraz w zakresie datpositions/getData
rt_get_snippets_statisticsstatystyki snippetów i funkcji SERP w projekciesnippets/getStatistics

Analiza SERP

Ten sam przepływ asynchroniczny co w REST API (Eksporty i zadania async): zlecasz analizę, odpytujesz o status, dopiero potem czytasz raporty.

Narzędzie MCPCo robiOdpowiednik w REST API
serp_createzleca analizę SERP dla frazy — zużywa limitserp_analysis/create
serp_checkstatus zadania (has_serp_data, has_keywords_analysis_data)serp_analysis/check
serp_listTwoje zadania SERP, od najnowszych— (poza zakresem tej dokumentacji)
serp_get_reportraport z gotowego zadania (9 udokumentowanych rodzajów, patrz niżej)strony raportów w module SERP

Raporty dostępne w serp_get_report (parametr report): urls, content_statistics, keyword_stats, competitors_number, topic_leaders, groups, questions, related_keywords, keywords_propositions.

Parametr report przyjmuje jeszcze titles, ale ten raport zwraca pustą listę na każdym zadaniu. Tytuły stron rankujących znajdziesz w raporcie urls.

Konto

Narzędzie MCPCo zwracaOdpowiednik w REST API
get_limitsstan wszystkich limitów konta naraz; nie zużywa żadnej puliGET /api/users/getLimits

Limity — jedna pula na konto

Wywołania przez MCP czerpią z tych samych liczników co REST API i klikanie w aplikacji. Nie ma osobnego „limitu MCP”: zapytanie asystenta o nową domenę zużywa tę samą jednostkę co odpowiadające mu żądanie REST. Zasady, okresy rozliczeniowe i Grace Window opisuje strona Limity zapytań.

W praktyce, przy pracy z asystentem:

  • get_limits jest darmowe — możesz kazać modelowi sprawdzać stan puli, ile chcesz.
  • serp_create kosztuje jednostkę serp_analysis_daily_limit. Zanim zlecisz nową analizę, warto sprawdzić serp_list — raporty istniejącego, zakończonego zadania dla tej samej frazy pobierzesz bez naliczenia.
  • Czytanie gotowych danych zwykle nie kosztuje — paginacja i kolejne raporty tego samego zadania podlegają limitom liczby wierszy, nie limitowi zapytań.
  • get_keyword_statistics i get_keywords czerpią z osobnych pul. Pierwsze liczy się do tools_daily_limit i kosztuje jedną jednostkę na wywołanie, choćby niosło 500 fraz. Drugie liczy się do keywords_analysis_queries_per_day, po jednostce za każdy seed — pięć seedów to pięć jednostek, w jednym wywołaniu czy w pięciu.
  • Pętla w rozmowie potrafi wyczerpać limit, którego potrzebujesz do pracy w panelu — to ta sama pula.

Czym MCP różni się od REST API

Serwer MCPREST API
Zakres26 narzędzi, wybrane raporty124 udokumentowane endpointy
Rynki (Analiza widoczności)1 (PL 1.0), 50 (CZ), 164 (SK), 200 (PL 2.0)wszystkie obsługiwane rynki
Rynki (Baza słów kluczowych)1, 50, 53, 82, 134, 153, 160, 164 — dla Polski 1, bez 200jak wyżej
Wielkość odpowiedzidetail_level: summary / standard / extendedpełna odpowiedź + paginacja
Strona wynikówdo 100 rekordów (rt_get_position_data: do 50)limity per endpoint
Zapistylko serp_create (zlecenie analizy) — reszta to odczytpełna powierzchnia odczytowa modułów
Kto ustala parametrymodel, na podstawie Twojego poleceniaTy, w kodzie

Baza 2.0 dla Polski (country_id: 200) nie działa w narzędziach Bazy słów kluczowych — tam użyj country_id: 1. W Analizie widoczności 200 jest dostępne i to nadal zalecana baza.

Parametry dobiera model, więc warto je weryfikować — zwłaszcza rynek (country_id) i tryb domeny (fetch_mode: topLevelDomain czy subdomain). Najprościej podać je wprost w poleceniu: „…dla senuto.com, cała domena, baza 2.0”. Do powtarzalnych, rozliczanych raportów zamiast MCP użyj REST API — tam parametry są w Twoim kodzie, nie w interpretacji promptu.

Gdy coś nie działa

ObjawPrzyczyna i co zrobić
Logowanie OAuth się nie kończy albo klient nie łączy się z serweremsprawdź, czy Twoje konto ma dostęp do MCP (plan Advanced/Prime albo dodatek); przy wątpliwościach napisz na czacie do supportu
Klient widzi serwer, ale nie ma żadnych narzędziserwer podłączony bez zakończonej autoryzacji — usuń konektor i dodaj go ponownie, przechodząc OAuth do końca
Asystent odpowiada „z głowy”, bez wywołania narzędziapoproś wprost: „użyj narzędzia Senuto” i wskaż raport; sprawdź też, czy konektor jest włączony w tej rozmowie
serp_get_report zwraca Unfinished taskcrawl jeszcze trwa — odpytuj serp_check, aż progress.has_serp_data będzie true
Błąd 418 w trakcie rozmowynajczęściej wyczerpany limit modułu — sprawdź get_limits (Limity zapytań)
403 z pustą treścią przy własnych żądaniach curl-emmasz dostęp do MCP, ale nie do REST API — patrz Czego potrzebujesz

Bieżące informacje o awariach: komunikat.senuto.com.

Co dalej

Ostatnia aktualizacja: