# Narzędzia i bezpieczeństwo

> Lista narzędzi MCP ProseCaptain dla WordPressa oraz zasady: role, potwierdzenia na produkcji, dziennik zmian, odłączanie.

## Narzędzia

Narzędzia WordPressa przyjmują `site`, czyli nazwę strony z `list_sites`. Grafiki nie wymagają strony.

| Narzędzie | Co robi | Zapis |
|---|---|---|
| `list_sites` | Strony połączone z Twoim workspace'em. | |
| `site_info` | Nazwa, wtyczki, typy treści i taksonomie strony. | |
| `list_content`, `get_content` | Lista i treść stron, wpisów i własnych typów. | |
| `create_content`, `update_content` | Nowa treść (zawsze szkic, chyba że poprosisz o publikację) i poprawki. Rewizje WordPressa zostają. | tak |
| `list_blocks`, `get_block_schema`, `list_patterns` | Dostępne bloki, ich pola i wzorce. | |
| `list_menus`, `get_menu`, `set_menu` | Menu i miejsca menu w motywie (np. nagłówek). | tak |
| `list_widgets`, `set_widget` | Obszary widżetów (stopka, paski boczne) i widżety w nich. | tak |
| `get_template_parts`, `set_template_part` | Nagłówek i stopka w motywach blokowych. | tak |
| `list_terms`, `ensure_terms` | Kategorie, tagi i własne taksonomie. | tak |
| `upload_media` | Obraz z adresu URL do biblioteki mediów. | tak |
| `list_image_templates` | Szablony grafik Twojego workspace'u w Paqshot: własne, styl marki z Reislo (`reislo:<marka>`), wspólne i wbudowane (infografiki, `auto`). | |
| `generate_image` | Grafika z szablonu marki: obrazek wyróżniający, grafika do social mediów, ilustracja. Krótki opis sceny, proporcje (`16:9`, `1:1`, `4:5`, `9:16` i inne), rozmiar `1K`–`4K`, opcjonalnie zdjęcie produktu z adresu URL. Z `site` trafia od razu do biblioteki mediów z tekstem alternatywnym. **Zużywa 1 kredyt na grafikę**; przy braku kredytów nic nie powstaje. | tak, gdy z `site` |
| `get_seo`, `set_seo` | Tytuł, opis i kanoniczny adres w Rank Math. | tak |
| `search_replace` | Wyszukaj i zamień w treściach. Domyślnie tylko pokazuje wyniki. | tak |

## Zasady

- **Rola ProseCaptain AI.** AI pracuje jako osobny użytkownik z rolą Redaktor poszerzoną o menu i widżety. Nie instaluje wtyczek ani motywów, nie zmienia użytkowników ani ustawień witryny. Konta administratora nie łączymy.
- **Produkcja pod kontrolą.** Każdy zapis na stronie produkcyjnej wymaga potwierdzenia nazwą strony. Na stronie testowej zmiany wchodzą od razu.
- **Nic nie znika.** Nowe treści są szkicami. Narzędzia nie usuwają treści ani mediów. Widżet „usunięty” trafia do nieaktywnych, skąd WordPress pozwala go przywrócić.
- **Dziennik.** Każdy zapis i każde połączenie trafiają do dziennika w aplikacji (**Ustawienia** → **Narzędzia AI**): kiedy, która strona, które narzędzie, wynik. Bez treści i bez haseł.
- **Twoje strony, tylko Twoje.** Token działa wyłącznie na stronach workspace'u, który go wydał.

## Dane i hasła

- Hasło aplikacji użytkownika `prosecaptain-ai` przechowujemy zaszyfrowane (AES-256-GCM). Nie wyświetlamy go nigdzie i nie zapisujemy w logach.
- Tokeny MCP zapisujemy tylko jako skrót SHA-256. Sam token widzisz raz, przy tworzeniu.
- Wtyczka ma osobny token dla każdej strony. Odłączenie jednej strony nie wpływa na pozostałe.
- Akceptację warunków pracy AI zapisujemy przy połączeniu strony i przy wydaniu tokenu: wersja, czas i kto zaakceptował.

## Odłączanie

- **Jedna strona:** we wtyczce **Disconnect from AI** albo w aplikacji **Odłącz** przy stronie. Hasło aplikacji jest usuwane także w WordPressie.
- **Jedna osoba albo narzędzie:** w aplikacji **Odbierz** przy tokenie. Działa od razu.
- **Awaryjnie, bez ProseCaptain:** w WordPressie **Użytkownicy** → `prosecaptain-ai` → **Hasła aplikacji** → **Unieważnij**.