Documentación con IA, de principio a fin
La IA te ayuda a escribirla. La IA te ayuda a traducirla. Y ahora la IA puede leerla — tu documentación publicada se convierte en una fuente en vivo que los agentes y asistentes consultan directamente.
“Documentación con IA” solía significar una sola cosa: usar IA para escribir más rápido. Eso sigue siendo la mitad de la historia, y OpenDocs lo hace bien — un Asistente de Escritura IA para redactar, un Mejorador de Escritura IA para pulir y Traducciones IA para llegar a una audiencia global. Pero hay una segunda mitad que la mayoría de las herramientas de documentación aún no ha alcanzado. Los asistentes de IA ahora consumen documentación. Cuando una persona desarrolladora le pregunta a su agente de programación cómo funciona tu API, ese agente necesita una fuente limpia, actual y legible por máquina — no una página web rastreada ni una exportación desactualizada.
OpenDocs trata ambas mitades como prioridad. Escribes con IA, localizas con IA, y tu contenido publicado funciona además como fuente de conocimiento consultable para agentes de IA mediante un servidor MCP integrado. El resto de esta página recorre los tres pilares, por qué el modelo BYOK importa para las funciones de IA y hacia dónde va el ecosistema de documentación legible por IA.
Escribe con IA
Asistente de Escritura IA
Empieza desde un prompt en lugar de una página en blanco. El Asistente de Escritura IA redacta secciones, esquemas y primeros borradores directamente dentro del editor de bloques, así dedicas tu tiempo a refinar en vez de mirar una pantalla vacía. Está disponible en todos los planes.
Mejorador de Escritura IA
Pule lo que ya tienes. El Mejorador de Escritura IA reescribe para dar claridad, recorta el relleno y suaviza el tono — útil cuando una nota interna en bruto necesita convertirse en una página pública pulida. Tú controlas qué aceptas.
BYOK, sin margen
Ambas herramientas de escritura son de trae-tu-propia-clave. Conectas tu propia clave de API de Anthropic, así que la IA corre sobre tu cuenta y tu relación de datos — y el consumo lo factura Anthropic a sus tarifas, nunca con un margen de OpenDocs.
Asistente de Escritura IA
Redacta secciones, esquemas y primeros borradores completos con Claude, la IA de Anthropic, sin salir del editor de bloques. Pega tu propia clave de API de Anthropic y funciona en todos los planes — sobre tu cuenta, bajo tu relación de datos, a las tarifas propias de Anthropic.
Las herramientas de escritura viven donde ya trabajas: el editor de bloques de OpenDocs. No hay una consola de IA aparte a la cual cambiar ni se requiere conocimiento de Markdown o git para usarlas. Una persona redactora sin perfil técnico puede redactar una página con el Asistente de Escritura, pasar el Mejorador de Escritura sobre un párrafo torpe y publicar — todo en el mismo editor visual. Como las funciones de IA son BYOK, la misma clave impulsa la escritura, la mejora y la traducción, y mantienes una única vista transparente de lo que la IA hace en tu cuenta de Anthropic.
Traduce con IA
38 idiomas
Las Traducciones IA muestran tu documentación en hasta 38 idiomas. Llega a una audiencia global sin contratar un proveedor de localización ni montar un pipeline de traducción aparte para cada idioma que quieras servir.
Se mantiene sincronizada
Las traducciones no son un volcado de una sola vez. Cuando actualizas la página original, las versiones traducidas se mantienen sincronizadas con tus cambios, así que tus lectores en español, japonés o alemán no se quedan con una copia desactualizada.
Docs globales, tu clave
Como las herramientas de escritura, la traducción es BYOK con tu clave de Anthropic. Obtienes documentación multilingüe con el consumo facturado directo a tu cuenta — predecible, transparente y sin un complemento de suscripción por idioma.
La localización suele ser el punto donde los proyectos de documentación se estancan. Los proveedores son caros, los traductores independientes son lentos y mantener al día decenas de páginas traducidas a medida que el producto cambia es un trabajo en sí mismo. Las Traducciones IA reducen esa carga: publicas una vez, traduces a los idiomas que habla tu audiencia y dejas que las traducciones sigan al contenido original conforme evoluciona. Para un equipo pequeño que atiende clientes en varias regiones, esto suele ser la diferencia entre tener documentación localizada y no tenerla en absoluto.
Sirve tu documentación a la IA
Un servidor MCP en vivo
Cada espacio publicado es alcanzable mediante el servidor MCP de OpenDocs sobre HTTP en streaming. Los agentes se conectan a un endpoint en vivo y leen tu contenido publicado actual bajo demanda — no una página rastreada ni una exportación desactualizada que tengas que recordar regenerar.
Cuatro herramientas específicas
El servidor MCP expone list_spaces, get_page_tree, get_page (el contenido completo de la página como texto plano limpio) y search_pages. Un agente puede enumerar lo que existe, recorrer la estructura, leer una página y buscar entre páginas.
Funciona con cualquier cliente MCP
Como habla el Model Context Protocol, funciona con cualquier cliente compatible con MCP — Claude Desktop, Claude Code y otros clientes MCP. Apunta el cliente a tu endpoint, autentícate con una clave de API y tu documentación queda dentro del flujo.
Este es el pilar que cambia para qué sirve la documentación. Tradicionalmente, la documentación se escribe para humanos que leen en un navegador. Pero cada vez más el lector es un agente de IA que actúa por cuenta de una persona — un asistente de soporte respondiendo a un cliente, un agente de programación conectando tu API, un bot interno atendiendo preguntas de tu equipo. Esos agentes trabajan mejor con una fuente estructurada y autoritativa que puedan consultar, y eso es exactamente lo que ofrece el servidor MCP de OpenDocs.
El endpoint está protegido con una clave de API de OpenDocs, así que el acceso es controlado en lugar de estar abierto por completo. Un agente alcanza solo el contenido que la clave tiene permitido ver, y puedes emitir o revocar esa clave. El resultado es que tu documentación publicada se convierte en una base de conocimiento en vivo y consultable para la IA — sin que exportes archivos, mantengas una base de datos vectorial aparte o dejes que los bots rastreen tu sitio y se desactualicen.
Por qué importa BYOK
Cada función de IA en OpenDocs — el Asistente de Escritura, el Mejorador de Escritura y las Traducciones IA — es de trae-tu-propia-clave. Aportas tu propia clave de API de Anthropic, y esa única decisión tiene tres consecuencias que vale la pena entender.
Transparencia de costos. Tu consumo de IA lo factura Anthropic directamente a tu cuenta, a las tarifas publicadas de Anthropic. Puedes ver, hasta el token, cuánto cuesta realmente generar y traducir tu documentación, porque aparece en tu propia factura en lugar de estar mezclado en una cuota de plataforma opaca.
Sin margen sobre la IA. Muchas herramientas revenden capacidad de IA con un margen incorporado, o reservan los mejores modelos para un nivel superior. OpenDocs no hace ninguna de las dos. Como traes tu propia clave, OpenDocs no está en el negocio de revenderte tokens — no hay nada sobre lo cual aplicar un margen.
Tú controlas la clave. La relación de datos del consumo de IA es entre tú y Anthropic, regida por los términos de tu propia cuenta. Eliges la clave, defines sus límites y puedes rotarla o revocarla. Tu relación con el proveedor de IA sigue siendo tuya, no intermediada por tu proveedor de documentación.
El panorama de la documentación legible por IA
Hacer que la documentación sea legible para la IA es un espacio en rápida evolución, y están surgiendo dos enfoques. Conviene entender ambos, porque resuelven problemas distintos.
llms.txt es una convención comunitaria: un archivo de texto plano en una ubicación conocida que apunta a los sistemas de IA hacia las partes del sitio aptas para LLM, algo parecido a robots.txt o un sitemap pero orientado a los modelos de lenguaje. Es una forma ligera y estática de anunciar contenido. Todavía es emergente, y su adopción entre herramientas y rastreadores es dispareja. Para ser claros, OpenDocs no genera actualmente archivos llms.txt para los sitios publicados — lo mencionamos porque es una parte real del ecosistema y vale la pena seguirla, no porque OpenDocs lo ofrezca hoy.
MCP toma el camino interactivo. En lugar de un archivo estático que describe el contenido, el Model Context Protocol da a los agentes herramientas en vivo para consultar el contenido bajo demanda — listar lo que existe, recorrer la estructura, leer una página, ejecutar una búsqueda. Es la diferencia entre entregarle a un agente un mapa y darle una línea telefónica para llamar. Para documentación que cambia, el enfoque en vivo significa que un agente siempre ve el estado actual, nunca una instantánea.
OpenDocs ofrece MCP hoy. Tus espacios publicados son consultables ahora mismo por cualquier cliente compatible con MCP, protegidos con tu clave de API. Si llms.txt o convenciones similares maduran hasta volverse ampliamente útiles, son complementarias a lo que MCP ya hace — pero el camino interactivo y siempre actual es el que más importa para la documentación de la que dependen los agentes, y es el que OpenDocs ofrece ahora.
Documentación tradicional vs documentación lista para IA
| Dimensión | Documentación tradicional | Documentación lista para IA en OpenDocs |
|---|---|---|
| Lector principal | Humanos en un navegador | Humanos y agentes de IA |
| Cómo acceden los agentes al contenido | Rastreo de HTML, con suerte | Servidor MCP en vivo, herramientas estructuradas |
| Frescura para los agentes | Exportaciones desactualizadas o rastreos en caché | Contenido publicado actual bajo demanda |
| Asistencia de redacción | Manual, o una herramienta de IA aparte | Asistente de Escritura y Mejorador integrados |
| Localización | Proveedor o pipeline manual | Traducciones IA, 38 idiomas, se mantienen sincronizadas |
| Modelo de costo de IA | Tokens agrupados o con margen | BYOK — facturado por Anthropic, sin margen |
| Control de acceso para agentes | Todo o nada | Endpoint MCP protegido con clave de API |
Preguntas frecuentes
¿Qué es la documentación con IA?
La documentación con IA abarca dos ideas relacionadas: usar IA para ayudar a producir documentación, y hacer que la documentación sea legible para la IA. OpenDocs hace ambas. La IA te ayuda a escribir y traducir páginas, y una vez publicada, tu documentación queda expuesta a agentes de IA mediante un servidor MCP en vivo, para que los asistentes la lean y busquen directamente en lugar de rastrear un sitio web.
¿Necesito mi propia clave de API para usar las funciones de IA?
Sí. El Asistente de Escritura IA, el Mejorador de Escritura IA y las Traducciones IA son BYOK (trae tu propia clave): conectas tu propia clave de API de Anthropic. Eso significa que la relación con la IA, los términos de datos y la facturación del consumo están directamente entre tú y Anthropic. OpenDocs nunca aplica un margen sobre tu consumo de IA.
¿Cuánto cuesta el consumo de IA?
Como las funciones de IA son BYOK, el consumo de IA lo factura Anthropic a tu propia cuenta a las tarifas publicadas de Anthropic. OpenDocs no agrega un margen por token ni revende tokens. Tu suscripción a OpenDocs cubre la plataforma; tu cuenta de Anthropic cubre el consumo de IA, así que ves exactamente cuánto cuesta la IA.
¿Qué es MCP?
MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA conectarse a herramientas y fuentes de datos externas. OpenDocs ejecuta un servidor MCP sobre HTTP en streaming que expone tus espacios publicados a cualquier cliente compatible con MCP, como Claude Desktop o Claude Code. Sus herramientas permiten a un agente listar espacios, navegar el árbol de páginas, leer una página como texto plano y buscar entre páginas.
¿Pueden los agentes de IA leer mi documentación privada?
Solo con el acceso que otorgues. El endpoint MCP de OpenDocs está protegido con una clave de API de OpenDocs, así que un agente solo puede alcanzar el contenido que esa clave tiene permitido ver. El acceso es controlado, no está abierto al internet público, y puedes emitir y revocar la clave que usan los agentes.
¿OpenDocs genera un archivo llms.txt?
Hoy no. llms.txt es una convención comunitaria emergente para anunciar contenido apto para LLM, y vale la pena seguirla, pero OpenDocs no genera actualmente archivos llms.txt para los sitios publicados. Lo que OpenDocs ofrece ahora es el camino interactivo: un servidor MCP en vivo que permite a los agentes consultar tu contenido publicado real bajo demanda.