Servidor MCP
Conecte Claude, Cursor, Codex o cualquier cliente MCP a los registros de cumplimiento de un restaurante con una URL y su clave de API.
BackResto ejecuta un servidor Model Context Protocol en
https://api.backresto.com/mcp. Conecte a él su herramienta de IA con su clave
de API y podrá hacer preguntas sobre los registros de un restaurante en la
propia interfaz de la herramienta: sin código, nada que instalar por nuestra
parte, nada que alojar por la suya.
Lee a través de la misma API Partner que todo lo demás, con la misma clave. No puede ver nada que la clave no pudiera ver ya: las concesiones por restaurante y por alcance las aplica la API, no la herramienta que conecte.
Conecte su herramienta
Primero necesita una clave; vea Obtener una clave. Después, elija su herramienta:
Elija su herramienta
Registrar el servidor
Abra un terminal y ejecute este comando, con su clave en lugar de brp_YOUR_KEY.
shellclaude mcp add --transport http --scope user backresto \ https://api.backresto.com/mcp \ --header "Authorization: Bearer brp_YOUR_KEY"Comprobar la conexión
Inicie Claude Code y escriba /mcp. backresto aparece como conectado, con cuatro herramientas.
Listo
Pregunte por sus entregas con palabras normales. La clave ya sabe cuál es su restaurante.
Las herramientas
Ocho herramientas, agrupadas por lo que leen.
Entregas
| Herramienta | Qué hace |
|---|---|
backresto_list_deliveries | Lista las entregas de un intervalo ordenado en milisegundos epoch de como mucho 366 días. Recibe from, to, y opcionalmente limit (1–100, 50 por defecto) y cursor. |
backresto_get_delivery | Obtiene una entrega por su deliveryId. |
backresto_get_delivery_photos | Muestra las fotografías de una entrega, cada una devuelta como una imagen que el modelo puede mirar, con su URL prefirmada. Requiere delivery-images:read. |
| Herramienta | Qué hace |
|---|---|
backresto_list_collections | Lista las colecciones concedidas a esta clave, con el alcance que abre cada una. Es la primera llamada adecuada cuando no sabe qué alcanza la clave. |
backresto_list_records | Lee una página de registros de una colección, lápidas incluidas. Recibe collection, y opcionalmente limit (1–100, 50 por defecto) y cursor. |
backresto_get_record | Obtiene un registro por collection y recordId. |
backresto_list_record_assets | Lista los archivos adjuntos a un registro —cleaning-task-pictures, traceability-labels o drive-files— como URL firmadas. |
Ambas
| Herramienta | Qué hace |
|---|---|
backresto_list_restaurants | Lista los restaurantes que alcanza la clave, con sus alcances en cada uno. |
restaurantId es opcional en todas partes. Si lo omite, se usa el restaurante
de la clave: un restaurante con una sola clave nunca necesita conocer su
identificador. Solo una clave que alcanza varios restaurantes tiene que elegir,
y el error nombra las opciones.
Las ocho están declaradas de solo lectura e idempotentes, así que un cliente bien hecho no le pedirá permiso en cada llamada como lo hace con una herramienta que escribe.
Dos límites prácticos. Las fotografías se incrustan para el modelo hasta diez imágenes y unos 7,5 MB por respuesta; lo que pase de ahí sigue apareciendo en el resumen, con su URL y el motivo por el que no se mostró. Y todo el endpoint comparte el presupuesto de la API de partners, 300 peticiones por minuto y clave: una llamada a una herramienta es una petición, algo a lo que una conversación nunca se acercará y un bucle sí.
Proteger la clave
La clave es todo su acceso, y la configuración de un cliente MCP es un archivo corriente en un portátil.
- Nunca haga commit de ese archivo. Si su herramienta guarda la configuración en un repositorio, haga referencia a una variable de entorno o a un almacén de secretos del sistema, como hace la configuración de Codex de arriba.
- Dé a cada máquina su propia clave. Una clave por portátil significa que un portátil perdido cuesta una revocación, no una rotación en todas sus integraciones.
- Pregúntenos cuándo se usó una clave por última vez si sospecha que queda una copia activa en algún sitio. Vemos la última autenticación de cada clave, y una revocación es el mismo correo.
Iniciar sesión con su cuenta de BackResto
Algunas herramientas, como los conectores personalizados de claude.ai, se conectan enviándole a una página de inicio de sesión en lugar de pedir una clave. Eso requiere un inicio de sesión OAuth con su cuenta de BackResto, que todavía no está disponible. Todas las herramientas de arriba funcionan hoy con una clave. Si el inicio de sesión es lo que le separa de una integración, dígalo: sube en la lista.
En qué es buena
En concreto, con las herramientas conectadas, un responsable de operaciones puede preguntar:
- «¿Qué entregas se rechazaron el mes pasado, y por qué?»
- «Muéstreme todas las entregas de pollo por encima de 4 °C este trimestre.»
- «Muéstreme las fotos de la entrega rechazada el martes: ¿se ve el daño?»
- «¿Qué neveras se salieron de rango más a menudo, y en qué zona?»
- «¿Bajaron a tiempo todos los ciclos de enfriamiento la semana pasada?»
- «¿Qué tareas de limpieza se saltaron, y cuáles no tienen fotografía?»
Las tres primeras leen entregas; el resto leen colecciones, y solo aquellas que se le concedieron a su clave. Las respuestas salen de los mismos registros que leería un inspector, a través de las mismas concesiones que emitió el restaurante.
A un modelo que lee colecciones hay que decirle qué está leyendo: una instantánea de lo que recibió la API, no un historial completo garantizado. Si pone esto delante de un cliente, ponga esa frase al lado.