Box

oficial

Interactúa con la plataforma de Gestión de Contenido Inteligente a través de Box AI.

GitHub

102

¿Qué puedes hacer con Box MCP?

Buscar archivos y carpetas — Encuentre contenido en Box usando box_tools_search por palabra clave, tipo de archivo o metadatos.
Listar, crear o gestionar carpetas — Explore el contenido de las carpetas, cree nuevas carpetas, o actualice y elimine las existentes con box_tools_folders.
Leer, cargar o descargar archivos — Recupere el contenido de los archivos, cargue nuevas versiones o descargue archivos mediante box_tools_files.
Gestionar enlaces compartidos — Cree, actualice o elimine enlaces compartidos para archivos, carpetas y enlaces web usando box_tools_shared_links.
Consultar archivos con IA — Haga preguntas sobre el contenido de los archivos o los datos del hub a través de box_tools_ai.
Manejar plantillas de metadatos — Cree y gestione plantillas de metadatos y aplique valores de instancia a los archivos con box_tools_metadata.

Documentación

Servidor Box MCP

[!WARNING] Este repositorio está discontinuado y ya no recibe mantenimiento. Box ahora ofrece un servidor MCP alojado con soporte oficial, que brinda la mejor experiencia y funcionalidad completa. Por favor, migre al servidor MCP alojado: Configurar el Servidor Box MCP →

Inicio Rápido

Clonar el repositorio:

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

Instalación opcional pero recomendada de `uv` para entorno virtual y gestión de dependencias:

Homebrew (macOS)

brew install uv

WinGet (Windows)

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

En macOS y Linux

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

En Windows

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

Configurar el entorno virtual e instalar dependencias:

uv sync

Establecer variables de entorno:

Configure las siguientes variables de entorno para la autenticación de Box en un archivo .env o en el entorno de su sistema.

Para opciones completas de configuración de autenticación, consulte la Guía de Autenticación.

Usando OAuth2.0 con una Aplicación de 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

Nota:

El BOX_MCP_SERVER_AUTH_TOKEN se utiliza para autenticar el cliente MCP ante el servidor MCP cuando se usa --mcp-auth-type=token (independiente de la autenticación de Box)

Ejecutar el servidor MCP en modo STDIO:

uv run src/mcp_server_box.py

Herramientas del Servidor Box Community MCP

A continuación se muestra un resumen de las herramientas disponibles:

Herramientas disponibles	Descripción
box_tools_ai	Consultas de archivos y hubs potenciadas por IA
box_tools_collaboration	Gestionar colaboraciones en archivos/carpetas
box_tools_docgen	Generación de documentos y gestión de plantillas
box_tools_files	Operaciones con archivos (leer, subir, descargar)
box_tools_folders	Operaciones con carpetas (listar, crear, eliminar, actualizar)
box_tools_generic	Utilidades genéricas de la API de Box
box_tools_groups	Gestión y consultas de grupos
box_tools_metadata	Gestión de plantillas e instancias de metadatos
box_tools_search	Buscar archivos y carpetas
box_tools_shared_links	Gestión de enlaces compartidos para archivos/carpetas/enlaces web
box_tools_tasks	Gestión de tareas y asignación de tareas
box_tools_users	Gestión y consultas de usuarios
box_tools_web_link	Creación y gestión de enlaces web

Detalles de Operaciones del Servidor Box Community MCP

Parámetros de la interfaz de línea de comandos

Para ejecutar el servidor MCP con configuraciones específicas, puede usar los siguientes parámetros de línea de comandos:

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)

Para información detallada sobre tipos de autenticación, configuraciones y casos de uso, consulte la Guía de Autenticación.

Configuración de Claude Desktop

Modo STDIO

Edite su 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"
            ]
        }
    }
}

Reinicie Claude si está en ejecución.

Modo HTTP

Asumiendo que su servidor MCP se está ejecutando en https://mcp.myserver.com/mcp

Vaya a Claude -> Configuración -> Conectores
Seleccione Add custom connector
Configuraciones:
1. Asígnele un nombre
2. Ingrese la URL, por ejemplo https://mcp.myserver.com/mcp
3. Opcionalmente ingrese el client id y client secret
Haga clic en agregar
Haga clic en conectar. El flujo OAuth debería iniciarse. Complete el flujo
De vuelta en Claude, haga clic en Configurar. Debería ver todas las herramientas disponibles.

Box