Guía completa de Slima MCP | Que la IA lea y escriba tus libros

Copiar. Pegar. Copiar otra vez. Pegar otra vez: metes la ficha del personaje en el chat, luego pegas el capítulo ocho, solo para preguntarle a la IA una cosa: “¿estos dos se contradicen?”. Pasas una tarde y has movido más texto del que has escrito.

El problema es simple: la IA no ve tu libro entero. Solo ve los fragmentos que le das a mano. Slima MCP resuelve justo eso: lo configuras una vez y tu IA lee y escribe tus libros de Slima directamente. Se acabó copiar y pegar.

Esta guía empieza por cómo instalarlo, repasa cada método y termina mostrándote qué hacer con él.

¿Qué es MCP? Siglas de Model Context Protocol, un estándar abierto que permite a las herramientas de IA intercambiar datos con servicios externos directamente. Piénsalo como el USB de la IA: cualquier herramienta que hable MCP puede conectarse a Slima y leer o escribir tu libro.

Elige tu camino

Cómo usas la IA	Qué instalación
claude.ai o ChatGPT en el navegador / el móvil	⭐ Conector web (configuración única, se actualiza solo para siempre, sin token)
Claude Desktop / Cursor / Gemini CLI en el ordenador	Instalación local con `npx`
Entorno empresarial / sin conexión	Autoalojado (avanzado)

El primero es el más fácil, sobre todo si alguna vez escribes desde el móvil.

Método 1 (recomendado): conectar desde claude.ai o ChatGPT en la web

Si hablas con Claude o ChatGPT en un navegador o una app de móvil, esta es la opción más sencilla y a prueba de futuro. Se configura una vez y cada actualización de Slima MCP llega sola: sin comandos, sin archivos de configuración.

Solo necesitas una URL: https://mcp.slima.ai/mcp

Conectar desde claude.ai (el que más uso)

Inicia sesión en claude.ai.
En la barra lateral izquierda, abre Customize → Connectors.
Arriba a la derecha de la lista de conectores, pulsa ”+” → Add custom connector.
Rellena solo dos campos:
- Name: Slima
- Remote MCP server URL: https://mcp.slima.ai/mcp
- Deja en blanco el OAuth Client ID / Secret.
Pulsa Add → te lleva a slima.ai para aprobar → vuelves a claude.ai.
El icono de herramientas de Slima aparece junto al chat. Listo.

El conector web está disponible en los planes Pro / Max / Team / Enterprise de claude.ai. La interfaz está en inglés; busca las palabras de arriba tal cual.

Conectar desde ChatGPT en la web

Inicia sesión en chatgpt.com.
Abre Settings → Connectors → Advanced y activa el Developer Mode (modo desarrollador) (2025.10+).
De vuelta en Connectors, pulsa Create → Custom MCP Server.
Rellena:
- Name: Slima
- Server URL: https://mcp.slima.ai/mcp
- Authentication: OAuth
Pulsa Create y completa la aprobación OAuth.

Después, las herramientas de Slima aparecen solas en tu siguiente conversación. Sin reinicios ni reinstalaciones.

Método 2: instalación local con npx (Claude Desktop / Cursor / Gemini CLI / VS Code)

Úsalo si prefieres apps de escritorio, quieres un arranque más rápido o ejecutas MCP junto a otros servidores locales. El núcleo es el mismo en todos: que la herramienta ejecute slima-mcp@0 con npx.

Autentícate una vez (guarda tu sesión en local):

npx slima-mcp@0 auth

Se abre un navegador que te guía para iniciar sesión con tu cuenta de Slima; se guarda en ~/.slima/credentials.json. O consigue un token en Ajustes de Slima → API Tokens y ponlo en el SLIMA_API_TOKEN de la configuración.

Claude Desktop

Edita claude_desktop_config.json (~/Library/Application Support/Claude/ en macOS, %APPDATA%\Claude\ en Windows):

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

Reinicia Claude Desktop; el icono de herramientas junto al chat significa que está conectado. (Si ya ejecutaste auth, puedes omitir el bloque env.)

Cursor

Crea .cursor/mcp.json en la raíz del proyecto con el mismo contenido que Claude Desktop. Cursor lo detecta y lo arranca cuando hace falta.

Gemini CLI

Una línea:

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

VS Code

Crea .vscode/mcp.json:

{
  "servers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"]
    }
  }
}

⚠️ VS Code usa servers, no mcpServers: el error más común.

¿Por qué slima-mcp@0 y no slima-mcp? @0 lo fija a la versión mayor actual: npx sigue trayendo automáticamente las nuevas 0.x (con funciones y correcciones), pero cuando salga una 1.0 con cambios incompatibles no se actualizará a tus espaldas.

¿Prefieres una instalación global? npm install -g slima-mcp también vale; solo ejecuta npm install -g slima-mcp@latest de vez en cuando para que tu copia local no se desfase de las herramientas que expone el backend de Slima.

Autenticación y seguridad

