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:

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

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

{
  "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

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):

{
  "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

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 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):

• 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.