Slima MCP

Lee y escribe tus libros de Slima desde Claude / ChatGPT / Cursor / Gemini

First-time MCP setup

• 01 Qué es Slima MCP MCP (Model Context Protocol) es el estándar para que las herramientas de IA lean y escriban en sistemas externos. Slima MCP permite que Claude / ChatGPT / Cursor / Gemini lean y escriban tus libros de Slima directamente.
• 02 Slima MCP vs file MCP vs Chat de IA integrado Tres rutas: Slima MCP (API hacia tus obras), file MCP (apunta a una carpeta local) y el Chat de IA dentro del editor.
• 03 Elige tu método de conexión: Web vs local Dos rutas: Web (OAuth, para claude.ai / ChatGPT) vs stdio local (paquete npm, para Claude Desktop / Cursor / Gemini CLI).

</ul>

Web connection (OAuth)

• 01 Conectar desde Claude.ai (recomendado) Añade Slima MCP como conector personalizado en Claude.ai. Flujo de OAuth y plan de Claude necesario (Pro / Max / Team / Enterprise).
• 02 Conectar desde ChatGPT ChatGPT necesita Modo Desarrollador (2025.10+) + servidor MCP personalizado + OAuth. Solo en planes Plus / Pro.

</ul>

Local connection (stdio)

• 01 Conectar Claude Desktop Claude Desktop en local: edita claude_desktop_config.json + npx slima-mcp@0 + variable de entorno del token. Rutas Mac / Win.
• 02 Conectar Cursor Cursor → Settings → MCP → añade el servidor + npx slima-mcp@0. Parecido a Claude Desktop pero con otra interfaz.
• 03 Conectar Gemini CLI Gemini CLI: gemini mcp add slima --command "npx -y slima-mcp@0". Requiere Gemini CLI ≥ 0.4.
• 04 Conectar VS Code VS Code se conecta mediante extensiones MCP. Las más habituales: MCP Tools / Continue.

</ul>

API tokens

• 01 Obtener SLIMA_API_TOKEN Dos caminos: ejecuta npx slima-mcp@0 auth (inicio de sesión en el navegador, se guarda en ~/.slima/credentials.json); o configura SLIMA_API_TOKEN a mano en un servidor sin navegador o en CI.
• 02 Referencia de comandos del CLI slima-mcp Todos los comandos del CLI `slima-mcp`: auth / status / logout / --help / --version. Descripción y ejemplos de cada uno.
• 03 Gestionar apps autorizadas Cuenta → Apps Autorizadas: mira qué está conectado, la hora del último uso y revoca de forma individual o en bloque.

</ul>

Versions & upgrades

• 01 Por qué `slima-mcp@0`: el anclaje de versión explicado Todos los ejemplos usan `slima-mcp@0`, no `slima-mcp`. `@0` ancla la versión mayor: recibes parches y versiones menores 0.x automáticamente, pero decides tú cuándo pasar a los cambios que rompen compatibilidad de la 1.0.
• 02 Migrar de la instalación global a `npx` Las versiones antiguas usaban `npm install -g slima-mcp`. El nuevo patrón es `npx -y slima-mcp@0`. Por qué migrar y cómo hacerlo.

</ul>

Tools reference

• 01 Herramientas de gestión de libros (6) El MCP de Slima ofrece 6 herramientas a nivel de libro: create_book / list_books / get_book / get_book_structure / get_chapter / get_writing_stats. Entradas, salidas y ejemplos.
• 02 Herramientas de operaciones de archivo (7) Siete herramientas a nivel de archivo: read_file / edit_file / write_file / create_file / delete_file / append_to_file / search_content. Reglas de permisos + ejemplos.
• 03 Herramientas de lectores de IA (2) Dos herramientas MCP exponen los Lectores Beta IA: list_personas y analyze_chapter. Entradas, salidas y su correspondencia con la lectura dentro de Slima.

</ul>

Writing vs Script Studio

• 01 Comportamiento de MCP según el estudio: tabla completa Estudio de escritura vs. Script Studio bajo MCP: qué rutas se pueden editar, cuáles son de solo lectura y el manejo especial de archivos estructurados.
• 02 Protección de archivos estructurados en Script Studio Todos los archivos estructurados de Script Studio (escenas / personajes / tramas / temporadas / episodios) son de solo lectura por MCP. Solo `.script_studio/planning/**/*` admite escritura. Por qué + cómo (no) saltártelo.
• 03 Límites específicos de las herramientas en Script Studio `search_content` excluye por defecto los archivos estructurados; `analyze_chapter` no admite archivos de escena. Cómo sortearlo o complementarlo.

</ul>

Advanced: schema & self-host

• 01 Consultar el schema de una obra con el recurso El recurso MCP `slima://books/{book_token}/schema` devuelve las reglas exactas de rutas de solo lectura / escribibles — la IA lo usa para saber si una ruta es escribible.
• 02 Autoalojar el Cloudflare Worker (avanzado) El servidor MCP de Slima corre en Cloudflare Workers (código abierto). Puedes hacer un fork, desplegar el tuyo y personalizar OAuth / añadir middleware.

</ul>

Troubleshooting

• 01 No me puedo conectar: 401 / encabezado Authorization El fallo de conexión MCP más común: 401 Unauthorized. Causas: token caducado / configuración incorrecta / fallo del flujo WWW-Authenticate. Diagnóstico.
• 02 Token caducado o necesita reautorización Los tokens de MCP los emite el inicio de sesión con OAuth de Slima y caducan cada cierto tiempo. La caducidad devuelve un 401; la reautorización (a menudo automática en la web) lo soluciona. Cómo detectarlo y renovarlo.
• 03 Permiso denegado al escribir El fallo 400 INVALID_PATH al escribir suele significar archivos estructurados de Script Studio — edítalos en la interfaz de Slima o escribe en `.script_studio/planning/`.
• 04 Avanzado: depurar el flujo OAuth El flujo OAuth de 9 pasos: DCR → authorize → callback → token → mcp. Rastrea qué paso falla con `wrangler tail` / curl.

</ul>