Servidor MCP de Insights

Conecta ChatGPT, Claude, Copilot o Gemini a tu tenant de Fooodo Insights mediante el servidor remoto de Model Context Protocol.

Auto-translated · pending native review. The English version is canonical.

Fooodo Insights incluye un servidor remoto Model Context Protocol por tenant. Expone los análisis operativos de tu organización y un conjunto reducido de acciones de escritura acotadas a cualquier cliente de AI que hable MCP — sin claves de API, integraciones personalizadas ni copiar y pegar.

¿Quién puede usarlo? Cualquier cliente de Fooodo Insights con acceso admin, analyst o viewer a un tenant que tenga activado el indicador de funcionalidad mcp_enabled. El indicador está desactivado por defecto en todas las organizaciones; contacta con support@fooodo.com para solicitar la activación y recibir la URL MCP de tu tenant.

Dos servidores MCP, una misma familia de productos. Esta página cubre el servidor MCP de Insights, que expone los análisis operativos por tenant mediante OAuth 2.1. Un servidor MCP del manual de marketing independiente se ejecuta en /api/mcp en fooodo.com y es público — los agentes lo utilizan para conocer qué es Fooodo y enviar solicitudes de contacto comercial. Ambas superficies están deliberadamente separadas: contenido del manual frente a datos de clientes.

Por qué MCP

MCP es el estándar abierto que los clientes de AI utilizan para comunicarse con datos y herramientas remotas — el equivalente para agentes de OAuth + REST. Un único servidor MCP puede añadirse una sola vez y ser reutilizado por ChatGPT, Claude, Copilot, Gemini, Cursor, Windsurf, Zed y la creciente lista de clientes compatibles.

Para los clientes de Fooodo Insights esto significa:

Sin dependencia de proveedor. Tu analista puede hacer la misma pregunta desde ChatGPT hoy y desde Gemini mañana sin reconfigurar nada.
Acciones acotadas y auditadas. Las herramientas de escritura (p. ej. disparar importación de datos, confirmar alerta) requieren el ámbito insights:write y el rol admin o analyst. Cada escritura queda registrada en el registro de auditoría con source: "mcp".
Aislamiento de tenant. Las herramientas están limitadas a la organización del usuario a nivel de base de datos; el acceso entre tenants es imposible.

Conectar desde tu AI

El servidor MCP de Insights utiliza OAuth 2.1 con Dynamic Client Registration, por lo que todos los clientes indicados a continuación emplean el mismo flujo de un clic: pega la URL de tu tenant, haz clic en Conectar, inicia sesión con tu cuenta de Fooodo Insights y aprueba los ámbitos — listo.

Los fragmentos de código siguientes usan <INSIGHTS_MCP_URL> como marcador de posición. Sustitúyelo por la URL que el soporte de Fooodo te envíe tras activar MCP para tu tenant.

ChatGPT (Plus / Pro / Enterprise)

Abre Ajustes → Conectores → Añadir conector personalizado (el Modo Desarrollador debe estar activado).
URL del servidor: <INSIGHTS_MCP_URL>.
Aprueba la página de consentimiento cuando se te solicite.

Claude.ai (Pro y superior)

Abre Ajustes → Conectores → Añadir conector personalizado.
Nombre: Fooodo Insights. URL del servidor: <INSIGHTS_MCP_URL>.
Aprueba la página de consentimiento.

GitHub Copilot (VS Code 1.101+, JetBrains, Visual Studio)

Añade lo siguiente al archivo .vscode/mcp.json de tu espacio de trabajo:

{
  "servers": {
    "fooodo-insights": {
      "type": "http",
      "url": "<INSIGHTS_MCP_URL>"
    }
  }
}

Si utilizas Copilot Business/Enterprise, tu administrador debe habilitar primero la directiva MCP servers in Copilot.

Gemini CLI

Añade lo siguiente a la configuración de Gemini CLI:

{
  "mcpServers": {
    "fooodo-insights": {
      "url": "<INSIGHTS_MCP_URL>",
      "oauth": true
    }
  }
}

Gemini Enterprise

En la consola de Google Cloud, registra el servidor como almacén de datos MCP personalizado:

Campo	Valor
URL del servidor	`<INSIGHTS_MCP_URL>`
Autenticación	OAuth 2.0 (Dynamic Client Registration)
Ámbitos requeridos	`insights:read`, `insights:write`

Qué puede hacer el agente

El servidor expone herramientas en tres niveles. Los clientes deben elegir el nivel más bajo que responda a la pregunta — es más económico, más rápido y determinista.

Nivel 1 — Herramientas de datos (rápidas, deterministas, solo lectura)

