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 el complemento del servidor MCP del lector. Aquel 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, después, 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 guardado el ajuste como activado, la tarjeta se expande para mostrar los datos de conexión de tu cliente de IA.
Si vuelves a desactivar el ajuste, los clientes de IA dejarán de poder trabajar en el proyecto.
Conectar tu cliente de IA
Claude
DeveloperHub está en el directorio de conectores de Claude. En Claude, abre Plugins en la barra lateral, busca DeveloperHub, ábrelo y haz clic en Connect. Claude te pedirá entonces que inicies sesión en DeveloperHub y apruebes el acceso.
Claude Code, Codex, Cursor y otros clientes
El servidor está en https://ai.developerhub.io/mcp y usa el transporte Streamable HTTP. También figura en el registro oficial de MCP (MCP Registry) como io.developerhub/editor.
Para Claude Code:
O instala el plugin de DeveloperHub para Claude Code, que añade este servidor junto con las Agent Skills de DeveloperHub.
Para Codex:
Para Cursor 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 se conecta un cliente, se abre una página del navegador que te pide permitir el 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 has iniciado tú mismo la conexión desde un cliente de confianza.
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.
Cada cliente que apruebas permanece conectado durante 30 días, aunque cierres sesión en el editor, y después te pide que lo apruebes de nuevo. Para desconectar uno antes, abre Configuración de la cuenta → Integraciones → Clientes de IA y haz clic en Desconectar junto a él en Clientes conectados.
Usar una clave MCP
Una clave MCP es para un cliente de IA que no puede iniciar sesión mediante un navegador, como una automatización que se ejecuta como cuenta de servicio. Una clave actúa como tu cuenta, así que solo puede hacer lo que tu rol permite en cada proyecto.
Para crear una:
Abre Configuración de la cuenta → Integraciones → Clientes de IA.
En Claves MCP, haz clic en Crear clave.
Ponle un nombre a la clave, elige cuándo caduca (de 30 a 365 días) y desmarca las herramientas que no deba usar.
Haz clic en Crear clave y copia la clave. Solo se muestra una vez.
El panel muestra entonces configuraciones ya preparadas para Claude Code, Codex y otros clientes. Cada una envía la clave como encabezado Authorization: Bearer <key> y omite el inicio de sesión en el navegador.
Las herramientas de una clave no se pueden cambiar después: crea una clave nueva y revoca la anterior. Una herramienta que hayas desactivado sigue apareciendo en el cliente de IA, pero se rechaza. Cambiar o restablecer tu contraseña revoca todas tus claves. Para detener una clave antes de que caduque, haz clic en Revocar junto a ella.
Qué puede hacer un agente
Herramienta | Qué hace |
|---|---|
| Muestra los proyectos que puedes editar. Todas las demás herramientas necesitan un proyecto, así que un agente empieza por aquí. |
| Muestra las versiones de un proyecto. |
| Copia una versión, con su documentación y referencias de API, en una nueva. |
| Muestra las secciones de documentación de una versión y si cada una está publicada. |
| Muestra las referencias de API de una versión. |
| Muestra 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 y sustituye lo que ven los lectores. La versión sustituida solo se recupera desde el historial de la página. Una página que estaba sin publicar vuelve a mostrarse a los lectores. |
| Anula la publicación de una página, conservando su contenido y su borrador. |
| Publica una sección de documentación. |
| Anula la publicación de una sección de documentación y oculta sus páginas a los lectores. |
| Publica una versión. |
| Anula la publicación de una versión y oculta todo su contenido a los lectores. |
| Elimina una página de forma permanente. |
| Sustituye la especificación OpenAPI en borrador de una referencia de API. |
| Comprueba si una página, o una versión completa, tiene enlaces rotos. |
| Muestra las páginas que enlazan a una página, si cada enlace está activo o solo en un borrador, y los encabezados a los que apunta. |
| Devuelve la referencia de Markdoc con la que escribe el agente. |
| Muestra las audiencias del proyecto, para el contenido adaptable. |
| Comprueba si un cuerpo tiene 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, por lo 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. Dos cosas funcionan de otra manera, 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 pide al agente que ejecute primero
list_backlinkspara ver 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, de modo que no puede eliminar una página que no ha consultado, pero una vez realizada la eliminación, la página desaparece.
list_backlinksmuestra qué páginas se quedarían con un enlace roto.
Un agente no puede dejar tu sitio de documentación fuera de línea. Se rechaza anular la publicación o eliminar la última página, sección o versión que ven los lectores, con un mensaje que indica hacerlo en el editor. Para impedir por completo que un agente publique, anule publicaciones o elimine, conéctalo con una clave MCP que tenga esas herramientas desactivadas.
Escribir Markdoc
Los cuerpos de página son Markdoc en el dialecto propio de DeveloperHub, que no es intercambiable con el Markdoc genérico. Un agente que escriba a partir de conocimiento general produce algo que se guarda pero es incorrecto: los bloques personalizados se degradan a 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 preguntar a un agente qué escribir a continuación además de pedirle que escriba.
get_search_analytics devuelve lo que los lectores buscaron, por defecto los términos que no encontraron nada, 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 por defecto, ya que los totales ya las cuentan.
Need help? Visit our community forums or contact us.