---
title: "Projekt-Key anlegen – Relyo"
description: "Projekt-Key für Relyo selbst anlegen, ohne Konto: per MCP-Server für Coding-Agents oder per API. Origins, Verwaltungs-Token, Grenzen."
lang: de
canonical: https://relyo.de/docs/projekt
---

# Projekt-Key anlegen

Ein Projekt-Key (`projectKey`) verbindet deine Website oder App mit relyo.de. Du legst ihn selbst an, ohne Konto und ohne E-Mail: per Coding-Agent über den MCP-Server, per API oder mit einem einzigen `curl`.

Bei der Anlage bekommst du zwei Werte:

- **`key`** (`pk_…`): öffentlich, kommt in `Relyo.init({ projectKey })`.
- **`manageToken`** (`rpm_…`): geheim, wird **nur einmal angezeigt**. Damit änderst du später Origins und Namen, tauschst den Key oder löschst das Projekt. Bewahre es in einem Passwort-Manager oder Secret-Store auf, nie im Code oder im Repository.

## Mit einem Coding-Agent (MCP)

relyo.de betreibt einen MCP-Server unter `https://relyo.de/mcp` (Streamable HTTP, ohne Anmeldung). In Claude Code fügst du ihn so hinzu:

```sh
claude mcp add --transport http relyo https://relyo.de/mcp
```

Andere Agents (Cursor, VS Code, Windsurf …) tragen ihn in ihrer MCP-Konfiguration ein:

```json
{
  "mcpServers": {
    "relyo": { "type": "http", "url": "https://relyo.de/mcp" }
  }
}
```

Danach genügt zum Beispiel: „Lege mit dem Relyo-MCP-Server ein Projekt für https://example.com an und baue Relyo ein.“ Der Server bietet diese Tools:

| Tool                 | Wirkung                                                         |
| -------------------- | --------------------------------------------------------------- |
| `create_project`     | Projekt anlegen, liefert `key` und `manageToken`                |
| `get_project`        | Projekt anzeigen                                                |
| `update_project`     | Namen ändern oder die Origin-Liste ersetzen                     |
| `rotate_project_key` | neuen Key ausgeben; der alte gilt sofort nicht mehr             |
| `delete_project`     | Projekt löschen; der Key gilt sofort nicht mehr, Sessions enden |

## Per API

```sh
curl -X POST https://relyo.de/api/projects \
  -H 'content-type: application/json' \
  -d '{"name": "Mein Shop", "origins": ["https://example.com", "https://www.example.com"]}'
```

Antwort (`201`):

```json
{
  "key": "pk_3f9c0a71d2e84b5c6a10",
  "name": "Mein Shop",
  "origins": ["https://example.com", "https://www.example.com"],
  "limits": { "maxSessions": 3, "maxSessionMinutes": 60, "idleMinutes": 10 },
  "createdAt": "2026-10-25T13:00:00.000Z",
  "updatedAt": "2026-10-25T13:00:00.000Z",
  "manageToken": "rpm_…"
}
```

Verwalten mit dem `manageToken` als Bearer-Token:

| Anfrage                        | Wirkung                                          |
| ------------------------------ | ------------------------------------------------ |
| `GET /api/project`             | Projekt anzeigen                                 |
| `PATCH /api/project`           | `name` und/oder `origins` ändern (Liste ersetzt) |
| `POST /api/project/rotate-key` | neuen Key ausgeben, das Token bleibt             |
| `DELETE /api/project`          | Projekt löschen                                  |

```sh
curl -X PATCH https://relyo.de/api/project \
  -H "authorization: Bearer $RELYO_MANAGE_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"origins": ["https://example.com", "https://staging.example.com"]}'
```

Die vollständige Beschreibung steht als [OpenAPI](/openapi.json) bereit.

## Origins

- **Websites:** Trage jede Adresse ein, von der das SDK lädt, also Schema, Host und Port, ohne Pfad (`https://example.com`, `https://www.example.com`, `http://localhost:5173` für die Entwicklung). Höchstens 20.
- **Flutter- und native Apps** senden keinen Origin und brauchen keinen Eintrag. Ein Projekt ohne Origins funktioniert nur für Apps.
- Verbindet sich eine Seite mit einem nicht eingetragenen Origin, lehnt relyo.de sie ab, und das SDK meldet „Der Support-Code konnte nicht angefordert werden.“

## Grenzen auf relyo.de

Selbst angelegte Projekte nutzen den kostenlosen Demo-Dienst ohne Gewährleistung (siehe [Nutzungsbedingungen](/nutzungsbedingungen)):

- höchstens 3 gleichzeitige Sessions je Projekt, jeweils höchstens 60 Minuten, Ende nach 10 Minuten ohne Aktivität;
- Sessions starten nur über den Code, den der Nutzer nennt (keine Geräteliste);
- höchstens 10 neue Projekte je Stunde und Adresse.

Die Antwort enthält die aktuellen Werte unter `limits`. Brauchst du mehr, betreibe den Relay selbst.

## Key verloren oder öffentlich geworden

Der Key steht ohnehin im Code deiner Website oder App; er ist kein Geheimnis. Die Origin-Liste verhindert, dass fremde Websites ihn nutzen. Willst du ihn trotzdem tauschen, nutze `rotate_project_key` bzw. `POST /api/project/rotate-key` und spiele den neuen Key aus.

Ist das `manageToken` verloren, lässt sich das Projekt nicht mehr ändern. Lege dann ein neues an.