Slima MCP

MCP (Model Context Protocol) Server für Slima – KI-Schreib-IDE für Romanautoren.

Verbinde deine Slima-Bücher mit jedem MCP-kompatiblen KI-Tool – ein Server, alle Plattformen.

Unterstützte Plattformen

Desktop-Anwendungen (Lokales MCP – stdio)

Web-Anwendungen (Remote MCP – HTTP)

MCP wurde im Dezember 2025 zum Industriestandard, als Anthropic, OpenAI und Block die Agentic AI Foundation unter der Linux Foundation gründeten.

Related MCP server: Loreum MCP Server

Funktionen

Buchverwaltung

• Erstellen neuer Bücher

• Auflisten und Anzeigen deiner Bücher

• Datei-/Ordnerstruktur abrufen

• Schreibstatistiken verfolgen

Dateioperationen

• Lesen jeder Datei über Pfad

• Bearbeiten bestimmter Textstellen (Suchen & Ersetzen)

• Schreiben (Ersetzen) von Dateiinhalten

• Erstellen neuer Dateien

• Löschen von Dateien

• Anhängen von Inhalten an Dateien

• Suchen in allen Dateien

KI-Beta-Leser

• Feedback von virtuellen Leser-Personas erhalten

• Kapitel aus verschiedenen Leserperspektiven analysieren

Schnellstart

Wähle den Pfad, der zu deiner KI-Nutzung passt:

• ⭐ Nutze claude.ai / ChatGPT im Webbrowser → Empfohlen: Web-Connector (einmalige Einrichtung, automatische Updates für immer)

• Nutze Claude Desktop / Cursor / Gemini CLI lokal → Lokale Installation mit npx

• Betrieb in abgeschotteten / Unternehmensumgebungen → Selbst hosten

Empfohlen: claude.ai / ChatGPT Web (automatisch aktualisierend)

Wenn du mit Claude oder ChatGPT im Browser chattest, ist dies die einfachste und zukunftssicherste Option. Einmal konfigurieren und du erhältst automatisch jedes Slima MCP-Update – keine Upgrade-Befehle, keine Konfigurationsänderungen.

MCP-URL: https://mcp.slima.ai/mcp

claude.ai (Pro / Max / Team / Enterprise)

1. Melde dich bei claude.ai an.

2. Öffne Einstellungen → Connectors (oder Integrationen, je nach Tarif).

3. Klicke auf Benutzerdefinierten Connector hinzufügen.

4. Fülle aus:

   • Name: Slima

   • URL: https://mcp.slima.ai/mcp

5. Klicke auf Verbinden → du wirst zu slima.ai weitergeleitet, um zuzustimmen → kehre zu claude.ai zurück.

6. Das Slima-Toolsymbol erscheint in deiner Chat-Eingabe. Fertig.

ChatGPT (Plus / Pro, Entwicklermodus)

1. Melde dich bei chatgpt.com an.

2. Öffne Einstellungen → Connectors → Erweitert und aktiviere den Entwicklermodus (2025.10+).

3. Zurück in Connectors klicke auf Erstellen → Benutzerdefinierter MCP-Server.

4. Fülle aus:

   • Name: Slima

   • Server-URL: https://mcp.slima.ai/mcp

   • Authentifizierung: OAuth

5. Klicke auf Erstellen → bestätige den OAuth-Ablauf.

Nach der Einrichtung werden Slima-Funktionen automatisch in deiner nächsten Unterhaltung bereitgestellt. Keine Neustarts, keine Neuinstallationen.

Lokal: Claude Desktop / Cursor / Gemini CLI

Verwende dies, wenn du eine offline-freundliche Bedienung, schnelleren Start oder die Ausführung von MCP neben anderen stdio-Servern benötigst.

Empfohlene Konfiguration – auf die Hauptversion festgelegt, sodass du automatisch neue Funktionen erhältst, aber nie durch ein 1.0-Release unterbrochen wirst:

Claude Desktop

Bearbeite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"],
      "env": {
        "SLIMA_API_TOKEN": "slima_your_token_here"
      }
    }
  }
}

Hole deinen Token von Slima Settings oder führe npx slima-mcp@0 auth einmal aus, um ihn auf der Festplatte zu speichern.

