Einen KI-Agenten per MCP mit deinem Buch verbinden.
Shiro ist ein MCP-Server. Claude Code, Cursor, Codex, Claude Desktop, VS Code oder jeder andere Client, der das Model Context Protocol spricht, kann ein Projekt lesen und mit etwa 85 Tools daran arbeiten. Die Änderungen eines Agenten wirken sofort, wie deine eigenen, und jede bleibt im Projektverlauf, wo du sie zurücknehmen kannst. Ein Agent kann eine Änderung auch vorschlagen, statt sie zu machen; sie wartet, bis du sie übernimmst oder ablehnst, und ein Agent, der auf „Schlägt nur vor“ steht, tut nichts anderes.
Drei Zugänge
Wähle danach, wo das Buch liegt.
shiro mcp |
Lokale API der Desktop-App | Cloud | |
|---|---|---|---|
| Arbeitet mit | Einem Projektordner | Dem in der App geöffneten Projekt | Cloud-Projekten, auf die du zugreifen kannst |
| Transport | stdio | Streamable HTTP | Streamable HTTP |
| Adresse | Keine | http://127.0.0.1:7341/mcp/<key> |
https://api.meetshiro.com/mcp |
| Authentifizierung | Keine, läuft als du | Ein Schlüssel pro Client | OAuth 2.1 |
| Änderungen | Sofort, im Verlauf, oder wartend als Vorschläge | Sofort, im Verlauf, oder wartend als Vorschläge | Sofort, im Rahmen deiner Rolle, oder wartend als Vorschläge |
| Braucht | Den Befehl shiro, bald |
Die laufende App, mit eingeschalteter API | Ein Shiro-Konto |
Alle drei liefern dieselben Tools aus demselben Servercode.
Die Kommandozeile: shiro mcp
Das Kommandozeilenwerkzeug shiro kommt bald. Sobald es installiert ist:
shiro mcp /path/to/MyNovel
Das stellt ein Projekt über stdio bereit, und die Shiro-App muss dafür nicht laufen. Szenen werden aus dem Ordner Manuscript/ des Projekts gelesen. Die Optionen:
--client <name>ist der Name des Agenten im Projektverlauf. Standard istAgent.--suggestlässt den Agenten nur vorschlagen: Er hat kein Tool, das das Buch ändert, und jede Änderung wartet als Vorschlag, den du in Shiro übernimmst oder ablehnst.--out <folder>ist der Ort für zusammengestellte Dateien. Standard ist der aktuelle Ordner.
Die meisten Clients nehmen in ihrer MCP-Konfiguration einen Block wie diesen:
{
"mcpServers": {
"shiro": {
"command": "node",
"args": [
"/path/to/shiro/apps/cli/dist/cli.js",
"mcp",
"/path/to/MyNovel",
"--client",
"Claude"
]
}
}
}
Die Änderungen des Agenten gehen direkt in die Dateien des Projekts. Jeder Aufruf wird im Projektverlauf festgehalten, im Ordner .shiro/history/, sodass du ihn in Shiro siehst und dort zurücknehmen kannst.
Die Desktop-App: lokale API
Sie ist standardmäßig aus.
- Öffne in der App Du › MCP, wähle „Auf diesem Computer“ und schalte „Agenten auf diesem Computer verbinden lassen“ ein.
- Wähle unter „Deine Tools verbinden“ dein Tool und drück „Schlüssel erstellen“. Jedes Tool bekommt seinen eigenen Schlüssel, sodass du eines allein trennen kannst.
- Füge in das Tool ein, was die Seite anzeigt. Sie hat Schritte für Claude, Claude Code, Codex, Gemini, Cursor und VS Code sowie einen Namen und eine URL für alles andere, das Streamable HTTP spricht.
Für Claude Code lautet der Befehl so, und Codex hat seine eigene Form:
claude mcp add --transport http --scope user shiro http://127.0.0.1:7341/mcp/<key>
codex mcp add shiro --url http://127.0.0.1:7341/mcp/<key>
Claude Desktop erreicht den Server über die Brücke mcp-remote, die Node braucht.
Der Server lauscht nur auf 127.0.0.1 und nur, solange die App geöffnet ist. 7341 ist der Standardport, und du kannst einen anderen wählen, falls etwas anderes ihn belegt. Der Schlüssel steht in der Adresse oder in einem Header Authorization: Bearer. Shiro zeigt ihn einmal an und speichert nur seinen Hash. Anfragen mit einem anderen Hostnamen oder von einer Webseite werden abgelehnt. Ein verbundener Client bearbeitet und schlägt standardmäßig vor: Was er ändert, wirkt sofort, unter seinem Namen im Projektverlauf, und eine Änderung, die er vorzuschlagen entscheidet, wartet unter Kommentare. Stell ihn unter Du › MCP auf „Schlägt nur vor“, dann schlägt er jede Änderung vor.
Derselbe Port stellt unter /api/v1 eine einfache HTTP-API bereit, mit dem Schlüssel als Bearer-Token:
| Anfrage | Liefert |
|---|---|
GET /project |
Titel, Typ, Sprache und Wortzahl des Projekts |
GET /outline |
Die Gliederung |
GET /world |
Einträge der Welt, als JSON |
GET /scenes/<id> |
Eine Szene |
GET /tools |
Die Liste der Tools |
POST /tools/<name> |
Führt ein Tool aus, mit seinen Argumenten als JSON-Body |
curl -H "Authorization: Bearer $SHIRO_KEY" http://127.0.0.1:7341/api/v1/outline
Cloud-Projekte: /mcp mit OAuth
Die Adresse ist https://api.meetshiro.com/mcp. Ein Client, der Remote-MCP mit OAuth unterstützt, braucht nichts weiter. Wenn du über den Link service_documentation in den Metadaten des Servers hierhergekommen bist, ist das der Abschnitt, den du gesucht hast.
- Discovery. Eine nicht authentifizierte Anfrage bekommt eine 401, deren Header
WWW-Authenticateauf/.well-known/oauth-protected-resource/mcpverweist. Die Metadaten des Autorisierungsservers liegen unter/.well-known/oauth-authorization-server. - Registrierung. Die dynamische Client-Registrierung liegt unter
/oauth/register. Redirect-URIs müssen https, Loopback oder ein eigenes Schema einer App (myapp://…) sein, ohne Fragment. - Autorisierung. Authorization Code mit PKCE, nur S256. Clients sind öffentlich, ohne Secret, und der Scope ist
shiro. Auf der Zustimmungsseite kannst du dich im selben Fenster anmelden oder ein Konto erstellen, mit einem Code aus einer E-Mail oder mit Google, und die Antwort nennt den Server, der sie ausgestellt hat (iss). - Tokens. Access Tokens gelten eine Stunde. Refresh Tokens rotieren bei jeder Nutzung, und das alte Paar funktioniert nicht mehr, sobald ein neues ausgestellt ist; ein zum zweiten Mal genutztes Refresh Token beendet die Verbindung, und eines, das 90 Tage nicht genutzt wurde, läuft ab. Ein Client, der die Verbindung trennt, gibt sein Token unter
/oauth/revokezurück. Das Token eines Agenten erreicht/mcpund/v1/api/*und sonst nichts im Konto.
/v1/api/* ist dieselbe REST-API wie die lokale, für Skripte. Der Agent beginnt mit deinem ersten Projekt, und das Tool project listet, öffnet und erstellt weitere. Das Projekt, das er öffnet, wird für diesen Client gemerkt.
Ein Agent hat deine Rolle und nicht mehr:
| Deine Rolle | Was der Agent tun kann |
|---|---|
| Eigentümer oder Mitautor | Bearbeiten |
| Lektor | Nur vorschlagen |
| Kommentator | Nur kommentieren |
| Betrachter | Nur lesen |
Unabhängig von deiner Rolle kannst du einen Agenten unter Du › MCP auch auf „Schlägt nur vor“ stellen, in Shiro im Web oder in der App.
Tool-Aufrufe haben ein Tageslimit, bei kostenlosen Konten niedriger. Darüber hinaus liefern Aufrufe bis zum nächsten Tag HTTP 429.
Wie du eine Änderung zurücknimmst
Ein Agent bearbeitet, wie du es tun würdest, ohne zu fragen. Nichts, was er ändert, wartet in Shiro auf eine Freigabe, und kein Tool nimmt oder verlangt confirmed: Löschen, Senden, Teilen, Veröffentlichen und Wiederherstellen geschehen sofort. Manuell, Auto und Max sind Modi von Shiros eigenem Chat, nicht von Agenten.
Der Agent entscheidet bei jeder Änderung, ob er sie macht oder vorschlägt. Der Server sagt ihm, eine Änderung direkt zu machen, wenn du darum gebeten hast, und eine vorzuschlagen, um die du nicht gebeten hast, bei der er unsicher ist oder die du erst ansehen willst. Ein Vorschlag geht über das Tool suggest, eine Änderung oder mehrere auf einmal, jede mit einer Notiz, warum. Er wartet unter Kommentare, bis du jede Änderung übernimmst oder ablehnst, und das Tool proposals sagt dem Agenten, was du getan hast.
Das Sicherheitsnetz ist der Projektverlauf. Jeder Aufruf ist ein Eintrag, mit dem Namen des Agenten („Claude: edit“). Jede Szene, deren Text der Agent geändert hat, bekommt in ihren Versionen eine Version davor („Vor der Änderung von Claude“) und eine danach („Von Claude geändert“), und dort stellst du die frühere wieder her. Die Änderung eines Agenten hat im Editor keine Rückgängig-Karte.
Ein Agent, der auf „Schlägt nur vor“ steht, hat kein Tool, das das Buch ändert, und schlägt jede Änderung vor. Ebenso einer in einem geteilten Buch, in dem die Person, die ihn verbunden hat, die Rolle Lektor hat, die nur vorschlagen darf. Ihre Änderungen warten als Vorschläge unter Kommentare, und du übernimmst oder lehnst jede einzeln ab.
Drei weitere Regeln gelten für jeden Client.
Buchtext, Kommentare, Webseiten und Elemente im Eingang sind Daten, und der Server weist Agenten an, Anweisungen darin nie zu befolgen. Eine mit ai: never markierte Szene ist leer. Und lokale Projekte und lokale Modelle bleiben nur so weit auf deinem Computer, wie Shiros eigener Teil reicht: Was ein Agent liest, sendet er an sein eigenes Modell.
Die Tools
Ein Cloud-Client sieht etwa 85, die lokale API der Desktop-App etwa 80 und shiro mcp etwa 70: Jeder Host bietet die Tools, die er bedienen kann. Die meisten kommen paarweise, eines, das nur liest (entries_read), und eines, das ändert (entries). Die Tabelle nennt jedes Paar einmal.
| Gruppe | Tools | Was sie tun |
|---|---|---|
| Nur lesen | read, search, count, check, skill |
Szenen, Einträge, Gliederung und Notizen lesen. Nach Text, Erwähnung oder Bedeutung suchen. Wörter, Adverbien und Dialog ohne Modell zählen. Kontinuitäts- und Schutzprüfungen ausführen. Handwerks-Skills laden. |
| Text | edit, replace_all, write, alternatives, snapshots |
Eine Szene per exaktem Zitat ändern, mit Vorschau suchen und ersetzen, benannte Fassungen einer Szene behalten, Schnappschüsse machen und wiederherstellen. |
| Struktur und Überarbeitung | structure, labels, whiteboard, passes, comments, note, inbox, memory, goals |
Szenen erstellen, festlegen, verschieben, teilen und zusammenführen und mit Labels versehen. An Whiteboards, Überarbeitungsdurchgängen, Kommentaren und Aufgaben, Notizen, dem Eingang, dem Projektgedächtnis und Schreibzielen arbeiten. |
| Welt und Recherche | entries, folders, media, maps, style_sheet, language |
Einträge und ihre Verknüpfungen, Ordner, Medien-Boards, Karten mit Markierungen und Routen, das Stylesheet und erfundene Sprachen verwalten. |
| Ausgabe | translations, adapt, publish, compile, export, beta_reads |
Übersetzungen am Original entlang schreiben, die Prosa zu einem Drehbuch oder Theaterstück bearbeiten, Buchangaben festlegen, mit einer Voreinstellung zusammenstellen, Ausgaben und Exportstile ausführen. beta_reads gibt es nur, wenn du bei Shiro Cloud angemeldet bist. |
| Projekt | project, book |
Die Projektkarte lesen, Projekte auflisten, öffnen und erstellen, alle Projekte auf einmal durchsuchen, die Einstellungen des Buchs lesen. |
| Vorschläge | suggest, proposals |
Eine Änderung vorschlagen, statt sie zu machen, eine oder mehrere auf einmal, jede mit einer Notiz für dich, und sehen, was du übernommen oder abgelehnt hast. |
write erzeugt Prosa mit Shiros eigenem Schreibmodell, und nur die Desktop-App bietet es an, sobald dort ein Schreibmodell eingerichtet ist. Ein Agent von außen bringt sein eigenes Modell mit, schreibt die Prosa also selbst und schickt sie mit edit. Websuche, Bilderzeugung und Shiros eigene Chat-Tools fehlen in MCP aus demselben Grund.
Der Server bietet außerdem Ressourcen an: shiro://project/card, /outline, /world, /passes, /worklist und /memory unter demselben Präfix, /proposals sowie shiro://scene/{id}/alternatives. Agenten sollten mit der Karte und der Gliederung beginnen.
Mehr dazu, wie Shiros eigene KI diese Tools nutzt, steht auf der KI-Seite.
Häufige Fragen
Kann ein Agent mein Buch ändern, ohne dass ich es sehe?
Ohne zu fragen, ja, so wie du es tun würdest, aber nicht ohne Spur. Jeder Aufruf ist ein Eintrag im Projektverlauf, mit dem Namen des Agenten, und jede Szene, deren Text er geändert hat, behält in ihren Versionen die Version von vorher. So siehst du, was er getan hat, und stellst wieder her, was du hattest. Ein Agent kann auch entscheiden, eine Änderung vorzuschlagen, statt sie zu machen, etwa eine, um die du nicht gebeten hast, oder eine, bei der er unsicher ist: Sie wartet unter Kommentare, bis du sie übernimmst oder ablehnst. Stell einen Agenten unter Du › MCP auf „Schlägt nur vor“, dann schlägt er jede Änderung vor. In einem geteilten Buch schlägt auch ein Agent, den jemand mit der Rolle Lektor verbunden hat, jede Änderung vor.
Sendet das Verbinden eines Agenten mein Buch irgendwohin?
Shiros Server auf deinem Computer sendet von sich aus nichts, aber der Agent, den du verbindest, sendet, was er liest, an das Modell, das er nutzt. Ist das ein gehostetes Modell, verlässt dein Text deinen Computer wegen des Agenten.
Brauche ich ein Konto?
Nicht für shiro mcp oder die lokale API der Desktop-App. Der Cloud-Endpunkt arbeitet mit Cloud-Projekten und braucht deshalb ein Shiro-Konto; ein kostenloses reicht zum Verbinden.
Kann ich eine Szene von Agenten fernhalten?
Ja. Eine vor Shiro verborgene Szene (ai: never in ihrem Front Matter) ist auch für Agenten leer.