SmartMCP — instrukcja obsługi
Instrukcja obsługi

SmartMCP — połącz Claude lub ChatGPT ze swoją stroną WordPress

Ta instrukcja zakłada, że nie musisz znać się na programowaniu. Każdy krok da się wykonać samymi kliknięciami — miejsca, w których łatwo o pomyłkę, są wyraźnie oznaczone.

Wersja wtyczki Standard 3.0.0 + PRO 2.0.0 (opcjonalny dodatek) Czas instalacji ok. 10 minut Poziom trudności podstawowy
§

Czym jest SmartMCP

SmartMCP to wtyczka, która otwiera Twoją stronę WordPress na agenta AI — Claude albo ChatGPT. Po podłączeniu możesz po prostu opisać słowami, co ma się zmienić na stronie ("dodaj podstronę Kontakt", "zmień kolor przycisku na zielony"), a agent robi to bezpośrednio w Elementorze, tak jakbyś sam/sama klikał/a w edytorze. Rozmowa toczy się w Claude lub ChatGPT — nie w samym WordPressie.

SmartMCP to dwie osobne wtyczki: SmartMCP (Standard — wymagana zawsze) i SmartMCP PRO (dodatek — instalujesz go tylko, jeśli kupiłeś/aś plan PRO). Ty cały czas decydujesz, na co agent ma dostęp — nic nie dzieje się bez Twojej zgody.

§

Czego potrzebujesz, zanim zaczniesz

WordPress
wersja 6.0 lub nowsza
PHP
wersja 7.4 lub nowsza (typowy standard u każdego hostingu)
Elementor
wersja darmowa lub Pro — do pełnej obsługi budowania stron
HTTPS
strona musi działać na bezpiecznym adresie (kłódka w przeglądarce)
Konto AI
Claude (Anthropic) lub ChatGPT/Codex (OpenAI), z możliwością dodania własnego konektora/serwera MCP
01

Wgraj i aktywuj wtyczkę (Standard, opcjonalnie PRO)

W paczce znajdziesz jeden lub dwa pliki ZIP, zależnie od kupionego planu: smartmcp-STANDARD-v3.0.0.zip zawsze, a przy planie PRO dodatkowo smartmcp-PRO-v2.0.0.zip. PRO to osobny dodatek i wymaga aktywnej wtyczki Standard.

  1. W panelu WordPress przejdź do Wtyczki → Dodaj nową → Wgraj wtyczkę.
  2. Wybierz plik smartmcp-STANDARD-v3.0.0.zip i kliknij Zainstaluj teraz, a po komunikacie „Plugin installed successfully" kliknij Aktywuj wtyczkę.
  3. Jeśli masz plan PRO: wróć do Wtyczki → Dodaj nową → Wgraj wtyczkę, wybierz smartmcp-PRO-v2.0.0.zip, zainstaluj i aktywuj dokładnie tak samo. Po aktywacji w zakładce Narzędzia automatycznie pojawi się osobna kolumna PRO.
twojastrona.pl/wp-admin/plugin-install.php?tab=upload
Installing plugin from uploaded file: smartmcp.zip
Unpacking the package…
Installing the plugin…
✓ Plugin installed successfully.

Tak wygląda poprawne zakończenie instalacji.

Ważne — jeśli zobaczysz „Plik wtyczki nie istnieje"

To nie błąd samej wtyczki — zwykle oznacza to, że plik ZIP został gdzieś po drodze przepakowany (np. przez program pocztowy albo chmurę) i stracił poprawną strukturę. Pobierz plik jeszcze raz z oryginalnego źródła i spróbuj ponownie, bez otwierania/rozpakowywania go po drodze.

02

Skopiuj dane połączenia

Wejdź w SmartMCP → Połączenie. Zobaczysz zakładki dla różnych klientów AI: ChatGPT/Codex, Claude Code, Claude Desktop i Inny klient (JSON). Wybierz tę, której faktycznie używasz — pola poniżej dopasują się automatycznie.

twojastrona.pl/wp-admin/admin.php?page=smartmcp&tab=polaczenie
Połączenie
OAuth
Narzędzia
Dziennik aktywności

Konfiguracja po stronie agenta

