Por qué la documentación importa
- APIs y parámetros vigentes
- Mejores prácticas
- Convenciones de la organización
- Terminología del dominio
Límite de conocimiento del modelo
- 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
¿Qué herramienta debería usar?
Modelo mental
Herramienta | Modelo mental |
---|---|
@Docs | Como navegar y leer la documentación oficial |
@Web | Como buscar soluciones en internet |
MCP | Como acceder a tu documentación interna |
Documentación pública
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
- 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
- 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ón | Acceso | Ejemplos |
---|---|---|
Confluence | Espacios de Confluence de la empresa | Documentación de arquitectura, especificaciones de API para servicios internos, estándares y guías de codificación, documentación de procesos |
Google Drive | Documentos y carpetas compartidos | Documentos de especificación, notas de reuniones y registros de decisiones, documentos de diseño y requisitos, bases de conocimiento del equipo |
Notion | Bases de datos y páginas del workspace | Documentación de proyectos, wikis de equipo, bases de conocimiento, requisitos de producto, especificaciones técnicas |
Custom | Sistemas y bases de datos internos | APIs propietarias, sistemas de documentación heredados, bases de conocimiento personalizadas, herramientas y flujos de trabajo especializados |
Soluciones personalizadas
- 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
Mantener la documentación actualizada
Desde código existente
@
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
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