Przeglądaj dokumentację

Połącz swoje kanały

Asystenci AI (MCP)

Semurai ma własny serwer MCP, więc asystent AI, z którego już korzystasz, może pracować w Twoim workspace Semurai. Poproś swojego asystenta (Claude, ChatGPT, Claude Code, Cursor lub VS Code) o badanie słów kluczowych, audyt strony albo nowy artykuł, a gotowa praca trafi do Semurai, gdzie ją przejrzysz.

MCP (Model Context Protocol) to otwarty standard, przez który asystenci AI łączą się z innymi aplikacjami. Dodajesz w asystencie jeden adres, raz zatwierdzasz połączenie i od tej chwili zlecasz pracę nad SEO i treściami w czacie, którego już używasz. Co to daje w praktyce, opisujemy na stronie Serwer MCP Semurai.

Co możesz zrobić

Pisz własnymi słowami. Asystent sam dobiera właściwe działania w Semurai, pracuje w Twoim workspace i mówi, co zrobił. Kilka przykładów z każdego obszaru:

Badanie SEO

Badanie słów kluczowych i podobnych fraz, analiza konkurencji i luk w słowach kluczowych, kto jest w wynikach na dane zapytanie, przegląd domeny, sprawdzanie pozycji na żywo i klastry tematyczne. Więcej w przewodniku Badanie słów kluczowych.

  • Znajdź frazy z długiego ogona o kawie cold brew z niską trudnością.
  • Na jakie słowa kluczowe rankuje konkurencja, a my nie?
  • Zbuduj klaster tematyczny wokół domowego espresso.

Pozycje i Search Console

Monitorowane słowa kluczowe i historia ich pozycji, nowe frazy do monitorowania, raporty Google Search Console (przegląd, najlepsze zapytania, najlepsze podstrony, trendy zapytań i okazje), audyty podstron, pełne audyty witryny i raporty wyników.

  • Jak zmieniły się pozycje monitorowanych fraz w tym miesiącu?
  • Pokaż zapytania z Search Console z dużą liczbą wyświetleń i niskim CTR.
  • Zrób pełny audyt SEO naszej strony i wypisz najważniejsze poprawki.

Treści

Wyszukiwanie i czytanie artykułów oraz dokumentów, konspekty, artykuły SEO z miejscami na obrazy, aktualizacja treści, dokumenty i szkice e-maili, plany treści i kampanie, okazje marketingowe oraz propozycje linków wewnętrznych.

  • Napisz artykuł SEO o wyborze młynka do kawy na podstawie naszego badania słów kluczowych.
  • Zaplanuj treści na blog sklepu na najbliższy miesiąc.
  • Zaproponuj linki wewnętrzne do artykułu o ekspresach do kawy.

Social media i kalendarz

Szkice postów (tekst), lista Twoich postów, kalendarz treści oraz planowanie treści i postów.

  • Przygotuj trzy posty na LinkedIn promujące nasz najnowszy artykuł.
  • Co mamy zaplanowane w kalendarzu treści na przyszły tydzień?
  • Zaplanuj post na LinkedIn o jesiennej mieszance na piątek na 9:00.

Publikacja

Publikacja artykułów w WordPressie, PrestaShop lub na blogu Shopera. W WordPressie asystent może też sprawdzać wpisy oraz przygotowywać, wdrażać lub odrzucać zmiany SEO.

  • Opublikuj artykuł o młynkach do kawy na naszym blogu w Shoperze.
  • Sprawdź SEO pięciu najnowszych wpisów w WordPressie i przygotuj poprawki.

E-commerce

Praca z połączonymi sklepami na Shoperze, WooCommerce i PrestaShop: wyszukiwanie produktów i kategorii, propozycje SEO dla produktów, kategorii i tekstów alternatywnych zdjęć, wdrażanie zatwierdzonych propozycji oraz import produktów z Shopera. Więcej w przewodniku Sklep.

  • Znajdź produkty bez meta opisu i przygotuj propozycje SEO.
  • Napisz teksty alternatywne do zdjęć w kategorii Młynki.
  • Wdróż w sklepie zatwierdzone propozycje.

Media i zadania

Wyszukiwanie w bibliotece mediów, dodawanie mediów z adresu URL, zmiana ich opisów i porządkowanie folderów. Lista zadań, tworzenie i zmiana zadań oraz przypisanie zadania jednemu z agentów Semurai.

  • Przenieś zdjęcia produktów z zeszłego tygodnia do folderu Kampania wiosenna.
  • Utwórz zadanie odświeżenia artykułu o cenach i przypisz je Tenko.

Połącz swojego asystenta

Każdy asystent korzysta z tego samego adresu serwera. Skopiuj go i wykonaj kroki dla swojego asystenta. Ten sam adres i skrócone instrukcje znajdziesz w aplikacji Semurai w Ustawienia → Asystenci AI (MCP).

https://api.semur.ai/mcp

