PL
Zacznij za darmo

Codex + Semurai

Codex MCP
do SEO i treści.

Skonfiguruj Semurai jako serwer Codex MCP raz, a Codex CLI, rozszerzenie IDE i aplikacja Codex zbadają frazy, przeczytają dane z Search Console i przeniosą szkice artykułów do Twojego repozytorium. Dla stron, których treści leżą w plikach Markdown i MDX. Jeden adres, logowanie OAuth, bez kluczy API.

Zacznij za darmoPoradnik konfiguracji

Codex CLI · Rozszerzenie IDE · Aplikacja Codex

Dodaj Semurai z terminala

Terminal
codex mcp add semurai --url https://api.semur.ai/mcp
codex mcp login semurai
  • Albo dopisz go do ~/.codex/config.toml
  • Zaloguj się do Semurai w przeglądarce i kliknij Zezwól
  • Rozszerzenie IDE i aplikacja Codex korzystają z tej samej konfiguracji

Konfiguracja

Jak skonfigurować
serwer Codex MCP?

Dwa polecenia w terminalu. Codex zapisuje serwer w swojej konfiguracji, którą czytają też rozszerzenie IDE i aplikacja Codex.

  1. W terminalu uruchom polecenie codex mcp add z ramki Terminal.

  2. Uruchom codex mcp login semurai. Codex otworzy stronę Semurai w przeglądarce.

  3. Zaloguj się do Semurai, wybierz domyślny workspace i kliknij Zezwól.

  4. Uruchom Codexa w swoim projekcie i poproś o coś, co wymaga danych z wyszukiwarki. Codex sam sięgnie po potrzebne narzędzia Semurai.

Terminal
codex mcp add semurai --url https://api.semur.ai/mcp
codex mcp login semurai
~/.codex/config.toml
[mcp_servers.semurai]
url = "https://api.semur.ai/mcp"

Warto wiedzieć

  • Wolisz plik? Dopisz blok TOML do ~/.codex/config.toml i uruchom codex mcp login semurai. Zaufany projekt może trzymać go w .codex/config.toml.
  • Codex CLI, rozszerzenie IDE i aplikacja Codex dzielą tę konfigurację, więc Semurai dodajesz raz.
  • Każde połączenie ma domyślny workspace. Poproś Codexa o listę Twoich workspace, a będzie mógł pracować w innym.

Zastosowania

Co Codex może robić
z Semurai?

Codex do SEO to dane z wyszukiwarki obok plików źródłowych: Codex edytuje treści, a Semurai podpowiada, czego ludzie szukają.

  • SEO stron budowanych z Markdowna

    Twój blog to pliki Markdown albo MDX, które Codex i tak edytuje. Semurai dodaje dane z wyszukiwarki, więc każda zmiana we wpisie zaczyna się od liczby wyszukiwań i intencji.

  • Tytuły, w które się klika

    Codex znajduje w Search Console strony z dużą liczbą wyświetleń i małą liczbą kliknięć, a potem przepisuje ich meta tytuły i opisy w kodzie źródłowym.

  • Cotygodniowy plik z pozycjami w repozytorium

    Jedno polecenie codex exec pobiera z monitoringu pozycji w Semurai zmiany z mijającego tygodnia i zapisuje je w pliku Markdown w repozytorium, gotowe na poniedziałek.

  • Szkice z edytora prosto do Gita

    Artykuł napisany i przejrzany w edytorze SEO Semurai wraca przez get_content jako Markdown, gotowy do zapisania jako nowy wpis.

  • Luki fraz jako zadania

    Codex porównuje w Semurai Twoją domenę z maksymalnie pięcioma konkurentami i dodaje brakujące tematy jako zadania na tablicy Semurai, skąd biorą je Twoi redaktorzy.

  • Frazy dla stron dokumentacji

    Centrów pomocy i dokumentacji też ktoś szuka. Codex sprawdza liczbę wyszukiwań i powiązane pytania, a potem układa nagłówki wokół tego, o co pytają ludzie.

Przykład

Dane z Search Console
poprawione w kodzie.

