Ein Skript oder einen KI-Assistenten verbinden

Alles, was du in der App siehst, ist auch programmatisch erreichbar: deine Beiträge, dein Plan, deine Kampagnen, deine Erfolge und die Aktivität des Teams. Es gibt zwei Wege hinein, und welchen du willst, hängt davon ab, wer fragt.

Ein API-Schlüssel, für deinen eigenen Code

Geh zu Meine Einstellungen → API & MCP und erstelle einen Schlüssel. Benenne ihn nach dem, was ihn nutzen wird, damit ein späterer Widerruf nicht gleich die anderen mitnimmt.

Der Schlüssel wird einmal angezeigt, im Moment der Erstellung. Er wird nirgends lesbar gespeichert: Wenn du ihn verlierst, erstellst du einen neuen, und nichts kann den alten wiederherstellen.

Nutze ihn als Bearer-Token. Leg ihn in eine Umgebungsvariable, statt ihn in einen Befehl zu tippen, damit er nicht in deiner Shell-History landet:

export THESTORY_API_KEY="der gerade kopierte Schlüssel"

curl https://api.thestory.run/v1/pieces \
  -H "Authorization: Bearer $THESTORY_API_KEY"

Die vollständige Liste der Endpunkte, Parameter und Antwortformen liegt unter /v1/openapi.json, diese Datei wird aus dem laufenden Code generiert und kann deshalb nicht auseinanderlaufen mit dem, was die API wirklich tut.

MCP, für Claude und andere Assistenten

MCP ist der Weg, wie ein KI-Assistent sich mit einem Werkzeug verbindet, ohne dass du einen Schlüssel in ein Chatfenster kopierst. Unter Meine Einstellungen → API & MCP findest du die MCP-Server-URL. Füge sie in Claude als Connector hinzu, und Claude schickt dich auf eine Seite hier. Melde dich an, falls noch nicht geschehen, und die Seite sagt dir, wer fragt und woran die App als du herankommt, deine privaten Entwürfe und Ideen eingeschlossen. Sie sagt auch klar, dass der Name der App der ist, den die App uns genannt hat, und dass wir ihn nicht geprüft haben.

Eine Wahl gibt es auf dieser Seite, welche Teamdaten welcher Organisation die Verbindung lesen darf, und dann einen Knopf Verbinden. Die Rechte selbst sind die, die der Assistent angefragt hat, die Seite nennt sie also, statt dir eine Auswahlliste hinzustellen. Kein Schlüssel wechselt den Besitzer.

Ein so verbundener Assistent kann deine Beiträge auflisten, deinen Plan lesen, Kampagnen und Aktivität ansehen, eine Idee festhalten, einen Beitrag als veröffentlicht markieren und ein fertiges Stück auf eine Zeit einplanen.

Was ein Token darf und was nicht

Beide Zugangsarten tragen eine von zwei Berechtigungen:

• Lesen listet Beiträge, Plan, Kampagnen, Erfolge und Team-Aktivität.
• Schreiben hält zusätzlich Ideen fest, markiert Beiträge als veröffentlicht und plant ein fertiges Stück auf Tag und Uhrzeit ein.

Beim letzten Punkt lohnt Genauigkeit, denn er ist die einzige Fähigkeit auf dieser Liste, die über die App hinausreicht. Ein Schreib-Token kann nicht auf der Stelle auf LinkedIn veröffentlichen, und etwas als gepostet zu markieren hält nur fest, dass du es getan hast. Es kann aber eine Planung setzen, und eine Planung veröffentlicht zu ihrer Zeit auf deinem eigenen LinkedIn-Profil, ohne dass jemand dabei ist. Das Stück liegt die ganze Zeit sichtbar in Fertig, mit seiner Uhrzeit daran, und ein Klick in der App blast es ab. Eine Planung, um die du nicht gebeten hast, ist also etwas, das du siehst und stoppen kannst, nichts, das still passiert. Ist dir das zu viel für einen Assistenten, nimm ein Lese-Token.

Was kein Token kann, egal mit welcher Berechtigung: ein Coach-Gespräch führen oder lesen. Interview-Mitschriften liegen nicht auf der API, und es gibt keinen Endpunkt, der den Coach etwas fragen lässt.

Sei dir aber im Klaren darüber, was ein Lese-Token sehr wohl sieht, denn es ist mehr als die veröffentlichte Arbeit. Es liest deine Stücke in jedem Zustand, Entwürfe eingeschlossen, mit dem Text, den du hineingeschrieben hast, und es liest deinen Plan: deine Themen und wie oft du posten willst. Ein Lese-Token ist deshalb so schützenswert wie ein Passwort, und eines zu widerrufen ist ein Druck in den Einstellungen.

Ein Token handelt als du und erreicht Organisationsdaten über deine Mitgliedschaft. Verlässt du eine Organisation, verliert alles, was dein Token nutzt, mit dir den Zugriff darauf.

Wenn du in mehreren Organisationen bist

Ein Schlüssel trägt deine eigenen Rechte in allen Organisationen, in denen du bist, du musst ihn also nicht pro Organisation neu anlegen. Welche eine Anfrage liest, entscheidet die Anfrage selbst: schicke die ID der Organisation im Header X-Org-Id mit.

curl https://api.thestory.run/v1/orgs \
  -H "Authorization: Bearer $THESTORY_API_KEY"

curl https://api.thestory.run/v1/campaigns \
  -H "Authorization: Bearer $THESTORY_API_KEY" \
  -H "X-Org-Id: 0b1f…"

GET /v1/orgs listet die IDs, die du verwenden darfst, und markiert die aktive Organisation. Ohne Header bekommst du diese aktive, also die, in die du in der App zuletzt gewechselt hast. Für ein Skript, das unbeaufsichtigt läuft, nenne die Organisation ausdrücklich: sonst ändert sich, was es liest, sobald du im Browser wieder umschaltest.

Eine MCP-Verbindung verhält sich absichtlich anders. Sie ist an die eine Organisation gebunden, die du bei der Freigabe gewählt hast, und eine Anfrage nach einer anderen wird abgelehnt statt stillschweigend beantwortet.

Zugriff zurücknehmen

Meine Einstellungen → API & MCP listet jeden Schlüssel und jede verbundene App. Ein Widerruf oder eine Trennung wirkt bei der nächsten Anfrage, ohne Übergangsfrist.

Der Name einer App ist der, den sie bei der Registrierung angegeben hat, und wir prüfen ihn nicht. Wenn du etwas nicht erkennst, trenne es.