Por qué la documentación importa

La documentación proporciona contexto actualizado y preciso. Sin ella, los modelos usan datos de entrenamiento obsoletos o incompletos. La documentación ayuda a los modelos a entender cosas como:
  • APIs y parámetros vigentes
  • Mejores prácticas
  • Convenciones de la organización
  • Terminología del dominio
Y mucho más. Sigue leyendo para aprender a 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 implica:
  • Es posible que las actualizaciones recientes de bibliotecas no estén reflejadas
  • Es probable que frameworks o herramientas nuevos no sean conocidos
  • Los cambios de API posteriores a la fecha de corte no se contemplan
  • Las buenas prácticas pueden haber evolucionado desde el entrenamiento
Por ejemplo, si el límite de conocimiento de un modelo es a inicios de 2024, no conocerá funciones lanzadas a finales de 2024, incluso en frameworks populares.

¿Qué herramienta debería 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 la documentación oficial
@WebComo buscar soluciones en internet
MCPComo acceder a tu documentación interna

Documentación pública

La documentación externa abarca información pública sobre la que los modelos pueden tener un conocimiento limitado o desactualizado. Cursor ofrece dos formas principales de acceder a esta información.

Uso de @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 introducción: Configuración, ajustes, uso básico
  • Mejores prácticas: Patrones recomendados por la fuente oficial
  • Depuración específica de frameworks: Guías oficiales de solución de problemas
@
@Docs Next.js How do I set up dynamic routing with catch-all routes?
Agent⌘I
Auto

Uso de @Web

@Web busca en la web información actual, entradas 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
  • Novedades recientes: actualizaciones o anuncios muy recientes
  • Múltiples perspectivas: distintos enfoques para resolver problemas
@
@Web latest performance optimizations for 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 visto durante su entrenamiento. Esto puede incluir:
  • APIs internas: Servicios y microservicios personalizados
  • Estándares de la empresa: Convenciones de codificación, patrones de arquitectura
  • Sistemas propietarios: Herramientas, bases de datos y flujos de trabajo personalizados
  • Conocimiento del dominio: Lógica de negocio, requisitos de cumplimiento normativo

Acceder a documentación interna con MCP

Model Context Protocol (MCP) proporciona una forma estandarizada de incorporar tu documentación y sistemas privados en Cursor. MCP actúa como una capa ligera entre Cursor y tus recursos internos. Por qué MCP importa:
  • Los modelos no pueden adivinar tus convenciones internas
  • La documentación de las APIs de servicios personalizados no está disponible públicamente
  • La lógica de negocio y el conocimiento del dominio son exclusivos de tu organización
  • Los requisitos de cumplimiento y seguridad varían según la empresa

Integraciones comunes de MCP

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 compartidosDocumentos 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 workspaceDocumentación de proyectos, wikis de equipo, bases de conocimiento, requisitos de producto, especificaciones técnicas
CustomSistemas y bases de datos internosAPIs propietarias, sistemas de documentación heredados, bases de conocimiento personalizadas, herramientas y flujos de trabajo especializados

Soluciones personalizadas

Para necesidades específicas, puedes crear servidores MCP personalizados que:
  • Hagan scraping de sitios web o portales internos
  • Se conecten a bases de datos propietarias
  • Accedan a sistemas de documentación personalizados
  • Extraigan información de wikis internos o bases de conocimiento
Si creas un servidor MCP personalizado, también puedes exponer herramientas para que Cursor actualice la documentación
Ejemplo de servidor MCP personalizado para hacer scraping de 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";

// Create an MCP server for scraping internal docs
const server = new McpServer({
  name: "internal-docs",
  version: "1.0.0"
});

const turndownService = new TurndownService();

// Add tool to scrape internal documentation
server.tool("get_doc",
  { url: z.string() },
  async ({ url }) => {
    try {
      const response = await fetch(url);
      const html = await response.text();
      
      // Convert HTML to markdown
      const markdown = turndownService.turndown(html);
      
      return {
        content: [{ type: "text", text: markdown }]
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: `Error scraping ${url}: ${error.message}` }]
      };
    }
  }
);

// Start receiving messages on stdin and sending messages on stdout
const transport = new StdioServerTransport();
await server.connect(transport);

Mantener la documentación actualizada

La documentación se queda obsoleta rápido. Cursor puede ayudarte a mantenerla al día y útil, generándola y actualizándola a partir de tu código real y de tus conversaciones de desarrollo.

Desde código existente

Usa Cursor para generar documentación directamente desde tu código:
@
Genera documentación de la 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 información valiosa que puede convertirse en documentación.
Después de resolver un problema complejo:
@
Resume nuestra conversación sobre cómo configurar la autenticación en una guía paso a paso para el wiki del equipo
Agent⌘I
Auto

Puntos clave

  • Usar la documentación como contexto hace que Cursor sea más preciso y esté al día
  • Usa @Docs para la documentación oficial y @Web para el conocimiento de la comunidad
  • MCP conecta Cursor con tus sistemas internos
  • Genera documentación a partir del código y las conversaciones para mantener el conocimiento actualizado
  • Combina documentación externa e interna para una comprensión completa