PL
Zacznij za darmo

VS Code + Semurai

VS Code MCP
do SEO z GitHub Copilot.

Skonfiguruj VS Code MCP z Semurai poleceniem MCP: Add Server, zaloguj się raz, a GitHub Copilot zacznie korzystać z Twoich fraz, pozycji, Search Console, sprawdzania stron i audytów w sesjach agenta. Dokumentacja, blog i landing pages dostają dane z wyszukiwarki tam, gdzie je piszesz i przeglądasz. Logowanie OAuth, bez kluczy API.

Zacznij za darmoPoradnik konfiguracji

GitHub Copilot MCP · Copilot Global albo .vscode/mcp.json

Wklej w MCP: Add Server

Adres serwera
https://api.semur.ai/mcp
  • Paleta poleceń (Command Palette) → MCP: Add Server → HTTP
  • ID serwera semurai, zapis w Global
  • Logowanie do Semurai, gdy serwer wystartuje

Konfiguracja

Jak skonfigurować
VS Code MCP z Semurai?

Kreator w VS Code dodaje Semurai dla wszystkich Twoich projektów. GitHub Copilot korzysta z niego potem w sesjach agenta.

  1. Otwórz paletę poleceń (Command Palette) i uruchom MCP: Add Server.

  2. Wybierz HTTP (HTTP or Server-Sent Events) i wklej https://api.semur.ai/mcp.

  3. Nadaj serwerowi ID semurai.

  4. Zapisz go w Global, a potem w Copilot Global (~/.copilot/mcp-config.json), żeby działał we wszystkich projektach.

  5. Gdy serwer wystartuje, w przeglądarce otworzy się Semurai. Zaloguj się, wybierz domyślny workspace i kliknij Zezwól.

  6. Otwórz Copilot Chat w sesji agenta i napisz, czego potrzebujesz. Wymień Semurai w poleceniu albo wybierz jego narzędzia w wyborze narzędzi (tools picker).

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

Wolisz plik?

  • VS Code nadal czyta .vscode/mcp.json dla zgodności, a kreator oznacza to miejsce jako przestarzałe (deprecated). Wpis semurai do tego pliku widzisz tutaj.
  • Ten plik zaczyna się od "servers", a nie od "mcpServers" jak w Cursorze czy Claude Code.
  • W pliku nie ma klucza ani tokenu. Każdy, kto z niego korzysta, loguje się do własnego konta Semurai.

Po co łączyć

Sam Copilot
czy Copilot z Semurai?

Copilot zna Twój kod. Semurai dodaje to, co dzieje się z Twoimi stronami w wyszukiwarce.

  1. Sam GitHub Copilot

    Przegląda zmianę landing page pod kątem kodu, a nie wyszukiwarki.

    GitHub Copilot z Semurai

    Podczas przeglądu porównuje nowy tytuł i nagłówki z liczbą wyszukiwań, trudnością i intencją.

  2. Sam GitHub Copilot

    Pisze informacje o wydaniu i na tym koniec.

    GitHub Copilot z Semurai

    Zamienia je w szkice postów w Semurai, gotowe do dodania do kolejki.

  3. Sam GitHub Copilot

    Nie wie, jak radzi sobie strona dokumentacji.

    GitHub Copilot z Semurai

    Czyta kliknięcia, wyświetlenia i pozycje Twoich stron z Search Console.

  4. Sam GitHub Copilot

    Znajduje błędny kod w jednym pliku.

    GitHub Copilot z Semurai

    Uruchamia pełny audyt strony z oceną 0-100 i zadaniami do poprawy.

Zastosowania

Co Copilot może robić
z Semurai?

Dla zespołów, które trzymają dokumentację, blog i landing pages w repozytorium i przeglądają każdą zmianę w VS Code.

  • Repozytoria dokumentacji i bloga

    Copilot porównuje stronę dokumentacji albo wpis z tym, czego ludzie naprawdę szukają, i proponuje tytuł, nagłówki oraz pytania, na które strona powinna odpowiedzieć.

  • SEO w przeglądzie kodu

    Zanim zatwierdzisz pull request, który zmienia stronę, Copilot porównuje nowy tytuł i nagłówki z danymi o frazach: liczbą wyszukiwań, trudnością i intencją.

  • Z informacji o wydaniu do szkiców postów

    Copilot czyta changelog, a Semurai pisze szkice postów na LinkedIn i Facebooka. Po przejrzeniu dodajesz je do kolejki na połączonych kontach.

  • Dane o frazach do tekstów na landing page

    Hasła w hero i nagłówki wybrane z fraz z prawdziwą liczbą wyszukiwań, trudnością i trendem z 12 miesięcy, żeby tekst trafiał w rosnący popyt.

  • Sprawdzenie wdrożonej strony na żywo

    Copilot sprawdza narzędziem Semurai publiczny adres URL: meta tagi, nagłówki, canonical, robots, czas ładowania i różnice po wyrenderowaniu JavaScriptu, a potem poprawia szablon w Twojej gałęzi.

  • Audyty strony zakończone zadaniami

    Uruchom pełny audyt strony i przeczytaj w czacie ocenę kondycji i najpoważniejsze problemy. Po zakończeniu Semurai tworzy zadania naprawy dla najsłabszych stron.

