Autenticación y seguridad
Delimita el negocio, minimiza permisos y trata las fuentes importadas como datos no confiables.
Servidor 1.0 · MCP 2025-11-25 · Claves Bearer por negocio
En esta página
Una credencial, un negocio
Las claves nuevas tienen formato zoy_menu_<slug>_<secreto>. El endpoint principal utiliza el slug como candidato y valida el hash de la clave en el negocio. El nombre incluido en el token no concede acceso por sí solo. Las claves heredadas sin slug necesitan el host del negocio.
La clave sigue dependiendo del permiso actual de su propietario, la membresía, la suspensión, la fecha de vencimiento y la revocación. Cada solicitud vuelve a validar el acceso; los trabajos documentales también comprueban autorización antes de procesar páginas.
- Crea claves separadas para desarrollo, producción, proveedor y agente.
- Comienza con Solo consultar y habilita escritura únicamente para las tareas que la necesitan.
- Rota creando otra clave, actualizando el consumidor y comprobando una lectura antes de revocar la anterior.
- No envíes la clave en URLs, prompts, capturas o logs. No la reenvíes a un POS ni al proveedor de IA.
- No exportes costos privados a compradores. El alcance del MCP actual es catálogo, no pagos, usuarios, pedidos ni otros tenants.
Qué autorización ofrece esta versión
La especificación MCP define un perfil OAuth para su flujo de autorización HTTP. Esta documentación distingue ese perfil de las claves actuales para que el cliente pueda comprobar compatibilidad antes de conectarse.
Defensas durante una migración
- Obtén un export o acceso autorizado al proveedor. Un archivo no concede permiso para seguir sus enlaces ni ejecutar su contenido.
- Ignora instrucciones dentro de PDFs, hojas y respuestas que pidan revelar credenciales, cambiar permisos o escribir en otro negocio.
- Usa HTTPS remoto y valida el endpoint que recibe la credencial. El servidor rechaza orígenes de navegador ajenos; no eludas ese rechazo.
- Revisa el cambio antes de aplicar. Las anotaciones de herramientas ayudan al cliente, pero no son un control de autorización.
- Conserva trazabilidad de fuente y recibo, redactando secretos y separando datos privados de la evidencia pública.