# Usa la documentación con IA

{% columns %}
{% column width="41.66666666666667%" %}
Cada página de 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 con tus herramientas de IA a través de MCP.
{% endcolumn %}

{% column width="58.33333333333333%" %}

<figure><img src="/files/65447cfa9704a67700ebe29c8e55327be6a11822" alt="" width="269"><figcaption></figcaption></figure>
{% 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 sin formato en una nueva pestaña     | Inspecciona la fuente sin procesar o copia secciones específicas manualmente                                  |
| **Copiar** (en bloques de código) | Copia un bloque de código directamente                         | Úsalo para `curl` comandos, cargas útiles JSON y fragmentos de configuración para evitar errores de selección |
| **Abrir en ChatGPT**              | Abre la página en ChatGPT con el contenido cargado previamente | Haz preguntas o resume sin pegar nada                                                                         |
| **Abrir en Claude**               | Abre la página en Claude con el contenido cargado previamente  | Haz preguntas o resume sin pegar nada                                                                         |
| **Exportar como PDF**             | Descarga la página como PDF                                    | Guarda una captura para usarla sin conexión o compartirla fuera de la documentación                           |

### Uso de Abrir en ChatGPT y Abrir en Claude

Ambos accesos directos envían automáticamente la página actual como contexto. Puedes empezar a escribir indicaciones 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 empezar:**

* Resume esta página antes de leerla completa.
* Convierte esto en una lista de verificación de prerrequisitos.
* Genera casos límite e ideas de pruebas a partir de esta referencia.
* Explica qué hace \[parameter] y cuándo lo cambiaría.
  {% endcolumn %}

{% column %}
**Cómo obtener mejores resultados:**

Añade una restricción para dar forma a la respuesta. Pide "solo pasos", "devuelve JSON" o "primero supuestos". Si la página es larga, especifica en qué sección quieres que se centre el asistente.
{% endcolumn %}
{% endcolumns %}

## Conectar el servidor MCP a tus herramientas de IA

Los accesos directos de página anteriores funcionan bien cuando ya tienes abierta la página correcta. 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 bajo demanda, sin que tengas que encontrar y abrir la página primero. Esto es especialmente útil durante el desarrollo activo, cuando te mueves entre varias 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 las secciones específicas que utilizó.

### Punto de conexión MCP

El servidor MCP es público y no requiere autenticación:

```
https://navixy.com/docs/~gitbook/mcp
```

También puedes copiar esta URL directamente desde la opción **Conectar con MCP** en el menú de accesos directos de la página.

### Conectar servidor MCP

Usa la configuración a continuación para las herramientas más comunes. MCP funciona con cualquier cliente que admita la configuración de `mcpServers` .

{% tabs %}
{% tab title="Claude Desktop" %}
{% hint style="info" %}
Consulta la [documentación oficial de Claude](https://code.claude.com/docs/en/mcp) para obtener la información más reciente sobre el uso de MCP con Claude.
{% endhint %}

1. En Claude, ve a **Configuración** y selecciona **Desarrollador**.&#x20;
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://navixy.com/docs/~gitbook/mcp"
      ]
    }
  }
}
```

3. Cierra Claude por completo y vuelve a iniciarlo. Recargar la ventana no es suficiente.
   {% endtab %}

{% tab title="Cursor" %}
{% hint style="info" %}
Consulta la [documentación oficial de Cursor](https://cursor.com/docs/mcp) para obtener la información más reciente sobre el uso de MCP con Cursor.
{% endhint %}

1\. Ve a **Configuración**, abre la pestaña **MCP** y selecciona **Add new global MCP server**. Esto abre `~/.cursor/mcp.json`. Para una configuración con alcance 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://navixy.com/docs/~gitbook/mcp"
      ]
    }
  }
}
```

3. Cierra Cursor por completo y vuelve a iniciarlo. Recargar la ventana no es suficiente.
   {% endtab %}

{% tab title="VS Code" %}
{% hint style="info" %}
Consulta la [documentación oficial de VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) para obtener la información más reciente sobre el uso de MCP con VS Code.
{% endhint %}

Si usas VS Code, esta es la ruta de configuración más rápida. Selecciona **Connect to VSCode** en el menú de accesos directos de la página. Esto abre una indicación 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 configuración de `mcpServers` , pega:

```json
{
  "mcpServers": {
    "navixy-docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://navixy.com/docs/~gitbook/mcp"
      ]
    }
  }
}
```

* Si la extensión admite puntos de conexión 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 por completo y vuelve a iniciarlo.
   {% 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://navixy.com/docs/~gitbook/mcp"
      ]
    }
  }
}
```

Si admite MCP sobre HTTP directamente, usa la URL del punto de conexión en su lugar:

```
https://www.navixy.com/docs/~gitbook/mcp
```

En ambos casos, reinicia la herramienta por completo después de añadir 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 MCP de la documentación navixy-docs.
¿Qué páginas cubren los flujos de IoT Logic?
Enumera 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 está funcionando. Una vez confirmado, puedes pedirle al asistente que recupere cualquier página, encuentre endpoints o siga un flujo de trabajo completo a través de varias secciones de la documentación.

## Solución de problemas

**No cambió nada después de añadir el servidor.** Reinicia la herramienta por completo. Cierra la aplicación y ábrela de nuevo. 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 breve de la sección a la que hizo referencia para confirmar que recuperó el contenido correcto.

**El contenido pegado se ve dañado.** Comprueba si hay líneas envueltas. Esto es más común con `curl` comandos y rutas API largas copiadas de la documentación.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://navixy.com/docs/home/es/documentacion-de-navixy/usa-la-documentacion-con-ia.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.