Qué puede hacer MCP con cada tipo de archivo

En una línea: la tabla completa — para cada extensión, qué puede leer MCP, escribir entero, cambiar solo con una herramienta a nivel de campo o no tocar en absoluto.

El eje cambió

Esta página comparaba antes «un libro del Estudio de escritura» con «un libro de Script Studio». Desde 4.0 esa pregunta ya no se sostiene: hay un solo estudio de escritura, y un guion es un archivo .script del árbol de archivos, un episodio por archivo.

Lo que decide qué puede hacer MCP no es a qué estudio pertenece un libro. Es qué tipo de archivo estás tocando.

La tabla completa

Extensión	Leer	Escritura de archivo completo (write_file / edit_file / append_to_file)	Cómo se cambia
.md .markdown .txt	✅	✅	Escríbelo
.map mapa de relaciones	✅	❌	update_relationship_map
.beats escaleta	✅	❌	update_beat_board
.timeline cronología	✅	❌	update_timeline
.script guion	✅	❌	update_script
.geomap mapa del mundo	✅	❌	update_world_map
.character .location	✅	❌	Sin vía para la IA
.json .yaml .yml	✅	❌	Sin vía para la IA
.png .jpg .jpeg .gif .pdf	✅	❌	Sin vía para la IA
Cualquier otra cosa (.csv, sin extensión…)	✅	✅	Escríbelo

Esa última fila es deliberada. Los autores guardan toda clase de archivos de referencia, y rechazarlos para proteger tipos que nadie estructuró sería estropear trabajo real por prevenir algo hipotético.

La autoridad es get_capabilities, no esta tabla. Devuelve el contrato que este servidor aplica de verdad; mira Guías y habilidades de escritura.

Tres clases de archivo, tres comportamientos

Prosa (.md / .markdown / .txt). Funcionan read_file, edit_file, write_file, create_file, append_to_file y delete_file. En la práctica, prefiere edit_file: el autor puede estar editando el mismo archivo, y una edición que no encuentra su ancla falla a gritos, mientras que una escritura completa reemplaza en silencio lo que él acababa de teclear.

Los cinco tipos estructurados. write_file, edit_file y append_to_file se rechazan los tres; los cambios pasan por una operación a la vez. Hay dos excepciones que conviene recordar: create_file sí funciona (pero el contenido que envías se ignora: el servidor escribe un esqueleto vacío), y delete_file también funciona (el borrado no consulta la política de tipos, solo el plan). Escribir y borrar pertenecen los dos a los planes de suscripción. Mira Herramientas de edición estructurada.

Sin escritura posible. .character y .location tienen un formato que pertenece a los editores propios de Slima; .json y .yaml son configuración y datos; el multimedia es multimedia. Se leen, no se escriben, y no hay alternativa a nivel de campo.

Cómo los trata el recuento de palabras

Esto se deduce del tipo, y conviene decirlo aparte:

• .md / .markdown / .txt — se cuentan como prosa
• .script — se cuentan las palabras que hay dentro de sus escenas, y sí alimentan el recuento diario del autor y su racha
• .map / .beats / .timeline / .geomap — siempre cero

Así que una IA que ordena un mapa de relaciones no deja progreso falso en los números del autor.

Herramientas a las que no les importa el tipo de archivo

Hay todo un conjunto que trabaja sobre la obra y no sobre un archivo, y a ellas no se les aplica la tabla de arriba: list_books, get_book, get_book_structure, get_writing_stats, search_content, semantic_search, notas, comentarios y el conjunto de enseñanza.

Algunas de ellas sí se comportan distinto en ciertos archivos; mira Herramientas que se comportan distinto en ciertos archivos.

create_book solo crea obras de escritura

Todo lo que crea MCP es un libro del Estudio de escritura. El antiguo Script Studio ya no admite obras nuevas, así que tampoco había nada que crear allí. Escribir un guion en 4.0 empieza dentro de un libro: clic derecho en el árbol de archivos, «Nuevo guion», y tienes un archivo .script.

Si todavía tienes un libro antiguo de Script Studio

Esos libros siguen abriéndose y MCP los sigue leyendo. Se rigen por otro conjunto de reglas, que no tiene nada que ver con la tabla de extensiones de arriba: funciona por rutas.

Acción	Libro antiguo de Script Studio
Leer cualquier archivo	✅ Incluidos series.json, *.character, *.scene
Escribir / editar / borrar	⚠️ Solo bajo .script_studio/planning/
Archivos estructurados (series.json, season.json, episode.json, *.character, *.location, *.scene, *.storyline, *.note)	❌ Solo lectura a través de MCP
.script_studio/planning/.initialized	❌ Solo lectura (el marcador de arranque del frontend)
search_content	⚠️ Excluye esos archivos estructurados por defecto; pasa include_structured: true
analyze_chapter	❌ No se admite en estos libros, en absoluto

Una escritura fuera del área permitida devuelve 400 INVALID_PATH. Para conocer las reglas exactas de un libro concreto, pregúntale al libro: lee el recurso slima://books/{book_token}/schema; mira Consultar el schema de una obra con el recurso.

get_book sobre uno de esos libros imprime él mismo sus restricciones de escritura, lo que convierte esa llamada en la forma más rápida de comprobarlo antes de hacer nada.

Relacionado

• Docs: Herramientas de edición estructurada
• Docs: Protección de archivos estructurados
• Docs: Herramientas que se comportan distinto en ciertos archivos
• Docs: Herramientas de operaciones de archivo
• Docs: Consultar el schema de una obra con el recurso
• Docs: Manuscrito vs. referencia