Herramientas de notas y comentarios

En una línea: cómo una herramienta de IA externa lee y escribe tus notas, y cómo entra en el ida y vuelta de los comentarios: dejar uno, resolverlo, reabrirlo.

Qué resuelve

Los archivos no son todo el libro. Al lado viven otras dos capas: las notas que el autor escribe para sí mismo y los comentarios que se pasan un editor y un autor.

Las dos importan mucho cuando una IA recibe el manuscrito de otra persona. En los comentarios suele estar ya escrito lo que alguien dijo que fallaba; saltárselos y producir una lista independiente es la forma más rápida de discutir contra una decisión que se cerró la semana pasada. Y las notas son el pensamiento del autor en marcha: leerlas es la diferencia entre «esta pista sembrada nunca se paga» y «esta pista está guardada a propósito para el segundo libro».

Notas

list_notes(book_token)                              → todas las notas de este libro
create_note(book_token, title, content, note_type…) → dejar una

Lo que acepta create_note:

Argumento	Detalle
title	Obligatorio. Una línea corta.
content	Opcional, hasta 50.000 caracteres
note_type	book (la obra entera) o chapter (anclada a un archivo). Por defecto, book.
file_id	Obligatorio cuando note_type es chapter: el token de ese archivo. Consíguelo antes con get_book_structure.
color	Uno de gray / red / blue / green / yellow / purple

Las notas viven junto al manuscrito, no dentro de él. Escribir una no toca ni una palabra de la prosa y no suma nada al recuento.

Por MCP no hay herramienta para borrar una nota. Las notas no están bajo control de versiones, así que, a diferencia de un archivo, no hay historial del que recuperarlas. Si el autor quiere que una desaparezca, la quita en la app.

Emparejar una siembra con su pago se hace en la app. Un registro de nota puede emparejar la nota donde se menciona por primera vez el cajón cerrado con la nota donde se abre, pero create_note no expone esos dos campos. Así que cuando una IA lee doce capítulos y detecta un detalle sembrado que nunca se paga, lo que puede hacer es escribir una nota diciéndolo y dejarle el emparejamiento al autor. Al menos así el hallazgo no desaparece cuando termina la conversación.

Comentarios

list_comments(book_token)                        → todos los hilos, abiertos y resueltos
create_comment(book_token, content, file_token?) → dejar uno
resolve_comment(book_token, comment_token)       → marcar un hilo como atendido
reopen_comment(book_token, comment_token)        → reabrir uno que no debió cerrarse

Un libro guarda dos clases: comentarios normales y sugerencias, que llevan texto de reemplazo. Lo que crea MCP es la primera clase.

comment_token viene de list_comments y tiene la forma bcmt_…. Pasa file_token para colgar el hilo de un archivo concreto; déjalo fuera y el hilo queda sobre el libro entero.

Di qué hiciste antes de resolver. Un hilo que se cierra en silencio no le dice nada a quien lo abrió: no puede saber si hiciste el cambio o si decidiste que la observación no se sostenía.

Resolver exige permiso de edición sobre el libro. Un colaborador de solo lectura puede leer los hilos y añadir mensajes, pero no cerrar el de otra persona.

Tres cosas que MCP no ofrece a propósito

No disponible	Por qué
Borrar una nota	Las notas no están bajo control de versiones, así que un borrado no tiene historial del que restaurarse
Aceptar o rechazar una sugerencia	Aceptar modifica el manuscrito, y esa decisión es del autor
Editar o borrar el comentario de otra persona	Son sus palabras

Cuándo comentar y cuándo editar directamente

Una pregunta lo resuelve: ¿esto es un juicio tuyo o algo que el autor pidió?

Un hallazgo, dos salidas

El ritmo se cae, una motivación no convence, la escena no se ha ganado su extensión Deja un comentario

El autor dijo «aprieta este pasaje» Edita el archivo

En caso de duda, comenta. Descartar un comentario cuesta diez segundos; una reescritura que nadie pidió le cuesta al autor leer el diff de su propia prosa.

Relacionado

• Docs: Herramientas de operaciones de archivo
• Docs: Búsqueda semántica y búsqueda de texto
• Docs: Guías y habilidades de escritura
• Docs: Comentarios en línea