Superficie de API e integración
Cómo los socios y desarrolladores se integran con Fooodo — el servidor MCP público, el conector POS y los contratos de marca blanca, qué está abierto y qué cerrado hoy, y la hoja de ruta de integración.
La superficie de integración pública de Fooodo es pequeña y enfocada. Esta página documenta qué está abierto hoy, qué está cerrado y qué figura en la hoja de ruta.
Qué está abierto hoy
Servidor MCP
Fooodo ejecuta un servidor Model Context Protocol (MCP) en /api/mcp para que los agentes de AI consulten el manual y realicen un número reducido de acciones acotadas en nombre de un comprador. Los agentes leen el manual sin hacer scraping de HTML y envían solicitudes estructuradas sin rellenar formularios HTML — de modo que los asistentes de soporte a socios, los copilotos de alcance de integración y los agentes de compras del lado del comprador se mantienen anclados en datos canónicos y llegan al buzón correcto.
# Connect from Claude Desktop, Cursor, or any MCP-compatible client:
mcp connect https://fooodo.com/api/mcpHerramientas de lectura (sin efectos secundarios):
| Herramienta | Devuelve |
|---|---|
list_docs | Todas las páginas del manual con slug, título y descripción en una línea. |
get_doc({ slug }) | El contenido MDX procesado de una sola página. |
search_docs({ query }) | Búsqueda por subcadena en títulos, descripciones y cuerpos, con un fragmento alrededor de cada coincidencia. |
list_pos_connectors | Conectores POS activos y la política de alcance por cliente para el resto. |
get_pricing_scope({ locations?, region? }) | Modelo de contratación (suscripción por ubicación, EUR), indicadores de segmento (Insights incluido a partir de 5 ubicaciones, Enterprise a partir de 150) y un veredicto de idoneidad para los datos introducidos por el comprador. No devuelve un precio — la plataforma se cotiza por cliente; esta herramienta devuelve la forma del contrato para que el agente del comprador pueda cualificar antes de solicitar una oferta. |
Herramienta de acción (envía un correo electrónico al equipo de Fooodo):
| Herramienta | Hace |
|---|---|
request_walkthrough({ name, email, variant?, company?, role?, locations?, message?, locale?, agent_origin? }) | Envía un correo electrónico de lead a operaciones en nombre del comprador que representa el agente. Las respuestas llegan a email en un plazo de dos días hábiles. variant tiene como valor predeterminado demo; pasa pricing para una oferta, partner para interés como revendedor, developer para el alcance de integración API/MCP. agent_origin se muestra en el correo para que operaciones pueda clasificar los leads generados por agentes de forma separada a los envíos de formularios. |
La herramienta de acción tiene límite de velocidad por correo electrónico del comprador (3 por hora) y toda la superficie MCP tiene límite de velocidad por IP (60 llamadas por minuto). Los correos de lead se enrutan a info@fooodo.com de forma predeterminada.
Servidor MCP de Insights (por tenant)
Con cada tenant de Fooodo Insights se incluye un servidor MCP independiente. Mientras que el MCP del manual anterior expone el contenido público de Fooodo y la acción de captación de leads, el MCP de Insights expone los análisis operativos propios de ese tenant — resúmenes por período, rendimiento por canal y producto, datos de P&L, tres agentes especialistas de AI, el orquestador entre dominios y un conjunto acotado de acciones de escritura como activar importación de datos y resolver alerta.
El servidor utiliza OAuth 2.1 con Dynamic Client Registration sobre Streamable HTTP, por lo que cualquier cliente compatible con MCP se conecta con el mismo flujo de un solo clic. La funcionalidad está desactivada por organización de forma predeterminada; la habilitación y el aprovisionamiento de la URL del tenant se gestionan a través de support@fooodo.com. Inventario completo de herramientas, configuración por cliente y detalles de seguridad: Servidor MCP de Insights.
Índice del sitio optimizado para LLM
/llms.txt proporciona un índice plano y estructurado de todas las páginas públicas del sitio de marketing y del manual. /llms-full.txt es el mismo manual concatenado como un único documento Markdown para su ingestión en un solo paso. Ambos son los puntos de entrada canónicos si estás apuntando un LLM a Fooodo.
Sitemap y Open Graph
Superficies estándar — /sitemap.xml cubre los 7 idiomas de marketing × rutas públicas. Las imágenes de Open Graph y Twitter Card se generan por idioma.
Qué está cerrado hoy
La API de pedidos de la aplicación de menú y la API de pagos del servicio de pagos no son públicas. Se ejecutan en infraestructura operada para nuestros socios de despliegue, protegida con credenciales por socio emitidas durante el proceso de incorporación.
Si eres un proveedor de POS que desea integrarse con Fooodo, escribe a hello@fooodo.com — el proceso de integración es manual hoy en día, no de autoservicio.
Con qué se integran realmente los socios
Las modalidades de integración que existen hoy, ordenadas por número de socios que las utilizan:
Conector POS (back-end)
La integración más solicitada. Un nuevo conector POS implementa el mismo contrato de entrada y salida que utiliza R-Keeper (véase Integración con R-Keeper). El conector es un paquete de Laravel añadido a la aplicación de menú — no es un proceso independiente.
Superficie requerida:
- Obtener menú (productos, categorías, modificadores, precios, indicadores fiscales)
- Enviar pedido (crear, actualizar, bloquear, marcar como pagado)
- Estado (restaurante en línea/fuera de línea, estado de la mesa)
R-Keeper es el único conector activo en producción hoy. El contrato del conector en sí es agnóstico al POS — los conectores POS adicionales se definen por cliente y se cotizan bajo demanda. Si eres un proveedor de POS interesado en colaborar en un conector, ponte en contacto a través de partners@fooodo.com.
Despliegue de marca blanca (front-end)
Algunos revendedores ejecutan un despliegue de Fooodo bajo su propia marca. La aplicación orientada al cliente admite configuración de marca a nivel de empresa: logotipo, tokens de color, dominio y marca de pago. Esta es una superficie de configuración, no una API.
Widgets embebidos (ligeros)
El widget AI Ask de este sitio puede embeberse en sitios de socios con una sola etiqueta de script. Otros widgets (vista previa del menú, disponibilidad de mesas) aún no están disponibles, pero figuran en la hoja de ruta.
Autenticación y secretos
Cuando los socios obtienen acceso a la API (paquetes de conector POS, despliegues de marca blanca), la autenticación es mediante token bearer. Los secretos se emiten por entorno; los entornos de staging y producción utilizan tokens separados. No existe un flujo OAuth hoy — los usuarios de la API son demasiado reducidos para justificarlo.
Webhooks (entrantes, para socios) — planificado
Para los despliegues de socios, los webhooks salientes para eventos de pedidos figuran en la hoja de ruta de integración. El conjunto de eventos planificado:
order.createdorder.paidorder.cancelledorder.errored
Los eventos internos que impulsan estos ya existen en el lado de la aplicación de menú; el despachador saliente se configura por socio durante la incorporación en lugar de ejecutarse como un servicio predeterminado. Si necesitas push de eventos como parte de tu integración, indícalo durante el alcance — lo añadimos a tu despliegue como módulo opcional.
Versionado
Las API internas no tienen versión — la aplicación de menú y el servicio de pagos se despliegan conjuntamente para Čili Pizza. Una vez que socios externos estén utilizando la API, introduciremos etiquetas de versión. Aún no hemos llegado a ese punto.
Límites de velocidad
Las API públicas del sitio de marketing (/api/ask, /api/mcp) tienen límite de velocidad por IP. Los límites no están publicados actualmente; están dimensionados para el uso normal de los socios y se relajarán para los socios con un acuerdo en vigor.
Hoja de ruta
En orden aproximado de prioridad:
- Un segundo conector POS — definido por cliente cuando una cadena se compromete con él.
- Un SDK de JS tipado para el flujo de embebido de marca blanca.
- Una API pública de solo lectura para consultas de menú (para que los sitios de socios puedan mostrar «el menú de hoy» sin hacer scraping).
Si necesitas alguno de estos antes, escribe a hello@fooodo.com — la demanda de los socios tiende a adelantarlos en la lista.
Descuentos, cupones y fidelización
El manual del operador para generar tráfico y aumentar el ticket medio a través de Fooodo — descuentos por franja horaria, códigos de cupón, fidelización integrada con el POS, venta cruzada en el proceso de pago, propinas y donaciones.
Fooodo Insights
La capa de inteligencia de decisión con AI para cadenas de restaurantes de 5 a 200 locales — vinculando cada recomendación al EBIT, manteniendo a las personas en el proceso y la arquitectura de seis capas que lo sustenta.