Made in DeveloperHub
Servidor MCP del editor
El servidor MCP del editor permite a tu equipo editar un proyecto desde un cliente de IA. Conecta Claude, Cursor, Codex o cualquier otro agente compatible con MCP, y podrá encontrar tus páginas, leerlas, escribirlas, publicarlas y comprobar si tienen enlaces rotos sin que salgas de la herramienta en la que ya estás trabajando.
Es la contraparte del servidor MCP del lector. Ese expone tu documentación publicada para que un agente pueda buscar en ella; este expone el editor para que un agente pueda modificarla.
Solo los administradores del proyecto pueden activar o desactivar el servidor MCP del editor.
Activar el servidor MCP del editor
Abre Configuración del proyecto → IA → Agentes de IA y MCP y luego la pestaña Editor.
En Servidor MCP del editor, activa Servidor MCP del editor.
Haz clic en Guardar cambios en el menú superior.
El cambio puede tardar hasta 5 minutos en aplicarse. Una vez guardada la configuración como activada, la tarjeta se expande para mostrar los datos de conexión de tu cliente de IA.
Si vuelves a desactivar la configuración, se desconectan todos los clientes que estaban conectados al proyecto.
Conectar tu cliente de IA
El servidor está en https://ai.developerhub.io/mcp y usa el transporte Streamable HTTP.
Para Claude Code:
Para Cursor, Codex y otros clientes que usan un archivo de configuración:
Los mismos pasos de instalación están en tu propia Configuración de la cuenta → Integraciones → Clientes de IA.
Iniciar sesión
La primera vez que un cliente se conecta, abre una página del navegador que te pide Permitir acceso. La página indica el cliente que lo solicita, la cuenta con la que vas a conceder el acceso y la dirección a la que se envía la autorización al aprobar. Continúa solo si iniciaste la conexión tú mismo desde un cliente de confianza.
No hay ninguna clave que crear ni compartir. Cada editor se conecta con su propia cuenta de DeveloperHub y el agente actúa como esa persona, por lo que solo accede a los proyectos que ya puede editar, y únicamente a aquellos que tienen activado el servidor MCP del editor.
La conexión dura mientras dure tu sesión de DeveloperHub. Después, tu cliente te pedirá que apruebes el acceso de nuevo.
Qué puede hacer un agente
Herramienta | Qué hace |
|---|---|
| Enumera los proyectos que puedes editar. Todas las demás herramientas necesitan un proyecto, así que un agente empieza aquí. |
| Enumera las versiones de un proyecto. |
| Copia una versión, con su documentación y sus referencias de API, en una nueva. |
| Enumera las secciones de documentación de una versión. |
| Enumera las referencias de API de una versión. |
| Enumera las páginas de una versión, con filtro opcional por título o slug. |
| Resuelve una página a partir de su slug. |
| Busca texto exacto en todas las páginas de una versión, incluidos los borradores. |
| Ejecuta una búsqueda por relevancia en las páginas publicadas de una versión. |
| Lee el cuerpo editable de una página como Markdoc. |
| Crea una página, opcionalmente anidada bajo otra existente. Empieza sin publicar. |
| Cambia el cuerpo, el título, el slug de una página o cualquier combinación de los tres. |
| Publica el borrador de una página. |
| Elimina una página de forma permanente. |
| Reemplaza el borrador de la especificación OpenAPI de una referencia de API. |
| Comprueba una sola página, o una versión completa, en busca de enlaces rotos. |
| Devuelve la referencia de Markdoc con la que escribe el agente. |
| Enumera las audiencias del proyecto, para el contenido adaptable. |
| Comprueba si un cuerpo contiene contenido que se descartaría silenciosamente, sin escribirlo. |
| Lee lo que los lectores buscan en tu documentación publicada. |
| Lee los comentarios de un proyecto: los totales, las páginas mejor y peor valoradas y los comentarios recientes. |
| Lee las valoraciones y los comentarios de una sola página. |
Borradores, cambios de nombre y eliminaciones
Las ediciones del cuerpo se escriben en el borrador de la página, así que nada de lo que escriba un agente es visible para los lectores hasta que se publique, y publicar es un paso aparte y explícito. Hay dos cosas que funcionan de forma distinta, y conviene conocerlas antes de dirigir un agente a un proyecto en producción:
Los títulos y los slugs no pasan por borrador. Un cambio de nombre se aplica de inmediato, también en las páginas publicadas. Cambiar un slug cambia la URL de la página, así que comprueba antes qué enlaces apuntan a ella.
Eliminar una página no se puede deshacer. Un agente tiene que devolver el slug actual de la página como confirmación, por lo que no puede eliminar una página que no ha consultado, pero una vez realizada la eliminación, la página desaparece.
Escribir en Markdoc
Los cuerpos de las páginas son Markdoc en el dialecto propio de DeveloperHub, que no es intercambiable con el Markdoc genérico. Un agente que escriba con conocimientos generales produce algo que se guarda pero es incorrecto: los bloques personalizados se degradan en texto literal y los enlaces sin texto desaparecen.
El servidor lleva la respuesta consigo. get_markdoc_syntax devuelve la referencia del dialecto con un ejemplo práctico de cada bloque, y validate_markdoc informa de lo que perdería un cuerpo antes de escribir nada. Cuando un agente edita tus páginas desde un repositorio de Git, las Agent Skills le enseñan el mismo dialecto.
Analítica y comentarios
Tres herramientas leen lo que hicieron tus lectores en lugar de lo que dicen tus páginas, de modo que puedes preguntarle a un agente qué escribir a continuación además de pedirle que escriba.
get_search_analytics devuelve lo que los lectores buscaron, con los términos que no dieron resultados como valor predeterminado, que es la forma más rápida de detectar un tema que no has cubierto. get_project_feedback y get_page_feedback devuelven las valoraciones y los comentarios que dejaron los lectores, en todo un proyecto o en una sola página. Las valoraciones sin comentario se omiten de forma predeterminada, ya que los totales ya las cuentan.
Need help? Visit our community forums or contact us.