Usa Mintlify como grafo de conocimiento de tu código

Un grafo de conocimiento del código es un proyecto de Mintlify que describe tu código: qué hace cada repositorio, qué expone y cómo dependen los repositorios entre sí. Los agentes lo consultan mediante MCP antes de modificar el código. No necesitas documentación existente ni una migración. La configuración consta de tres pasos:

Genera el grafo de conocimiento inicial con el agente de Mintlify o con tu propio agente de programación.
Configura automatizaciones para mantenerlo actualizado.
Usa el grafo de conocimiento mediante MCP.

Los repositorios, las pull requests y las respuestas de los ejemplos de esta página son datos de muestra.

Requisitos previos

Un proyecto de Mintlify conectado a un repositorio de Git. Este repositorio central contiene el grafo de conocimiento y puede empezar vacío. Consulta la Guía rápida.
La GitHub App de Mintlify instalada en el repositorio central y en cada repositorio de origen que quieras documentar.
Un plan Enterprise para las automatizaciones personalizadas.
El agente de Mintlify o un agente de programación como Claude Code, Codex o Cursor.

Para mantener privado el grafo de conocimiento, configura la autenticación. Así, el servidor MCP de búsqueda requerirá que cada usuario inicie sesión.

Planifica la estructura

Coloca todos los repositorios en un único proyecto central, para que los agentes consulten un solo servidor MCP y las páginas puedan enlazarse entre repositorios. Asigna a cada repositorio su propio grupo, además de una sección de descripción general.

docs.json

{
  "navigation": {
    "groups": [
      {
        "group": "Overview",
        "pages": ["index", "architecture", "glossary"]
      },
      {
        "group": "Web app",
        "pages": ["repos/web-app/index", "repos/web-app/local-development", "repos/web-app/routing"]
      },
      {
        "group": "API service",
        "pages": ["repos/api-service/index", "repos/api-service/endpoints", "repos/api-service/data-model"]
      },
      {
        "group": "API gateway",
        "pages": ["repos/api-gateway/index", "repos/api-gateway/auth"]
      }
    ]
  }
}

La sección de cada repositorio debe cubrir lo que un agente necesita saber antes de modificar el código: qué hace el repositorio y quién es responsable de él, los endpoints o eventos que expone, a qué llama y qué lo llama, sus modelos de datos principales y cómo ejecutarlo y probarlo. Empieza con unos pocos repositorios representativos, como un frontend, un backend y un servicio compartido, antes de añadir el resto.

Paso 1: Genera el grafo de conocimiento inicial

Haz que un agente lea tu código fuente y escriba las primeras páginas en el repositorio central. Usa el agente de Mintlify, o clona los repositorios y ejecuta tu propio agente de programación.

Agente de Mintlify
Clonar y hacer push

El agente de Mintlify lee cualquier repositorio que tenga instalada la GitHub App de Mintlify, así que no necesitas clonar nada.

Conecta tus repositorios de origen

Instala la GitHub App de Mintlify en cada repositorio de origen que quieras documentar. Consulta Conectar repositorios como contexto.

Genera la documentación de un repositorio

Abre el agente en tu dashboard o en Slack e indica el repositorio de origen, la carpeta de destino y las páginas que debe escribir.

Example prompt

Read the source code in the your-org/api-service repository and write
documentation for it in repos/api-service/.

Create these pages:
- index.mdx: what the service does, who owns it, and how it fits into the
  rest of the system
- endpoints.mdx: every HTTP endpoint with method, path, parameters, and
  response shape, based on the route definitions
- data-model.mdx: the main models and database tables
- local-development.mdx: how to install, run, and test the service

For each page, list the other repositories this service calls or is called
by, and link to their pages under repos/.

Only document what you can confirm from the code. If something is unclear,
leave a TODO comment instead of guessing.

Add the new pages to docs.json in a group named "API service".

El agente abre una pull request en el repositorio central. Revísala y corrige cualquier error que haya cometido el agente.

Repite el proceso para cada repositorio

