Sprint de Manuscrito en 30 Días — Solo quedan 10 plazas. Aplica Ahora →
Guía de usuario de Slima

Guía Completa de Slima MCP: Conecta tu Libro con la IA

13 min de lectura T Tim
Disponible en: 繁體中文 English العربية Español

Slima MCP: conecta tu libro con la IA en tres minutos


Copiar. Pegar. Copiar otra vez. Pegar otra vez.


Abres la ficha del personaje en Slima, seleccionas todo, copias. Cambias a la ventana de Claude, pegas. Abres el capítulo ocho, seleccionas todo, copias. Vuelves a Claude, pegas de nuevo. Escribes una frase: "Compara estos dos documentos y dime si hay contradicciones." La IA responde algo, pero no captó la pista que dejaste en el capítulo tres porque nadie le pasó el capítulo tres. Tampoco sabe que existe un archivo de worldbuilding. Entonces vuelves a Slima. Otro archivo. Otro copiar. Otro pegar.


Una tarde entera. Perdida no en escribir -- en transportar texto.


El dolor tiene una causa concreta: la IA no puede ver tu libro. Solo ve los pedazos que le entregas a mano. La solución tampoco es complicada: Slima MCP. Tres minutos de configuración, y la IA accede directamente a tus libros en Slima. Sin portapapeles. Sin intermediarios.


¿Qué es MCP?


MCP significa Model Context Protocol, un estándar abierto de Anthropic. El nombre suena técnico, pero el concepto cabe en una oración: permite que las herramientas de IA intercambien datos directamente con servicios externos.


Sin MCP, la IA está ciega. Ve únicamente lo que aterriza en la ventana del chat -- fragmentos pegados a mano. No sabe que tus fichas de personajes existen. No puede consultar capítulos anteriores. No tiene idea de dónde guardas las notas de tu mundo ficticio. Quien escribe se convierte en mensajero, cargando texto de un lado a otro.


Con MCP: "Verifica si las acciones del protagonista en el capítulo ocho contradicen su ficha de personaje." La IA recupera ambos archivos por su cuenta, los compara, reporta. Sin copiar. Sin pegar. Sin contexto perdido.


Si hace falta una analogía -- MCP es el USB de la inteligencia artificial. Antes de USB, cada fabricante tenía su conector propietario. USB le dio a todos una interfaz común: conectas cualquier dispositivo a cualquier computadora, funciona. Mismo principio. Claude Desktop, Cursor, Gemini CLI, VS Code -- cualquier herramienta que soporte MCP puede conectarse a Slima y trabajar con manuscritos directamente.


Slima MCP
es un paquete npm (slima-mcp). Se instala, se configura, y las herramientas de IA obtienen acceso en tiempo real a los libros en Slima. Lectura, edición, búsqueda -- todo en vivo, todo instantáneo.


Instalación y autenticación


Dos cosas nada más: Node.js instalado en la máquina y una cuenta de Slima.


Paso 1: autenticación


Abre la terminal. Un comando:

npx slima-mcp auth


El navegador se abre, guía el inicio de sesión con la cuenta de Slima. Listo.


El token de autenticación se guarda en el gestor de credenciales nativo del sistema operativo: Keychain en macOS, Credential Manager en Windows, libsecret en Linux. No es un archivo de texto en alguna carpeta olvidada. Es seguridad a nivel de sistema operativo -- el mismo mecanismo que protege contraseñas guardadas y llaves de cifrado. Aunque alguien revisara cada directorio del disco duro, no encontraría ningún archivo de token que robar.


El token se refresca automáticamente. Casi nunca hay que volver a iniciar sesión. Para verificar el estado:

npx slima-mcp auth --status


Para cerrar sesión:

npx slima-mcp auth --logout


Eso es todo con la autenticación. Siguiente paso.


Configuración por plataforma


Después de autenticarse, hay que decirle a la herramienta de IA dónde encontrar Slima MCP. Los archivos de configuración varían ligeramente entre plataformas, pero el núcleo es idéntico: indicarle a la herramienta que ejecute slima-mcp mediante npx.


