Box

officiel

Interagissez avec la plateforme de gestion de contenu intelligente via Box AI.

GitHub

102

Que pouvez-vous faire avec Box MCP ?

Rechercher des fichiers et dossiers — Trouvez du contenu dans Box à l'aide de box_tools_search par mot-clé, type de fichier ou métadonnées.
Lister, créer ou gérer des dossiers — Parcourez le contenu des dossiers, créez de nouveaux dossiers, ou mettez à jour et supprimez des dossiers existants avec box_tools_folders.
Lire, télécharger ou importer des fichiers — Récupérez le contenu des fichiers, téléchargez de nouvelles versions ou importez des fichiers via box_tools_files.
Gérer les liens partagés — Créez, mettez à jour ou supprimez des liens partagés pour des fichiers, dossiers et liens web à l'aide de box_tools_shared_links.
Interroger des fichiers avec l'IA — Posez des questions sur le contenu des fichiers ou les données du hub via box_tools_ai.
Gérer les modèles de métadonnées — Créez et gérez des modèles de métadonnées et appliquez des valeurs d'instance aux fichiers avec box_tools_metadata.

Documentation

Serveur Box MCP

[!WARNING] Ce dépôt est abandonné et n'est plus maintenu. Box propose désormais un serveur MCP hébergé officiellement pris en charge, offrant la meilleure expérience et toutes les fonctionnalités. Veuillez migrer vers le serveur MCP hébergé : Configurer le serveur Box MCP →

Démarrage rapide

Cloner le dépôt :

git clone https://github.com/box-community/mcp-server-box.git
cd mcp-server-box

Facultatif mais recommandé : installation de `uv` pour l'environnement virtuel et la gestion des dépendances :

Homebrew (macOS)

brew install uv

WinGet (Windows)

winget install --id=astral-sh.uv  -e

Sur macOS et Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Sur Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Configurer l'environnement virtuel et installer les dépendances :

uv sync

Définir les variables d'environnement :

Définissez les variables d'environnement suivantes pour l'authentification Box dans un fichier .env ou dans l'environnement de votre système.

Pour des options complètes de configuration d'authentification, consultez le Guide d'authentification.

Utilisation d'OAuth2.0 avec une application Box

BOX_CLIENT_ID = YOUR_CLIENT_ID
BOX_CLIENT_SECRET = YOUR_CLIENT_SECRET
BOX_REDIRECT_URL = http://localhost:8000/callback

# MCP Server Authentication (for HTTP transports)
BOX_MCP_SERVER_AUTH_TOKEN = YOUR_BOX_MCP_SERVER_AUTH_TOKEN
OAUTH_PROTECTED_RESOURCES_CONFIG_FILE = .oauth-protected-resource.json

Remarque :

Le BOX_MCP_SERVER_AUTH_TOKEN est utilisé pour authentifier le client MCP auprès du serveur MCP lors de l'utilisation de --mcp-auth-type=token (indépendant de l'authentification Box)

Exécuter le serveur MCP en mode STDIO :

uv run src/mcp_server_box.py

Outils du serveur Box Community MCP

Voici un résumé des outils disponibles :

Outils disponibles	Description
box_tools_ai	Requêtes de fichiers et hubs assistées par IA
box_tools_collaboration	Gestion des collaborations sur fichiers/dossiers
box_tools_docgen	Génération de documents et gestion de modèles
box_tools_files	Opérations sur les fichiers (lecture, téléversement, téléchargement)
box_tools_folders	Opérations sur les dossiers (lister, créer, supprimer, mettre à jour)
box_tools_generic	Utilitaires génériques de l'API Box
box_tools_groups	Gestion des groupes et requêtes
box_tools_metadata	Gestion des modèles et instances de métadonnées
box_tools_search	Rechercher des fichiers et dossiers
box_tools_shared_links	Gestion des liens partagés pour fichiers/dossiers/liens web
box_tools_tasks	Gestion des tâches et des assignations de tâches
box_tools_users	Gestion des utilisateurs et requêtes
box_tools_web_link	Création et gestion de liens web

Détails des opérations du serveur Box Community MCP

Paramètres de l'interface en ligne de commande

Pour exécuter le serveur MCP avec des configurations spécifiques, vous pouvez utiliser les paramètres de ligne de commande suivants :

uv run src/mcp_server_box.py --help

usage: mcp_server_box.py [-h] [--transport {stdio,sse,http}] [--host HOST] [--port PORT] [--mcp-auth-type {oauth,token,none}] [--box-auth-type {oauth,ccg,jwt,mcp_client}]

Box Community MCP Server

options:
  -h, --help            show this help message and exit
  --transport {stdio,sse,http}
                        Transport type (default: stdio)
  --host HOST           Host for SSE/HTTP transport (default: localhost)
  --port PORT           Port for SSE/HTTP transport (default: 8005)
  --mcp-auth-type {oauth,token,none}
                        Authentication type for MCP server (default: token)
  --box-auth-type {oauth,ccg,jwt,mcp_client}
                        Authentication type for Box API (default: oauth)

Pour des informations détaillées sur les types d'authentification, les configurations et les cas d'utilisation, consultez le Guide d'authentification.

Configuration de Claude Desktop

Mode STDIO

Modifiez votre claude_desktop_config.json :

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the configuration:

{
    "mcpServers": {
        "mcp-server-box": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-box",
                "run",
                "src/mcp_server_box.py"
            ]
        }
    }
}

Redémarrez Claude s'il est en cours d'exécution.

Mode HTTP

En supposant que votre serveur MCP s'exécute sur https://mcp.myserver.com/mcp

Allez dans Claude -> Paramètres -> Connecteurs
Sélectionnez Add custom connector
Configurations :
1. Donnez-lui un nom
2. Entrez l'URL, par exemple https://mcp.myserver.com/mcp
3. Entrez éventuellement le client id et le client secret
Cliquez sur Ajouter
Cliquez sur Connecter. Le flux OAuth devrait démarrer. Terminez le flux
De retour dans Claude, cliquez sur Configurer. Vous devriez voir tous les outils disponibles.

Box