Cursor

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"],
      "env": {
        "SLIMA_API_TOKEN": "slima_your_token_here"
      }
    }
  }
}

Gemini CLI

gemini mcp add slima --command "npx -y slima-mcp@0"

Warum slima-mcp@0 statt slima-mcp / slima-mcp@latest? Die Verwendung von @0 fixiert die aktuelle Hauptversion – npx holt weiterhin automatisch neue 0.x.y-Versionen (du erhältst also Funktionen + Fehlerbehebungen), aber wenn wir 1.0.0 mit bahnbrechenden Änderungen ausliefern, wirst du diese nicht stillschweigend übernehmen, ohne deine Konfiguration zu aktualisieren. Wir werden den Wechsel zu @1 in den Versionshinweisen ankündigen.

Migration von einer globalen Installation

Wenn du bereits global mit npm install -g slima-mcp installiert hast:

# Remove the old global install (optional but cleaner)
npm uninstall -g slima-mcp

# Change your config `command` from "slima-mcp" to the npx form above, and restart the client.

Oder, wenn du bei einer globalen Installation bleiben möchtest, führe regelmäßig aus:

npm install -g slima-mcp@latest

Andernfalls driftet dein lokaler Client von den MCP-Tools/Schemata ab, die das Slima-Backend bereitstellt.

Selbst hosten (fortgeschritten)

Du kannst dieses Repository auch klonen und den Cloudflare Worker selbst bereitstellen. Siehe wrangler.toml + npm run deploy:worker. Für den normalen Gebrauch nicht erforderlich.

Remote MCP-Sicherheit

Der gehostete Remote MCP-Server unter https://mcp.slima.ai/mcp verwendet:

• OAuth 2.0 + PKCE zur Authentifizierung – keine Tokens per Copy-Paste.

• Keine serverseitig gespeicherten Geheimnisse – Anmeldedaten verlassen niemals den Slima-Auth-Server.

• Sitzungsbasiert: OAuth-Tokens werden in Cloudflare KV gespeichert, pro Sitzung begrenzt.

• Jederzeit widerrufbar über Slima Settings.

Buchtypen: Writing Studio vs Script Studio

Slima-Bücher gibt es in zwei Varianten, unterschieden durch das Feld book_type. MCP verhält sich für jede leicht unterschiedlich:

Für buchspezifische Details bitte deinen KI-Client, die Ressource slima://books/{book_token}/schema zu lesen – sie gibt eine JSON-Spezifikation zurück, welche Pfade für dieses spezifische Buch beschreibbar/schreibgeschützt sind.

list_books kennzeichnet jedes Buch mit seinem Studio-Symbol (📝 / 📖), damit du (und die KI) sie auf einen Blick unterscheiden könnt.

Verfügbare Tools

Buchverwaltung

Dateioperationen

KI-Beta-Leser

Anwendungsbeispiele

Nach der Konfiguration kannst du deine KI fragen:

Buch & Inhalt:

• "Erstelle ein neues Buch mit dem Namen 'Mein Roman'"

• "Liste meine Bücher in Slima auf"

• "Zeige mir die Struktur meines Romans"

• "Lies Kapitel 3 meines Buches"

• "Was sind meine Schreibstatistiken?"

Dateioperationen:

• "Lies das Charakterprofil meines Protagonisten"

• "Bearbeite Kapitel 1 und ändere 'John' zu 'James'"

• "Erstelle eine neue Datei namens worldbuilding.md mit Notizen zum Magiesystem"

• "Suche nach allen Erwähnungen von 'blauen Augen' in meinem Buch"

• "Hänge diesen neuen Absatz an Kapitel 5 an"

KI-Feedback:

• "Hole Feedback zu Kapitel 5 aus der Perspektive eines jungen Lesers"

• "Analysiere meine Eröffnungsszene aus der Perspektive eines Kritikers"

CLI-Befehle

slima-mcp auth      # Authenticate with browser (recommended)
slima-mcp status    # Check authentication status
slima-mcp logout    # Remove saved credentials
slima-mcp --help    # Show help
slima-mcp --version # Show version

Der Token wird in ~/.slima/credentials.json mit sicheren Berechtigungen gespeichert.

Umgebungsvariablen

