Die API nutzen
Aktualisiert am 2026-09-02
Mit einem persönlichen Zugriffstoken kann ein Skript oder ein KI-Assistent in deinem rifts.to-Konto handeln, ohne den Browser zu öffnen. Dieser Artikel ordnet die beiden Wege ein, es zu nutzen; die vollständige Referenz steht unter /api und /mcp.
Persönliche Zugriffstokens
Ein Zugriffstoken authentifiziert Anfragen an /api/v1 als dich. Damit kannst du Umfragen erstellen, einfärben, bearbeiten und neu starten sowie eine gespeicherte Vorlage starten – alles ohne den Browser-Editor. Die API-Nutzung setzt ein aktives Abo voraus; ein Token ohne Abo dahinter wird abgelehnt.
Was es nicht tut
Eine über die API erstellte Umfrage überschreibt nicht die Palette, die du zuletzt von Hand im Browser gewählt hast. Nennst du beim Erstellen keine Farbe, nimmt sie die gemerkte Standardpalette deines Kontos – genau wie ein Vorlagenstart mit einem Klick – und schreibt nie einen neuen Standard zurück. Über ein Token in deinem Namen zu handeln ist nicht dasselbe, wie wenn du dich hinsetzt und selbst ein Thema wählst, also ändert es nicht, womit der Browser-Editor beim nächsten Mal öffnet.
Einen KI-Assistenten verbinden
Der andere Weg hinein ist ein MCP-Server: Damit kann ein Assistent wie Claude deine Umfragen im normalen Gespräch erstellen und lesen, statt dass du Anfragen von Hand schreibst. Es ist ein eigenes Projekt neben rifts.to selbst, veröffentlicht auf npm als @rifts_to/mcp. Dieser Paketname nutzt einen Unterstrich, keinen Punkt: npm-Paketnamen dürfen keinen Punkt enthalten, also wird rifts.to für den Scope zu rifts_to. Unter keiner anderen Schreibweise ist ein Paket veröffentlicht, und ein Paket ohne den Unterstrich existiert nicht.
Die vollständigen Einrichtungsschritte samt exaktem Installationsbefehl stehen unter /mcp. Einen Assistenten so zu verbinden nutzt weiterhin dasselbe Konto und dieselbe Abo-Voraussetzung wie ein einfaches Zugriffstoken; es ist eine andere Tür in dasselbe Konto, kein eigenes Produkt.
Eine Verbindung autorisieren
Wenn ein MCP-Client oder eine andere Drittanbieter-App sich zum ersten Mal verbinden will, siehst du einen Zustimmungsbildschirm, auf dem du freigibst, was sie tun darf. Die Zustimmung gibt weder dein Passwort noch deine Admin-Tokens heraus; sie gewährt der verbindenden App einen eigenen Zugang, den du jederzeit in deinem Konto widerrufen kannst, ohne deine Anmeldung zu beeinträchtigen.
Wo es weitergeht
Für Anfragen und Antworten Endpunkt für Endpunkt, Fehlercodes und Ratenbegrenzungen siehe /api. Für die MCP-Werkzeugliste und die Verbindungsschritte siehe /mcp.