Reguły AI (AI Rule)

Po integracji z ServBay MCP, narzędzia AI co prawda „mogą” wywoływać ServBay, ale niekoniecznie „wiedzą”, kiedy i jak powinny to robić. Reguły AI (AI Rule) to swego rodzaju instrukcja dla AI — wyjaśnia, że gdy pojawiają się kwestie takie jak lokalne usługi, strony, domeny, HTTPS, porty, bazy danych czy kopie zapasowe, AI powinno w pierwszej kolejności skorzystać z ServBay MCP do sprawdzenia i operacji, zamiast zmieniać kod aplikacji, by obchodzić problemy środowiskowe. W tym dokumencie pokazujemy, jak zainstalować reguły AI.

Jakie problemy rozwiązuje Reguła AI

• Priorytet dla MCP — Gdy pojawiają się problemy lokalnego środowiska, takie jak „strona się nie ładuje / 502 / port zajęty / błąd certyfikatu”, AI najpierw sprawdza status przez ServBay MCP, a nie chaotycznie modyfikuje kod.
• Wyraźne granice bezpieczeństwa — Zapis lub operacje destrukcyjne wymagają najpierw opisu i potwierdzenia, nie wolno w rozmowie podawać czy wklejać kluczy ani innych wrażliwych danych.
• Mniej tłumaczenia i powtarzania — Reguły są stałe, AI w każdej sesji działa według tych samych założeń.

Wymagania wstępne

• ServBay jest zainstalowany i uruchomiony.
• Zalecamy wykonać integrację z ServBay MCP.

Poziom workspace vs globalny

Reguły AI można zainstalować na dwóch poziomach:

• Przestrzeń robocza (Workspace) — Plik reguł zapisany w katalogu projektu, dotyczy tylko tego projektu. Najlepsze do dopasowania pod konkretną realizację.
• Poziom globalny — Plik reguł zapisany w konfiguracji użytkownika narzędzia AI, działa dla wszystkich projektów. Na razie tylko Claude Code i Codex obsługują poziom globalny.

Instalacja reguł AI

Przejdź do ServBay Ustawienia (Settings) → Integracje AI (IDE Integrations) i przy wybranym kliencie kliknij Zainstaluj reguły AI (Install AI Rule); przy instalacji na poziomie workspace wybierz najpierw docelowy katalog projektu. ServBay utworzy lub zaktualizuje odpowiedni plik reguł. Aby cofnąć, kliknij Usuń reguły AI (Remove AI Rule).

Lokalizacja plików reguł – workspace

Klient	Plik reguł (względem katalogu projektu)
VS Code	.github/instructions/servbay-mcp.instructions.md
Cursor	.cursor/rules/servbay-mcp.mdc
Codex	AGENTS.md
Claude Code	CLAUDE.md

Lokalizacja plików reguł – poziom globalny

Klient	Plik reguł
Claude Code	~/.claude/CLAUDE.md (pamięć użytkownika, ładowana przy starcie)
Codex	~/.codex/AGENTS.md (pamięć globalna)

Polityka łączenia: Twoje treści są bezpieczne

ServBay stosuje strategię łączenia z użyciem znaczników dla plików reguł: zawartość zarządzaną przez ServBay otacza specjalnymi komentarzami-znacznikami i aktualizuje wyłącznie obszar pomiędzy nimi, nie ruszając pozostałej zawartości pliku. To oznacza, że bezpiecznie można dodać reguły do istniejącego CLAUDE.md lub AGENTS.md — Twoje dotychczasowe treści nie znikną, a usunięcie reguł oznacza usunięcie wyłącznie fragmentu zarządzanego.

Najczęstsze pytania (FAQ)

• Q: Czy instalacja reguł AI nadpisze moje CLAUDE.md lub AGENTS.md?
  • A: Nie. ServBay uaktualnia tylko fragment wydzielony znacznikami, reszta pliku zostaje bez zmian.
• Q: Dlaczego mój klient nie ma opcji „reguł globalnych”?
  • A: Poziom globalny obsługiwany jest obecnie tylko przez Claude Code i Codex; w innych klientach używaj poziomu workspace.
• Q: Jaki jest związek między Regułami AI a integracją MCP?
  • A: Integracja MCP pozwala AI wywoływać ServBay, a Reguły AI informują, kiedy i jak to robić. Razem działają najskuteczniej.
• Q: Czy pliki reguł w projektach Cursor/VS Code będą trafiać do Git?
  • A: Pliki reguł są w katalogu projektu; czy będą kontrolowane przez Git, zależy od Twojego .gitignore, możesz zdecydować według zasad zespołu.

Podsumowanie

Reguły AI pełnią funkcję „instrukcji obsługi” ServBay MCP. Dzięki nim AI podczas pracy z lokalnym środowiskiem projektowym korzysta z ServBay w sposób priorytetowy, prawidłowy i bezpieczny. Dostępne są instalacje na poziomie workspace i globalnym, a strategia łączenia znaczników chroni Twoją dotychczasową zawartość. Po instalacji Twój AI stanie się rzeczywistym wsparciem dla lokalnego środowiska!