Claude Desktop


Localiza claude_desktop_config.json. En macOS suele estar en ~/Library/Application Support/Claude/, en Windows en %APPDATA%\Claude\. Agrega:

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["slima-mcp"]
    }
  }
}


Reinicia Claude Desktop. Aparece un ícono de herramienta junto al campo de entrada -- Slima MCP conectado.


Cursor


Crea .cursor/mcp.json en la raíz del proyecto:

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["slima-mcp"]
    }
  }
}


Cursor lo detecta automáticamente y lanza Slima MCP cuando es necesario.


Gemini CLI


Edita ~/.gemini/settings.json:

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["slima-mcp"]
    }
  }
}


VS Code


Crea .vscode/mcp.json dentro del proyecto:

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


Ojo -- VS Code usa servers, no mcpServers. Es la confusión más frecuente. Si la conexión no funciona, revisa esa clave primero.


Con cualquiera de estas configuraciones en su lugar, la herramienta puede interactuar con libros de Slima directamente. Sin pasos adicionales.


Quince herramientas en tres categorías


Slima MCP ofrece quince herramientas en tres grupos: gestión de libros, operaciones de archivos y AI Beta Reader. En lugar de una lista seca de funcionalidades, veamos cómo suena cada una en conversación real con la IA.


Gestión de libros


create_book
-- Crea un libro nuevo. Una idea fresca aparece: "Crea un libro en Slima que se llame El último tren." La IA lo construye y puede inmediatamente armar carpetas para personajes, worldbuilding y estructura.


list_books
-- Muestra todo. "¿Qué libros tengo ahora mismo?" Una frase, inventario completo, se elige el proyecto.


get_book
-- Detalles de un libro específico. Título, autoría, descripción, fecha de creación. Lo básico de un vistazo.


get_book_structure
-- El árbol completo de archivos y carpetas. Esta herramienta le da a la IA una visión panorámica. "Muéstrame la estructura completa de esta novela." La IA ve cada capítulo, cada ficha de personaje, cada carpeta de notas. Con ese mapa, cada solicitud posterior aterriza con más precisión.


get_writing_stats
-- Estadísticas de escritura. "¿Cómo va mi progreso?" La IA desglosa el conteo total de palabras, conteo por capítulo, frecuencia de actualizaciones. Los números no mienten sobre el impulso.


Operaciones de archivos


read_file
/ get_chapter -- Las herramientas de uso diario. "Lee el capítulo cinco." "Abre la ficha del protagonista." "Muéstrame las notas del sistema de magia." Una vez que la IA lee el texto real, su retroalimentación se basa en lo que existe en la página -- no en consejos genéricos flotando en el vacío.


write_file
-- Reemplaza el contenido completo de un archivo. Para reescrituras mayores. "Sustituye el capítulo tres por la versión que acabamos de trabajar." El archivo entero se reemplaza.


edit_file
-- Búsqueda y reemplazo quirúrgico. Más preciso que write_file. "Cambia cada 'Doctora Ramos' por 'Doctora Fuentes' en el capítulo uno." Sustitución exacta, nada más se toca.


create_file
-- Construye archivos nuevos. "Crea una ficha de villano en la carpeta de personajes." La IA crea el archivo y lo llena con contenido inicial.


delete_file
-- Elimina lo que ya no sirve. Notas viejas de lluvia de ideas, esquemas descartados, borradores temporales. Limpieza sin salir de la conversación.


append_to_file
-- Agrega contenido al final de un archivo sin sobrescribir. Ideal para diarios de escritura y registros de sesión. "Agrega las notas de progreso de hoy al final de mi diario de escritura."


search_content
-- Búsqueda de texto completo en todos los archivos del libro. La joya de la corona. "Busca en toda la novela cada mención de 'el reloj de bolsillo'." O: "Encuentra todos los párrafos donde aparece el inspector León." Rastrea cada archivo, devuelve todas las coincidencias. Para mantener la consistencia de personajes y la continuidad de la trama en un manuscrito largo -- esta herramienta no tiene precio.