Repite el proceso con tus otros repositorios y, después, pide al agente las páginas de descripción general.

Example prompt

Read every page under repos/ and write architecture.mdx. Describe how the
repositories depend on each other, which services call which, and how a
request moves through the system. Link to the repository pages for details.

Fusiona las pull requests

Cuando se fusionan las pull requests, Mintlify despliega el grafo de conocimiento y lo indexa para la búsqueda y MCP.

Ejecuta Claude Code, Codex o Cursor sobre clones locales y, después, haz push de las páginas al repositorio central.

Configura tu agente de programación

Clona el repositorio central y los repositorios de origen en un mismo directorio principal.

mkdir knowledge-graph && cd knowledge-graph
git clone https://github.com/your-org/docs-hub.git
git clone https://github.com/your-org/web-app.git
git clone https://github.com/your-org/api-service.git
git clone https://github.com/your-org/api-gateway.git

Desde el repositorio central, ejecuta mint agent setup para instalar la skill de Mintlify y conectar el servidor MCP de administración.

cd docs-hub
mint agent setup

Genera la documentación de un repositorio

Inicia tu agente en el directorio principal e indica el repositorio de origen, la carpeta de destino y las páginas que debe escribir.

Example prompt

Read the source code in ../api-service and write documentation for it in
docs-hub/repos/api-service/.

Create these pages:
- index.mdx: what the service does, who owns it, and how it fits into the
  rest of the system
- endpoints.mdx: every HTTP endpoint with method, path, parameters, and
  response shape, based on the route definitions
- data-model.mdx: the main models and database tables
- local-development.mdx: how to install, run, and test the service

For each page, list the other repositories this service calls or is called
by, and link to their pages under docs-hub/repos/.

Only document what you can confirm from the code. If something is unclear,
leave a TODO comment instead of guessing.

Add the new pages to docs-hub/docs.json in a group named "API service".

Revisa el resultado, corrige cualquier error que haya cometido el agente y ejecuta mint dev desde el repositorio central para previsualizar las páginas.

Repite el proceso para cada repositorio

Repite el proceso con tus otros repositorios y, después, pide al agente las páginas de descripción general.

Example prompt

Read every page under docs-hub/repos/ and write docs-hub/architecture.mdx.
Describe how the repositories depend on each other, which services call
which, and how a request moves through the system. Link to the repository
pages for details.

Haz push al repositorio central

Haz commit de las páginas, haz push al repositorio central y abre una pull request. Cuando se fusione, Mintlify desplegará el grafo de conocimiento y lo indexará para la búsqueda y MCP.

git checkout -b initial-knowledge-graph
git add repos architecture.mdx docs.json
git commit -m "Add initial knowledge graph"
git push -u origin initial-knowledge-graph

Guarda los prompts que te hayan funcionado como una skill personalizada o en un archivo AGENTS.md en el repositorio central. Así, quien añada un repositorio nuevo más adelante obtendrá la misma estructura de páginas.

Paso 2: Mantén actualizado el grafo de conocimiento

Crea una automatización personalizada con un activador de cambio de código para que el agente actualice el repositorio central cada vez que se fusione una pull request en un repositorio de origen.

Crea la automatización

Abre la configuración de Automatizaciones.
Haz clic en New automation.
Selecciona el activador Code change.
Haz clic en Add repo para cada repositorio de origen que documentaste en el paso 1. Una automatización puede escuchar hasta 50 repositorios.

Filtra el activador

