> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP setup

> Conecta Claude, ChatGPT, Perplexity o cualquier cliente compatible con MCP a tu cuenta de Scanova.

<Note>
  Este recorrido está redactado a partir del componente de integración MCP del panel (`McpBody`) y su configuración, además del código fuente real y público del servidor `trycon/scanova-mcp` — no a partir de un recorrido en vivo. La cuenta de prueba provista para esta revisión encontró un desafío de MFA por passkey sin código de respaldo accesible, lo que bloqueó un inicio de sesión automatizado en el navegador antes de poder capturar el panel. Cada URL, lista de pestañas por cliente y paso a continuación se transcribió del propio contenido renderizado del componente, así que debería coincidir exactamente con el panel en vivo — repórtalo si no es así.
</Note>

Hay dos formas de conectarte, según si tu herramienta de IA tiene soporte nativo de conector basado en OAuth.

## Requisito previo

Tu cuenta necesita tener desbloqueada la integración MCP — consulta [Requisitos de acceso](/es/mcp/overview#access-requirements). Si la tarjeta **Integrations → Model Context Protocol** muestra **Upgrade** en lugar de **Connect**, el resto de esta página aún no te aplica.

## Paso 1: Abrir la integración MCP

Desde el panel, ve a **Integrations** y haz clic en la tarjeta **Model Context Protocol**. Esto abre un panel de configuración que muestra la URL de tu servidor MCP de Scanova:

```
https://mcp.scanova.io/mcp
```

con una insignia **OAuth** y un botón de copiar. Esta es la única URL a la que se conecta cada cliente a continuación — es un endpoint real y en vivo (verificado contra el propio código fuente del servidor desplegado y sus respuestas de información `/health`/`/`), no un marcador de posición.

## Opción A: clientes nativos de OAuth (Claude, ChatGPT, Perplexity)

El panel tiene una pestaña por cliente, cada una con sus propios pasos numerados y un par **Client ID** / **Client Secret** mostrado en línea (cópialos desde el propio panel — no se reproducen aquí). Estos son identificadores públicos de conector para ese producto de IA específico, no un secreto personal; de todos modos completas un inicio de sesión OAuth real y das tu consentimiento a Scanova después.

<Tabs>
  <Tab title="Claude">
    <Steps>
      <Step title="Abrir la configuración de conectores">
        En Claude, abre **Settings → Connectors**.
      </Step>

      <Step title="Añadir un conector personalizado">
        Haz clic en **+ Add custom connector**.
      </Step>

      <Step title="Pegar la URL del servidor">
        Pega `https://mcp.scanova.io/mcp` desde el panel.
      </Step>

      <Step title="Pegar las credenciales OAuth">
        Pega el **Client ID** y el **Client Secret** que se muestran en la pestaña de Claude del panel.
      </Step>

      <Step title="Conectar y autorizar">
        Haz clic en **Add**, luego en **Connect**, y aprueba el acceso. Inicia sesión en Scanova cuando se te solicite.
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    <Steps>
      <Step title="Activar el modo de desarrollador">
        En ChatGPT, abre **Settings → Apps → Advanced settings** y activa **Developer mode**.
      </Step>

      <Step title="Crear una app">
        Crea una App y pega `https://mcp.scanova.io/mcp` como la URL del servidor.
      </Step>

      <Step title="Pegar las credenciales OAuth">
        Haz clic en **Advanced OAuth settings** y pega el **Client ID** y el **Client Secret** que se muestran en la pestaña de ChatGPT del panel.
      </Step>

      <Step title="Autorizar">
        Autoriza a Scanova cuando se te solicite, y luego actívalo desde el menú de herramientas en tu chat.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Perplexity">
    <Steps>
      <Step title="Añadir un conector personalizado">
        En Perplexity, abre **Customise → Connectors** y haz clic en **+ Add Custom Connector**.
      </Step>

      <Step title="Nombrarlo y pegar la URL del servidor">
        Añade un nombre y pega `https://mcp.scanova.io/mcp` como la URL del servidor.
      </Step>

      <Step title="Pegar las credenciales OAuth">
        Haz clic en el interruptor **Advanced** y pega el **Client ID** y el **Client Secret** que se muestran en la pestaña de Perplexity del panel.
      </Step>

      <Step title="Añadir y autorizar">
        Haz clic en **Add**, autoriza a Scanova cuando se te solicite y empieza a usarlo en tus conversaciones de Perplexity.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Opción B: clientes basados en archivo de configuración (Cursor, VS Code, Claude Desktop, o cualquier otro)

Para clientes MCP que no tienen una interfaz de conector OAuth nativa — sino que reciben un archivo de configuración JSON — expande **Use a token instead** en la parte inferior del panel. Esto genera una clave de la [Management API](/es/api-reference/management-api/overview) de Scanova con `environment=mcp`, el mismo tipo de token documentado en [Creating an API token](/es/api-reference/management-api/tokens/create). Haz clic en **Generate token** y luego copia el valor mostrado (enmascarado en el panel; el botón de copiar revela el valor completo a tu portapapeles).

Añádelo a la configuración MCP de tu cliente como el valor de la cabecera `Authorization` — este es exactamente el formato documentado en el propio README del servidor:

<CodeGroup>
  ```json Cursor (~/.cursor/mcp.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```

  ```json VS Code (~/.vscode/mcp.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```

  ```json Claude Desktop (claude_desktop_config.json) theme={null}
  {
    "mcpServers": {
      "scanova-mcp": {
        "transport": "http",
        "url": "https://mcp.scanova.io/mcp",
        "headers": {
          "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
        }
      }
    }
  }
  ```
</CodeGroup>

<Warning>
  Coloca el valor sin procesar del token en la cabecera `Authorization` — sin el prefijo `Bearer`. El servidor lee lo que haya en esa cabecera (también acepta `X-API-Key` o `Scanova-API-Key`) y lo reenvía tal cual a la Management API de Scanova, que rechaza cualquier cosa que no sea la clave desnuda.
</Warning>

Reinicia tu IDE/cliente después de guardar la configuración.

## Revocar el acceso

**Clientes por token:** de vuelta en la sección expandida **Use a token instead** del panel, haz clic en el icono de papelera junto al token y confirma. Esto desactiva de inmediato todos los clientes MCP que usan ese token.

**Clientes OAuth (Claude/ChatGPT/Perplexity):** elimina el conector desde la propia lista de conectores/configuración de esa herramienta de IA — usa un token de acceso OAuth estándar emitido a ese cliente específico, independiente de la alternativa por token descrita arriba.

## Solución de problemas

* **"Invalid token" / llamadas a herramientas que fallan con un 401** — el token fue revocado o expiró. Genera uno nuevo y actualiza la configuración de tu cliente.
* **Herramienta no encontrada tras añadir el servidor** — reinicia tu IDE o cliente; la mayoría de los clientes MCP solo obtienen la lista de herramientas una vez, al iniciar o al conectarse.
* **Errores de conexión** — verifica que la URL sea exactamente `https://mcp.scanova.io/mcp` (no `/health` ni el origen sin más) y que tu red pueda alcanzarla.

## Siguiente paso

Consulta [Available tools](/es/mcp/available-tools) para ver todo lo que tu asistente de IA puede hacer ahora.

## Relacionado

* [MCP overview](/es/mcp/overview) — qué hace el servidor, los requisitos de acceso y la compuerta de cupo `INTEGRATION_MCP`.
* [Available tools](/es/mcp/available-tools) — la lista completa y verificada de herramientas disponibles una vez conectado.
* [Create an API token](/es/api-reference/management-api/tokens/create) — el mismo tipo de clave que genera aquí la opción alternativa por token, con `environment=mcp`.
* [Management API overview](/es/api-reference/management-api/overview) — la arquitectura de autenticación de dos hosts contra la que se autentica la alternativa por token.