Este artículo explica cómo integrar Scanova con herramientas impulsadas por LLM como ChatGPT, LangChain, AutoGen, Cursor, Claude Desktop y otras, utilizando el Protocolo de Contexto de Modelo (MCP).
Introducción
El Protocolo de Contexto de Modelo (MCP) permite una integración segura entre una cuenta de Scanova y herramientas de IA o entornos de desarrollo como ChatGPT, LangChain, AutoGen, VS Code, Cursor y Claude Desktop. Usando MCP, los usuarios pueden generar, administrar y descargar Códigos QR directamente desde aplicaciones compatibles con MCP, reduciendo pasos manuales y permitiendo la automatización.
Esta integración es ideal para desarrolladores y equipos técnicos que trabajan con flujos de trabajo de Códigos QR a gran escala o impulsados por IA.
A. Generar un token MCP desde Scanova
Para vincular de forma segura una cuenta de Scanova con una herramienta compatible con MCP, siga estos pasos:
Inicie sesión en la cuenta de Scanova
Desde la barra lateral izquierda, vaya a Integraciones > Protocolo de Contexto de Modelo (MCP)
Haga clic en Configurar
Haga clic en Generar Token
El token generado sirve como credencial de autorización para el servidor MCP. Debe almacenarse de forma segura y no compartirse públicamente.
B. Configurar el cliente MCP
Una vez generado el token, debe añadirse al archivo de configuración de la herramienta compatible con MCP. A continuación, se muestran configuraciones de ejemplo para entornos comúnmente usados:
Para Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "YOUR_SCANOVA_API_KEY_HERE"
}
}
}
}
Para VS Code (~/.vscode/mcp.json):
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "YOUR_SCANOVA_API_KEY_HERE"
}
}
}
}
Para Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "YOUR_SCANOVA_API_KEY_HERE"
}
}
}
}
Reemplace YOUR_SCANOVA_API_KEY_HERE con el token generado en el Paso A.
C. Herramientas y acciones compatibles
El servidor MCP de Scanova soporta una variedad de acciones que pueden activarse usando comandos en texto plano o directamente a través de herramientas compatibles con MCP:
| Herramienta | Descripción | Frase de Ejemplo |
|---|---|---|
create_qr_code |
Crear un nuevo Código QR | “crear qr”, “hacer código qr” |
list_qr_codes |
Listar todos los Códigos QR | “listar códigos qr”, “mostrar qrs” |
update_qr_code |
Editar nombre o URL de un Código QR | “actualizar qr”, “editar código qr” |
retrieve_qr_code |
Obtener detalles del Código QR | “obtener detalles qr”, “info qr” |
download_qr_code |
Descargar imagen del Código QR | “descargar qr”, “obtener imagen qr” |
activate_qr_code |
Reactivar un Código QR desactivado | “activar qr” |
deactivate_qr_code |
Desactivar un Código QR | “desactivar qr” |
Estas herramientas usan la API de Scanova a través de la capa MCP para garantizar una experiencia fluida y segura.
D. Repositorio público en GitHub para Scanova MCP
Scanova ofrece un servidor MCP de código abierto que puede clonarse, extenderse o ejecutarse localmente para propósitos de desarrollo.
Visite: Scanova MCP en GitHub
El repositorio incluye:
Pasos de instalación
Instrucciones para despliegue con Docker
Guías para pruebas locales
Lista completa de herramientas y endpoints de API soportados
E. Solución de problemas
| Problema | Acción Sugerida |
|---|---|
| “Se requiere clave API” | Asegúrese de que el token esté correctamente añadido bajo Authorization en el archivo de configuración |
| Error de “Token inválido” | Genere nuevamente el token desde el panel de Scanova |
| “Error de conexión” | Confirme que la URL sea correcta y que haya acceso a internet |
| “Herramienta no encontrada” | Reinicie el IDE y asegúrese de que la configuración sea válida |
El estado de salud del servidor MCP puede verificarse visitando: https://mcp.scanova.io/health
Si se necesita más ayuda
Para orientación adicional o ayuda con la configuración de MCP, los usuarios pueden visitar esta base de conocimientos o contactar al equipo de atención al cliente en support@scanova.io.