Przykład

Kontrola SEO
w przeglądzie kodu.

Zmiana landing page w gałęzi, dwa narzędzia Semurai i poprawki, zanim pull request trafi do głównej gałęzi.

  1. Ty:

    Użyj Semurai: przejrzyj zmiany w src/pages/subskrypcja.astro w tej gałęzi. Czy nowy tytuł, H1 i nagłówki H2 celują w frazy, których ludzie szukają?

  2. Narzędzie Semurai: semurai.research_keywords4 frazy z tytułu, H1 i nagłówków H2
  3. Asystent:

    Nowy H1 nie celuje w żadną wyszukiwaną frazę:

    FrazaWyszukiwaniaTrudnośćTrend
    subskrypcja kawy2 90044Rośnie
    kawa w subskrypcji1 30035Bez zmian
    świeżo palona kawa z dostawą26018Rośnie
    nasza obietnica palenia0--

    H1 brzmi „Nasza obietnica palenia”. Proponuję „Subskrypcja kawy palonej na zamówienie”, a obietnicę przenieść do H2. Sprawdzić też stronę na żywo?

  4. Ty:

    Tak, sprawdź.

  5. Narzędzie Semurai: semurai.audit_pagemorrowfield.coffee/subskrypcja/
  6. Asystent:

    Strona na żywo nie ma meta opisu i ma dwa nagłówki H1. W tej gałęzi zmieniony jest H1, dodany opis i poprawione poziomy nagłówków. Gotowe do przejrzenia.

Projekt demo: Morrowfield Coffee Co. (dane przykładowe). Przykład GitHub Copilot, który korzysta z dwóch narzędzi Semurai podczas przeglądu kodu.

Prompty do wypróbowania

Napisz do Copilota
na przykład tak.

  • „Użyj Semurai i porównaj tytuły oraz nagłówki H2 stron zmienionych w tej gałęzi z danymi o frazach.”
  • „Przeczytaj CHANGELOG.md i poproś Semurai o szkic posta na LinkedIn i na Facebooka o najnowszym wydaniu.”
  • „Sprawdź w Semurai stronę https://morrowfield.coffee/subskrypcja/ i wypisz, co ta gałąź powinna poprawić.”
  • „Znajdź frazy z prawdziwą liczbą wyszukiwań do sekcji hero w src/pages/subskrypcja.astro.”
  • „Uruchom audyt strony w Semurai i po zakończeniu podaj trzy najpoważniejsze problemy.”

GitHub Copilot MCP

Semurai w Copilocie,
dla Ciebie i zespołu.

Narzędzia Semurai działają w sesjach agenta GitHub Copilot. Każda osoba w zespole łączy własne konto Semurai.

Pisz w sesji agenta

Otwórz Copilot Chat w sesji agenta. Wymień Semurai w poleceniu, na przykład „Użyj Semurai, żeby…”, albo wybierz jego narzędzia w wyborze narzędzi (tools picker), żeby zdecydować, z których Copilot może korzystać.

  • Wpisz w czacie /semurai.weekly_seo_report, żeby uruchomić jeden z sześciu promptów Semurai, albo /semurai.seo_article, żeby zacząć artykuł.
  • Copilot pracuje w Twoim domyślnym workspace. Poproś o listę workspace, żeby przejść do innego.
  • Narzędzia, które zmieniają coś na żywo, na przykład publikacja w WordPressie, mają w Semurai oznaczenie, a Copilot czeka na Twoją zgodę, zanim któreś uruchomi.

Konfiguracja dla zespołu

Każda osoba dodaje Semurai raz przez MCP: Add Server albo zespół trzyma wpis w .vscode/mcp.json w repozytorium. W obu przypadkach każdy loguje się do własnego konta Semurai.

  • W każdym workspace obowiązuje rola danej osoby: właściciel, administrator albo edytor.
  • Działania liczą się do limitów użycia workspace, tak samo jak w aplikacji.
  • Każdy może odłączyć swoje połączenie z VS Code w Ustawieniach Semurai, w sekcji Asystenci AI (MCP), a dostęp kończy się od razu.