Codex czyta liczby z Semurai i edytuje pliki, które za nimi stoją.

  1. Ty:

    Część stron naszego bloga ma wyświetlenia, ale mało kliknięć. Sprawdź je w Semurai i popraw tytuły i opisy najsłabszych.

  2. Narzędzie Semurai: semurai.search_console_reporttop_pages, ostatnie 28 dni
  3. Narzędzie Semurai: semurai.research_keywords3 frazy do tytułów
  4. Asystent:

    Trzy strony bloga z dużą liczbą wyświetleń i małą liczbą kliknięć:

    StronaWyświetleniaCTRPozycja
    /blog/poradnik-french-press/12 4000,9%6,2
    /blog/kawa-bez-kofeiny/81501,1%7,8
    /blog/ustawienia-mlynka/53201,4%5,4

    Ich pliki są w content/blog. Tytuł i opis w sekcji front matter każdego z nich są już przepisane wokół frazy z największą liczbą wyszukiwań. Uruchomić build?

  5. Ty:

    Tak, uruchom.

  6. Asystent:

    Build przeszedł. Trzy pliki w content/blog zmienione i gotowe do przejrzenia przed commitem.

Projekt demo: Morrowfield Coffee Co. (dane przykładowe). Przykład Codexa, który korzysta z dwóch narzędzi Semurai w repozytorium strony.

Prompty do wypróbowania

Zleć Codexowi
takie zadanie.

  • „Przenieś nasz najnowszy szkic z Semurai o młynkach do kawy do content/blog jako MDX, z meta tytułem i opisem w sekcji front matter.”
  • „Znajdź w Semurai lukę fraz między nami a dwoma zapisanymi konkurentami i dodaj pięć najlepszych tematów jako zadania.”
  • „Wypisz monitorowane w Semurai frazy, które nie mają jeszcze wpisu w content/blog.”
  • „Zbadaj frazy dla strony dokumentacji o proporcjach parzenia i zaproponuj nagłówki H2 z pytań, które zadają ludzie.”
  • „Dodaj frazy docelowe naszych pięciu najnowszych wpisów do monitoringu pozycji w Semurai.”

CLI, IDE czy aplikacja

Codex CLI, rozszerzenie IDE
czy aplikacja Codex?

Wszystkie trzy czytają tę samą konfigurację MCP. Dodaj Semurai w tym, który otworzysz pierwszy.

Gdzie dodać serwer Codex MCP

Dodawanie serwera MCP Semurai w Codex CLI, rozszerzeniu IDE i aplikacji
Codex CLIRozszerzenie IDEAplikacja Codex
Gdzie dodajeszcodex mcp add albo config.tomlMenu z kołem zębatym → Serwery MCP (MCP servers) → Dodaj serwer (Add server)Ustawienia → Serwery MCP (Settings → MCP servers)
Jak się logujeszcodex mcp login semuraiUruchom ponownie rozszerzenie (Restart extension), potem Uwierzytelnij (Authenticate)Uruchom ponownie (Restart), potem zaloguj się, gdy Codex poprosi
Dobre doPracy w terminalu i uruchomień ze skryptu przez codex execPoprawek w otwartych plikach z treściąZlecania zadań Codexowi poza terminalem i edytorem

W rozszerzeniu IDE

  1. Otwórz menu z kołem zębatym i wybierz Serwery MCP (MCP servers), a potem Dodaj serwer (Add server).
  2. Wybierz Streamable HTTP, wpisz nazwę semurai i adres https://api.semur.ai/mcp, a potem zapisz.
  3. Kliknij Uruchom ponownie rozszerzenie (Restart extension), potem Uwierzytelnij (Authenticate). Zaloguj się do Semurai i kliknij Zezwól.

W aplikacji Codex

  1. Otwórz Ustawienia → Serwery MCP (Settings → MCP servers).
  2. Dodaj serwer tak samo: Streamable HTTP, nazwa semurai i adres serwera.
  3. Kliknij Uruchom ponownie (Restart), zaloguj się do Semurai, gdy Codex poprosi, i kliknij Zezwól.

Skrypty i zespoły

Codex do SEO
nie tylko w rozmowie.

Uruchamiaj raporty Semurai ze skryptu, daj Codexowi stałą instrukcję SEO albo wybierz agenta do kodu, który pasuje do Twojego zespołu.

Raporty ze skryptu przez codex exec

codex exec uruchamia Codexa bez sesji interaktywnej, więc cotygodniowe podsumowanie pozycji to jedno polecenie. Codex czyta monitorowane frazy w Semurai i zapisuje podsumowanie w repozytorium jako Markdown.

Terminal
codex exec "Pobierz z Semurai monitorowane frazy z ich zmianą tygodniową. Zapisz pięć największych zmian z krótkim komentarzem w reports/pozycje-tydzien.md."

Wstaw polecenie do skryptu uruchamianego w każdy poniedziałek, a raporty utworzą w Gicie historię obok Twoich treści.

Sekcja SEO do AGENTS.md

Codex stosuje się do instrukcji projektu z pliku AGENTS.md. Krótka sekcja taka jak ta wpisuje badanie fraz w jego codzienną pracę:

