Brancher Coffrify à Claude Desktop

Le serveur MCP Coffrify (@coffrify/mcp) expose plus de 200 outils à tout client compatible Model Context Protocol, dont Claude Desktop. Une fois la connexion établie, votre assistant peut lister vos transferts, créer des webhooks, interroger l'audit log ou vérifier vos quotas, sans jamais quitter l'interface de conversation. Les tokens MCP sont des identifiants distincts des clés API classiques : ils vivent dans la table coffrify_mcp_tokens, supportent les mêmes scopes et la même logique d'IP allowlist, mais leur cycle de vie (rotation, révocation) est isolé pour ne pas perturber vos intégrations existantes.

Endpoints concernés

Authentification

Tous les appels vers /v1/mcp/tokens (et leurs sous-routes) exigent le scope api_keys:manage. Utilisez votre clé API principale (préfixe cof_live_… ou cof_test_…) dans l'en-tête Authorization: Bearer <clé> pour créer ou gérer les tokens MCP. Une fois le token MCP généré, c'est lui que vous placez dans claude_desktop_config.json : il n'est jamais retourné une seconde fois, conservez-le immédiatement.

Corps de la requête, Créer un token MCP

Créer le token MCP

curl -s -X POST https://api.coffrify.com/v1/mcp/tokens \
  -H "Authorization: Bearer cof_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Claude Desktop local",
    "description": "Token pour mon Mac personnel",
    "environment": "live",
    "client_hint": "claude-desktop",
    "scopes": [
      "transfers:read",
      "transfers:write",
      "webhooks:read",
      "webhooks:manage",
      "analytics:read",
      "api_keys:manage",
      "audit:read"
    ],
    "expires_in_days": 90
  }'

Réponse (201 Created)

{
  "id": "mcpt_01jx7z2k9p8w4r3n6q5y",
  "name": "Claude Desktop local",
  "description": "Token pour mon Mac personnel",
  "token_prefix": "cof_mcp_live_3fa8b2d1...",
  "token": "cof_mcp_live_3fa8b2d17e9c4a05bdf123456789abcdef0123456789abcdef01234567",
  "scopes": [
    "transfers:read",
    "transfers:write",
    "webhooks:read",
    "webhooks:manage",
    "analytics:read",
    "api_keys:manage",
    "audit:read"
  ],
  "environment": "live",
  "client_hint": "claude-desktop",
  "allowed_ips": null,
  "expires_at": "2026-09-04T14:22:00.000Z",
  "max_uses": null,
  "created_at": "2026-06-06T14:22:00.000Z",
  "warning": "Save this token now - it will not be shown again."
}

Configurer Claude Desktop

Une fois le token MCP en main, ouvrez (ou créez) le fichier de configuration de Claude Desktop. Sur macOS il se trouve dans ~/Library/Application Support/Claude/claude_desktop_config.json, sur Windows dans %APPDATA%\Claude\claude_desktop_config.json. Ajoutez l'entrée coffrify dans la section mcpServers.

{
  "mcpServers": {
    "coffrify": {
      "transport": "streamable-http",
      "url": "https://mcp.coffrify.com/u/<votre-workspace-id>",
      "headers": {
        "Authorization": "Bearer cof_mcp_live_3fa8b2d1…"
      }
    }
  }
}

Le transport streamable-http s'appuie sur la spec MCP 2024-11-05 et ne nécessite aucune installation locale. Le transport npx (fallback local) exécute @coffrify/mcp dans un processus enfant : utile si votre réseau bloque les connexions outbound vers mcp.coffrify.com. Redémarrez Claude Desktop après toute modification de claude_desktop_config.json.

Vérifier la connexion

Avant de relancer Claude Desktop, vous pouvez appeler l'endpoint de contrôle hébergé pour confirmer que votre token est valide et connaître l'URL de transport assignée à votre workspace.

$ curl -s https://api.coffrify.com/v1/mcp/hosted/<workspaceId> \
  -H "Authorization: Bearer cof_mcp_live_3fa8b2d1…" | jq .

{
  "object": "mcp_hosted_endpoint",
  "status": "available",
  "workspace_id": "ws_01jx7…",
  "transport": "streamable-http",
  "spec_version": "2024-11-05",
  "endpoints": {
    "streamable_http": "https://mcp.coffrify.com/u/ws_01jx7…",
    "sse": "https://mcp.coffrify.com/sse",
    "local_fallback": "npx @coffrify/mcp"
  },
  "catalog": {
    "tools": 207,
    "families": 33,
    "disabled_by_default": 0
  },
  "authenticated_as": "cof_mcp_live_3fa8b2d1...",
  "scopes": ["transfers:read", "transfers:write", "webhooks:read", "webhooks:manage", "analytics:read", "api_keys:manage", "audit:read"]
}

Outils disponibles par scope

Le catalogue MCP Coffrify comprend 207 outils répartis en 33 familles. Les scopes octroient l'accès à des groupes d'outils. Voici les familles principales et le scope requis pour chacune :

Rotation et révocation du token

Pour changer de token sans interruption de service, utilisez la rotation : le nouveau token hérite exactement des mêmes scopes, IP allowlist et client_hint. L'ancien reste actif pendant une fenêtre de grâce (défaut : 7 jours, maximum : 90 jours), ce qui vous laisse le temps de mettre à jour claude_desktop_config.json.

$ # Rotation avec fenêtre de grâce de 14 jours
$ curl -s -X POST https://api.coffrify.com/v1/mcp/tokens/mcpt_01jx7z2k9p8w4r3n6q5y/rotate \
  -H "Authorization: Bearer cof_live_…" \
  -H "Content-Type: application/json" \
  -d '{"grace_days": 14}'

{
  "new_token": "cof_mcp_live_a1b2c3d4…",
  "new_prefix": "cof_mcp_live_a1b2c3d4...",
  "old_id": "mcpt_01jx7z2k9p8w4r3n6q5y",
  "new_id": "mcpt_01jy3a8p0q2t6m9r7b4c",
  "grace_expires_at": "2026-06-20T14:22:00.000Z",
  "warning": "Save this token now - it will not be shown again."
}

Pour une révocation immédiate, envoyez une requête DELETE avec une raison optionnelle. Les valeurs de raison reconnues sont : manual, compromised, rotated, expired_auto, suspicious_activity, other.

$ curl -s -X DELETE https://api.coffrify.com/v1/mcp/tokens/mcpt_01jx7z2k9p8w4r3n6q5y \
  -H "Authorization: Bearer cof_live_…" \
  -H "Content-Type: application/json" \
  -d '{"reason": "compromised"}'

Erreurs courantes

Voir aussi

• Référence complète des tokens MCP
• Catalogue des scopes API
• Catalogue des outils MCP (207 outils)
• Quickstart : créer votre première clé API
• Quickstart : envoyer votre premier transfert via l'API
• Quickstart : créer et tester un Webhook
• Quickstart : utiliser le MCP avec Cursor