Herramienta	Devuelve
`get_period_summary`	Métricas agregadas para un intervalo de fechas — ventas, COGS, EBIT, margen bruto, campañas principales
`get_weekly_sales_data`	Ventas semana a semana con campañas activas y datos de costes
`get_channel_stats`	Métricas de rendimiento por canal (en sala, reparto a domicilio, cocina fantasma, etc.)
`get_daily_performance`	Ventas día a día por canal y restaurante
`get_product_performance`	Clasificación de productos/elementos de menú por margen y volumen
`get_cfo_pnl_data`	Desglose de P&L — ingresos, COGS, personal, OpEx, EBIT — para la vista del panel CFO

Nivel 2 — Agentes especializados (análisis LLM de dominio único)

Herramienta	Devuelve
`consult_financial_analyst`	Análisis del «por qué» exclusivamente financiero, fundamentado en los datos del periodo
`consult_marketing_strategist`	Análisis de uplift causal y atribución de campañas exclusivamente de marketing
`consult_market_research`	Contexto de mercado — estacionalidad, festivos, tendencias de comportamiento del consumidor

Nivel 3 — Orquestador (síntesis multidisciplinar)

Herramienta	Devuelve
`ask_orchestrator`	Enruta una pregunta multidisciplinar a todos los agentes especializados y sintetiza una única respuesta

Búsqueda y recuperación (ChatGPT Deep Research, clientes genéricos)

Herramienta	Devuelve
`search`	Lista de insights e historial de acciones de agentes que coinciden con una consulta — `{id, title, url, snippet}`
`fetch`	Contenido completo de un documento por id obtenido de `search` — `{id, title, text, url, metadata}`

Herramientas de escritura (requieren `insights:write` + rol `admin`/`analyst`)

Herramienta	Acción
`trigger_data_import`	Dispara inmediatamente una obtención de fichero programada y configurada (asíncrono — devuelve un `job_id`)
`acknowledge_alert`	Marca una alerta como confirmada
`resolve_alert`	Resuelve una alerta
`generate_report`	Genera un informe en PDF (asíncrono)
`regenerate_insights`	Vuelve a ejecutar el generador de insights para la organización (asíncrono)
`get_job_status`	Consulta el estado de un trabajo asíncrono

Prompts

weekly_business_review, margin_diagnosis — prompts de comando de barra para ChatGPT Apps y otros clientes compatibles con prompts.

Seguridad y límites

OAuth 2.1 + PKCE, clientes públicos, tokens de actualización rotativos. Los tokens de acceso son JWT HS256 válidos durante una hora. Los tokens de actualización son válidos durante 60 días, se almacenan como hashes SHA-256 y son de un solo uso en la rotación.
Control por organización mediante el indicador de funcionalidad mcp_enabled — desactivado por defecto en todas las organizaciones. La activación se gestiona mediante un ticket de soporte, no mediante un interruptor de autoservicio, para que los clientes puedan escalonar el despliegue.
Límites de frecuencia por nivel y usuario. Herramientas de datos: 60/min; agentes especializados y orquestador: 10 cada 5 min; herramientas de escritura: 5 cada 5 min.
Revocación. Los usuarios pueden revocar cualquier cliente en cualquier momento desde los ajustes de su cuenta (/account/connected-apps en el lado de Insights). Los administradores pueden revocar a nivel de toda la organización.
Registro de auditoría. Cada llamada a una herramienta de escritura queda registrada en el registro de auditoría con source: "mcp", incluyendo el nombre del cliente, el usuario y el payload de entrada.
Aislamiento de tenant a nivel de base de datos. Cada consulta se limita a la organización del usuario antes de salir de la aplicación; el servidor no puede devolver datos de otros tenants.

Para desarrolladores de agentes

URL de descubrimiento: <INSIGHTS_MCP_URL>/.well-known/oauth-authorization-server (y con el sufijo /mcp, según RFC 8414 §3.1).
Metadatos del recurso protegido: <INSIGHTS_MCP_URL>/.well-known/oauth-protected-resource/mcp (según RFC 9728).
Dynamic Client Registration: POST <INSIGHTS_MCP_URL>/register — registro abierto, pero cada autorización sigue requiriendo consentimiento interactivo.
Ámbitos: insights:read (por defecto) e insights:write (para herramientas de escritura).
Transporte: HTTP con streaming, versión del protocolo MCP 2025-06-18.

Estándares seguidos: MCP 2025-06-18, RFC 6749 (OAuth 2.0), RFC 7636 (PKCE), RFC 7591 (Dynamic Client Registration), RFC 8414 (Authorization Server Metadata), RFC 9728 (Protected Resource Metadata).

Servidor MCP de Insights

En esta página