ChatGPT / Codex Claude Code Claude Desktop
Adres URLtwojastrona.pl/wp-json/smartmcp/v1/mcp
Token okazicielasmcp_••••••••••••••
Wygeneruj nowy kluczKopiuj

Zakładka SmartMCP → Połączenie — stąd kopiujesz gotowe dane.

  1. Kliknij Wygeneruj nowy klucz (unieważni poprzedni) — klucz pokaże się tylko ten jeden raz, więc od razu go skopiuj.
  2. W wybranej zakładce klienta skopiuj przyciskiem Kopiuj adres URL oraz klucz/token.
Traktuj klucz jak hasło do panelu admina

Kto ma ten klucz, ma pełny dostęp do wszystkich włączonych narzędzi SmartMCP na Twojej stronie. Nie wklejaj go nigdzie poza ustawieniami swojego klienta AI. Jeśli podejrzewasz wyciek — wróć tu i kliknij „Wygeneruj nowy klucz", stary od razu przestanie działać.

03

Podłącz Claude lub ChatGPT

W ChatGPT / Codex: w ustawieniach konektorów wybierz „Połącz z niestandardowym MCP", ustaw typ na Streamable HTTP i wklej adres URL oraz token z Kroku 02.

W Claude Desktop: otwórz ustawienia (Ctrl + ,), w bocznym menu kliknij Connectors, potem Add → Add custom connector.

