---
title: "Accès API et MCP"
description: "REST et MCP partagent opérations et autorisation ; les chemins sont ceux de votre instance."
---

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

# Accès API et MCP

REST et MCP partagent opérations et autorisation ; les chemins sont ceux de votre instance.

## Clé

Compte → MCP/API keys : nom de 1–64 octets UTF-8, plafond de rôle et expiration future facultative. Copiez immédiatement, une seule présentation.

Une clé par outil facilite la révocation. Son rôle ne dépasse pas celui effectif à la création et reste limité par le compte actuel. Mot de passe changé : clé conservée. Compte supprimé : clé invalidée.

## REST

Définissez URL et clé localement :

```sh
curl --fail-with-body "$CDELIVERY_URL/api/me" \
  -H "Authorization: Bearer $CDELIVERY_API_KEY"
```

Attendez votre profil. `/scalar` documente le schéma installé.

Patch : absent conserve ; `null` efface uniquement les champs compatibles ; patch vide valide. Enums sensibles à la casse : Reader/Operator/Admin.

## MCP

Configurez le client HTTP distant avec `/mcp` et `Authorization: Bearer YOUR_API_KEY`. Listez les outils et testez une lecture pour vérifier le compte et les droits avant toute écriture.

## Erreurs

401 : secret invalide/expiré/révoqué ou utilisateur indisponible. 403 : droits. 422 : champs/prérequis. Connexion : URL, TLS, proxy.

Après révocation, vérifiez le rejet. Voir [rôles](/docs/fr/administration/accounts/roles/).

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