Slima MCP

Servidor MCP (Protocolo de Contexto de Modelo) para Slima - IDE de escritura con IA para autores de novelas.

Conecta tus libros de Slima a cualquier herramienta de IA compatible con MCP: un servidor, todas las plataformas.

Plataformas compatibles

Aplicaciones de escritorio (MCP local - stdio)

Aplicaciones web (MCP remoto - HTTP)

MCP se convirtió en el estándar de la industria en diciembre de 2025 cuando Anthropic, OpenAI y Block cofundaron la Fundación de IA Agéntica bajo la Fundación Linux.

Related MCP server: scrumdo-mcp

Características

Gestión de libros

• Crear nuevos libros

• Listar y ver tus libros

• Obtener estructura de archivos/carpetas

• Seguimiento de estadísticas de escritura

Operaciones con archivos

• Leer cualquier archivo por ruta

• Editar texto específico (buscar y reemplazar)

• Escribir (reemplazar) contenido de archivo

• Crear nuevos archivos

• Eliminar archivos

• Añadir contenido a archivos

• Buscar en todos los archivos

Lector beta de IA

• Obtén comentarios de personajes lectores virtuales

• Analiza capítulos desde diferentes perspectivas de lectores

Inicio rápido

Elige la ruta que coincida con cómo usas la IA:

• ⭐ Usas claude.ai / ChatGPT en un navegador web → Recomendado: conector web (configuración única, actualizaciones automáticas para siempre)

• Usas Claude Desktop / Cursor / Gemini CLI localmente → Instalación local con npx

• Ejecutas en entornos aislados / empresariales → Autoalojado

Recomendado: claude.ai / ChatGPT Web (actualización automática)

Si conversas con Claude o ChatGPT en un navegador, esta es la opción más fácil y a prueba de futuro. Configura una vez y recibirás automáticamente cada actualización de Slima MCP — sin comandos de actualización, sin ediciones de configuración.

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

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

1. Inicia sesión en claude.ai.

2. Abre Configuración → Conectores (o Integraciones según tu plan).

3. Haz clic en Añadir conector personalizado.

4. Rellena:

   • Nombre: Slima

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

5. Haz clic en Conectar → serás redirigido a slima.ai para aprobar → regresa a claude.ai.

6. El icono de herramientas de Slima aparece en tu entrada de chat. Has terminado.

ChatGPT (Plus / Pro, Modo Desarrollador)

1. Inicia sesión en chatgpt.com.

2. Abre Configuración → Conectores → Avanzado y activa Modo Desarrollador (2025.10+).

3. De vuelta en Conectores, haz clic en Crear → Servidor MCP personalizado.

4. Rellena:

   • Nombre: Slima

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

   • Autenticación: OAuth

5. Haz clic en Crear → aprueba el flujo OAuth.

Después de la configuración, las funciones de Slima se despliegan automáticamente en tu próxima conversación. Sin reinicios, sin reinstalaciones.

Local: Claude Desktop / Cursor / Gemini CLI

Usa esto si prefieres un funcionamiento sin conexión, un inicio más rápido, o necesitas ejecutar MCP junto con otros servidores stdio.

Configuración recomendada — anclada a la versión principal para que recibas nuevas funciones automáticamente pero nunca se rompa en una versión 1.0:

Claude Desktop

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

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

Obtén tu token desde Configuración de Slima o ejecuta npx slima-mcp@0 auth una vez para guardarlo en disco.

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"

¿Por qué slima-mcp@0 en lugar de slima-mcp / slima-mcp@latest? Usar @0 ancla a la versión principal actual — npx sigue obteniendo nuevas versiones 0.x.y automáticamente (para que recibas funciones y correcciones de errores), pero cuando lancemos 1.0.0 con cambios importantes, no lo adoptarás silenciosamente sin actualizar tu configuración. Anunciaremos el cambio a @1 en las notas de la versión.

Migrar desde una instalación global

Si ya instalaste globalmente con npm install -g slima-mcp:

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

O, si prefieres mantener una instalación global, recuerda ejecutar periódicamente:

npm install -g slima-mcp@latest

De lo contrario, tu cliente local se desviará de las herramientas/esquema MCP que expone el backend de Slima.

Autoalojado (avanzado)

