Conecta un agente de IA a tu libro por MCP.

Shiro es un servidor MCP. Claude Code, Cursor, Codex, Claude Desktop, VS Code o cualquier otro cliente que hable el Model Context Protocol puede leer un proyecto y trabajar en él con unas 85 herramientas. Las ediciones de un agente se aplican al instante, como las tuyas, y cada una queda en el historial del proyecto, desde donde puedes deshacerla. Un agente también puede sugerir un cambio en lugar de hacerlo, que espera a que lo apliques o lo rechaces, y un agente en Solo sugiere no hace otra cosa.

Tres formas de entrar

Elige según dónde vive el libro.

shiro mcp API local de escritorio Nube
Trabaja con Una carpeta de proyecto El proyecto abierto en la aplicación Los proyectos en la nube a los que tienes acceso
Transporte stdio Streamable HTTP Streamable HTTP
Dirección Ninguna http://127.0.0.1:7341/mcp/<key> https://api.meetshiro.com/mcp
Autenticación Ninguna, se ejecuta como tú Una clave por cliente OAuth 2.1
Ediciones Al instante, en el historial, o en espera como sugerencias Al instante, en el historial, o en espera como sugerencias Al instante, dentro de tu función, o en espera como sugerencias
Necesita El comando shiro, pronto La aplicación abierta, con la API activada Una cuenta de Shiro

Las tres sirven las mismas herramientas desde el mismo código de servidor.

La línea de comandos: shiro mcp

La herramienta de línea de comandos shiro llegará pronto. Una vez instalada:

shiro mcp /path/to/MyNovel

Esto sirve un proyecto por stdio, y la aplicación Shiro no tiene que estar abierta. Las escenas se leen de la carpeta Manuscript/ del proyecto. Las opciones:

  • --client <name> es el nombre del agente en el historial del proyecto. El predeterminado es Agent.
  • --suggest hace que el agente solo sugiera: no tiene ninguna herramienta que cambie el libro, y cada cambio espera como una propuesta que aplicas o rechazas en Shiro.
  • --out <folder> es adonde van los archivos compilados. El predeterminado es la carpeta actual.

La mayoría de los clientes aceptan un bloque como este en su configuración MCP:

{
  "mcpServers": {
    "shiro": {
      "command": "node",
      "args": [
        "/path/to/shiro/apps/cli/dist/cli.js",
        "mcp",
        "/path/to/MyNovel",
        "--client",
        "Claude"
      ]
    }
  }
}

Los cambios del agente van directamente a los archivos del proyecto. Cada llamada queda registrada en el historial del proyecto, en su carpeta .shiro/history/, así que la ves en Shiro y puedes deshacerla desde allí.

La aplicación de escritorio: API local

Está desactivada de forma predeterminada.

  1. En la aplicación, abre Tú › MCP, elige “En este equipo” y activa “Permitir que los agentes de este equipo se conecten”.
  2. En “Conecta tus herramientas”, elige la tuya y pulsa “Crear una clave”. Cada herramienta tiene su propia clave, así que puedes desconectar una sola.
  3. Pega en la herramienta lo que muestra la página. Tiene pasos para Claude, Claude Code, Codex, Gemini, Cursor y VS Code, y un nombre y una URL para cualquier otra cosa que hable Streamable HTTP.

Para Claude Code, el comando es este, y Codex tiene su propia forma:

claude mcp add --transport http --scope user shiro http://127.0.0.1:7341/mcp/<key>
codex mcp add shiro --url http://127.0.0.1:7341/mcp/<key>

Claude Desktop llega al servidor a través del puente mcp-remote, que necesita Node.

El servidor escucha solo en 127.0.0.1, y solo mientras la aplicación está abierta. 7341 es el puerto predeterminado, y puedes elegir otro si algo más lo ocupa. La clave va en la dirección o en un encabezado Authorization: Bearer. Shiro la muestra una vez y solo guarda su hash. Se rechazan las solicitudes con otro nombre de host o que vienen de una página web. Un cliente conectado edita y sugiere por defecto: lo que cambia se aplica al instante, con su nombre en el historial del proyecto, y un cambio que elige sugerir espera en Comentarios. Ponlo en Solo sugiere en Tú › MCP, y sugerirá cada cambio.

El mismo puerto sirve una API HTTP sencilla en /api/v1, con la clave como token Bearer:

