# Claude Code und Cursor verbinden

> Wie du den MCP-Server von Memberfy in Claude Code (per Befehl oder .mcp.json) und in Cursor (per mcp.json) hinzufügst, im Browser autorisierst und die Verbindung prüfst. Für alle, die im Terminal oder im Editor arbeiten.

Claude Code und Cursor sprechen MCP über HTTP, wie Claude und ChatGPT: Es reicht, auf **`https://api.memberfy.net/mcp`** zu zeigen. Beim ersten Aufruf öffnen sie den Browser, damit du mit deinem Memberfy-Konto autorisierst. Es gibt keinen Schlüssel zum Kopieren und kein Secret, das im Projekt liegen müsste.

> [!TIP]
> Die Adresse und diese Schritte stehen auch in Memberfy selbst. Unter **Mein Konto › KI-Assistenten** (`/account?tab=assistants`) oder unter **Einstellungen › KI-Assistenten** (Eigentümer und Administrator) zeigt der Block **Einen Assistenten verbinden** die **Adresse des MCP-Servers** mit dem Button **Kopieren** und die Schritte für jeden Assistenten: **Claude**, **ChatGPT** und **Claude Code / Cursor** (mit dem Befehl und dem Dateiausschnitt unter **Ausschnitt kopieren**).

## Claude Code

### Per Befehl

Im Terminal, im Projektordner:

```bash
claude mcp add --transport http memberfy https://api.memberfy.net/mcp
```

Damit es für alle deine Projekte gilt und nicht nur für dieses, ergänze `--scope user`.

### Per Datei

Oder lege die `.mcp.json` im Projektstamm an (oder bearbeite sie):

```json
{
  "mcpServers": {
    "memberfy": {
      "type": "http",
      "url": "https://api.memberfy.net/mcp"
    }
  }
}
```

Die `.mcp.json` darf ins Repository: Sie enthält kein Geheimnis. Jede Person im Team autorisiert mit dem eigenen Konto und der eigenen Rolle.

### Autorisieren

1. Öffne Claude Code und gib `/mcp` ein.
2. Wähle **memberfy** und die Option zum Authentifizieren.
3. Der Browser öffnet den Memberfy-Bildschirm. Melde dich an, wähle die **Community** und klicke auf **Erlauben**.
4. Zurück im Terminal erscheint der Server als verbunden, mit den Tools.
5. Teste: *„nutze memberfy und sag mir, mit welcher Community du verbunden bist"*.

### Fertige Rezepte

In Claude Code werden die acht Rezepte von Memberfy zu Befehlen: Tippe `/` und wähle zum Beispiel `/mcp__memberfy__monthly_report` (den Monatsbericht) oder `/mcp__memberfy__create_course`. Die Liste, und wer welches sieht, steht unter [Fertige Rezepte im Menü](/mcp/conectar-o-claude#fertige-rezepte-im-menu). Eine Sitzung, die vor dem 6. Oktober 2026 geöffnet wurde, kann noch die alten Tool-Namen zeigen: Öffne eine neue Sitzung.

## Cursor

1. Öffne **Cursor Settings › MCP** und füge einen Server hinzu, oder bearbeite die Datei direkt:
   - `~/.cursor/mcp.json` für alle Projekte;
   - `.cursor/mcp.json` im Projektordner, nur für dieses Projekt.
2. Füge ein:

```json
{
  "mcpServers": {
    "memberfy": {
      "url": "https://api.memberfy.net/mcp"
    }
  }
}
```

3. Speichere. Unter **Cursor Settings › MCP** erscheint der Server **memberfy** und verlangt eine Anmeldung: Klicke zum Authentifizieren.
4. Melde dich im Browser bei Memberfy an, wähle die **Community** und klicke auf **Erlauben**.
5. Zurück in Cursor wird der Server grün, mit der Liste der Tools.
6. Frag im Cursor-Chat (Agent-Modus) etwas bei Memberfy an.

## Andere Clients

Jeder MCP-Client, der den **HTTP**-Transport (*streamable HTTP*) und **OAuth** mit automatischer Erkennung unterstützt, funktioniert mit derselben Adresse. Der Server veröffentlicht alles, was der Client braucht, unter `https://api.memberfy.net/.well-known/oauth-protected-resource/mcp`, und der Client registriert sich selbst. Clients, die nur den lokalen Transport (*stdio*) sprechen, brauchen eine Brücke zu HTTP.

## Technische Details

| | |
|---|---|
| Adresse | `https://api.memberfy.net/mcp` (nur `POST`) |
| Transport | HTTP, ohne Sitzung: Jeder Aufruf ist unabhängig |
| Autorisierung | OAuth 2.1 mit PKCE (`S256`), dynamische Client-Registrierung |
| Rückleitung der Autorisierung | Beliebiges `https://`, oder `http://localhost` / `http://127.0.0.1` für lokale Clients |
| Scopes | `read` und `write` (Standard: beide). Nur mit `read` erscheinen die Erstell- und Geld-Tools nicht |
| Zugriffstoken | 1 Stunde, vom Client selbst erneuert |
| Erneuerungstoken | 30 Tage, bei jeder Nutzung ausgetauscht |

Mehr unter [Sicherheit und Grenzen](/mcp/seguranca).

## Probleme beim Verbinden

| Was passiert | Was du tust |
|---|---|
| `401` bei allen Aufrufen | Die Autorisierung wurde nicht abgeschlossen oder getrennt. Führe `/mcp` (Claude Code) erneut aus oder klicke zum Authentifizieren (Cursor) |
| Der Browser öffnet sich nicht | Kopiere den Link, den der Client anzeigt, und öffne ihn von Hand |
| *„Diese Zugriffsanfrage ist ungültig."* | Entferne den Server und füge ihn erneut hinzu; die Client-Registrierung hat eventuell eine andere Rückleitungsadresse |
| Viele Aufrufe hintereinander schlagen fehl | Die Grenze liegt bei 120 Tool-Aufrufen pro Minute und Verbindung. Warte eine Minute |

Weitere Fälle unter [Häufige Probleme](/mcp/problemas-comuns).

## Verwandte Artikel

- [MCP im Überblick](/mcp/o-que-e-o-mcp)
- [Tools](/mcp/ferramentas)
- [API](/api/introducao): zum Integrieren mit Code, ohne Assistent