AGENTS.md
## SEO
Zanim napiszesz albo zmienisz wpis na blogu, sprawdź jego frazę docelową w Semurai:
liczbę wyszukiwań, trudność i pytania, które zadają ludzie.
Użyj tych pytań jako nagłówków tam, gdzie pasują.

Codex czy Claude Code?

Codex i Claude Code z serwerem MCP Semurai
CodexClaude Code
Dodanie Semuraicodex mcp addclaude mcp add
Logowaniecodex mcp login semurai/mcp w Claude Code albo claude mcp login semurai
Konfiguracja~/.codex/config.toml, wspólna dla CLI, rozszerzenia IDE i aplikacjiZakres local, project (.mcp.json) albo user

Oba sięgają po te same 62 narzędzia Semurai na tym samym koncie. Pracujesz w Claude Code? Zajrzyj na stronę o Claude Code. Do badań i planów w rozmowie połączysz też ChatGPT.

Inni asystenci

Korzystaj z Semurai
w innym asystencie.

Ten sam adres serwera i to samo konto Semurai działają w każdym asystencie poniżej.

FAQ

Codex i Semurai: pytania

Jak dodać serwer MCP do Codexa?

Uruchom codex mcp add z nazwą i adresem serwera. Dla Semurai: codex mcp add semurai --url https://api.semur.ai/mcp, a potem codex mcp login semurai, żeby się zalogować. Serwer możesz też wpisać do config.toml albo dodać w sekcji MCP servers w rozszerzeniu IDE lub w aplikacji Codex.

Gdzie Codex zapisuje serwery MCP?

W pliku config.toml, jako tabelę [mcp_servers.semurai] z adresem serwera w polu url. Czytają go Codex CLI, rozszerzenie IDE i aplikacja Codex.

Czy konfiguracja Codex MCP działa we wszystkich projektach?

Tak, jeśli serwer jest w ~/.codex/config.toml: ten plik obowiązuje we wszystkich Twoich projektach. Zaufany projekt może mieć też własny plik .codex/config.toml z serwerami tylko dla tego repozytorium.

Czy rozszerzenie Codexa do IDE korzysta z tej samej konfiguracji?

Tak. Codex CLI, rozszerzenie IDE i aplikacja Codex mają wspólną konfigurację MCP, więc serwer dodany w jednym z nich jest dostępny w pozostałych.

Jak Codex loguje się do Semurai?

Przez OAuth. Polecenie codex mcp login semurai otwiera stronę Semurai w przeglądarce, gdzie logujesz się, wybierasz domyślny workspace i klikasz Zezwól. Do pliku konfiguracyjnego nie trafia żaden klucz API, a token dostępu odnawia się sam.

Czy Codex napisze wpisy na blog w moim repozytorium z danymi z Semurai?

Tak, na dwa sposoby. Codex może zbadać frazę w Semurai i sam napisać wpis jako plik Markdown albo MDX. Albo Semurai pisze pełny szkic w swoim edytorze SEO, a Codex przenosi go do repozytorium narzędziem get_content, które zwraca treść jako Markdown.

Czy Codex stworzy grafiki w Semurai?

Tak, przez serwer pełny. Dodaj go obok wpisu semurai poleceniem codex mcp add semurai-full --url https://api.semur.ai/mcp/full i zaloguj się przez codex mcp login semurai-full. CLI, rozszerzenie IDE i aplikacja mają wspólną konfigurację, więc narzędzia do grafiki trafią do wszystkich trzech: obrazy AI zapisywane w bibliotece mediów, projekty w Canvas i Creative Studio oraz teksty ALT, tytuły i tagi dla obrazów z biblioteki. Codex odpowie też na pytania projektanta, poprawi projekt albo wróci do wcześniejszej wersji bez wychodzenia z edytora czy terminala. Serwer pełny wymaga osobnej zgody w Semurai.

Czy wywołania narzędzi Semurai liczą się do limitów użycia?

Tak. Działania, które Codex uruchamia w Semurai, liczą się do limitów użycia workspace dokładnie tak samo jak te same działania w aplikacji Semurai. Czytanie i edycja plików w repozytorium nie angażują Semurai.

W którym workspace Semurai pracuje Codex?

W domyślnym workspace, wybranym przy kliknięciu Zezwól. Poproś Codexa o listę Twoich workspace, a będzie mógł pracować w innym, z Twoją rolą w tamtym workspace.

Połącz Codexa
dwoma poleceniami.

Załóż konto w Semurai, uruchom codex mcp add i codex mcp login, a potem zleć Codexowi pierwsze zadanie SEO.

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