Claude Desktop — Add custom connector
NameSmartMCP
Remote MCP server URLtwojastrona.pl/wp-json/smartmcp/v1/mcp
Cancel Add
  1. W polu Remote MCP server URL (albo „Adres URL" w ChatGPT) wklej adres skopiowany w Kroku 02.
  2. Jeśli klient prosi o nagłówek/token uwierzytelniający — wklej tam skopiowany klucz jako Authorization: Bearer TWÓJ_KLUCZ (dokładny sposób wpisania różni się między klientami — trzymaj się instrukcji widocznej w danej zakładce panelu SmartMCP).
  3. Kliknij Add / Connect (albo odpowiednik w Twoim kliencie).
Skąd wiesz, że się udało

Klient AI pokaże SmartMCP jako połączony/aktywny konektor, a w rozmowie od razu zobaczysz dostępne narzędzia SmartMCP. Jeśli coś nie działa — sprawdź sekcję „Rozwiązywanie problemów" niżej.

04

Pierwsza rozmowa z agentem

Po podłączeniu po prostu piszesz w oknie czatu Claude lub ChatGPT, czego potrzebujesz — tak jak do kolegi z zespołu. Kilka przykładów na start:

  • Pokaż listę stron na mojej stronie
  • Utwórz nową stronę „Kontakt" jako szkic
  • Jaki motyw i kolory ma teraz moja strona?
Zacznij od szkiców, nie publikacji

Poproś agenta, żeby nowe strony tworzył jako „szkic" (draft) — obejrzysz efekt w spokoju i sam/a zdecydujesz, kiedy opublikować.

§

Metoda alternatywna — logowanie przez OAuth (tylko Claude)

Jeśli wolisz nie kopiować klucza ręcznie, Claude obsługuje też logowanie przez OAuth: logujesz się jak zwykle na swojej stronie i klikasz „Zezwól" — Claude sam wymienia to na bezpieczny token w tle.

  1. Wejdź w SmartMCP → OAuth i kliknij Wygeneruj dane OAuth.
  2. Skopiuj Client ID i Client Secret do bezpiecznego miejsca — Secret pokaże się tylko ten jeden raz.
  3. W oknie „Add custom connector" Claude wklej te dane w sekcji Advanced settings, zamiast tokenu z Kroku 02.
  4. Kliknij Connect — otworzy się przeglądarka z ekranem zgody. Kliknij Zezwól.
Ważne — wymagane „ładne" bezpośrednie odnośniki

OAuth wymaga, żeby w Ustawienia → Bezpośrednie odnośniki była wybrana dowolna opcja inna niż „Zwykłe". Jeśli nie jest, zakładka OAuth pokaże Ci czerwone ostrzeżenie z linkiem prosto do tych ustawień — wystarczy tam kliknąć „Zapisz zmiany", nawet nic nie zmieniając.

Wtyczka sama Cię ostrzeże, jeśli hosting robi problemy

Niektóre firmy hostingowe blokują techniczny adres potrzebny do logowania (dotyczy automatycznego odnawiania darmowych certyfikatów SSL). Jeśli tak jest u Ciebie, zakładka OAuth pokaże czerwoną kartę z gotową, wypełnioną wiadomością do skopiowania i wysłania do supportu hostingu — nie musisz nic pisać samodzielnie.

§

Panel „Narzędzia" — co agent może robić

W zakładce SmartMCP → Narzędzia funkcje są rozdzielone na osobne kolumny. Sam Standard udostępnia 21 narzędzi MCP. Po aktywowaniu dodatku PRO katalog rozszerza się do 39 narzędzi, a klient dokładnie widzi, które funkcje należą do Standardu, a które do PRO.

Standard zawiera teraz fasadę smartmcp_content_authoring z 35 operacjami dla wpisów, stron, komentarzy, mediów, kategorii, tagów, wzorców i wyszukiwania oraz smartmcp_site_editor_context do odczytu motywu, ustawień theme.json i dostępnych bloków. PRO dodaje m.in. smartmcp_site_management do ustawień witryny, statystyk, wtyczek, dziennika i motywów.

Każdy zapis wymaga potwierdzenia

Tworzenie, aktualizacja i usuwanie przez nowe fasady wymaga jawnej zgody użytkownika. Trwałe usuwanie kategorii lub tagów wymaga dodatkowego potwierdzenia operacji nieodwracalnej.

§

Dziennik aktywności

Zakładka SmartMCP → Dziennik aktywności pokazuje ostatnie 500 czynności agenta — co zrobił, kiedy i czy się udało. Warto tam zajrzeć od czasu do czasu, szczególnie na początku, żeby zobaczyć, jak agent faktycznie korzysta z dostępu.

§

Rozwiązywanie problemów

„Connection issue" w Claude (metoda OAuth)
Najczęściej hosting blokuje adres logowania — sprawdź czerwoną kartę w zakładce SmartMCP → OAuth, tam znajdziesz gotową wiadomość do supportu.
Narzędzie „niedostępne w tym środowisku" (ChatGPT/Codex)
To nie błąd wtyczki — środowisko Twojego klienta AI (np. sandbox Codex) nie ma jeszcze dodanego połączenia albo dostępu do internetu. Sprawdź ustawienia sieciowe/konektory danego środowiska, nie ustawienia SmartMCP.
Widzę 21 zamiast 39 narzędzi
Działa tylko Standard. Sprawdź w Wtyczki → Zainstalowane wtyczki, czy SmartMCP PRO 2.0.0 jest zainstalowany i aktywny.
Nie widzę domen, DNS lub planów WordPress.com
Te funkcje należą do infrastruktury konta WordPress.com i wymagają osobnej integracji z API WordPress.com/Jetpack. Nie są lokalnymi funkcjami samodzielnej instalacji WordPress.
„Plik wtyczki nie istnieje"
Pobierz plik ZIP jeszcze raz, bez otwierania go po drodze — patrz Krok 01.
Ostrzeżenie o odnośnikach
Ustawienia → Bezpośrednie odnośniki → dowolna opcja poza „Zwykłe" → Zapisz zmiany.
Agent widzi „stary" wygląd strony
Poproś go, żeby najpierw wywołał sprawdzenie kontekstu strony — sam odświeży swoją wiedzę o aktualnym stanie.
§

Bezpieczeństwo w skrócie

  • Każde połączenie można pojedynczo odwołać w zakładce OAuth — dostęp znika natychmiast.
  • Nie ma możliwości wykonania dowolnego kodu — wszystko idzie przez standardowe, bezpieczne mechanizmy WordPressa.
  • Instalacja wtyczek (jeśli włączona) możliwa tylko z oficjalnego repozytorium WordPress.org.
  • Nowe operacje zapisu są blokowane, dopóki agent nie przekaże potwierdzenia użytkownika.
  • Traktuj Client Secret i klucz API jak hasło — nie wklejaj ich nigdzie poza panelem Claude.

SmartMCP — SmartExcel.pl / IT STUDIO Sebastian Godziszewski · kontakt@smartexcel.pl