Claude (w przeglądarce i aplikacji desktopowej)

  1. W Claude otwórz Dostosuj → Konektory (Customize → Connectors).
  2. Kliknij + Dodaj (+ Add) i wybierz Dodaj własny konektor (Add custom connector).
  3. Wpisz nazwę, na przykład Semurai, wklej adres serwera i kliknij Dalej (Continue), a potem Dodaj (Add).
  4. Kliknij Połącz (Connect) i zatwierdź połączenie na stronie Semurai.

W planach Claude Team i Enterprise konektor dodaje raz właściciel organizacji (Owner) w Ustawienia organizacji → Konektory → Dodaj → Własny → Web (Organization settings → Connectors → Add → Custom → Web). Członkowie organizacji klikają potem Połącz (Connect) i logują się do własnych kont Semurai. Na planie Free możesz dodać jeden własny konektor. Co Claude potrafi zrobić z Semurai, wraz z przykładowymi poleceniami: Claude do SEO.

ChatGPT

  1. W ChatGPT w przeglądarce otwórz Wtyczki (Plugins) i kliknij +.
  2. Wybierz Dodaj własny serwer MCP (Add custom MCP server), wpisz nazwę i wklej adres serwera.
  3. Jako uwierzytelnianie wybierz OAuth, zaznacz Rozumiem i chcę kontynuować (I understand and want to continue) i kliknij Utwórz (Create).
  4. Zatwierdź połączenie na stronie Semurai.

Pełne akcje (zapis) w ChatGPT: plany Business, Enterprise i Edu. Na planie Pro własne serwery MCP łączą się w trybie odczytu. Własne serwery MCP dodajesz w ChatGPT w przeglądarce. Zastosowania i polecenia do wypróbowania znajdziesz na stronie ChatGPT do SEO.

Claude Code

Uruchom to polecenie w terminalu:

claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp

Opcja --scope user dodaje Semurai do wszystkich Twoich projektów. Potem zaloguj się do Semurai poleceniem claude mcp login semurai albo wpisz /mcp w Claude Code. Praca nad SEO z terminala, z przykładami: Claude Code do SEO.

Codex

Uruchom to polecenie w terminalu:

codex mcp add semurai --url https://api.semur.ai/mcp

Potem zaloguj się do Semurai poleceniem codex mcp login semurai. Serwer możesz też dodać w pliku ~/.codex/config.toml:

config.toml
[mcp_servers.semurai]
url = "https://api.semur.ai/mcp"

Rozszerzenie Codex do IDE i aplikacja desktopowa Codex korzystają z tej samej konfiguracji. Serwer dodasz w nich też w Ustawienia → Serwery MCP → Dodaj serwer (Settings → MCP servers → Add server), z typem Streamable HTTP. Więcej o pracy z Semurai w Codexie: Codex MCP.

Cursor

Dodaj serwer do pliku ~/.cursor/mcp.json, aby używać go we wszystkich projektach, albo do .cursor/mcp.json w jednym projekcie:

