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 de partners que todo lo demás, con la misma clave. No puede ver nada que la clave no pudiera ver ya: las concesiones de restaurante y de scope 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
Añadir un conector personalizado
En Claude, en la aplicación de escritorio o en claude.ai, abra Personalizar, luego Conectores, y haga clic en Añadir conector personalizado. En un plan Team o Enterprise, un propietario lo añade primero una vez en la configuración de la organización.
Póngale nombre y pegue la dirección
Llámelo BackResto y pegue esta URL. En Autenticación y Cliente OAuth, Claude detecta nuestro servidor y preselecciona Iniciar sesión ahora y Registrarse automáticamente: mantenga esas dos opciones. No introduzca ID de cliente ni secreto. Luego haga clic en Añadir.
URLhttps://api.backresto.com/mcpConéctese con su clave
Haga clic en Conectar. Se abre una página de BackResto: pegue su clave, que empieza por brp_, y haga clic en Conectar. Claude vuelve con el conector activado y sus cinco herramientas.
Listo
Pregunte con palabras normales por lo que registra su restaurante: temperaturas, limpieza, etiquetas, entregas. La clave ya sabe cuál es.
Las herramientas
Cinco herramientas: una que encuentra el restaurante, y cuatro que leen sus colecciones.
| Herramienta | Qué hace |
|---|---|
backresto_list_restaurants | Lista los restaurantes que alcanza la clave, con sus scopes en cada uno. |
backresto_list_collections | Lista las colecciones concedidas a esta clave, con el scope 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, tombstones incluidos. 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, delivery-pictures, traceability-labels o drive-files) como URL firmadas, y muestra las fotografías al modelo como imágenes que puede mirar. |
Las entregas son dos de esas colecciones, deliveries y delivery-pictures, y
se leen con las mismas herramientas que todo lo demás. Consulte
Entregas para saber qué significan sus campos.
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 cinco 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 llamada a backresto_list_record_assets; 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.
Conectarse solo con la URL
Claude (aplicación de escritorio y claude.ai), ChatGPT y otras herramientas que solo piden una URL de servidor se conectan por OAuth: se registran solas en BackResto y luego abren una página de BackResto donde pega su clave una vez. Nada que instalar y ningún archivo de configuración. La herramienta guarda la clave y la envía por usted: llega exactamente a lo que llega la clave, y revocar la clave la desconecta.
Todavía no existe el inicio de sesión con una cuenta de BackResto: la clave sigue siendo la credencial. Si eso 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 las colecciones deliveries y delivery-pictures, el
resto leen otras colecciones, y cada una de ellas solo lo
que se le concedió 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: un snapshot de lo que recibió la API, no un historial completo garantizado. Si pone esto delante de un cliente, ponga esa frase al lado.