En Show advanced options de la tarjeta de cada repositorio, configura Listening to changes in con rutas de código fuente como src/** y usa Excluding PRs from para omitir bots. Consulta Filtrar activadores de cambio de código.

Escribe las instrucciones

Indica al agente cómo se corresponden los repositorios con las páginas del repositorio central y qué debe cambiar.

Example instructions

1. Read the merged pull request diff from the trigger repository.
2. Find the matching folder under /repos/ in this project. The folder name
   matches the repository name.
3. Identify changes to endpoints, events, data models, dependencies on
   other repositories, or setup steps.
4. Update the affected pages in that folder. If the change affects how
   repositories depend on each other, also update /architecture.mdx.
5. If the pull request doesn't change anything the documentation covers,
   make no changes.
6. Open a pull request that lists the pages you changed and links to the
   source pull request.

Elige un modo de actualización

Empieza con Modify and wait for review, que abre una pull request y asigna como revisores a los autores del cambio de origen. Cambia a Update and merge changes cuando los resultados sean consistentes. Si usas protección de ramas, consulta Configurar la fusión automática.

Prueba la automatización

Guárdala y ejecútala manualmente; después, revisa el historial de ejecuciones y ajusta las instrucciones.

Este simulador usa una automatización que escucha src/** en los tres repositorios de ejemplo y excluye a dependabot[bot]. Para añadir un repositorio más adelante, genera sus páginas como en el paso 1 y, después, añádelo al activador. Cada ejecución que actualiza el repositorio central consume créditos, y las ejecuciones que no cambian nada son gratuitas. En repositorios con mucha actividad, un activador programado agrupa muchas fusiones en una sola ejecución. Consulta Controlar el uso de créditos.

La estimación supone que cada fusión cambia código documentado, por lo que el uso real probablemente sea menor.

Paso 3: Usa el grafo de conocimiento mediante MCP

Cada proyecto tiene un servidor MCP de búsqueda alojado en la ruta /mcp de la URL de tu sitio. Si usas autenticación, utiliza /authed/mcp y, antes, habilita el MCP autenticado.

Claude Code
Codex
Cursor

claude mcp add --transport http knowledge-graph https://docs.your-company.com/mcp

codex mcp add knowledge-graph --url https://docs.your-company.com/mcp

Añade el servidor a .cursor/mcp.json en tu proyecto, o a ~/.cursor/mcp.json para todos los proyectos.

.cursor/mcp.json

{
  "mcpServers": {
    "knowledge-graph": {
      "url": "https://docs.your-company.com/mcp"
    }
  }
}

Consulta Usar tu servidor MCP para otros clientes. Para que los agentes lo consulten sin que se lo pidas, añade una línea al archivo CLAUDE.md, AGENTS.md o de reglas de Cursor en cada repositorio de origen.

AGENTS.md

Before changing code that calls another service or repository, search the
knowledge-graph MCP server for that service. Use its documented endpoints,
data models, and conventions instead of guessing.

Así es como un agente usa las herramientas de MCP para responder preguntas sobre tu código: Cuando un agente encuentra una página incorrecta, puede informar de ello con la herramienta de comentarios. Los informes aparecen en tu dashboard de comentarios.

Próximos pasos

Automatizaciones

Conoce los tipos de activadores, los modos de actualización y los límites de uso.

Servidor MCP de búsqueda

Configura la indexación, la autenticación y las credenciales de cliente de tu servidor MCP.

Skills

Enseña a los agentes a usar tu grafo de conocimiento con archivos de skills.

Autenticación

Restringe el grafo de conocimiento a tu equipo.

Descripción general

IA

Documentación de la API

Mejores prácticas

Git

Casos de uso

Usa Mintlify como grafo de conocimiento de tu código

Requisitos previos

Planifica la estructura

Paso 1: Genera el grafo de conocimiento inicial

Paso 2: Mantén actualizado el grafo de conocimiento

Paso 3: Usa el grafo de conocimiento mediante MCP

Próximos pasos

Automatizaciones

Servidor MCP de búsqueda

Skills

Autenticación

​Requisitos previos

​Planifica la estructura

​Paso 1: Genera el grafo de conocimiento inicial

​Paso 2: Mantén actualizado el grafo de conocimiento

​Paso 3: Usa el grafo de conocimiento mediante MCP

​Próximos pasos

Automatizaciones

Servidor MCP de búsqueda

Skills

Autenticación

Requisitos previos

Planifica la estructura

Paso 1: Genera el grafo de conocimiento inicial

Paso 2: Mantén actualizado el grafo de conocimiento

Paso 3: Usa el grafo de conocimiento mediante MCP

Próximos pasos