# Csatlakozás az MCP-kiszolgálóhoz

> Az MCP bekapcsolása, alkalmazásjelszó létrehozása és az AI-kliens (Claude Desktop, Cursor, Claude Code, VS Code) beállítása.

Az AI-asszisztens csatlakoztatásához három dolgot kell elvégezned: bekapcsolod az MCP-t a WordPressben, alkalmazásjelszót hozol létre, és beállítod az AI-klienst.

## Előfeltétel

WordPress 6.9 vagy újabb, telepített és aktív Gravity Forms.

## Az MCP bekapcsolása

1. Nyisd meg: **Űrlapok → Beállítások → MCP**.
2. Kapcsold be az **MCP-integráció** kapcsolóját.
3. Kattints a **Beállítások mentése** gombra.

![Az MCP beállítóoldala kikapcsolt állapotban](./kepek/mcp-beallitasok-ki.webp)

*Az MCP beállítóoldala kikapcsolt állapotban* (https://minta-bolt.hu/wp-admin/admin.php?page=gf_settings&subview=mcp)

Kikapcsolt állapotban csak a főkapcsoló látszik. Figyelj rá, hogy a további beállítások csak a bekapcsolás és a mentés után jelennek meg.

![Az MCP beállítóoldala bekapcsolva](./kepek/mcp-beallitasok-be.webp)

*Az MCP beállítóoldala bekapcsolva* (https://minta-bolt.hu/wp-admin/admin.php?page=gf_settings&subview=mcp)

Bekapcsolva megjelenik az eszközök listája, a **Végpont módja** és az **Ügynökkészségek** rész. Ezeket az [MCP-beállítások](https://hub.hellowp.io/hu/plugins/gravityforms/mcp-beallitasok/) fejezet írja le.

## Alkalmazásjelszó létrehozása

1. A WordPressben nyisd meg a **Felhasználók → Profil** oldalt, és keresd meg az **Alkalmazásjelszavak** részt.
2. Írj be egy felismerhető nevet (például „Claude MCP” vagy „Cursor MCP”).
3. Kattints az új alkalmazásjelszó hozzáadására.
4. Másold ki a létrehozott jelszót. Csak egyszer látod, ezért tárold biztonságos helyen.

A felhasználónevet és ezt a jelszót fogod megadni az AI-kliensben.

Az alkalmazásjelszót külön felhasználói fiókból generáld, amelynek csak azok a jogosultságai vannak, amelyekre az MCP-kiszolgálónak szüksége van. Lásd: [Felhasználó létrehozása az MCP-hozzáféréshez](https://hub.hellowp.io/hu/plugins/gravityforms/mcp-felhasznalo/).

## Claude Desktop beállítása

1. Töltsd le és telepítsd a Claude Desktopot.
2. Nyisd meg a **Settings → Developer** részt.
3. A „Local MCP servers” mellett kattints az **Edit Config** gombra.
4. Add hozzá a következő beállítást. A „yoursite.com”, „your-username” és „your-api-password” helyére a saját adataidat írd:

```json
{
    "mcpServers": {
        "gravityforms": {
            "command": "npx",
            "args": [
                "-y",
                "@automattic/mcp-wordpress-remote"
            ],
            "env": {
                "WP_API_URL": "https://yoursite.com/wp-json/mcp/gravityforms",
                "WP_API_USERNAME": "your-username",
                "WP_API_PASSWORD": "your-api-password",
                "OAUTH_ENABLED": "false"
            }
        }
    }
}
```

5. Mentsd a fájlt.
6. Lépj ki a Claude Desktopból, és indítsd újra.

## Más AI-kliensek

A legtöbb MCP-kompatibilis kliens JSON-beállítófájlt használ. Ugyanezt a formátumot használd, csak a fájl helye más:

| Kliens | A beállítás helye |
|---|---|
| Cursor | `~/.cursor/mcp.json` vagy projektenként `.cursor/mcp.json` |
| Claude Code | `.mcp.json` a projektmappában, vagy globálisan `~/.claude/mcp.json` |
| VS Code | `.vscode/mcp.json` a projekt munkaterületén |
| ChatGPT Business | Felhőalapú kliens, külön végpontot és hitelesítést igényel: [ChatGPT Business csatlakoztatása](https://hub.hellowp.io/hu/plugins/gravityforms/mcp-chatgpt/) |
| Egyéb kliens | A kliens MCP-beállítási leírása szerint |

Mindenhol a saját webhelyed URL-jét, a felhasználónevet és az alkalmazásjelszót írd be.

## A kapcsolat tesztelése

1. Indíts új beszélgetést az AI-asszisztenssel, és kérd meg, hogy sorolja fel az elérhető eszközöket.
2. Próbálj ki egy csak olvasási műveletet, például:
   - „Listázd az összes űrlapomat.”
   - „Hány beküldése van az 1. űrlapnak?”
   - „Add meg a 2. űrlap részleteit.”

Ha az asszisztens a webhelyed adataival válaszol, a kapcsolat működik. Az eszközök csak akkor láthatók, ha az **MCP-beállítások** oldalon be vannak kapcsolva.

## Hibaelhárítás

| Tünet | Valószínű ok | Megoldás |
|---|---|---|
| 401 / a hitelesítés sikertelen | Hibás vagy hiányzó alkalmazásjelszó vagy felhasználónév | Hozz létre új alkalmazásjelszót, és ellenőrizd a `WP_API_USERNAME` és `WP_API_PASSWORD` értékét a beállításban |
| Az eszköz nincs a listán / „unknown tool” | Az eszköz le van tiltva az MCP-beállításokban, vagy a főkapcsoló ki van kapcsolva | Az **Űrlapok → Beállítások → MCP** oldalon kapcsold be a főkapcsolót és a kívánt eszközt |
| „Permission denied” egy eszköz futtatásakor | A WordPress-felhasználónak nincs meg a szükséges jogosultsága | Olyan felhasználót vagy szerepkört használj, amelynek megvan az eszközhöz tartozó Gravity Forms-jogosultsága |
| Az MCP-beállítások „nem elérhető” üzenetet mutatnak | A WordPress régebbi, mint 6.9 | Frissítsd a WordPresst 6.9-es vagy újabb verzióra |
| A beállítófájl nem menthető | Érvénytelen JSON | Ellenőrizd a vesszőket, idézőjeleket és zárójeleket JSON-ellenőrzővel |
| A kliens nem ismeri fel az MCP-kiszolgálót | A fájl nincs elmentve, vagy a kliens nem indult újra | Mentsd a fájlt, és teljesen indítsd újra a klienst (nem elég az ablakot bezárni) |
| „No actions are available for this app.” (ChatGPT) | A ChatGPT WordPress Basic hitelesítés nélkül kérdezte le az eszközöket, vagy csak az alkalmazásjelszót küldte | Az Access token mezőbe `felhasználónév:alkalmazásjelszó` kerüljön, Basic sémával, majd frissíts. Ne emeld a felhasználót rendszergazdává |
| A piszkozat létrejön, de az engedélyezés bejelentkezés nélkül a közzétételi ellenőrzésre ugrik (ChatGPT) | A ChatGPT az engedélyezéskor nem kér WordPress-hitelesítő adatokat | Az adatokat az eszközök beolvasása előtt, a létrehozó űrlapon kell megadni |
| A ChatGPT nem éri el a kiszolgálót | Felhőalapú kliens privát URL-t hív | Nyilvános HTTPS-címet használj. A localhost és a helyi hálózati címek nem működnek |
| A Claude Desktop JSON/npx beállítását használtad ChatGPT-ben | Rossz klienstípus | A ChatGPT-t közvetlenül a `/wp-json/mcp/gravityforms` címre irányítsd, és ne használd az `@automattic/mcp-wordpress-remote` csomagot |
| A ChatGPT-ben OAuth van kiválasztva, és a kapcsolat sosem listáz eszközt | A Gravity Forms MCP-je nem támogatja az OAuth-ot | Access token / API key és Basic séma, vagy helyi stdio kliens |
| Néhány bejelölt eszköz hiányzik a ChatGPT műveleteiből | A felhasználónak nincs meg az adott eszköz jogosultsága | Lásd a [jogosultságtérképet](https://hub.hellowp.io/hu/plugins/gravityforms/mcp-felhasznalo/). A **Bejegyzések számlálása** és a **Bejegyzés jegyzeteinek listázása** a bejegyzések megtekintésének és a jegyzetek jogosultságát igényli, az űrlapeszközökhöz `gravityforms_edit_forms` kell |
| Az alkalmazás létezik, de a ChatGPT nem hívja | Az alkalmazás nincs engedélyezve a beszélgetésben | Kapcsold be a fejlesztői módot a csevegésben, és válaszd ki az alkalmazást |