MCP setup - Scanova API Documentation

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 activada la integración MCP — consulta Requisitos de acceso. 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.

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í. Después completas un inicio de sesión OAuth y das acceso a tu cuenta de Scanova.

Claude
ChatGPT
Perplexity

Abrir la configuración de conectores

En Claude, abre Settings → Connectors.

Añadir un conector personalizado

Haz clic en + Add custom connector.

Pegar la URL del servidor

Pega https://mcp.scanova.io/mcp desde el panel.

Pegar las credenciales OAuth

Pega el Client ID y el Client Secret que se muestran en la pestaña de Claude del panel.

Conectar y autorizar

Haz clic en Add, luego en Connect, y aprueba el acceso. Inicia sesión en Scanova cuando se te solicite.

Activar el modo de desarrollador

En ChatGPT, abre Settings → Apps → Advanced settings y activa Developer mode.

Crear una app

Crea una App y pega https://mcp.scanova.io/mcp como la URL del servidor.

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.

Autorizar

Autoriza a Scanova cuando se te solicite, y luego actívalo desde el menú de herramientas en tu chat.

Añadir un conector personalizado

En Perplexity, abre Customise → Connectors y haz clic en + Add Custom Connector.

Nombrarlo y pegar la URL del servidor

Añade un nombre y pega https://mcp.scanova.io/mcp como la URL del servidor.

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.

Añadir y autorizar

Haz clic en Add, autoriza a Scanova cuando se te solicite y empieza a usarlo en tus conversaciones de Perplexity.

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 de Scanova con environment=mcp, el mismo tipo de token documentado en Crear y gestionar claves de API. 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:

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_MCP_TOKEN"
      }
    }
  }
}

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.

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 para ver todo lo que tu asistente de IA puede hacer ahora.

Relacionado

MCP overview — qué hace el servidor, los requisitos de acceso y la compuerta de cupo INTEGRATION_MCP
Available tools — todas las herramientas disponibles una vez conectado
Crear y gestionar claves de API — el mismo tipo de clave que genera aquí la opción alternativa por token, con environment=mcp
Management API overview — el esquema de autenticación por clave sin procesar contra el que se autentica la alternativa por token

​Requisito previo

​Paso 1: Abrir la integración MCP

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

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

​Revocar el acceso

​Solución de problemas

​Siguiente paso

​Relacionado

Requisito previo

Paso 1: Abrir la integración MCP

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

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

Revocar el acceso

Solución de problemas

Siguiente paso

Relacionado