mcp.json
{
  "mcpServers": {
    "semurai": {
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Gdy Cursor o to poprosi, zaloguj się do Semurai. O co możesz poprosić w Cursorze: Cursor MCP.

VS Code (GitHub Copilot)

GitHub Copilot w trybie agenta korzysta z serwerów zapisanych w pliku .vscode/mcp.json w projekcie:

.vscode/mcp.json
{
  "servers": {
    "semurai": {
      "type": "http",
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Kliknij Start nad serwerem w pliku i zaloguj się do Semurai. Przykłady dla Copilota w trybie agenta: VS Code MCP.

Inni asystenci

Każdy asystent, który obsługuje zdalne serwery MCP z logowaniem OAuth, łączy się tak samo: dodaj https://api.semur.ai/mcp jako adres serwera.

Gemini CLI: dodaj serwer tym poleceniem, a potem zaloguj się, wpisując /mcp auth semurai w Gemini CLI.

gemini mcp add --transport http semurai https://api.semur.ai/mcp

W pliku settings.json Gemini CLI adres trafia pod klucz httpUrl:

settings.json
{
  "mcpServers": {
    "semurai": {
      "httpUrl": "https://api.semur.ai/mcp"
    }
  }
}

Pełny serwer z grafiką AI

Adres powyżej to serwer oficjalny, do katalogów aplikacji w Claude i ChatGPT oraz do codziennej pracy. Semurai ma też serwer pełny: to samo logowanie i te same narzędzia, a do tego grafika AI. Dodajesz go ręcznie jako własny konektor, pod tym adresem:

https://api.semur.ai/mcp/full

Z serwerem pełnym asystent może też:

  • tworzyć obrazy do postów i artykułów,
  • tworzyć projekty w Canvas,
  • tworzyć projekty w Creative Studio,
  • pracować na projektach z Creative Studio: wybrać tryb (Szablon, Unikat albo Projektant), odpowiadać na pytania projektanta, poprawiać projekt i wracać do wcześniejszej wersji albo wariantu,
  • zapisywać grafiki do social mediów, karuzele i reklamy z Creative Studio w bibliotece mediów i dodawać je do postów,
  • proponować pomysły na projekty dla Twojej marki,
  • pisać opisy AI i teksty alternatywne do obrazów w bibliotece mediów.

Jak dodać serwer pełny

  • Claude: w Dostosuj → Konektory (Customize → Connectors) kliknij + Dodaj, wybierz Dodaj własny konektor i wklej adres serwera pełnego.
  • ChatGPT: we Wtyczkach (Plugins) kliknij +, wybierz Dodaj własny serwer MCP i wklej adres serwera pełnego.
  • Cursor i VS Code: użyj tego samego pliku mcp.json co wyżej, z adresem serwera pełnego.

W Claude Code uruchom:

claude mcp add --transport http --scope user semurai-full https://api.semur.ai/mcp/full

W Codex uruchom:

codex mcp add semurai-full --url https://api.semur.ai/mcp/full

Połączenie zatwierdzone dla serwera oficjalnego działa z serwerem oficjalnym. Aby korzystać z serwera pełnego, dodaj go jako osobny konektor i zatwierdź połączenie na stronie Semurai. W Claude Code i Codex zaloguj się poleceniem claude mcp login semurai-full lub codex mcp login semurai-full. Grafiki tworzone przez serwer pełny wliczają się do limitów użycia workspace, tak jak grafiki tworzone w aplikacji.

Pierwsze połączenie i workspace

Przy pierwszym połączeniu asystent otwiera stronę Semurai. Zaloguj się, jeśli jeszcze nie jesteś zalogowany, a potem:

  1. Sprawdź nazwę aplikacji i adres, na który wróci przeglądarka. Oba widać na stronie.
  2. Wybierz Domyślny workspace.
  3. Kliknij Zezwól. Przeglądarka wróci do asystenta, który jest gotowy do pracy.

Asystent pracuje w domyślnym workspace. Na Twoją prośbę pokaże Twoje inne workspace, zadziała w każdym z nich i zmieni domyślny, na przykład: Jakie mam workspace? Przełącz się na workspace sklepu.

Dłuższa praca toczy się w tle: pisanie artykułu, pełny audyt witryny, plan treści, posty albo klaster tematyczny. Asystent sprawdza postęp i przynosi wynik, gdy jest gotowy. Szkice pojawiają się w aplikacji Semurai: w Bibliotece, w kalendarzu treści i wśród Twoich postów.

Zarządzanie i odłączanie

W aplikacji Semurai otwórz Ustawienia → Asystenci AI (MCP). Znajdziesz tam:

  • oba adresy serwera (oficjalny i pełny) z przyciskami kopiowania oraz skrócone instrukcje dla każdego asystenta,
  • połączone aplikacje z datą połączenia i ostatniego użycia,
  • domyślny workspace każdej aplikacji, który możesz zmienić w dowolnej chwili,
  • przycisk Odłącz, który od razu odbiera aplikacji dostęp.

Aby znów korzystać z odłączonego asystenta, połącz go ponownie z poziomu asystenta.

Bezpieczeństwo i limity użycia

  • To Ty potwierdzasz to, co wychodzi poza Semurai. Publikacja i planowanie poza Semurai (WordPress, blog PrestaShop lub Shopera, sieci społecznościowe) oraz wdrażanie zmian w sklepie lub w witrynie na WordPressie to osobne działania, a asystent prosi Cię o potwierdzenie każdego z nich.
  • Zmiany w sklepie zaczynają się od propozycji. Zmiany SEO produktów, kategorii i zdjęć powstają najpierw jako propozycje, a do sklepu trafiają tylko te, które zatwierdzisz.
  • Obowiązuje Twoja rola. Asystent działa z Twoją rolą w każdym workspace. Z rolą Widz może tylko odczytać podstawowe informacje o workspace.
  • Jedne limity użycia. Działania asystenta wliczają się do tych samych limitów użycia co Twoja praca w aplikacji.

Rozwiązywanie problemów

  • Link do połączenia wygasł: strona zatwierdzenia jest ważna przez 10 minut. Zacznij łączenie od nowa w asystencie.
  • Asystent mówi, że stracił dostęp: połącz go ponownie. W Ustawienia → Asystenci AI (MCP) sprawdzisz, czy aplikacja nie została odłączona.
  • Limit użycia się wyczerpał: poczekaj, aż się odnowi, i poproś ponownie.
  • Narzędzie zgłasza, że integracja nie jest połączona: połącz Google Search Console, WordPressa lub sklep w Ustawienia → Integracje i poproś ponownie. Zobacz Połącz stronę lub sklep.

Co dalej

Twoi agenci są gotowi.
Daj im cel.

Zacznij od adresu swojej strony. Semurai pozna Twoją markę i zaplanuje pierwszy tydzień treści.

  • Darmowy plan na zawsze
  • Bez karty płatniczej
  • Start w około 3 minuty