Al terminar, una conversación de Claude hace su investigación, abre una de tus Notes de osFoundry, añade una pestaña Slides nueva junto a las presentaciones que ya hay, la llena con una presentación corta y pone cada página que usó en la pestaña Sources de la Note. Las presentaciones que tu equipo ya hizo se quedan como estaban. Las citas quedan en la Note y no en el chat, así que la próxima persona que abra la presentación puede comprobar de dónde sale cada cifra.
Quién hace qué
| Lado de Claude | Lado de osFoundry | |
|---|---|---|
| Investigación | La búsqueda web y el razonamiento del propio Claude, en tu chat de Claude | Nada hasta que Claude escribe |
| Qué Note | Claude la elige de lo que lista el servidor | Solo Notes de proyectos a los que se añadió la conexión |
| Qué presentación | Claude debe enviar un ID de pestaña exacto |
list_note_tabs devuelve cada instancia de pestaña, así que dos pestañas Slides son dos IDs |
| Presentación nueva | Claude envía el esquema, hasta 20 diapositivas por llamada |
create_note_tab añade una pestaña Slides y devuelve su nuevo ID |
| Citas | Claude envía un título y una URL HTTP o HTTPS |
add_note_source añade una fila a la pestaña Sources |
| Aprobaciones | El aviso de permisos de herramientas de Claude antes de cada escritura | Tus permisos de edición actuales sobre la Note, comprobados en cada llamada |
| Registro | La transcripción del chat | El Recent activity de la conexión, una línea por llamada a herramienta |
Configuración
Esto supone que el conector personalizado de Claude ya existe: icono de llave → Connected → Add assistant en osFoundry, luego https://api.osfoundry.io/api/v1/external-mcp añadido como conector en Claude, y la conexión añadida a un proyecto.
1. Pon la Note en el proyecto conectado
Abre la Note, abre el panel derecho y ve a Config → Settings. Si el campo Project muestra "Add to project", elige el proyecto al que pertenece la conexión de Claude. Una Note que solo existe en este dispositivo no tiene copia en la nube, así que la conexión no puede verla.
2. Deja activadas las tres herramientas de escritura
En icono de llave → Connected, selecciona la conexión de Claude y mira Tools. Para esta guía Claude necesita estas:
read list_note_tabs read_note_tab list_note_attachments
write create_note_tab edit_note_tab add_note_source
Todas las herramientas compatibles vienen activadas por defecto. Si desmarcas las herramientas de escritura y haces clic en Save tools, Claude puede seguir leyendo la Note y la lista de Sources, pero no puede añadir una presentación ni una cita.
3. Nombra la Note, la presentación y la pestaña Sources en el prompt
Claude convierte los nombres en IDs de pestaña por su cuenta, pero pedirle que cree una pestaña nueva, en lugar de "actualizar la presentación", lo mantiene lejos de las presentaciones que ya existen.
Investiga cómo cambiaron este trimestre los precios de API de los modelos de lenguaje grandes.
Luego, en osFoundry, abre la Note "Q4 pricing research". Lee primero la pestaña
Research notes y las Sources que ya hay. Añade una pestaña Slides NUEVA llamada
"API price cuts" con unas cinco diapositivas, termínala con una diapositiva de Sources y
añade cada página en la que te basaste a la pestaña Sources de la Note. No toques las
presentaciones Pricing ni Launch status.
Una ejecución real
La Note, las páginas y la respuesta de Claude son datos de ejemplo. Los nombres de herramientas y argumentos son los que el servidor en producción lista en tools/list. En Claude Code, las mismas herramientas aparecen como mcp__osfoundry__create_note_tab, etc.
Example
[Claude runs its own web searches and reads three pages]
Claude → list_note_tabs {"note_id": "…"}
← version "…12:41.118Z"
Research notes (markdown) id "markdown"
Pricing (slides) id "slides-3-mh1q…"
Launch status (slides) id "slides-5-mh4c…"
… plus Files and Sources
Claude → read_note_tab {"note_id": "…", "tab_id": "markdown"}
← the team's notes, 1,240 characters
Claude → list_note_attachments {"note_id": "…", "kind": "sources"}
← 1 source: "Vendor pricing page (Q3 snapshot)"
Claude → create_note_tab {"note_id": "…", "tab_type": "slides",
"label": "API price cuts",
"slides": [{"title": "API prices this quarter", "body": "…"},
{"title": "Who cut, by how much", "body": "…"},
{"title": "Cached input pricing", "body": "…"},
{"title": "What it means for our plan", "body": "…",
"notes": "Pause here for questions"},
{"title": "Open questions", "body": "…"}],
"expected_version": "…12:41.118Z",
"idempotency_key": "deck-api-price-cuts"}
[Claude asks you to allow this tool call → Allow]
← tab ID "slides-9-mh8z…"
Claude → read_note_tab {"note_id": "…", "tab_id": "slides-9-mh8z…"}
← 5 slides, version "…13:02.540Z"
Claude → edit_note_tab {"note_id": "…", "tab_id": "slides-9-mh8z…",
"operation": "slide_add", "title": "Sources",
"body": "Three pages, listed in the Sources tab",
"expected_version": "…13:02.540Z",
"idempotency_key": "deck-api-price-cuts-sources-slide"}
← saved, 6 slides
Claude → list_note_tabs → add_note_source {"title": "…", "url": "https://…",
"description": "Price table, used on slide 2",
"expected_version": "…",
"idempotency_key": "src-…"}
(three times, one page each, a fresh version before each)
← source IDs
Claude → list_note_attachments {"note_id": "…", "kind": "sources"}
← 4 sources
Claude: "API price cuts" es una pestaña Slides nueva en Q4 pricing research,
con seis diapositivas, incluida una diapositiva final de Sources. Las tres
páginas que usé están en la pestaña Sources con una nota sobre qué
diapositiva respalda cada una. Pricing y Launch status no se modificaron.
Ejemplo: La barra de pestañas de la Note con las dos presentaciones existentes y la nueva presentación API price cuts abierta
Ya había dos presentaciones en la Note, y las dos son de tipo slides. Si Claude hubiera pedido "la pestaña de slides", no habría habido una respuesta correcta. list_note_tabs devuelve un ID por instancia, create_note_tab devuelve el ID de la pestaña que creó y cada edición posterior nombra ese ID. Por eso la diapositiva final acabó en la presentación nueva y no en Pricing, que es la primera de la barra.
El esquema entró con la llamada de creación. Una sola escritura creó la pestaña y sus cinco diapositivas. La diapositiva de Sources llegó después, como una edición a la presentación que ya existía. slide_add añade una diapositiva a la presentación a la que apunta y su esquema no tiene campo de posición, así que si el orden importa, pon las diapositivas en el esquema.
Ejemplo: La pestaña Sources después de la ejecución, con las tres páginas que añadió Claude debajo de la que ya estaba
Cada cita es una fila de la pestaña Sources con un título, el enlace, su nombre de host y la descripción de una línea de Claude. Ahí puedes abrirlas, editarlas, actualizarlas o quitarlas como cualquier fuente que haya añadido una persona. Si pasas el cursor por una fila, el botón de copiar te da un enlace directo a ese registro de fuente, que puedes pegar en el texto de una diapositiva.
Ejemplo: Recent activity de la conexión de Claude, una línea por llamada a herramienta
El Recent activity de la conexión, en icono de llave → Connected, lista cada llamada con su decisión y su hora, así que puedes ver lo que Claude hizo en la Note sin leer el chat.
Dónde está el límite
La investigación se queda del lado de Claude. osFoundry no ve las búsquedas de Claude ni las páginas que leyó. Solo recibe lo que Claude decide escribir: las diapositivas y un título, una URL y una descripción por fuente. Si una afirmación de una diapositiva no tiene fila en Sources, eso se ve en la Note, y para eso precisamente se piden ahí las citas.
Claude puede añadir una presentación, no apoderarse de una. create_note_tab solo crea pestañas Slides o Sheet nuevas, así que un esquema no puede sobrescribir una presentación que hizo otra persona. slide_add y slides_add_outline trabajan sobre la única presentación cuyo ID nombra Claude, y cada escritura lleva la versión de la Note que Claude leyó por última vez, así que si una persona cambió la presentación entretanto, la escritura se rechaza hasta que Claude vuelva a leer.
Las citas entran, los archivos siguen cerrados. add_note_source solo acepta enlaces HTTP y HTTPS. list_note_attachments lista Files y Sources como metadatos, 50 como máximo por página, sin contenido de archivos ni enlaces de descarga. Un enlace de descarga pegado en un chat podría reenviarse a cualquier parte y seguiría funcionando después de revocar la conexión. Editar o quitar fuentes y archivos queda en manos de las personas en la app de escritorio, porque edit_note_tab no toca ninguno de los dos.
Las diapositivas de un conector son sencillas. Cada diapositiva del esquema lleva un título, un cuerpo y notas del orador. Los temas, las imágenes y el diseño quedan para la persona que abra después la presentación en osFoundry.
Los reintentos son seguros. Cada escritura lleva una idempotency_key. Si la respuesta a Claude se pierde y vuelve a llamar con la misma clave, osFoundry devuelve el primer resultado, así que tienes una sola pestaña "API price cuts" y una fila por fuente, no dos.
El acceso termina en la siguiente llamada en cuanto lo cambias. Saca la Note del proyecto, quita el proyecto de la conexión o haz clic en Revoke connection, y la siguiente lectura de Claude se rechaza.
Siguiente paso
Pide a Claude que lea la presentación Pricing con read_note_tab, la compare con la nueva presentación API price cuts y añada sus correcciones como una tercera pestaña Slides con sus propias fuentes, para que la original quede intacta para revisarla. Qué contiene la pestaña Sources y cómo añade algo una persona a mano está en la página de la pestaña Sources, y el editor de presentaciones está en la página de Note Slides.



Top comments (0)