Búsqueda

Pregúntame cualquier cosa

Conecta el servidor Box MCP 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 unos 10 minutos.

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

Lo que necesitarás

  • 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 ámbitos 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 las integraciones en la consola de administración

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

  1. Inicia sesión en la consola de administración de Box.
  2. Selecciona Integraciones.
  3. Busca Servidor MCP de Box personalizado.
  4. Pasa el cursor por encima y selecciona Configurar.

Captura de pantalla de la página de integraciones

Paso 2: Añade las credenciales de integración

Para crear la entrada de credenciales:

  1. En Configuración adicional, selecciona + Añadir credenciales de integración.

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

  1. Escribe un nombre para la entrada y selecciona Guardar.
  2. Despliega 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 corresponden a ninguna entrada de credenciales. Copia de nuevo ambos valores desde la misma entrada.

No incluyas el Secreto de cliente en comentarios, capturas de pantalla ni documentos compartidos.

Paso 3: Añade el URI de redirección

Para añadir el URI de redirección:

  1. En URI de redirección, añade https://search.clickup-prod.com/connect/boxmcp.
  2. Deja la entrada de credenciales abierta.

Escribe el URI exactamente como se muestra, sin barra diagonal al final. Un URI de redirección de MCP genérico falla con el error redirect_uri_mismatch.

Captura de pantalla de las credenciales difuminadas

Paso 4: Selecciona los ámbitos de acceso

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

  1. Selecciona solo los Ámbitos 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. Comprueba que la entrada guardada muestra el URI de redirección y los ámbitos.

Los ámbitos de Box establecen las acciones máximas que la integración puede solicitar. No conceden acceso a contenido al que la identidad de Box que autoriza la conexión no pueda acceder ya.

Si ClickUp muestra un error insufficient_scope, pide a tu administrador de Box que seleccione y guarde los ámbitos 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. Comprueba que hay al menos un ámbito 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 acceder a Box con su propia cuenta.
    • Entorno de trabajo (Para todos los miembros): Un propietario o administrador del Entorno de trabajo lo 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 es seguro para compartir.
  4. Selecciona Conectar.
  5. Escribe 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 independiente.

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

Herramientas disponibles

Las herramientas disponibles dependen de tus ámbitos de Box, el plan, la configuración del administrador y los permisos de la cuenta de Box que autorizó la conexión. A continuación encontrarás algunos ejemplos de herramientas:

Herramienta Capacidad
search_files_keyword Busca archivos de Box por palabra clave, con filtros opcionales y definición del ámbito por 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 a lo que puedes configurar y usar:

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

Solución de problemas

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

Error Acción
redirect_uri_mismatch Comprueba que la entrada de credenciales de Box guardó el URI de redirección exacto del paso 3. Revísalo carácter por carácter, incluido 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 los consejos del paso 2 y el paso 4.
insufficient_scope Consulta los consejos 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 icono de puntos suspensivos ... junto a Conectado.
  6. Selecciona Desconectar.

Al desconectar en ClickUp solo se elimina 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 contacta 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 ámbitos 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.