También puedes clonar este repositorio e implementar el Worker de Cloudflare tú mismo. Consulta wrangler.toml + npm run deploy:worker. No es necesario para uso normal.

Seguridad MCP remota

El servidor MCP remoto alojado en https://mcp.slima.ai/mcp utiliza:

• OAuth 2.0 + PKCE para autenticación — sin copiar y pegar tokens.

• Sin secretos almacenados en el servidor — las credenciales nunca salen del servidor de autenticación de Slima.

• Basado en sesión: los tokens OAuth se almacenan en Cloudflare KV, con alcance por sesión.

• Revocable en cualquier momento desde Configuración de Slima.

Tipos de libro: Writing Studio vs Script Studio

Los libros de Slima vienen en dos variantes, distinguidas por el campo book_type. MCP se comporta de manera ligeramente diferente para cada uno:

Para obtener detalles específicos de cada libro, pide a tu cliente de IA que lea el recurso slima://books/{book_token}/schema — devuelve una especificación JSON de exactamente qué rutas son editables/solo lectura para ese libro en particular.

list_books etiqueta cada libro con su icono de estudio (📝 / 📖) para que tú (y la IA) puedan distinguirlos de un vistazo.

Herramientas disponibles

Gestión de libros

Operaciones con archivos

Lector beta de IA

Ejemplos de uso

Una vez configurado, puedes pedirle a tu IA:

Libro y contenido:

• "Crea un nuevo libro llamado 'Mi Novela'"

• "Lista mis libros en Slima"

• "Muéstrame la estructura de mi novela"

• "Lee el capítulo 3 de mi libro"

• "¿Cuáles son mis estadísticas de escritura?"

Operaciones con archivos:

• "Lee el perfil del personaje de mi protagonista"

• "Edita el capítulo 1 y cambia 'Juan' por 'Santiago'"

• "Crea un nuevo archivo llamado worldbuilding.md con notas sobre el sistema de magia"

• "Busca todas las menciones de 'ojos azules' en mi libro"

• "Añade este nuevo párrafo al capítulo 5"

Comentarios de IA:

• "Obtén comentarios sobre el capítulo 5 desde la perspectiva de un lector joven"

• "Analiza mi escena inicial desde la perspectiva de un crítico"

Comandos CLI

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

El token se almacena en ~/.slima/credentials.json con permisos seguros.

Variables de entorno

*No requerida si usaste slima-mcp auth

Desarrollo

Desarrollo local de CLI

# 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

Desarrollo de Cloudflare Worker

# 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

Estructura del proyecto

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

Seguridad

• Los tokens de API se almacenan localmente y nunca se comparten

• Toda la comunicación con la API de Slima utiliza HTTPS

• Los tokens se pueden revocar en cualquier momento desde la configuración de Slima

Publicación e implementación

npm (Automático)

La fusión a main con un aumento de versión en package.json desencadena la publicación automática en npm a través de GitHub Actions.

# 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 (Manual)

La implementación del Worker es independiente de npm. Implementa después de cambios en el código:

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

Registro MCP (Manual)

Para publicar/actualizar la lista del servidor en el Registro MCP:

mcp-publisher login github
mcp-publisher publish

Requiere mcpName en package.json y server.json en la raíz del repositorio.

Notas operativas

Depuración del Worker OAuth

Al solucionar problemas con el conector de claude.ai o ChatGPT:

# Live logs from production Worker
wrangler tail slima-mcp

Todos los puntos de conexión OAuth registran parámetros clave (client_id, redirect_uri, prefijo del token, etc.) para ayudar a rastrear el flujo.

Flujo OAuth del Worker (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})

Limitaciones conocidas

• La validación del token Bearer del Worker acepta todos los tokens no vacíos (no solo el prefijo slima_) para admitir tokens emitidos por OAuth. La API de Rails realiza la validación real.

• getTokenFromSession() verifica primero el encabezado Authorization, luego recurre a la sesión de cookie.

• El Inspector MCP (npx @modelcontextprotocol/inspector) es útil para probar el flujo completo de OAuth de forma independiente.

Licencia

MIT

Enlaces

• Sitio web de Slima

• Aplicación Slima

• Documentación de MCP

• Registro de MCP

• Reportar problemas