Búsqueda

Pregúntame lo que quieras

Conecta el servidor MCP de Box a tu entorno de trabajo

Conecta ClickUp al servidor MCP alojado de Box para que tus herramientas de IA puedan buscar, leer, subir y organizar contenido de Box. La configuración tarda aproximadamente 10 minutos.

Los alcances de Box y los permisos de la cuenta de Box que autorizó la conexión se aplican a cada solicitud.

Lo que necesitas

  • Un Entorno de trabajo de ClickUp y la aplicación de navegador de ClickUp.
  • Un plan Box Business o superior. Business Starter no es compatible. Algunas funciones o alcances individuales de MCP pueden requerir un plan superior.
  • Un administrador o coadministrador de Box que pueda configurar integraciones y credenciales de MCP.
  • Propietario o administrador del Entorno de trabajo para una conexión de Entorno de trabajo. Los miembros necesitan el permiso Conectar servidor MCP personal para una conexión personal. Los invitados y miembros con acceso limitado no pueden conectar servidores MCP.

Paso 1: Abre Integraciones en la consola de administración

Un administrador o coadministrador de Box completa los pasos del 1 al 4:

  1. Inicia sesión en la Consola de administración de Box.
  2. Selecciona Integraciones.
  3. Busca Custom Box MCP Server.
  4. Pasa el cursor sobre ella y selecciona Configurar.

Captura de pantalla de la página de Integraciones

Paso 2: Agrega credenciales de integración

Para crear la entrada de credenciales:

  1. En Configuración adicional, selecciona + Agregar credenciales de integración.

Captura de pantalla de la pestaña de Configuración

  1. Ingresa un nombre para la entrada y selecciona Guardar.
  2. Expande la nueva entrada.
  3. Copia el ID de cliente y el Secreto de cliente en un lugar seguro.

Si ClickUp muestra un error invalid_client, el ID de cliente y el Secreto de cliente no coinciden con ninguna entrada de credenciales. Copia ambos valores de nuevo desde la misma entrada.

Mantén el Secreto de cliente fuera de comentarios, capturas de pantalla y documentos compartidos.

Paso 3: Agrega el URI de redireccionamiento

Para agregar el URI de redireccionamiento:

  1. En URI de redireccionamiento, agrega https://search.clickup-prod.com/connect/boxmcp.
  2. Deja la entrada de credenciales abierta.

Ingresa el URI exactamente como se muestra, sin barra diagonal al final. Un URI de redireccionamiento MCP genérico falla con redirect_uri_mismatch.

Captura de pantalla de las credenciales difuminadas

Paso 4: Selecciona los alcances de acceso

Los alcances disponibles dependen de tu plan de Box y la configuración del administrador. Para seleccionar alcances:

  1. Selecciona únicamente los Alcances de acceso necesarios para el trabajo que quieres que ClickUp realice en Box.

Captura de pantalla de la configuración y el URI

  1. Selecciona Guardar.
  2. Confirma que la entrada guardada muestre el URI de redireccionamiento y los alcances.

Los alcances de Box establecen las acciones máximas que la integración puede solicitar. No otorgan acceso a contenido al que la identidad de Box que autoriza la conexión no tenga acceso.

Si ClickUp muestra un error insufficient_scope, pide a tu administrador de Box que seleccione y guarde los alcances para las herramientas que necesitas. Los administradores de Box también pueden desactivar herramientas.

Si la conexión se establece correctamente pero no muestra herramientas, ClickUp necesita al menos una herramienta del servidor. Verifica que haya al menos un alcance guardado y pide a tu administrador de Box que confirme que las herramientas que necesitas están activadas.

Conectar en ClickUp