AI Beta Reader


list_personas
-- Explora los perfiles de lectores virtuales disponibles. Los AI Beta Readers de Slima no son máquinas de retroalimentación genérica. Cada perfil tiene una especialización distinta: estructura narrativa, desarrollo de personajes, análisis de ritmo, viabilidad comercial. "¿Qué perfiles de Beta Reader hay disponibles?" Se revisan las opciones, se elige el que encaje con la necesidad del momento.


analyze_chapter
-- Envía un capítulo a un perfil específico para análisis profundo. "Usa el perfil de analista de ritmo para revisar el capítulo tres." El perfil lee el capítulo y entrega retroalimentación de nivel profesional: ritmo, curvas de tensión, arcos de personaje, puntos débiles potenciales. Como tener un lector beta de guardia -- salvo que los resultados llegan en minutos, no en semanas.


Cuatro escenarios comunes


Conocer las herramientas es una cosa. Saber cuándo combinarlas -- eso es lo que transforma el proceso de escritura.


Escenario 1: empezar la jornada de escritura


Sentarse. Abrir la herramienta de IA. Primer mensaje:


"Muéstrame la estructura del libro y luego lee la última sección del capítulo en el que trabajé ayer."


La IA lanza get_book_structure para mapear el proyecto, después read_file para abrir el capítulo más reciente. Podría responder: "Ayer terminaste a mitad de escena -- el protagonista acababa de llegar a la estación abandonada y encontró la primera pista. Según el esquema, el siguiente momento es el encuentro con el maquinista. ¿Arrancamos?"


Sin buscar archivos. Sin releer el esquema. Sin intentar recordar dónde quedó todo. El contexto ya está cargado. La escritura empieza de inmediato.


Escenario 2: verificar la consistencia de un personaje


Capítulo quince. Una duda que no para: ¿qué dijo exactamente ese personaje secundario en el capítulo tres? En una novela larga, esto pasa todo el tiempo.


"Busca en todo el libro cada pasaje donde aparece el inspector León."


La IA ejecuta search_content, reúne cada mención, organiza las palabras y acciones del personaje capítulo por capítulo. Tal vez emerge una contradicción: en el capítulo tres juró que nunca viaja de noche, pero en el capítulo doce aparece en el tren nocturno. ¿Pista deliberada? ¿Error accidental? Sea como sea, la evidencia queda expuesta en segundos. Sin revisar manualmente docenas de páginas.


Escenario 3: la fase de revisión


Primer borrador terminado. Hora de revisar. Capítulo por capítulo, cada uno pasa por un AI Beta Reader:


"Analiza el capítulo uno con el perfil de analista de ritmo."


analyze_chapter se ejecuta, devuelve retroalimentación: dónde el ritmo se arrastra, dónde las transiciones son bruscas, dónde el lector podría desconectarse. Se revisan las notas, se decide qué cambiar, y entonces:


"La descripción del andén en el tercer párrafo del capítulo uno es demasiado larga. Recórtala -- conserva las imágenes centrales pero reduce la extensión a la mitad."


La IA usa edit_file para modificar ese pasaje específico. Nada más en el capítulo cambia. Sin reescritura completa. Sin buscar el párrafo a mano.


Escenario 4: consolidar el worldbuilding


Una novela con un sistema de reglas elaborado. Normas dispersas en capítulos, notas sueltas, fichas de personajes. Ni la propia autoría recuerda qué detalle vive dónde.


"Busca en todo el libro cada pasaje que describe las reglas del sistema ferroviario, luego consolídalos en un documento de referencia unificado y guárdalo en la carpeta de worldbuilding."


La IA encadena search_content para localizar fragmentos, read_file para extraer el contexto completo, después create_file para producir una referencia limpia y organizada. Piezas dispersas en veinte archivos se convierten en una guía autoritativa. Este tipo de orquestación multiarchivo es donde MCP brilla con más fuerza -- la IA no solo responde preguntas. Ejecuta flujos de trabajo completos.


