Slima MCP

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

Configuración inicial de MCP

• 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).

Conexión web (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.

Conexión local (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.

Tokens de API

• 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.

Versiones y actualizaciones

• 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.
• 03 Cómo funcionan las versiones de slima-mcp 0.3.0 (2026-09-09). El servidor nunca bloquea un cliente antiguo; un cliente antiguo solo tiene menos herramientas. Cómo comprobar tu versión y cómo actualizar.

Referencia de herramientas

• 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 Argumentos y comportamiento de read_file / edit_file / write_file / create_file / delete_file / append_to_file / search_content, y los tipos de archivo que este grupo no puede tocar.
• 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.
• 04 Herramientas de edición estructurada (update_*) Cómo las herramientas update_* cambian una escaleta, una cronología, un guion, un mapa de relaciones o un mapa del mundo: una operación a la vez, encadenado con op_ref y lotes de todo o nada.
• 05 Herramientas de notas y comentarios Deja que una IA externa lea y escriba notas y entre en el circuito de comentarios: list_notes / create_note / list_comments / create_comment / resolve_comment / reopen_comment.
• 06 Búsqueda semántica y búsqueda de texto semantic_search busca por significado y search_content por palabras. Qué pregunta le toca a cada herramienta y cómo se construye el índice.

Tipos de archivo y permisos

• 01 Qué puede hacer MCP con cada tipo de archivo La tabla completa: los archivos de prosa aceptan escrituras completas, los cinco tipos estructurados pasan por herramientas a nivel de campo, algunos tipos no aceptan ninguna de las dos, y las reglas de ruta de los libros antiguos de Script Studio.
• 02 Protección de archivos estructurados: cómo leer un rechazo Qué significan AI_READONLY_FILE_TYPE, SUBSCRIPTION_REQUIRED, INVALID_PATH y FOLDER_NOT_EMPTY, y cuál es el paso correcto después de cada uno.
• 03 Herramientas que se comportan distinto en ciertos archivos Las excepciones de read_file, search_content, semantic_search, analyze_chapter, get_writing_stats, create_file y delete_file, y qué hacer con cada una.

Avanzado: esquema y autoalojamiento

• 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.
• 03 Guías y habilidades de escritura get_capabilities, las guías de operación de Slima y sus habilidades de escritura: cómo Slima le entrega sus propias reglas a tu herramienta de IA.
• 04 Dejar que una IA vea un mapa de relaciones view_relationship_map devuelve una imagen más un resumen legible, mucho mejor que leer el JSON en crudo de un .map, y las cuatro respuestas con las que te vas a topar.

Solución de problemas

• 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 Escritura rechazada: qué hacer Qué significan AI_READONLY_FILE_TYPE, SUBSCRIPTION_REQUIRED, INVALID_PATH y FOLDER_NOT_EMPTY, más el caso de create_file que funciona y deja un archivo vacío.
• 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.