Para conectar el servidor MCP en ClickUp:

  1. En la aplicación de navegador de ClickUp, abre el Centro de aplicaciones.
  2. Busca y selecciona Box MCP.
  3. Selecciona Personal o Entorno de trabajo:
    • Personal (Solo para mí): Solo tú puedes usar las herramientas de esta conexión. Úsala cuando cada persona necesite acceso a Box con su propia cuenta.
    • Entorno de trabajo (Para todos los miembros): Un propietario o administrador del Entorno de trabajo la configura, y todos los miembros pueden usar sus herramientas. Todos los miembros actúan como la cuenta de Box que autorizó la conexión, así que asegúrate de que el acceso de esa cuenta sea seguro para compartir.
  4. Selecciona Conectar.
  5. Ingresa el ID de cliente y el Secreto de cliente que copiaste en el Paso 2.

Captura de pantalla de la conexión en el centro de aplicaciones

  1. Inicia sesión en Box con la cuenta que quieres que use la conexión y permite el acceso.
  2. Espera a que ClickUp valide la conexión.

La validación tarda hasta 15 segundos y falla si Box no devuelve ninguna herramienta.

La conexión de Box MCP usa https://mcp.box.com. No necesitas una aplicación OAuth separada.

El flujo OAuth predeterminado de Box MCP actúa como el usuario de Box que lo autoriza. Box sigue aplicando el acceso de esa identidad, los permisos de colaboración y los alcances seleccionados por el administrador.

Herramientas disponibles

Las herramientas disponibles dependen de tus alcances de Box, el plan, la configuración del administrador y los permisos de la cuenta de Box que autorizó la conexión. Estos son algunos ejemplos de herramientas:

Herramienta Capacidad
search_files_keyword Busca archivos de Box por palabra clave, con filtros opcionales y definición del alcance de la carpeta.
get_file_content Recupera el contenido de un archivo de Box.
upload_file Sube un archivo a Box.
create_folder Crea una carpeta en Box.

Limitaciones

El plan de Box y la configuración del administrador afectan lo que puedes configurar y usar:

  • Funciones según el plan: No todos los planes de Box incluyen todos los alcances y herramientas. Por ejemplo, el alcance docgen.readwrite requiere el plan Box Enterprise Advanced. Pregunta a tu administrador de Box qué alcances están disponibles para tu organización.
  • Acceso a la consola de administración: Si no encuentras Integraciones o no puedes configurar Box MCP, pide ayuda a un administrador de Box. Los permisos de coadministrador y las funciones del plan de Box pueden afectar qué configuraciones son visibles.

Solución de problemas

Si tu conexión falla, identifica el error que muestra ClickUp:

Error Acción
redirect_uri_mismatch Confirma que la entrada de credenciales de Box guardó el URI de redireccionamiento exacto del Paso 3. Verifícalo carácter por carácter, incluyendo https:// y sin barra diagonal al final. Si Box no guarda tus valores, pide ayuda a tu administrador de Box o al soporte de Box antes de conectar.
invalid_client Consulta las sugerencias del Paso 2 y el Paso 4.
insufficient_scope Consulta las sugerencias del Paso 2 y el Paso 4.

Desconectar o revocar el acceso

Solo los propietarios y administradores del Entorno de trabajo pueden desconectar una conexión de Entorno de trabajo.

Para desconectar Box de ClickUp:

  1. Abre el Centro de aplicaciones.
  2. Selecciona Servidores MCP.
  3. Abre la conexión de Box MCP.
  4. Selecciona la pestaña Personal o Entorno de trabajo.
  5. Selecciona el ícono de puntos suspensivos ... junto a Conectado.
  6. Selecciona Desconectar.

Al desconectarte en ClickUp se elimina únicamente la conexión de ClickUp. Para revocar el acceso en Box, pide a tu administrador de Box que revoque el token de esta conexión, o comunícate con el soporte de Box.

Revocar un token que otro cliente también usa interrumpe la conexión de ese cliente.

Consideraciones de seguridad

Solicita solo los alcances de acceso de Box necesarios para tu caso de uso y revisa qué identidad de Box autoriza la conexión antes de ponerla a disposición de todo el Entorno de trabajo.

Box MCP no omite los permisos de Box existentes de la identidad que autoriza la conexión.