servidor box-mcp

Uso

Necesitarás:

• BOX_USER_ID

y uno de los siguientes:

• BOX_JWT_BASE64 (recomendado)

• BOX_JWT_CONFIG_PATH

• BOX_JWT

Related MCP server: File Search Tool

Autorización

Autorización de token web JSON (JWT) (recomendado)

Cómo obtener un JWT

El uso de una configuración JWT permite una conexión persistente a Box.

Necesitará una cuenta empresarial paga de Box, o puede registrarse para obtener una cuenta de desarrollador gratuita (asegúrese de cerrar sesión en Box antes de hacer clic en ese enlace).

Acceda a la consola de desarrollo de Box y cree una nueva aplicación. Asegúrese de que el tipo de autorización sea JSON Web Token.

Vaya a Configuration > Add and Manage Public Keys y genere un par de claves pública/privada. Si aún no lo ha hecho, Box le solicitará que configure la autenticación de dos factores y autorice la aplicación como administrador en su cuenta de Box. Deberá:

1. Dar a la aplicación App + Enterprise Access , y

2. Habilitar la make API calls using the as-user header

A través de la página de configuración de la aplicación Box. Asegúrese de volver a autorizar la aplicación si va a modificar esta configuración .

JWT con codificación Base64

Para codificar su JWT en Base64, puede usar el siguiente comando en su terminal:

cat /path/to/your/box-jwt-config.json | base64

Reemplace /path/to/your/box-jwt-config.json con la ruta real a su archivo de configuración JWT. Esto generará el JWT codificado en Base64, que podrá usar en sus variables de entorno.

Configuración del escritorio de Claude

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_JWT_BASE64": "YOUR_BASE64_ENCODED_JWT",
        "BOX_USER_ID": "123456"
      }
    }
  }
}

Autorización de token de desarrollador (la más sencilla)

Usar un token de desarrollador es la forma más fácil de integrarse con Box, pero solo durará 60 minutos.

Para comenzar, configure BOX_DEV_TOKEN en un token de desarrollador de Box .

Para empezar, visite la Consola de Desarrollador de Box y cree una nueva aplicación. El tipo de autorización no importa actualmente, ya que todas admiten el token de desarrollador de Box.

Una vez creada su aplicación, navegue a su configuración y haga clic en Generate Developer Token .

Configuración del escritorio de Claude

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_DEV_TOKEN": "YOUR_DEV_TOKEN_GOES_HERE"
      }
    }
  }
}

Capacidades

1. Buscando archivos

2. Leyendo archivos

• [x] PDF

• [x] Palabra

• [ ] Otros

Desarrollo

Prerrequisitos

Antes de comenzar, asegúrese de tener instalado lo siguiente:

• Node.js (recomendado v22 o superior)

• npm

• git

• dotenv

Configuración del entorno de desarrollo

Para configurar el entorno de desarrollo, siga estos pasos:

1. Bifurcar el repositorio

   • Haga clic en el botón "Bifurcar" en la esquina superior derecha de este repositorio.

   • Esto crea tu propia copia del repositorio en tu cuenta de Github.

2. Clona tu bifurcación:

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

3. Agregar control remoto ascendente

   git remote add upstream https://github.com/hmk/box-mcp-server.git

4. Copiar el archivo dotenv

   cp .env.template .env

5. Instalar dependencias:

   npm install

6. Ejecute watch para mantener index.js actualizado:

   npm run watch

7. Inicie el servidor de desarrollo del protocolo de contexto del modelo:

   dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js

8. Si el servidor de desarrollo no cargó correctamente la variable de entorno, configure BOX_DEV_TOKEN en el lado izquierdo del inspector mcp.