# Cursor, VS-Code, Claude Code und andere Clients

> Clients that read an MCP config file use a personal access token sent in a request header. Tokens are stored only as hashes and can be rotated or revoked.

Source: https://pageforge.pro/de/docs/cursor-vs-code-claude-code-und-andere-clients/

Cursor, VS-Code mit GitHub Copilot, Claude Code, Codex, Roo-Code und die meisten anderen MCP-Clients lesen ihre Server aus einer Konfigurationsdatei. Sie führen keine OAuth-Anmeldung durch, daher gibt PageForge ihnen stattdessen ein persönliches Zugriffstoken. Der Client sendet das Token bei jedem Aufruf in einem Anforderungsheader.

## Erstellen Sie einen Token

1. Gehen Sie zu **PageForge > Verbindungen** und stellen Sie sicher, dass MCP aktiviert ist.
2. Klicken Sie unter **Andere MCP-Clients (Personal Access Token)** auf **Persönliche Zugriffstoken**.
3. Der Dialog **Persönlicher Zugriff wird geöffnet**-Dialog angezeigt. Klicken Sie auf **Kopieren von Token**. PageForge speichert nur einen Hash davon und kann ihn nicht wieder anzeigen.
4. Under **Client configuration**, pick your client’s tab: **VS Code / GitHub Copilot**, **Cursor**, **Claude Code** or **Generic MCP client**.
5. Klicken Sie auf **Kopieren von Konfiguration** und fügen Sie es in die Konfigurationsdatei dieses Clients ein.
6. Starten Sie den Client neu und fragen Sie: “Show my PageForge Site-Status.”

Der Dialog zeigt auch die **Scopes** des Tokens und **Expires**. Tokens verfallen nicht von alleine, sondern widerrufen Sie einen Token, wenn Sie ihn nicht mehr benötigen.

## Beispielkonfigurationen

Für Cursor, in `.cursor/mcp.json`:

```
{
  "mcpServers": {
    "pageforge": {
      "url": "https://example.com/wp-json/pageforge/v1/mcp",
      "headers": {
        "X-PageForge-MCP-API-Key": "pfmcp_YOUR_TOKEN_HERE"
      }
    }
  }
}
```

Für VS-Code und GitHub-Copilot in `.vscode/mcp.json`:

```
{
  "servers": {
    "pageforge": {
      "type": "http",
      "url": "https://example.com/wp-json/pageforge/v1/mcp",
      "headers": {
        "X-PageForge-MCP-API-Key": "pfmcp_YOUR_TOKEN_HERE"
      }
    }
  }
}
```

Claude Code verwendet `.mcp.json` mit der gleichen `mcpServers`-Form wie Cursor plus `"type": "http"`. Ersetzen Sie URL durch Ihren eigenen Endpunkt und den Platzhalter durch Ihren Token.

## Welcher Header soll verwendet werden?

| Kopfzeile | Format |
| --- | --- |
| `X-PageForge-MCP-API-Key` | Der Token für sich. Dies ist es, was die kopierten Konfigurationen verwenden. |
| `Authorization` | `Bearer` gefolgt von einem Leerzeichen und dem Token |

Senden Sie das eine oder andere, nicht beide. Eine Anfrage mit beiden wird abgelehnt. Setzen Sie niemals ein Token in die URL- oder eine Abfragezeichenfolge ein. PageForge Liest nur Token aus Headern.

## Wie Token geschützt sind

- Jedes Token gehört dem Administrator, der es erstellt hat, und handelt mit den Berechtigungen WordPress dieser Person.
- PageForge speichert einen keyed Hash, sodass der Token nicht aus der Datenbank zurückgelesen werden kann.
- In Free, a token can only read and preview. In Pro, you choose its access under **Access this token may use** before creating it.

## Token verwalten

Jedes Token ist unter **Personal Access Tokens** mit seinem Status aufgeführt: “Credential Active · Never Used”, **In use**, **Widerrufen** oder **gelaufen**.

- **Rotate** Gibt ein neues Token für denselben Client aus. Der Alte hört sofort auf zu arbeiten. Aktualisieren Sie die Konfiguration des Clients mit dem neuen Token.
- **Widerruf** Beendet den Zugriff sofort.

**Wichtig** Eine Konfigurationsdatei mit einem Token ist ein Passwort. Übertragen Sie es nicht in ein freigegebenes Repository. Wenn ein Laptop mit einem Token verloren geht, widerrufen Sie diesen Token.

Weiter: [Scopes, Berechtigungen und Sicherheit](https://pageforge.pro/docs/mcp-security/) und [AI-Assistent kann keine Verbindung](https://pageforge.pro/docs/mcp-connection-issues/) verbinden.
