REST y MCP comparten operaciones y autorización; las rutas pertenecen a tu instancia.
Clave
En Cuenta → MCP / API keys, crea nombre de 1–64 bytes UTF-8, techo de rol y vencimiento futuro opcional. Copia inmediatamente: se muestra una vez.
Separa claves por herramienta. Su rol no supera el efectivo al crear y queda limitado por el rol actual del usuario. Cambiar contraseña no revoca; eliminar usuario invalida.
REST
Define URL y clave en tu entorno:
curl --fail-with-body "$CDELIVERY_URL/api/me" \
-H "Authorization: Bearer $CDELIVERY_API_KEY"Espera información de tu cuenta. /scalar documenta el schema de la versión instalada.
Los cambios usan normalmente patch: omitir conserva, null limpia solo campos que lo permiten; patch vacío es válido. Los enums distinguen mayúsculas: Reader, Operator, Admin.
MCP
Configura el cliente HTTP remoto con /mcp y Authorization: Bearer YOUR_API_KEY. Lista las herramientas y prueba una lectura para verificar la cuenta y los permisos antes de escribir.
Errores
401: credencial inválida, vencida, revocada o usuario no autenticable. 403: rol insuficiente. 422: campos o requisitos inválidos. Para conexión, revisa URL, TLS y proxy.
Revoca y verifica rechazo de la clave antigua. Consulta roles.