Guide d'installation

Connecter votre IA

Une seule URL connecte n'importe quel agent parlant MCP aux buckets que vous choisissez. Identifiez-vous, cochez les buckets, c'est fait — rien à installer.

1

Ajoutez CopyBucket à votre IA

Tous les agents utilisent la même adresse de serveur — indiquez cette URL là où votre outil ajoute des serveurs MCP :

https://mcp.copybucket.com/mcp

Claude Code

claude mcp add --transport http copybucket https://mcp.copybucket.com/mcp

Claude Desktop · claude.ai

Dans Claude, ouvrez Réglages ▸ Connecteurs ▸ Ajouter un connecteur personnalisé et collez l'URL.

Cursor

Ajouter à Cursor en un clic — ou collez l'URL dans une entrée de ~/.cursor/mcp.json.

VS Code

Installer dans VS Code — le mode agent le détecte directement.

Tout autre outil parlant MCP

{
  "mcpServers": {
    "copybucket": { "type": "http", "url": "https://mcp.copybucket.com/mcp" }
  }
}
2

Approuvez-le dans votre navigateur

À la première utilisation, votre IA vous envoie sur copybucket.com pour vous identifier et choisir les buckets auxquels elle peut accéder. Rien n'est coché à votre place : un agent voit exactement ce que vous approuvez — et vous pouvez modifier ou révoquer cela quand vous voulez.

3

Demandez, tout simplement

Nommez le bucket en langage naturel — les outils (list, get, search, put, edit, move, copy, create, delete) font le reste.

› Regarde mon bucket bug-4521 et dis-moi ce qui se passe.

Consultez et révoquez les agents ayant accès à tout moment

Chaque agent que vous avez approuvé figure sur votre page des agents ayant accès et dans l'app Mac sous Réglages ▸ Agents IA — même liste, même bouton Révoquer. La révocation coupe l'accès de l'agent immédiatement, même en pleine session.

Avancé : exécuter plutôt le serveur sur votre Mac

CopyBucket pour Mac peut aussi enregistrer un serveur MCP local : ouvrez Réglages ▸ Agents IA et le flux guidé le configure en un clic pour Claude Code, Claude Desktop, Cursor, OpenCode et Codex/ChatGPT Desktop. Les agents sur ce Mac reçoivent des chemins de fichiers directs pour les éléments volumineux, et le contenu en cache reste disponible hors ligne.

Une seule des deux options suffit — le serveur hébergé est celle que nous recommandons, et il n'affiche jamais d'invites d'autorisation macOS.

Les agents ne voient que les buckets que vous choisissez. Jamais votre presse-papiers brut.

La visibilité est désactivée par défaut, bucket par bucket. Chaque élément ajouté par un agent porte le nom de l'agent, et l'app vous montre en direct quand un agent lit. Toute l'histoire est dans la promesse de confidentialité.

Dépannage

Mon agent dit que je n'ai aucun bucket
C'est le réglage de confidentialité par défaut qui fonctionne : soit aucun bucket n'est encore marqué « Visible par les agents IA » (activez-le dans Gérer mes buckets), soit le bucket n'a pas été coché sur l'écran d'approbation — reconnectez l'agent pour approuver à nouveau.
La première requête prend un instant
Le serveur se connecte à votre compte de façon différée, au premier appel d'outil d'une session. La pause, c'est la connexion — les appels suivants sont instantanés.
Mon agent ne peut pas lire un fichier volumineux
Les fichiers et les grandes images sont servis comme ressources MCP, que l'agent doit savoir lire — Claude Code, Claude Desktop et Cursor le font tous. Les éléments de plus de 25 Mo sont réservés à l'app CopyBucket.
Comment déconnecter un agent ?
Appuyez sur Révoquer sur votre page des agents ayant accès ou dans Réglages ▸ Agents IA de l'app. Pour un serveur local, désenregistrez-le au même endroit (ou retirez l'entrée de la configuration MCP de l'agent). Chaque bucket peut aussi être masqué à nouveau à tout moment — désactivez son interrupteur de visibilité.