Lister et inspecter les outils MCP disponibles

GET /v1/mcp/tools renvoie le registre complet des 207 outils exposés par le serveur @coffrify/mcp. Pour chaque outil vous obtenez son nom, sa famille fonctionnelle, sa description, le scope OAuth requis, et l'état activé/désactivé propre à votre workspace (stocké dans la table coffrify_mcp_tool_overrides). PATCH /v1/mcp/tools permet ensuite d'activer ou de désactiver un outil sans redémarrer le serveur MCP (effectif dès la version v0.3.0 du serveur). En dessous de v0.3.0, le toggle est cosmétique : le serveur expose tous les outils quoi qu'il arrive.

Endpoints

Deux endpoints suffisent : GET /v1/mcp/tools pour lister le catalogue et PATCH /v1/mcp/tools pour activer ou désactiver un outil.

Authentification

Les deux endpoints nécessitent une clé API transmise dans l'en-tête Authorization: Bearer <clé>. Les préfixes valides sont cof_live_… (production), cof_test_… (sandbox) et cof_sandbox_… (environnement de test isolé). GET est accessible avec n'importe quelle clé authentifiée : aucun scope supplémentaire n'est requis. PATCH exige le scope api_keys:manage.

Corps de la requête (PATCH)

L'activation ou la désactivation d'un outil se fait par son nom exact. Le tableau ci-dessous détaille les champs acceptés.

Exemples d'appel

Les exemples ci-dessous listent les outils puis en désactivent un. Choisissez votre langage.

# Lister tous les outils MCP
curl https://api.coffrify.com/v1/mcp/tools \
  -H "Authorization: Bearer cof_live_..."
 
# Désactiver un outil
curl https://api.coffrify.com/v1/mcp/tools \
  -X PATCH \
  -H "Authorization: Bearer cof_live_..." \
  -H "Content-Type: application/json" \
  -d '{"tool_name": "coffrify_gdpr_export", "disabled": true}'
 
# Réactiver un outil
curl https://api.coffrify.com/v1/mcp/tools \
  -X PATCH \
  -H "Authorization: Bearer cof_live_..." \
  -H "Content-Type: application/json" \
  -d '{"tool_name": "coffrify_gdpr_export", "disabled": false}'

Réponse (GET)

La réponse liste chaque outil (data) avec sa famille, son scope requis et son état. Filtrez sur required_scope pour n'exposer que les outils réellement utilisables par votre clé.

{
  "object": "list",
  "data": [
    {
      "name": "coffrify_list_transfers",
      "family": "transfers",
      "description": "Lister tous les transferts du workspace, avec pagination cursor.",
      "required_scope": "transfers:read",
      "disabled": false,
      "overridden_at": null
    },
    {
      "name": "coffrify_gdpr_export",
      "family": "gdpr",
      "description": "Export complet RGPD : profile, transferts, fichiers, audit, webhooks, api keys, branding, notifications.",
      "required_scope": "gdpr:export",
      "disabled": true,
      "overridden_at": "2026-06-05T14:32:11.000Z"
    },
    {
      "name": "coffrify_get_workspace_info",
      "family": "workspace",
      "description": "Métadonnées du workspace courant (nom, tier, quota, member count).",
      "required_scope": null,
      "disabled": false,
      "overridden_at": null
    }
  ],
  "note": "Phase A : ce toggle est cosmétique côté @coffrify/mcp v0.2.0. v0.3.0+ respectera la liste."
}

Réponse (PATCH)

{
  "tool_name": "coffrify_gdpr_export",
  "disabled": true
}

Champs de réponse (objet outil)

Le tableau ci-dessous décrit chaque champ de l'objet outil renvoyé par la liste.

Erreurs

Les erreurs portent sur un nom d'outil inconnu ou un scope manquant. Le tableau ci-dessous indique la résolution.

Voir aussi

• Créer et gérer les tokens MCP
• Connecter un serveur MCP hébergé
• Référence : GET /v1/mcp/tools
• Référence : PATCH /v1/mcp/tools
• Scopes OAuth disponibles