​
Por qué importa la documentación

La documentación proporciona contexto actual y preciso. Sin ella, los modelos utilizan datos de entrenamiento desactualizados o incompletos. La documentación ayuda a los modelos a entender cosas como:
  • APIs y parámetros actuales
  • Mejores prácticas
  • Convenciones de la organización
  • Terminología del dominio
Y mucho más. Continúa leyendo para aprender cómo usar la documentación directamente en Cursor sin tener que cambiar de contexto.

​
Límite de conocimiento del modelo

Los modelos de lenguaje grandes se entrenan con datos hasta un punto específico en el tiempo, llamado “límite de conocimiento”. Esto significa:
  • Las actualizaciones recientes de librerías podrían no estar reflejadas
  • Los nuevos frameworks o herramientas pueden ser desconocidos
  • Los cambios en APIs posteriores a la fecha límite se pierden
  • Las mejores prácticas pueden haber evolucionado desde el entrenamiento
Por ejemplo, si el límite de conocimiento de un modelo es a principios de 2024, no conocerá las características lanzadas a finales de 2024, incluso para frameworks populares.

​
¿Qué herramienta debo usar?

Usa este árbol de decisión para determinar rápidamente el mejor enfoque para tus necesidades de documentación:

​
Modelo mental

HerramientaModelo Mental
@DocsComo navegar y leer documentación oficial
@WebComo buscar soluciones en internet
MCPComo acceder a tu documentación interna

​
Documentación pública

La documentación externa cubre información disponible públicamente sobre la cual los modelos podrían tener conocimiento limitado o desactualizado. Cursor proporciona dos formas principales de acceder a esta información.

​
Usando @Docs

@Docs conecta Cursor con la documentación oficial de herramientas y frameworks populares. Úsalo cuando necesites información actual y autorizada sobre:
  • Referencias de API: Firmas de funciones, parámetros, tipos de retorno
  • Guías de inicio: Configuración, configuración inicial, uso básico
  • Mejores prácticas: Patrones recomendados desde la fuente
  • Depuración específica del framework: Guías oficiales de resolución de problemas
@
@Docs Next.js ¿Cómo configuro el enrutamiento dinámico con rutas catch-all?
∞
Agent⌘I
Auto

​
Usando @Web

@Web busca en internet en vivo información actual, publicaciones de blog y discusiones de la comunidad. Úsalo cuando necesites:
  • Tutoriales recientes: Contenido y ejemplos generados por la comunidad
  • Comparaciones: Artículos que comparan diferentes enfoques
  • Actualizaciones recientes: Actualizaciones o anuncios muy recientes
  • Múltiples perspectivas: Diferentes enfoques para problemas
@
@Web últimas optimizaciones de rendimiento para React 19
∞
Agent⌘I
Auto

​
Documentación interna

La documentación interna incluye información específica de tu organización que los modelos de IA nunca han encontrado durante el entrenamiento. Esto podría ser:
  • APIs internas: Servicios personalizados y microservicios
  • Estándares de la empresa: Convenciones de codificación, patrones de arquitectura
  • Sistemas propietarios: Herramientas personalizadas, bases de datos, flujos de trabajo
  • Conocimiento del dominio: Lógica de negocio, requisitos de cumplimiento

​
Accediendo a documentación interna con MCP

Model Context Protocol (MCP) proporciona una forma estandarizada de traer tu documentación privada y sistemas a Cursor. MCP actúa como una capa delgada entre Cursor y tus recursos internos. Por qué MCP es importante:
  • Los modelos no pueden adivinar tus convenciones internas
  • La documentación de API para servicios personalizados no está disponible públicamente
  • La lógica de negocio y el conocimiento del dominio es único para tu organización
  • Los requisitos de cumplimiento y seguridad varían según la empresa

​
Integraciones MCP comunes

IntegraciónAccesoEjemplos
ConfluenceEspacios de Confluence de la empresaDocumentación de arquitectura, especificaciones de API para servicios internos, estándares y guías de codificación, documentación de procesos
Google DriveDocumentos y carpetas compartidasDocumentos de especificación, notas de reuniones y registros de decisiones, documentos de diseño y requisitos, bases de conocimiento del equipo
NotionBases de datos y páginas del espacio de trabajoDocumentación de proyectos, wikis del equipo, bases de conocimiento, requisitos de producto, especificaciones técnicas
PersonalizadoSistemas internos y bases de datosAPIs propietarias, sistemas de documentación heredados, bases de conocimiento personalizadas, herramientas y flujos de trabajo especializados

​
Soluciones personalizadas

Para necesidades únicas, puedes construir servidores MCP personalizados que:
  • Extraigan información de sitios web o portales internos
  • Se conecten a bases de datos propietarias
  • Accedan a sistemas de documentación personalizados
  • Extraigan de wikis internos o bases de conocimiento
Si construyes un servidor MCP personalizado, también puedes exponer herramientas para que Cursor actualice la documentación
Ejemplo de servidor MCP personalizado para extraer documentación interna: 
import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import TurndownService from "turndown";

// Crear un servidor MCP para extraer documentación interna
const server = new McpServer({
  name: "internal-docs",
  version: "1.0.0"
});

const turndownService = new TurndownService();

// Agregar herramienta para extraer documentación interna
server.tool("get_doc",
  { url: z.string() },
  async ({ url }) => {
    try {
      const response = await fetch(url);
      const html = await response.text();
      
      // Convertir HTML a markdown
      const markdown = turndownService.turndown(html);
      
      return {
        content: [{ type: "text", text: markdown }]
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: `Error extrayendo ${url}: ${error.message}` }]
      };
    }
  }
);

// Comenzar a recibir mensajes en stdin y enviar mensajes en stdout
const transport = new StdioServerTransport();
await server.connect(transport);

​
Mantener la documentación actualizada

La documentación se vuelve obsoleta rápidamente. Cursor puede ayudarte a mantener documentación actual y útil generándola y actualizándola basándose en tu código real y conversaciones de desarrollo.

​
Desde código existente

Usa Cursor para crear documentación directamente desde tu base de código:
@
Genera documentación de API para este router de Express, incluyendo todos los endpoints, parámetros y formatos de respuesta
∞
Agent⌘I
Auto

​
Desde sesiones de chat

Tus conversaciones con Cursor contienen intención valiosa que puede convertirse en documentación.
Después de resolver un problema complejo:
@
Resume nuestra conversación sobre la configuración de autenticación en una guía paso a paso para la wiki del equipo
∞
Agent⌘I
Auto

​
Conclusiones clave

  • La documentación como contexto hace que Cursor sea más preciso y actual
  • Usa @Docs para documentación oficial y @Web para conocimiento de la comunidad
  • MCP conecta Cursor con tus sistemas internos
  • Genera documentación a partir del código y conversaciones para mantener el conocimiento actualizado
  • Combina fuentes de documentación externas e internas para una comprensión integral