Připojení MCP klienta

Co potřebujete

• Počítač, na kterém běží AI klient, s PHP 8.3 nebo novějším a rozšířením phar. Ověříte příkazy php -v a php -m. Composer není potřeba.
• Soubor wbengine-mcp.phar a jeho soubor s kontrolním součtem wbengine-mcp.phar.sha256 z vydání WBengine.
• Klíč pro asistenta ze stránky Integrace webu s vhodnou předvolbou (viz MCP server). Stránka ukáže konfiguraci jednou a klíč už je v ní.

Server potřebuje tři nastavení, která klient předává jako proměnné prostředí: WBENGINE_MCP_URL (adresa webu s https), WBENGINE_MCP_KEY (klíč) a WBENGINE_MCP_MODE (full, nebo draft, který na tomto počítači skryje nástroje pro zveřejňování).

Stažení a kontrola souboru

Uložte oba soubory do jedné složky, kterou nesmažete, například ~/wbengine/ na Linuxu a macOS nebo C:\Users\vy\wbengine\ ve Windows. Soubor zkontrolujte proti kontrolnímu součtu:

• Linux: sha256sum -c wbengine-mcp.phar.sha256
• macOS: shasum -a 256 -c wbengine-mcp.phar.sha256
• Windows (PowerShell): Get-FileHash wbengine-mcp.phar -Algorithm SHA256 a hodnotu porovnejte s obsahem souboru wbengine-mcp.phar.sha256

Soubor, jehož součet se liší, nepoužívejte.

Přidání serveru do klienta

Claude Code. Stránka Integrace ukáže tento příkaz s vaším klíčem. Cestu nahraďte úplnou cestou k souboru:

claude mcp add --env 'WBENGINE_MCP_URL=https://www.example.org' --env 'WBENGINE_MCP_KEY=wbv2_...' --env 'WBENGINE_MCP_MODE=full' --transport stdio wbengine-www -- php /path/to/wbengine-mcp.phar

Claude Desktop a další klienti, které čtou sekci mcpServers konfiguračního souboru:

{
  "mcpServers": {
    "wbengine-www": {
      "command": "php",
      "args": ["/path/to/wbengine-mcp.phar"],
      "env": {
        "WBENGINE_MCP_URL": "https://www.example.org",
        "WBENGINE_MCP_KEY": "wbv2_...",
        "WBENGINE_MCP_MODE": "full"
      }
    }
  }
}

Pokud klient nenajde php (program spuštěný z nabídky nebo z docku často nevidí PATH vašeho shellu), uveďte do command úplnou cestu k programu PHP, například /opt/homebrew/bin/php nebo C:\\php\\php.exe.

Linux

Použijte příkazy výše s cestou jako /home/vy/wbengine/wbengine-mcp.phar. Pokud php -v ukazuje starší verzi než 8.3, nainstalujte PHP správcem balíčků.

macOS

Použijte cestu jako /Users/vy/wbengine/wbengine-mcp.phar. PHP je k dispozici z Homebrew (brew install php). Claude Desktop čte konfiguraci z ~/Library/Application Support/Claude/claude_desktop_config.json; to umístění je z dokumentace klienta a nezkoušeli jsme ho.

Windows

Doporučený postup je WSL2. Nainstalujte do WSL2 distribuci Linuxu, spusťte AI klienta i server uvnitř ní a postupujte podle kroků pro Linux. Server i klient pak běží ve stejném linuxovém prostředí jako na každém počítači s Linuxem.

Pokud klienta spouštíte přímo ve Windows, nainstalujte PHP pro Windows (v php.ini musí být zapnuté rozšíření phar) a použijte cestu s písmenem disku. V souboru JSON se každé zpětné lomítko píše dvakrát:

"args": ["C:\\Users\\vy\\wbengine\\wbengine-mcp.phar"]

V PowerShellu příkaz claude mcp add funguje s jednoduchými uvozovkami, jak je uvedeno. V cmd.exe použijte místo nich dvojité. Claude Desktop čte %APPDATA%\Claude\claude_desktop_config.json; to umístění je z dokumentace klienta a nezkoušeli jsme ho.

Ověření, že to funguje

Restartujte klienta nebo server znovu připojte (v Claude Code /mcp reconnect a název serveru). Požádejte asistenta, ať zavolá site_info. Vypíše jazyky webu a co smí klíč. Pokud chybí nástroj pro zveřejňování, klíč nebo režim ho nedovoluje.

Co bylo ověřeno

Na Linuxu, macOS a ve Windows byl server spuštěn tak, jak ho spouští klient, odpověděl na první požadavky, zůstal běžet, když byl klient přes minutu zticha, a čistě skončil, když ho klient zavřel. Plná relace Claude Code proběhla na macOS. Relace jiných klientů a Claude Code na Linuxu a ve Windows neproběhly.

Když se nespustí

Zpráva nebo příznak	Náprava
klient hlásí, že server selhal nebo se hned odpojil	spusťte stejný příkaz v terminálu: php /path/to/wbengine-mcp.phar. Zpráva pojmenuje chybějící nastavení, nebo soubor nebyl nalezen.
php se nenajde	uveďte do command úplnou cestu k PHP
cesta stále zní /path/to/wbengine-mcp.phar	nahraďte ji skutečnou cestou k souboru
klíč, který fungoval, přestal	byl odvolán, nebo ho web omezuje na jiné adresy
server potřebuje novější PHP	nainstalujte PHP 8.3 nebo novější s rozšířením phar

Server aktualizujete výměnou souboru podle stránky MCP server a opětovným připojením klienta.