Al terminar, Claude (un chat de claude.ai con el conector, o Claude Code en tu terminal) responde preguntas de soporte y de producto a partir de una de tus bases de conocimiento de osFoundry. Cada afirmación de su respuesta apunta a un ID de artículo y a la hora en que ese artículo se actualizó por última vez. Al día siguiente, Claude puede preguntarle a osFoundry qué cambió desde entonces y decirte cuáles de las respuestas de ayer se apoyan en un artículo que alguien ha reescrito. Cuando el propio artículo está mal, Claude puede corregirlo, pero solo a partir de la versión exacta que leyó y solo después de que permitas la llamada.
Quién hace qué
| Lado de Claude | Lado de osFoundry | |
|---|---|---|
| Inicio de sesión | Tu cuenta de Claude o tu instalación de Claude Code, sin cambios | Una conexión aprobada a un único workspace |
| Qué puede buscar | Lo que devuelva el servidor | Artículos publicados en bases de conocimiento de los proyectos a los que se añadió la conexión |
| La cita | Claude la guarda junto a cada afirmación | Cada lectura devuelve el ID del artículo y la hora de su última actualización |
| Vigencia | Claude pide los cambios desde un número de secuencia | poll_resource_events mantiene un registro ordenado por base de conocimiento |
| Edición | El aviso de permisos de Claude antes de cada escritura | expected_version debe coincidir, y tus permisos de edición se comprueban en cada llamada |
| Registro | La propia transcripción de Claude | Cada llamada aparece en Recent activity de la conexión |
Configuración
1. Conecta Claude
Crea primero la conexión en osFoundry: icono de llave → Connected → Assistant: Claude → Add assistant. Copia la dirección del servidor que muestra:
https://api.osfoundry.io/api/v1/external-mcp En claude.ai, añade esa URL como conector personalizado. En Claude Code, añádela desde la shell e inicia sesión desde dentro de una sesión:
claude mcp add --transport http osfoundry https://api.osfoundry.io/api/v1/external-mcp # then, in Claude Code: /mcp # pick osfoundry → Authenticate En ambos casos, el navegador abre la página "Connect an agent" de osFoundry. Elige el workspace, marca la casilla de aprobación y conecta. En Claude Code, las herramientas aparecen entonces como mcp__osfoundry__search_knowledge_base, etc.
2. Añade la conexión al proyecto de la base de conocimiento
Una conexión nueva no ve nada. En icono de llave → Connected, selecciónala, elige el proyecto en Projects y haz clic en Add to project.
Ejemplo: La sección Projects de una conexión, con un proyecto añadido
Si la base de conocimiento aún no está en ese proyecto, ábrela, ve al panel derecho → Settings y elige el proyecto en el campo Project. El campo se guarda al seleccionar.
Ejemplo La pestaña Settings de la base de conocimiento con el campo Project configurado
3. Publica los artículos de los que Claude debe responder
Selecciona un artículo y abre la pestaña Publishing en el panel derecho. El estado indica Published o Draft. Haz clic en Publish Article en cada uno que Claude deba ver. La nota del propio panel explica qué significa: "Published articles are used by this workspace's AI assistant and search. They are not visible outside the workspace." Es decir, los artículos publicados los usan el asistente de IA y la búsqueda de ese workspace, pero no se ven fuera de él. Los borradores quedan fuera del alcance de Claude a propósito, para que nunca se cite un artículo a medio escribir.
Ejemplo La pestaña Publishing de un artículo con Status: Published y la nota de que solo se ve dentro del workspace
4. Deja activadas las herramientas de la base de conocimiento
En Tools de la conexión, estas vienen activadas por defecto junto con todo lo demás:
read search_knowledge_base read_knowledge_article poll_resource_events write edit_knowledge_article 
Ejemplo: La lista Tools de una conexión de Claude, con las herramientas de la base de conocimiento marcadas
Si solo quieres respuestas, desmarca edit knowledge article y haz clic en Save tools. La búsqueda, la lectura y el sondeo siguen funcionando.
5. Pide citas en el prompt
Claude cita con más fiabilidad cuando le dices cómo es una cita:
Answer from the "Support" knowledge base in osFoundry only. After each claim, add [article_id · updated_at] from read_knowledge_article. If no published article covers it, say so instead of guessing. Una ejecución real
Los artículos, IDs y fechas de abajo son contenido de ejemplo. Los nombres de las herramientas y sus argumentos son los que el servidor real lista en tools/list, tal como los muestra Claude Code.
Example You: A customer on a monthly plan asks how long they have to request a refund, and whether SSO users get the same window. ● mcp__osfoundry__list_project_resources {"project_id": "…", "resource_type": "knowledge_base"} ← "Support" (knowledge base) ● mcp__osfoundry__search_knowledge_base {"knowledge_base_id": "…", "query": "refund window monthly plan", "limit": 5} ← 5 results, each with article_id and updated time "Refund policy" updated 2026-11-03 09:41 "SSO and billing owners" updated 2026-10-28 16:02 ● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "9c1e…"} ← "Refund policy", citation 9c1e… · 2026-11-03T09:41:12.408211Z ● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "4b70…"} ← "SSO and billing owners", citation 4b70… · 2026-10-28T16:02:55.019874Z Claude: Monthly plans can be refunded within 14 days of the charge [9c1e… · 2026-11-03T09:41:12Z]. SSO doesn't change that: refund requests go through the billing owner, not the SSO account [4b70… · 2026-10-28T16:02:55Z]. A la mañana siguiente, en la misma conversación:
You: Are any of the answers you gave yesterday out of date? ● mcp__osfoundry__poll_resource_events {"resource_type": "knowledge_base", "resource_id": "…", "after_sequence": 1182} ← 3 events; one touches 9c1e… ● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "9c1e…"} ← "Refund policy", citation 9c1e… · 2026-11-04T08:15:30.112054Z now says 30 days for monthly plans Claude: One answer changed. "Refund policy" was updated this morning and now gives 30 days, not 14 [9c1e… · 2026-11-04T08:15:30Z]. The SSO part still stands; that article hasn't changed. You: The FAQ article still says 14 days. Fix it to match. ● mcp__osfoundry__read_knowledge_article {"knowledge_base_id": "…", "article_id": "e27a…"} ← "Refund FAQ", version 2026-11-01T10:03:44.250911Z ● mcp__osfoundry__edit_knowledge_article {"knowledge_base_id": "…", "article_id": "e27a…", "content": "…30 days…", "expected_version": "2026-11-01T10:03:44.250911Z", "idempotency_key": "faq-refund-30d"} [Claude Code asks: allow this tool? → Yes] ← saved, version 2026-11-04T08:22:09.871530Z Aquí pasan tres cosas que no ocurren en un chat normal.
La cita lleva la hora, no solo el ID. El ID por sí solo te dice qué artículo usó Claude. La hora de actualización te dice en qué estado estaba. Eso es lo que permite a Claude responder "¿esto sigue siendo cierto?" sin volver a leer todos los artículos que ha citado alguna vez.
El sondeo sale barato porque es un registro. Claude solo tuvo que recordar un número de ayer: la última secuencia de eventos que vio. Una sola llamada a poll_resource_events devolvió lo que había cambiado desde entonces, y Claude volvió a leer solo el artículo que se movió.
La edición indica una versión. edit_knowledge_article reemplaza el contenido del artículo (y su título, si lo pasas) solo si el artículo sigue en expected_version. Claude leyó el FAQ segundos antes de escribir, así que la versión coincidía. Si alguien hubiera guardado el FAQ entretanto, osFoundry habría rechazado la escritura y Claude lo habría vuelto a leer. Reutilizar la versión de una cita de ayer es la forma habitual de que te rechacen, así que un buen prompt dice "vuelve a leer antes de editar".
Dónde está el límite
Solo se pueden buscar artículos actuales y publicados. La búsqueda y la lectura trabajan sobre el artículo tal como está ahora. Si despublicas un artículo, desaparece de los resultados de Claude en la siguiente llamada, y una respuesta que lo citaba no encontrará nada al comprobarlo. Para eso existe el paso de publicar: es el workspace quien decide qué cuenta como respuesta, no el modelo.
Solo bases de conocimiento de un proyecto conectado. Claude no puede buscar en una base de conocimiento que no se le dio a la conexión, y mover la base de conocimiento a otro proyecto, quitar el proyecto de la conexión o hacer clic en Revoke connection corta la siguiente llamada. Un token anterior no mantiene el acceso abierto.
Una edición es un reemplazo completo, con doble protección. La herramienta recibe el contenido entero, así que osFoundry no fusiona una copia desactualizada con una más nueva. La rechaza y deja que Claude rehaga el cambio a partir de lo que hay ahora. Del lado de Claude, la herramienta está marcada como una escritura que cambia contenido compartido (readOnlyHint: false, destructiveHint: true), y por eso Claude Code se detiene a preguntar. Del lado de osFoundry, la llamada se ejecuta con los permisos de edición de la persona que aprobó la conexión. Si un chat de Claude vinculado edita desde la propia pantalla Knowledge Base de osFoundry, osFoundry pide aprobación en cada llamada a edit_knowledge_article, y esa aprobación no se puede ampliar al resto de la sesión.
Cada llamada queda a la vista. Recent activity de la conexión lista el nombre de cada herramienta, la decisión y la hora, así que puedes ver qué artículos leyó Claude antes de responder.
Ejemplo Recent activity de una conexión de Claude con las llamadas a herramientas de la base de conocimiento
Siguiente paso
Elige diez preguntas reales que tu equipo respondió la semana pasada, pide a Claude que las responda desde la base de conocimiento con citas y guarda la conversación. Mañana, pregúntale qué respuestas están desactualizadas. Los artículos que señale son los que tu equipo cambió, y las citas muestran exactamente de qué versión salió cada respuesta. Qué contiene una base de conocimiento y cómo se versionan sus artículos está en la página de Knowledge Base.
