Cursor + Semurai
Skonfiguruj Cursor MCP z Semurai jednym wpisem w mcp.json, a agent Cursora zacznie korzystać z danych o frazach, pozycji, aktualnych wyników wyszukiwania, analizy konkurencji i propozycji SEO dla sklepu, gdy edytujesz wpisy na blogu, dokumentację i strony sklepu. Logowanie OAuth, bez kluczy API.
Cursor MCP · ~/.cursor/mcp.json albo .cursor/mcp.json
Dodaj jeden wpis do mcp.json
{
"mcpServers": {
"semurai": {
"url": "https://api.semur.ai/mcp"
}
}
}Konfiguracja
Jeden wpis w JSON i jedno logowanie. Plik globalny działa w każdym projekcie, plik projektu tylko w danym projekcie.
Otwórz ~/.cursor/mcp.json, żeby korzystać z Semurai we wszystkich projektach, albo utwórz .cursor/mcp.json w projekcie, żeby korzystać z niego tylko tam.
Dodaj wpis semurai z adresem https://api.semur.ai/mcp i zapisz plik.
Gdy Cursor poprosi o logowanie, w przeglądarce otworzy się Semurai. Zaloguj się, wybierz domyślny workspace i kliknij Zezwól.
Pisz do agenta Cursora zwyczajnie. Zanim użyje narzędzia Semurai, poprosi Cię o zgodę.
{
"mcpServers": {
"semurai": {
"url": "https://api.semur.ai/mcp"
}
}
}Warto wiedzieć
Po co łączyć
Agent szybko radzi sobie z Twoimi plikami. Semurai pokazuje mu, jak edytowane strony wypadają w wyszukiwarce.
Pisze wstęp kategorii z ogólnej wiedzy.
Pisze go wokół fraz z prawdziwą liczbą wyszukiwań, trudnością i intencją.
Nie wie, kto rankuje na frazę, w którą celujesz.
Sprawdza domeny w aktualnych wynikach Google i frazy, na które rankują.
Zgaduje, do których stron powinien linkować artykuł.
Korzysta z kotwic i stron docelowych, które Semurai proponuje dla zapisanego artykułu.
Zmienia teksty sklepu tylko w motywie.
Przygotowuje propozycje SEO produktów i kategorii, które zatwierdzasz w Semurai.
Zastosowania
Agent Cursora i tak edytuje Twoje pliki. Z Semurai wie, czego ludzie szukają, kto jest wysoko w wynikach i co mogą mówić strony Twojego sklepu.
Piszesz wpis w Markdownie, a agent sprawdza liczbę wyszukiwań, trudność i intencję każdego nagłówka, który dodajesz.
Agent widzi, które domeny zajmują czołowe miejsca na frazę kategorii, i układa wstęp pod intencję, jaką pokazują te wyniki.
Szablony produktów i kolekcji dostają słowa, których szukają kupujący: frazy z liczbą wyszukiwań i trudnością, wplecione w edytowany tekst.
Gdy Shoper, WooCommerce albo PrestaShop jest połączony z Semurai, agent przygotowuje propozycje SEO produktów i kategorii. Do sklepu trafia tylko to, co zatwierdzisz.
Dla artykułu zapisanego w Semurai agent dostaje kotwicę, stronę docelową i zdanie, w którym ma się znaleźć każdy link, a potem edytuje Twój plik.
Agent sprawdza, kto dziś rankuje na frazę i na jakie frazy rankują te domeny, a potem zapisuje brief w pliku obok Twojego szkicu.
Przykład
Edytujesz stronę sklepu, agent Cursora pyta Semurai, kto jest w wynikach i czego ludzie szukają, a potem pisze wstęp.
Piszę wstęp do content/sklep/kawa-do-espresso.md. Na jakie frazy powinien celować?
Na górze wyników są strony sklepów palarni, więc wstęp kategorii pasuje. Frazy warte uwagi:
| Fraza | Wyszukiwania | Trudność | Intencja |
|---|---|---|---|
| kawa do espresso | 9 900 | 54 | Zakupowa |
| najlepsza kawa do espresso | 2 400 | 41 | Zakupowa |
| ciemno palona kawa do espresso | 720 | 27 | Zakupowa |
| kawa do kawiarki | 480 | 11 | Informacyjna |
Na początek polecam frazę „ciemno palona kawa do espresso”, a pytanie o kawiarkę warto zamknąć w jednym krótkim akapicie. Wpisać to do pliku?
Tak, maksymalnie 150 słów.
Gotowe. Wstęp jest w content/sklep/kawa-do-espresso.md, ma 136 słów, a obie frazy są w pierwszych dwóch zdaniach.
Prompty do wypróbowania
Opcje konfiguracji
Cursor czyta serwery MCP z dwóch plików. Wybierz właściwy, a potem pozwól agentowi korzystać z Semurai, gdy edytujesz.
| ~/.cursor/mcp.json | .cursor/mcp.json | |
|---|---|---|
| Działa w | Wszystkich Twoich projektach | Tylko tym projekcie |
| Sprawdza się przy | Własnej pracy nad SEO i treściami w wielu stronach | Repozytorium strony, w którym każdy ma mieć Semurai |
| W systemie kontroli wersji | Nie, plik leży w Twoim katalogu domowym | Tak, jeśli zacommitujesz folder .cursor |
| Logowanie | Twoje konto Semurai | Każdy loguje się do własnego konta Semurai |
Pisz w czacie agenta, mając otwarty plik. Agent sam decyduje, których narzędzi Semurai użyć, a Cursor domyślnie prosi o Twoją zgodę przed każdym narzędziem MCP.
Reguły projektu w Cursorze leżą w .cursor/rules jako pliki .mdc i dają agentowi stałe instrukcje. Krótka reguła może określić, kiedy sięgać po Semurai.
Cursor czy VS Code?
Oba to edytory kodu z agentem AI i oba łączą się z tym samym serwerem Semurai. Różnią się sposobem dodania serwera.
| Cursor | VS Code | |
|---|---|---|
| Jak dodać Semurai | Wpis w mcp.json | MCP: Add Server w palecie poleceń (Command Palette) |
| Gdzie jest zapisany | ~/.cursor/mcp.json albo .cursor/mcp.json | Copilot Global (~/.copilot/mcp-config.json) albo .vscode/mcp.json |
| Kto używa narzędzi | Agent Cursora | GitHub Copilot w sesjach agenta |
| Logowanie | OAuth w przeglądarce, gdy Cursor poprosi | OAuth w przeglądarce, gdy serwer wystartuje |
Jedno konto Semurai działa w obu. Konfigurację krok po kroku dla VS Code znajdziesz na stronie o VS Code MCP.
Inni asystenci
Ten sam adres serwera i to samo konto Semurai działają w każdym asystencie poniżej.
FAQ
Dodaj wpis do mcp.json: ~/.cursor/mcp.json dla wszystkich projektów albo .cursor/mcp.json dla jednego. Dla Semurai wpis nazywa się semurai i ma url https://api.semur.ai/mcp. Gdy Cursor poprosi, zaloguj się do Semurai w przeglądarce i kliknij Zezwól.
Cursor MCP pozwala agentowi Cursora korzystać z narzędzi serwerów MCP. Z Semurai agent bada frazy, sprawdza, kto rankuje na daną frazę, pisze briefy z danych o konkurencji, proponuje linki wewnętrzne do zapisanych artykułów i przygotowuje propozycje SEO dla sklepu, gdy edytujesz pliki w Cursorze.
Plik globalny w katalogu domowym, jeśli Semurai to Twoje narzędzie do wielu stron. Plik projektu, jeśli repozytorium strony ma mieć Semurai dla każdego, kto je otworzy. Każdy i tak loguje się do własnego konta Semurai.
Przez OAuth, przepływem kodu autoryzacji (authorization code) z PKCE. W przeglądarce otwiera się Semurai, logujesz się, wybierasz domyślny workspace i klikasz Zezwól. Tokeny dostępu są ważne godzinę i odnawiają się automatycznie.
Domyślnie nie. Cursor prosi o zgodę, zanim użyje narzędzia MCP. Semurai oznacza też narzędzia, które zmieniają coś na żywo, więc publikacja albo post w kolejce wyróżniają się na tle sprawdzenia frazy.
Tak, z wyraźnym podziałem. Kod motywu edytujesz w Cursorze, podobnie jak szablony i treści trzymane w repozytorium. Wpisy, które żyją w WordPressie, idą przez Semurai: trafiają tam jako szkice albo są planowane, a poprawki meta i tekstów ALT czekają w zestawie zmian, z którego wybierasz. WordPress musi być połączony z Semurai.
Tak, jeśli dodasz serwer pełny Semurai jako drugi wpis w mcpServers: "semurai-full": { "url": "https://api.semur.ai/mcp/full" }. Cursor poprosi wtedy o logowanie także dla tego wpisu, bo Semurai zatwierdza serwer pełny osobno. Agent wygeneruje obrazy w stylu marki do edytowanych stron i dostanie ich adresy, zaprojektuje grafiki do social mediów i reklamy w Canvas oraz uzupełni teksty ALT obrazów w bibliotece mediów. Przygotuje też projekty w Creative Studio, odpowie na pytania projektanta i poprawi je z poziomu czatu. Każda grafika liczy się do limitów użycia workspace.
Tak. W ustawieniach MCP Cursora włączasz i wyłączasz serwery, więc możesz wyłączyć Semurai i zostawić wpis semurai w mcp.json na później.
Nie. Plik zawiera tylko nazwę i adres serwera. Każdy, kto otworzy projekt, loguje się do Semurai osobno i może odłączyć swoje połączenie w Ustawieniach, w sekcji Asystenci AI (MCP).
Załóż konto w Semurai, dodaj jeden wpis do mcp.json i zapytaj agenta Cursora o swoje strony.