npx slima-mcp@0 auth — inicia sesión por navegador (recomendado)
npx slima-mcp@0 status — comprueba tu estado de autenticación
npx slima-mcp@0 logout — elimina las credenciales guardadas

El conector web usa OAuth —sin tokens copiados a mano— y puedes revocar el acceso cuando quieras desde Ajustes de Slima. Los tokens locales viven en ~/.slima/credentials.json con permisos protegidos. Slima MCP solo toca los libros de la cuenta que autorizaste, y la IA solo lee o escribe cuando se lo pides.

Quince herramientas, tres grupos

Gestión de libros

create_book libro nuevo · list_books lista todo · get_book detalles del libro · get_book_structure todo el árbol de archivos (le da a la IA la visión de conjunto, y cada paso posterior es más certero) · get_writing_stats estadísticas de escritura.

Operaciones con archivos

read_file / get_chapter leer un archivo (el de cabecera) · write_file sobrescribir · edit_file buscar y reemplazar con precisión · create_file archivo nuevo · delete_file borrar · append_to_file añadir al final · search_content búsqueda de texto en todos los archivos (la herramienta clave para la coherencia).

Lector Beta IA

list_personas lista las personas lectoras · analyze_chapter que una persona concreta lea un capítulo entero.

Nota: todas funcionan en libros del Estudio de escritura. En el Estudio de guion (guiones), los archivos estructurados (escenas, personajes, tramas…) son de solo lectura por MCP; edítalos en la app de Slima.

Flujos de trabajo reales

1. Empezar un día de escritura

“Muéstrame la estructura de este libro y luego lee el último capítulo que escribí ayer.” La IA ejecuta get_book_structure + read_file, te prepara el contexto y te dice por dónde ibas y qué toca según el esquema.

2. Comprobar la coherencia de un personaje

“Busca todos los pasajes donde aparece el viejo mayordomo.” search_content los reúne y descubres que en el capítulo tres jura que nunca miente, pero en el diez está ocultando algo. Presagio o desliz, al menos ya lo has pillado.

3. Revisión (que lo lea el Lector Beta)

“Lee el capítulo uno como la analista de ritmo.” analyze_chapter te da feedback de ritmo, tensión y arco de personaje; luego “recorta esa escena demasiado larga del tercer párrafo” y edit_file cambia solo eso, sin tocar lo demás.

4. Ordenar el worldbuilding

“Busca todos los pasajes que mencionan una regla del sistema de magia y reúnelos en un único archivo de referencia en la carpeta de worldbuilding.” search_content → read_file → create_file convierte fragmentos dispersos en una sola fuente fiable.

5. Ficción con mucha documentación (trabajo de campo)

Las historias históricas, locales o de oficio acumulan notas de campo, transcripciones de entrevistas y archivos de localización. Mételos en una carpeta de Slima y pide: “Compara mi escena del juzgado del capítulo seis con ‘documentacion/procedimiento-judicial.md’: ¿hay algo que no cuadre?”. O “Saca de mis notas de entrevista los detalles sobre el trabajo en el muelle y arma una referencia de escena en la carpeta.” La IA lee tus archivos de documentación directamente, los contrasta entre sí y devuelve los datos al libro: la verosimilitud deja de depender de tu memoria.

6. En la calle, colaborar desde el móvil

Como el conector web está en la nube y no requiere instalación local, puedes usarlo desde la app de claude.ai en el móvil. En el transporte, en la cola, en una cafetería: cuando llega una idea, di “Lee la última escena del capítulo ocho y proponme tres maneras de seguir”, o “Añade esta línea de diálogo al final de ‘ideas.md’.” Abre Slima de vuelta en el escritorio y está todo sincronizado. El móvil captura e idea; el ordenador escribe en serio, y nada viaja por correo entre ambos.

Preguntas frecuentes

¿Puede ver alguien mi contenido? No. MCP solo toca los libros de la cuenta que autorizaste; la IA lee o escribe solo cuando se lo pides y nunca comparte nada.

¿Puedo dejar que la IA lea pero no edite? Sí. Di “solo lectura hoy” al principio y se ceñirá a las herramientas de lectura (read_file, search_content).

¿Las herramientas no responden tras configurarlas? En instalaciones locales casi siempre es un error de JSON (coma de más, llave de menos, comillas de ancho completo): valida el archivo y luego ejecuta npx slima-mcp@0 status. En el conector web, confirma que la URL es https://mcp.slima.ai/mcp y que terminaste la aprobación.

¿Necesito Node.js en el móvil? No. En el móvil usas el conector web (la app de claude.ai / ChatGPT); nada de línea de comandos.

Tres minutos, un flujo de trabajo mejor para siempre

El camino más corto: en claude.ai, ve a Customize → Connectors, añade un conector personalizado con la URL https://mcp.slima.ai/mcp, apruébalo y listo. A partir de ahí —escritorio o móvil— solo dile a la IA “enséñame por dónde iba ayer” y va a leer tu libro por su cuenta.

El tiempo va en la historia. No en copiar y pegar.

Guía completa de Slima MCP: deja que la IA lea y escriba tu libro