---
title: "Acceso mediante API y MCP"
description: "REST y MCP comparten operaciones y autorización; las rutas pertenecen a tu instancia."
---

> Documentation Index
> Fetch the complete documentation index at: https://cdelivery.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Acceso mediante API y MCP

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:

```sh
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](/docs/es/administration/accounts/roles/).

Source: https://cdelivery.dev/docs/es/guides/automation/api-mcp/index.mdx