VS Code czy Cursor?

VS Code
czy Cursor?

Wybierz edytor, w którym zespół już pracuje. Oba łączą się z tym samym serwerem Semurai na tym samym koncie.

Dwa edytory, jeden serwer Semurai

VS Code i Cursor z serwerem MCP Semurai
VS Code z GitHub CopilotCursor
KonfiguracjaKreator: MCP: Add ServerWpis JSON w mcp.json
Plik konfiguracji~/.copilot/mcp-config.json (Global) albo .vscode/mcp.json~/.cursor/mcp.json albo .cursor/mcp.json
Klucz najwyższego poziomuserversmcpServers
Gdzie piszeszCopilot Chat, w sesji agentaAgent Cursora

Pracujesz w Cursorze? Wystarczy jeden wpis w mcp.json, opisany na stronie o Cursor MCP.

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

VS Code i Semurai: pytania

Jak dodać serwer MCP w VS Code?

Otwórz paletę poleceń (Command Palette), uruchom MCP: Add Server, wybierz HTTP (HTTP or Server-Sent Events) i wklej adres serwera. Dla Semurai to https://api.semur.ai/mcp z ID semurai. Zapisz go w Global i zaloguj się do Semurai, gdy serwer wystartuje.

Czym jest VS Code MCP i co dodaje Semurai?

VS Code MCP to obsługa serwerów Model Context Protocol w VS Code, z których narzędzi GitHub Copilot korzysta w sesjach agenta. Semurai jest zdalnym serwerem MCP: dodany raz, daje Copilotowi dane o frazach, pozycje, raporty Search Console, sprawdzanie stron, audyty i szkice w Twoim workspace Semurai.

Gdzie VS Code zapisuje serwer Semurai?

Przy opcji Global w Copilot Global, czyli w ~/.copilot/mcp-config.json, poza Twoimi projektami. VS Code nadal czyta .vscode/mcp.json w workspace dla zgodności, a kreator oznacza to miejsce jako przestarzałe.

Jak GitHub Copilot loguje się do Semurai?

Przez OAuth. Gdy serwer wystartuje, w przeglądarce otworzy się Semurai. Logujesz się, wybierasz domyślny workspace i klikasz Zezwól. Do ustawień nie trafia żaden klucz API, a tokeny dostępu są ważne godzinę i odnawiają się automatycznie.

Czy Copilot pyta, zanim użyje narzędzi Semurai?

Semurai oznacza każde narzędzie, które zmienia coś na żywo, na przykład publikację w WordPressie, dodanie posta do kolejki albo wdrożenie propozycji w sklepie. Gdy Copilot ma uruchomić takie narzędzie, zatrzymuje się i najpierw pyta Ciebie. Narzędzia, które tylko czytają dane, jak badanie fraz, są oznaczone jako tylko do odczytu.

Czy Copilot w VS Code stworzy grafiki w Semurai?

Tak, z serwerem pełnym jako drugim serwerem MCP. Uruchom ponownie MCP: Add Server, wybierz HTTP, wklej https://api.semur.ai/mcp/full i nadaj ID semurai-full. Gdy serwer wystartuje, zatwierdź nowe połączenie w Semurai. W sesjach agenta Copilot wygeneruje wtedy obrazy w stylu marki, przygotuje projekty w Canvas i Creative Studio oraz napisze teksty ALT, tytuły i tagi dla obrazów z biblioteki mediów. Copilot odpowie też na pytania projektanta, poprawi projekty i doda gotowe do postów. Grafiki zużywają limity użycia workspace tak samo jak w aplikacji.

Czy zespół może korzystać z tej samej konfiguracji VS Code?

Tak. Każdy dodaje Semurai przez MCP: Add Server albo dzielicie plik .vscode/mcp.json w repozytorium. Nikt nie dzieli się loginem: każda osoba łączy własne konto Semurai i ma taki dostęp, na jaki pozwala jej rola w workspace.

Które prompty Semurai uruchomię w Copilot Chat?

Sześć: seo_article, competitor_gap_report, weekly_seo_report, monthly_content_plan, store_product_seo i social_week. Wpisz w czacie /, potem semurai, kropkę i nazwę promptu, na przykład /semurai.monthly_content_plan.

Czy potrzebuję pliku .vscode/mcp.json?

Nie. Kreator MCP: Add Server zapisuje Semurai za Ciebie. Plik przyda się tylko wtedy, gdy chcesz trzymać konfigurację w repozytorium. Pamiętaj, że jego klucz najwyższego poziomu to servers.

Dodaj Semurai
do VS Code.

Załóż konto w Semurai, uruchom MCP: Add Server i zapytaj Copilota o swoje strony.

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