Consejos avanzados


Variables de entorno


Para depuración, se pueden agregar variables de entorno a la configuración y obtener registros detallados de Slima MCP:

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["slima-mcp"],
      "env": {
        "SLIMA_LOG_LEVEL": "debug"
      }
    }
  }
}


El nivel debug produce información detallada de cada llamada a la API. Una vez resuelto el problema, conviene volver al nivel predeterminado para mantener los registros limpios.


MCP remoto


Por defecto, Slima MCP usa transporte stdio -- se ejecuta localmente. Pero también soporta transporte HTTP remoto. Un servidor ejecutando MCP, múltiples dispositivos conectándose. Del escritorio a la laptop a la tablet -- el modo remoto significa que no hace falta instalar Node.js en cada máquina.


Elegir la plataforma según la tarea


Múltiples plataformas, todas conectadas a la misma cuenta de Slima, los mismos libros. La elección depende de lo que se necesite:

  • Claude -- Comprensión de contexto largo en su mejor expresión. Analizar capítulos completos, verificar consistencia de personajes, discusiones profundas sobre lógica de la trama. Aquí es donde destaca.
  • Cursor -- Construido para operaciones de lote precisas. Búsqueda y reemplazo, ajustes de formato, ediciones de texto a gran escala. Máxima eficiencia.
  • Gemini -- Capacidades multilingües sobresalientes. Traducción, comparación entre idiomas, consolidación de información. El ajuste natural.

Misma cuenta, mismos libros, cambiar en cualquier momento.


Preguntas frecuentes


P: ¿MCP permite que alguien más vea mi contenido?


No. Slima MCP accede únicamente a los libros de la cuenta autenticada. Los permisos del token están limitados a un solo usuario. La IA lee o modifica contenido solo bajo instrucción directa -- no navega la biblioteca por su cuenta ni comparte datos con terceros.


P: ¿Puedo restringir la IA a solo lectura?


Sí. Las herramientas MCP se dividen en operaciones de lectura (read_file, search_content) y operaciones de escritura (write_file, edit_file). Las plataformas de IA suelen pedir confirmación antes de ejecutar escrituras. Basta con decir al inicio de la conversación "hoy solo lectura, sin ediciones" y la IA se limita a herramientas de lectura durante toda la sesión.


P: Configuré todo pero la herramienta de IA no responde. ¿Qué hago?


Causa más común: JSON mal formado en el archivo de configuración. Una coma de más, una llave faltante, unas comillas de ancho completo -- cualquiera de estos errores causa un fallo silencioso. Primero, validar el JSON. Después, ejecutar npx slima-mcp auth --status para confirmar la autenticación. Esos dos pasos resuelven la gran mayoría de los problemas.


P: ¿El token de autenticación caduca?


Se refresca automáticamente en segundo plano. En uso normal, la caducidad es prácticamente inexistente. Si llega a ocurrir, basta con ejecutar npx slima-mcp auth otra vez -- treinta segundos y queda resuelto.


Tres minutos. Cambio permanente.


Esto es lo que cubrió este artículo.


MCP es un protocolo estandarizado que permite a la IA leer y escribir datos de servicios externos directamente -- se acabó el copiar y pegar manual. Configuración: npx slima-mcp auth para autenticarse, unas cuantas líneas de JSON en la configuración de la herramienta de IA. Tres minutos. Quince herramientas abarcan gestión de libros, operaciones de archivos y AI Beta Reader -- desde leer capítulos hasta buscar manuscritos enteros hasta tener lectores virtuales analizando la obra. Todo mediante lenguaje natural.


Lo que MCP cambia se resume en una frase: transforma a la IA de una herramienta que espera a que le den datos en una compañera que puede buscar las cosas por sí misma.


El tiempo debería invertirse en escribir la historia. No en cargar texto entre ventanas.


Abrir una terminal. Ejecutar npx slima-mcp auth. Volver a la herramienta de IA y decir: "Muéstrame dónde me quedé ayer."


La escritura puede ser más enfocada ahora.

Artículos Relacionados