# Usar la documentación con IA {% columns %} {% column width="41.66666666666667%" %} Cada página en la documentación de Navixy incluye accesos directos integrados para trabajar con asistentes de IA. Úsalos para copiar contenido, abrir páginas directamente en ChatGPT o Claude, o conectar la documentación directamente a tus herramientas de IA mediante MCP. {% endcolumn %} {% column width="58.33333333333333%" %}
{% endcolumn %} {% endcolumns %} ## Accesos directos integrados de la página | Acceso directo | Qué hace | Cuándo usarlo | | --------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | | **Copiar página** | Copia la página completa como Markdown | Pega el contexto completo en cualquier asistente de IA | | **Ver como Markdown** | Abre la página como texto plano en una pestaña nueva | Inspecciona la fuente sin formato o copia secciones específicas manualmente | | **Copiar** (en bloques de código) | Copia un bloque de código directamente | Usar para `curl` comandos, payloads JSON y fragmentos de configuración para evitar errores de selección | | **Abrir en ChatGPT** | Abre la página en ChatGPT con el contenido precargado | Haz preguntas o resume sin pegar nada | | **Abrir en Claude** | Abre la página en Claude con el contenido precargado | Haz preguntas o resume sin pegar nada | | **Exportar como PDF** | Descarga la página como PDF | Guarda una instantánea para uso sin conexión o comparte fuera de la documentación | ### Usar Abrir en ChatGPT y Abrir en Claude Ambos accesos directos envían la página actual como contexto automáticamente. Puedes comenzar a solicitar respuestas de inmediato sin copiar ni pegar. Esto es útil cuando quieres una respuesta rápida sobre una página específica sin cambiar de herramienta manualmente. {% columns %} {% column %} **Buenos prompts para comenzar:** * Resume esta página antes de que la lea por completo. * Convierte esto en una lista de verificación de requisitos previos. * Genera casos límite e ideas de prueba a partir de esta referencia. * Explica qué hace \[parameter] y cuándo lo cambiaría. {% endcolumn %} {% column %} **Obtener mejores resultados:** Añade una restricción para moldear la respuesta. Pide “solo pasos”, “devolver JSON” o “suposiciones primero”. Si la página es larga, especifica en qué sección quieres que se concentre el asistente. {% endcolumn %} {% endcolumns %} ## Conectar el servidor MCP a tus herramientas de IA Los accesos directos de la página anteriores funcionan bien cuando ya tienes la página correcta abierta. MCP (Model Context Protocol) va más allá: permite que tu herramienta de IA busque y recupere cualquier página de la documentación de Navixy a demanda, sin que necesites encontrar y abrir la página primero. Esto es especialmente útil durante el desarrollo activo, cuando te desplazas por múltiples referencias de API, configuraciones de dispositivos y guías de integración en una sola sesión. Una vez conectado, tu herramienta de IA recupera respuestas directamente de la documentación publicada y puede enlazar a las secciones específicas que utilizó. ### Endpoint de MCP El servidor MCP es público y no requiere autenticación: ``` https://www.navixy.com/docs/~gitbook/mcp ``` También puedes copiar esta URL directamente desde el **Conectar con MCP** opción en el menú de accesos directos de la página. ### Conectar servidor MCP Usa la configuración A continuación puedes encontrar pasos de configuración para las herramientas más comunes. MCP funciona con cualquier cliente que admita `mcpServers` configuración. {% tabs %} {% tab title="Claude Desktop" %} 1. En Claude, ve a **Ajustes** y selecciona **Desarrollador**. 2. Selecciona **Editar configuración** para abrir `claude_desktop_config.json`, luego añade lo siguiente: ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` 3. Cierra Claude completamente y vuelve a abrirlo. Recargar la ventana no es suficiente. {% endtab %} {% tab title="Cursor" %} 1\. Ve a **Ajustes**, abre la **MCP** pestaña, y selecciona **Agregar nuevo servidor MCP global**. Esto abre `~/.cursor/mcp.json`. Para una configuración a nivel de proyecto, crea o edita `.cursor/mcp.json` en la raíz de tu proyecto en su lugar. 2. Pega lo siguiente en el archivo: ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` 3. Cierra Cursor completamente y vuelve a abrirlo. Recargar la ventana no es suficiente. {% endtab %} {% tab title="VS Code" %} Si usas VS Code, este es el camino de configuración más rápido. Selecciona **Conectar a VSCode** desde el menú de accesos directos de la página. Esto abre un aviso para instalar el servidor MCP directamente en tu entorno de VS Code sin configuración manual. 1. Abre VS Code y ve a la configuración de la extensión de tu asistente de IA. * Si la extensión admite `mcpServers` configuración, pega: ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` * Si la extensión admite endpoints MCP HTTP directos, usa la URL en su lugar: ``` https://www.navixy.com/docs/~gitbook/mcp ``` Usa el método que documente tu extensión. 2. Cierra VS Code completamente y vuelve a abrirlo. {% endtab %} {% tab title="Otros IDEs" %} Si tu herramienta admite MCP con un comando local, pega la siguiente configuración: ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` Si admite MCP por HTTP directamente, usa la URL del endpoint en su lugar: ``` https://www.navixy.com/docs/~gitbook/mcp ``` En ambos casos, reinicia la herramienta por completo después de agregar el servidor. {% endtab %} {% endtabs %} ### Validar la conexión MCP Después de la configuración, ejecuta este prompt para confirmar que el servidor responde: ``` Usa el servidor de docs MCP navixy-docs. ¿Qué páginas cubren los flujos de IoT Logic? Lista las páginas que encontraste y enlaza cada una. ``` Si la respuesta incluye enlaces a páginas específicas de la documentación de Navixy, la conexión funciona. Una vez confirmada, puedes pedir al asistente que recupere cualquier página, encuentre endpoints o trace un flujo completo a través de múltiples secciones de la documentación. ## Solución de problemas **No cambió nada después de agregar el servidor.** Reinicia la herramienta por completo. Cierra la aplicación y vuelve a abrirla. Recargar la ventana no es suficiente. **El asistente responde pero no cita fuentes.** Pide enlaces explícitamente. También puedes pedirle que cite una frase corta de la sección que referenció para confirmar que recuperó el contenido correcto. **El contenido pegado parece roto.** Comprueba si hay líneas envueltas. Esto es más común con `curl` comandos y rutas largas de API copiadas de la documentación.