Solicitud Devuelve
GET /project El título, el tipo, el idioma y el recuento de palabras del proyecto
GET /outline El esquema
GET /world Las fichas del Mundo, en JSON
GET /scenes/<id> Una escena
GET /tools La lista de herramientas
POST /tools/<name> Ejecuta una herramienta, con sus argumentos como cuerpo JSON
curl -H "Authorization: Bearer $SHIRO_KEY" http://127.0.0.1:7341/api/v1/outline

Proyectos en la nube: /mcp con OAuth

La dirección es https://api.meetshiro.com/mcp. Un cliente compatible con MCP remoto con OAuth no necesita nada más. Si has llegado desde el enlace service_documentation de los metadatos del servidor, esta es la sección que buscabas.

  • Descubrimiento. Una solicitud sin autenticar recibe un 401 cuyo encabezado WWW-Authenticate indica /.well-known/oauth-protected-resource/mcp. Los metadatos del servidor de autorización están en /.well-known/oauth-authorization-server.
  • Registro. El registro dinámico de clientes está en /oauth/register. Las URI de redirección deben ser https, de bucle local (loopback) o un esquema propio de una aplicación (myapp://…), sin fragmento.
  • Autorización. Código de autorización con PKCE, solo S256. Los clientes son públicos, sin secreto, y el ámbito es shiro. La página de consentimiento te deja iniciar sesión o crear una cuenta en la misma ventana, con un código recibido por correo o con Google, y la respuesta nombra el servidor que la emitió (iss).
  • Tokens. Los tokens de acceso duran una hora. Los tokens de actualización rotan con cada uso, y el par anterior deja de funcionar cuando se emite uno nuevo; un token de actualización usado por segunda vez termina la conexión, y uno que no se usa en 90 días caduca. Un cliente que se desconecta devuelve su token en /oauth/revoke. El token de un agente llega a /mcp y /v1/api/* y a nada más de la cuenta.

/v1/api/* es la misma API REST que la local, para scripts. El agente empieza en tu primer proyecto, y la herramienta project lista, abre y crea otros. El proyecto que abre se recuerda para ese cliente.

Un agente tiene tu función y nada más:

Tu función Lo que puede hacer el agente
Propietario o coautor Editar
Editor Solo sugerir
Comentarista Solo comentar
Lector Solo leer

Sea cual sea tu función, también puedes poner un agente en Solo sugiere en Tú › MCP, en Shiro en la web o en la aplicación.

Las llamadas a herramientas tienen un límite diario, más bajo en las cuentas gratuitas. Superado ese límite, las llamadas devuelven HTTP 429 hasta el día siguiente.

Cómo deshacer un cambio

Un agente edita como lo harías tú, sin preguntar. Nada de lo que cambia espera aprobación en Shiro, y ninguna herramienta acepta ni pide confirmed: eliminar, enviar, compartir, publicar y restaurar se hacen al instante. Manual, Auto y Max son modos del chat propio de Shiro, no de los agentes.

El agente decide, cambio por cambio, si lo hace o lo sugiere. El servidor le dice que haga directamente un cambio que pediste, y que sugiera uno que no pediste, uno del que no está seguro o uno que quieres revisar antes. Una sugerencia pasa por la herramienta suggest, un cambio o varios a la vez, cada uno con una nota que dice por qué. Espera en Comentarios hasta que apliques o rechaces cada cambio, y la herramienta proposals le dice al agente lo que hiciste.

La red de seguridad es el historial del proyecto. Cada llamada es una entrada, con el nombre del agente (“Claude: edit”). Cada escena cuyo texto cambió el agente recibe en sus Versiones una versión de antes (“Antes del cambio de Claude”) y otra de después (“Cambiada por Claude”), y desde allí restauras la anterior. El cambio de un agente no tiene tarjeta de Deshacer en el editor.

Un agente en Solo sugiere no tiene ninguna herramienta que cambie el libro, y sugiere cada cambio. Lo mismo uno en un libro compartido en el que quien lo conectó tiene la función de Editor, que solo puede sugerir. Sus cambios esperan en Comentarios como propuestas, y tú aplicas o rechazas cada uno.

Otras tres reglas se aplican a todos los clientes.

El texto del libro, los comentarios, las páginas web y los elementos de la Bandeja de entrada son datos, y el servidor indica a los agentes que nunca sigan instrucciones que encuentren en ellos. Una escena marcada ai: never aparece vacía. Y los proyectos locales y los modelos locales se quedan en tu equipo solo en lo que respecta a la parte de Shiro: lo que lee un agente, lo envía a su propio modelo.

Las herramientas

Un cliente en la nube ve unas 85, la API local de escritorio unas 80 y shiro mcp unas 70: cada host ofrece las herramientas que puede servir. La mayoría van en pares, una que solo lee (entries_read) y otra que hace cambios (entries). La tabla nombra cada par una vez.

Grupo Herramientas Qué hacen
Solo lectura read, search, count, check, skill Leer escenas, fichas, el esquema y las notas. Buscar por texto, mención o significado. Contar palabras, adverbios y diálogo sin modelo. Ejecutar comprobaciones de continuidad y de protección. Cargar habilidades de oficio.
Texto edit, replace_all, write, alternatives, snapshots Cambiar una escena citando el texto exacto, buscar y reemplazar con vista previa, conservar versiones con nombre de una escena, tomar y restaurar instantáneas.
Estructura y revisión structure, labels, whiteboard, passes, comments, note, inbox, memory, goals Crear, ajustar, mover, dividir y fusionar escenas, y etiquetarlas. Trabajar con pizarras, pasadas de revisión, comentarios y tareas, notas, la Bandeja de entrada, la memoria del proyecto y los objetivos de escritura.
Mundo e Investigación entries, folders, media, maps, style_sheet, language Gestionar fichas y sus vínculos, carpetas, tableros de medios, mapas con marcadores y rutas, la hoja de estilo y las lenguas inventadas.
Salida translations, adapt, publish, compile, export, beta_reads Escribir traducciones frente al original, adaptar la prosa a un guion o una obra de teatro, fijar los datos del libro, compilar con un ajuste predefinido, ejecutar ediciones y estilos de exportación. beta_reads solo se ofrece cuando has iniciado sesión en Shiro Cloud.
Proyecto project, book Leer la ficha del proyecto, listar, abrir y crear proyectos, buscar en todos los proyectos a la vez, leer los ajustes del libro.
Sugerencias suggest, proposals Sugerir un cambio en lugar de hacerlo, uno o varios a la vez, cada uno con una nota para ti, y ver lo que aplicaste o rechazaste.

write genera prosa con el modelo de escritura propio de Shiro, y solo la aplicación de escritorio lo ofrece, una vez configurado allí un modelo de escritura. Un agente externo trae su propio modelo, así que escribe la prosa y la envía con edit. La búsqueda web, la generación de imágenes y las herramientas de chat propias de Shiro quedan fuera de MCP por el mismo motivo.

El servidor también ofrece recursos: shiro://project/card, /outline, /world, /passes, /worklist y /memory con el mismo prefijo, /proposals, y shiro://scene/{id}/alternatives. Los agentes deberían empezar por la ficha y el esquema.

Hay más sobre cómo usa la IA de Shiro estas herramientas en la página de IA.

Lo que la gente pregunta

¿Puede un agente cambiar mi libro sin que yo lo vea?

Puede cambiarlo sin preguntar, como lo harías tú, pero no sin dejar rastro. Cada llamada es una entrada en el historial del proyecto, con el nombre del agente, y cada escena cuyo texto cambió guarda en sus Versiones la versión de antes, así que ves lo que hizo y restauras lo que tenías. Un agente también puede elegir sugerir un cambio en lugar de hacerlo, por ejemplo uno que no pediste o uno del que no está seguro: ese cambio espera en Comentarios hasta que lo apliques o lo rechaces. Pon un agente en Solo sugiere en Tú › MCP, y sugerirá cada cambio. En un libro compartido, un agente conectado por alguien con la función de Editor también sugiere cada cambio.

¿Conectar un agente envía mi libro a algún sitio?

El servidor de Shiro en tu equipo no envía nada por sí mismo, pero el agente que conectas envía lo que lee al modelo que use. Si es un modelo alojado, tu texto sale de tu equipo por culpa del agente.

¿Necesito una cuenta?

No para shiro mcp ni para la API local de escritorio. El punto de acceso en la nube trabaja con proyectos en la nube, así que necesita una cuenta de Shiro, y una gratuita basta para conectarse.

¿Puedo mantener una escena lejos de los agentes?

Sí. Una escena oculta para Shiro (ai: never en su front matter) también aparece vacía para los agentes.

Y así, después de leer hasta el final una web sobre escribir, abriste por fin una página en blanco.