*Nicht erforderlich, wenn du slima-mcp auth verwendet hast

Entwicklung

Lokale CLI-Entwicklung

# Clone the repository
git clone https://github.com/slima-ai/slima-mcp.git
cd slima-mcp

# Install dependencies
npm install

# Build CLI
npm run build

# Run tests
npm test

# Run in development mode
npm run dev

Cloudflare Worker-Entwicklung

# Build the Worker
npm run build:worker

# Run Worker locally
npm run dev:worker

# Deploy to Cloudflare
npm run deploy:worker

# Deploy to preview environment
npm run deploy:worker:preview

Projektstruktur

slima-mcp/
├── src/
│   ├── core/           # Shared core modules
│   │   ├── api/        # Slima API Client
│   │   ├── tools/      # MCP Tool implementations
│   │   └── utils/      # Utilities and errors
│   ├── cli/            # CLI entry point (stdio transport)
│   │   ├── index.ts    # CLI main
│   │   ├── auth.ts     # Authentication commands
│   │   └── server.ts   # MCP Server for CLI
│   └── worker/         # Cloudflare Worker (HTTP transport)
│       ├── index.ts    # Worker entry point
│       └── oauth.ts    # OAuth 2.0 + PKCE client
├── wrangler.toml       # Cloudflare Worker config
├── tsup.config.ts      # CLI build config
└── tsup.worker.config.ts # Worker build config

Sicherheit

• API-Tokens werden lokal gespeichert und niemals weitergegeben

• Die gesamte Kommunikation mit der Slima-API erfolgt über HTTPS

• Tokens können jederzeit über die Slima-Einstellungen widerrufen werden

Veröffentlichung & Bereitstellung

npm (Automatisch)

Merge in main mit einer Versionserhöhung in package.json löst eine automatische npm-Veröffentlichung über GitHub Actions aus.

# 1. Bump version on dev branch
npm version patch   # 0.1.10 → 0.1.11

# 2. Merge to main
git checkout main && git merge dev && git push

# 3. CI runs tests → publish.yml publishes to npm + creates git tag

Cloudflare Worker (Manuell)

Die Worker-Bereitstellung erfolgt getrennt von npm. Nach Codeänderungen bereitstellen:

npm run deploy:worker           # Production (mcp.slima.ai)
npm run deploy:worker:preview   # Staging

MCP-Registry (Manuell)

Um die Serverliste im MCP Registry zu veröffentlichen/aktualisieren:

mcp-publisher login github
mcp-publisher publish

Erfordert mcpName in package.json und server.json im Repository-Stammverzeichnis.

Betriebshinweise

Debugging von Worker-OAuth

Bei der Fehlersuche bei claude.ai- oder ChatGPT-Connector-Problemen:

# Live logs from production Worker
wrangler tail slima-mcp

Alle OAuth-Endpunkte protokollieren wichtige Parameter (client_id, redirect_uri, Token-Präfix usw.), um den Ablauf nachvollziehen zu können.

Worker-OAuth-Ablauf (claude.ai / ChatGPT)

Client POST /mcp → 401 + WWW-Authenticate header
  → Client GET /.well-known/oauth-protected-resource
  → Client GET /.well-known/oauth-authorization-server
  → Client POST /register (DCR)
  → Client redirects user to GET /authorize
    → Worker redirects to Rails OAuth
    → User authorizes → Rails redirects to Worker /callback
    → Worker issues auth code → redirects to client callback
  → Client POST /token (exchange code for access_token)
  → Client POST /mcp (Authorization: Bearer {access_token})

Bekannte Einschränkungen

• Die Worker-Bearer-Token-Validierung akzeptiert alle nicht leeren Token (nicht nur das Präfix slima_), um OAuth-ausgestellte Token zu unterstützen. Die Rails-API führt die eigentliche Validierung durch.

• getTokenFromSession() prüft zuerst den Authorization-Header und fällt dann auf die Cookie-Sitzung zurück.

• MCP Inspector (npx @modelcontextprotocol/inspector) ist nützlich zum Testen des vollständigen OAuth-Ablaufs unabhängig.

Lizenz

MIT

Links

• Slima Website

• Slima App

• MCP-Dokumentation

• MCP-Registry

• Probleme melden