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 administradores

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:

claude mcp add --transport http developerhub https://ai.developerhub.io/mcp

O instala el plugin de DeveloperHub para Claude Code, que añade este servidor junto con las Agent Skills de DeveloperHub.

Para Codex:

codex mcp add developerhub --url https://ai.developerhub.io/mcp

Para Cursor y otros clientes que usan un archivo de configuración:

{
"mcpServers": {
"developerhub": {
"url": "https://ai.developerhub.io/mcp"
}
}
}

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

list_projects

Muestra los proyectos que puedes editar. Todas las demás herramientas necesitan un proyecto, así que un agente empieza por aquí.

list_versions

Muestra las versiones de un proyecto.

clone_version

Copia una versión, con su documentación y referencias de API, en una nueva.

list_documentation_sections

Muestra las secciones de documentación de una versión y si cada una está publicada.

list_api_references

Muestra las referencias de API de una versión.

list_pages

Muestra las páginas de una versión, con filtro opcional por título o slug.

find_page_by_slug

Resuelve una página a partir de su slug.

find_text

Busca texto exacto en todas las páginas de una versión, incluidos los borradores.

search_pages

Ejecuta una búsqueda por relevancia en las páginas publicadas de una versión.

get_page

Lee el cuerpo editable de una página como Markdoc.

create_page

Crea una página, opcionalmente anidada bajo otra existente. Empieza sin publicar.

edit_page

Cambia el cuerpo, el título, el slug de una página o cualquier combinación de los tres.

publish_page

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.

unpublish_page

Anula la publicación de una página, conservando su contenido y su borrador.

publish_section

Publica una sección de documentación.

unpublish_section

Anula la publicación de una sección de documentación y oculta sus páginas a los lectores.

publish_version

Publica una versión.

unpublish_version

Anula la publicación de una versión y oculta todo su contenido a los lectores.

delete_page

Elimina una página de forma permanente.

edit_api_reference

Sustituye la especificación OpenAPI en borrador de una referencia de API.

check_broken_links

Comprueba si una página, o una versión completa, tiene enlaces rotos.

list_backlinks

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.

get_markdoc_syntax

Devuelve la referencia de Markdoc con la que escribe el agente.

list_audiences

Muestra las audiencias del proyecto, para el contenido adaptable.

validate_markdoc

Comprueba si un cuerpo tiene contenido que se descartaría silenciosamente, sin escribirlo.

get_search_analytics

Lee lo que los lectores buscan en tu documentación publicada.

get_project_feedback

Lee los comentarios de un proyecto: los totales, las páginas mejor y peor valoradas y los comentarios recientes.

get_page_feedback

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_backlinks para 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_backlinks muestra 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.

ai
  Última actualización