Recherche

Demande-moi ce que tu veux

Connectez le serveur MCP Box à votre Environnement de travail

Connectez ClickUp au serveur MCP hébergé par Box pour que vos outils d'IA puissent rechercher, lire, téléverser et organiser du contenu Box. La configuration prend environ 10 minutes.

Les portées Box et les autorisations du compte Box ayant autorisé la connexion s'appliquent à chaque requête.

Ce dont vous aurez besoin

  • Un Environnement de travail ClickUp et l'application navigateur ClickUp.
  • Un forfait Box Business ou supérieur. Business Starter n'est pas pris en charge. Certaines fonctionnalités ou portées MCP individuelles peuvent nécessiter un forfait supérieur.
  • Un administrateur ou co-administrateur Box capable de configurer des intégrations et des identifiants MCP.
  • Le rôle de propriétaire ou d'administrateur d'Environnement de travail pour une connexion d'Environnement de travail. Les membres doivent disposer de l'autorisation Connecter un serveur MCP personnel pour une connexion personnelle. Les invités et les membres limités ne peuvent pas connecter de serveurs MCP.

Étape 1 : ouvrir les intégrations dans la console d'administration

Un administrateur ou co-administrateur Box effectue les étapes 1 à 4 :

  1. Connectez-vous à la console d'administration Box.
  2. Sélectionnez Intégrations.
  3. Recherchez Serveur MCP Box personnalisé.
  4. Survolez-le et sélectionnez Configurer.

Capture d'écran de la page Intégrations

Étape 2 : ajouter des identifiants d'intégration

Pour créer l'entrée d'identifiants :

  1. Dans Configuration supplémentaire, sélectionnez + Ajouter des identifiants d'intégration.

Capture d'écran de l'onglet Configuration

  1. Saisissez un nom pour l'entrée et sélectionnez Enregistrer.
  2. Développez la nouvelle entrée.
  3. Copiez son Identifiant client et son Secret client dans un emplacement sécurisé.

Si ClickUp affiche une erreur invalid_client, l'Identifiant client et le Secret client ne correspondent pas à la même entrée d'identifiants. Copiez à nouveau les deux valeurs depuis la même entrée.

Ne laissez pas le Secret client apparaître dans des commentaires, des captures d'écran ou des documents partagés.

Étape 3 : ajouter l'URI de redirection

Pour ajouter l'URI de redirection :

  1. Sous URI de redirection, ajoutez https://search.clickup-prod.com/connect/boxmcp.
  2. Laissez l'entrée d'identifiants ouverte.

Saisissez l'URI exactement comme indiqué, sans barre oblique finale. Une URI de redirection MCP générique échoue avec l'erreur redirect_uri_mismatch.

Capture d'écran des identifiants floutés

Étape 4 : sélectionner les portées d'accès

Les portées disponibles dépendent de votre forfait Box et des paramètres d'administration. Pour sélectionner les portées :

  1. Sélectionnez uniquement les Portées d'accès nécessaires aux actions que vous souhaitez que ClickUp effectue dans Box.

Capture d'écran de la configuration et de l'URI

  1. Sélectionnez Enregistrer.
  2. Vérifiez que l'entrée enregistrée affiche bien l'URI de redirection et les portées.

Les portées Box définissent le maximum d'actions que l'intégration peut demander. Elles n'accordent pas l'accès à du contenu auquel l'identité Box ayant autorisé la connexion n'a pas déjà accès.

Si ClickUp affiche une erreur insufficient_scope, demandez à votre administrateur Box de sélectionner et d'enregistrer les portées pour les outils dont vous avez besoin. Les administrateurs Box peuvent aussi désactiver des outils.

Si la connexion réussit mais n'affiche aucun outil, ClickUp a besoin d'au moins un outil du serveur. Vérifiez qu'au moins une portée est enregistrée et demandez à votre administrateur Box de confirmer que les outils dont vous avez besoin sont bien activés.

Connexion dans ClickUp

Pour connecter le serveur MCP dans ClickUp :

  1. Dans l'application navigateur ClickUp, ouvrez le Centre d'applications.
  2. Recherchez et sélectionnez Box MCP.
  3. Sélectionnez Personnel ou Environnement de travail :
    • Personnel (Juste pour moi) : vous seul pouvez utiliser les outils de cette connexion. Choisissez cette option quand chaque personne doit accéder à Box avec son propre compte.
    • Environnement de travail (Pour tous les membres) : un propriétaire ou administrateur d'Environnement de travail configure la connexion, et tous les membres peuvent en utiliser les outils. Chaque membre agit en tant que compte Box ayant autorisé la connexion ; assurez-vous donc que l'accès de ce compte peut être partagé en toute sécurité.
  4. Sélectionnez Connecter.
  5. Saisissez l'Identifiant client et le Secret client copiés à l'étape 2.

Capture d'écran de la connexion au centre d'applications

  1. Connectez-vous à Box avec le compte à utiliser pour la connexion, puis autorisez l'accès.
  2. Attendez que ClickUp valide la connexion.

La validation prend jusqu'à 15 secondes et échoue si Box ne renvoie aucun outil.

La connexion Box MCP utilise https://mcp.box.com. Vous n'avez pas besoin d'une application OAuth distincte.

Le flux OAuth par défaut de Box MCP agit en tant qu'utilisateur Box qui l'autorise. Box continue d'appliquer les accès, les autorisations de collaboration et les portées sélectionnées par l'administrateur pour cette identité.

Outils disponibles

Les outils disponibles dépendent de vos portées Box, de votre forfait, des paramètres d'administration et des autorisations du compte Box ayant autorisé la connexion. Voici quelques exemples d'outils :

Outil Fonctionnalité
search_files_keyword Rechercher des fichiers Box par mot-clé, avec des filtres optionnels et une portée par dossier.
get_file_content Récupérer le contenu d'un fichier Box.
upload_file Téléverser un fichier dans Box.
create_folder Créer un dossier dans Box.

Limitations

Le forfait Box et les paramètres d'administration influent sur ce que vous pouvez configurer et utiliser :

  • Fonctionnalités dépendantes du forfait : tous les forfaits Box n'incluent pas toutes les portées et tous les outils. Par exemple, la portée docgen.readwrite requiert le forfait Box Enterprise Advanced. Demandez à votre administrateur Box quelles portées sont disponibles pour votre organisation.
  • Accès à la console d'administration : si vous ne trouvez pas les intégrations ou ne parvenez pas à configurer Box MCP, contactez un administrateur Box. Les autorisations de co-administrateur et les fonctionnalités du forfait Box peuvent influer sur les paramètres visibles.

Résolution des problèmes

Si votre connexion échoue, identifiez l'erreur affichée par ClickUp :

Erreur Action
redirect_uri_mismatch Vérifiez que l'entrée d'identifiants Box a bien enregistré l'URI de redirection exact de l'étape 3. Contrôlez-le caractère par caractère, y compris https:// et l'absence de barre oblique finale. Si Box n'enregistre pas vos valeurs, contactez votre administrateur Box ou le support Box avant de vous connecter.
invalid_client Consultez les conseils des étapes 2 et 4.
insufficient_scope Consultez les conseils des étapes 2 et 4.

Déconnecter ou révoquer l'accès

Seuls les propriétaires et les administrateurs d'Environnement de travail peuvent déconnecter une connexion d'Environnement de travail.

Pour déconnecter Box de ClickUp :

  1. Ouvrez le Centre d'applications.
  2. Sélectionnez Serveurs MCP.
  3. Ouvrez la connexion Box MCP.
  4. Sélectionnez l'onglet Personnel ou Environnement de travail.
  5. Sélectionnez l'icône points de suspension … à côté de Connecté.
  6. Sélectionnez Déconnecter.

La déconnexion dans ClickUp supprime uniquement la connexion ClickUp. Pour révoquer l'accès dans Box, demandez à votre administrateur Box de révoquer le jeton de cette connexion, ou contactez le support Box.

La révocation d'un jeton également utilisé par un autre client interrompt la connexion de ce client.

Considérations de sécurité

Ne demandez que les portées d'accès Box nécessaires à votre cas d'usage et vérifiez quelle identité Box autorise la connexion avant de la rendre disponible pour l'ensemble de l'Environnement de travail.

Box MCP ne contourne pas les autorisations Box existantes de l'identité ayant autorisé la connexion.