Ricerca

Chiedimi qualsiasi cosa

Connetti il server MCP di Box alla tua Area di lavoro

Collega ClickUp al server MCP ospitato da Box in modo che i tuoi strumenti IA possano cercare, leggere, caricare e organizzare contenuti su Box. La configurazione richiede circa 10 minuti.

Gli ambiti di accesso di Box e le autorizzazioni dell'account Box che ha autorizzato la connessione si applicano a ogni richiesta.

Di cosa hai bisogno

  • Un'area di lavoro ClickUp e l'app browser di ClickUp.
  • Un piano Box Business o superiore. Il piano Business Starter non è supportato. Alcune funzionalità o ambiti di accesso MCP singoli potrebbero richiedere un piano superiore.
  • Un amministratore o co-amministratore Box in grado di configurare le integrazioni e le credenziali MCP.
  • Un titolare o amministratore dell'area di lavoro per una connessione dell'area di lavoro. I membri hanno bisogno dell'autorizzazione Connetti server MCP personale per una connessione personale. Gli ospiti e i membri con accesso limitato non possono connettere server MCP.

Passaggio 1: apri le integrazioni nella Console di amministrazione

Un amministratore o co-amministratore Box completa i passaggi da 1 a 4:

  1. Accedi alla Console di amministrazione di Box.
  2. Seleziona Integrazioni.
  3. Cerca Custom Box MCP Server.
  4. Passa il cursore sopra e seleziona Configura.

Screenshot della pagina delle integrazioni

Passaggio 2: aggiungi le credenziali di integrazione

Per creare la voce delle credenziali:

  1. In Configurazione aggiuntiva, seleziona + Aggiungi credenziali di integrazione.

Screenshot della scheda Configurazione

  1. Inserisci un nome per la voce e seleziona Salva.
  2. Espandi la nuova voce.
  3. Copia il Client ID e il Client Secret in un posto sicuro.

Se ClickUp mostra un errore invalid_client, il Client ID e il Client Secret non corrispondono a nessuna voce delle credenziali. Copia di nuovo entrambi i valori dalla stessa voce.

Tieni il Client Secret fuori da commenti, screenshot e documenti condivisi.

Passaggio 3: aggiungi l'URI di reindirizzamento

Per aggiungere l'URI di reindirizzamento:

  1. Sotto URI di reindirizzamento, aggiungi https://search.clickup-prod.com/connect/boxmcp.
  2. Lascia aperta la voce delle credenziali.

Inserisci l'URI esattamente come mostrato, senza barra finale. Un URI di reindirizzamento MCP generico restituisce un errore redirect_uri_mismatch.

Screenshot delle credenziali offuscate

Passaggio 4: seleziona gli ambiti di accesso

Gli ambiti di accesso disponibili dipendono dal tuo piano Box e dalle impostazioni dell'amministratore. Per selezionare gli ambiti:

  1. Seleziona solo gli Ambiti di accesso necessari per le operazioni che vuoi che ClickUp esegua in Box.

Screenshot della configurazione e dell'URI

  1. Seleziona Salva.
  2. Verifica che la voce salvata mostri l'URI di reindirizzamento e gli ambiti.

Gli ambiti di accesso di Box definiscono le azioni massime che l'integrazione può richiedere, ma non concedono l'accesso a contenuti che l'identità Box che ha autorizzato la connessione non può già vedere.

Se ClickUp mostra un errore insufficient_scope, chiedi al tuo amministratore Box di selezionare e salvare gli ambiti per gli strumenti di cui hai bisogno. Gli amministratori Box possono anche disattivare gli strumenti.

Se la connessione riesce ma non mostra strumenti, ClickUp ha bisogno di almeno uno strumento dal server. Verifica che sia salvato almeno un ambito e chiedi al tuo amministratore Box di confermare che gli strumenti di cui hai bisogno siano attivati.

Connetti in ClickUp

Per connettere il server MCP in ClickUp:

  1. Nell'app browser di ClickUp, apri l'App Center.
  2. Cerca e seleziona Box MCP.
  3. Seleziona Personale o Area di lavoro:
    • Personale (Solo per me): solo tu puoi usare gli strumenti di questa connessione. Scegli questa opzione quando ogni persona deve accedere a Box con il proprio account.
    • Area di lavoro (Per tutti i membri): un titolare o amministratore dell'area di lavoro la configura e tutti i membri possono usarne gli strumenti. Ogni membro agisce come l'account Box che ha autorizzato la connessione, quindi assicurati che l'accesso di quell'account sia sicuro da condividere.
  4. Seleziona Connetti.
  5. Inserisci il Client ID e il Client Secret copiati nel Passaggio 2.

Screenshot della connessione nell'App Center

  1. Accedi a Box con l'account che vuoi usare per la connessione, poi consenti l'accesso.
  2. Attendi che ClickUp convalidi la connessione.

La convalida richiede fino a 15 secondi e non va a buon fine se Box non restituisce strumenti.

La connessione Box MCP usa https://mcp.box.com. Non serve un'app OAuth separata.

Il flusso OAuth predefinito di Box MCP opera come l'utente Box che lo autorizza. Box continua ad applicare l'accesso, le autorizzazioni di collaborazione e gli ambiti selezionati dall'amministratore per quell'identità.

Strumenti disponibili

Gli strumenti disponibili dipendono dagli ambiti di accesso Box, dal piano, dalle impostazioni dell'amministratore e dalle autorizzazioni dell'account Box che ha autorizzato la connessione. Di seguito trovi alcuni esempi:

Strumento Funzionalità
search_files_keyword Cerca file su Box per parola chiave, con filtri opzionali e scoping per cartella.
get_file_content Recupera il contenuto di un file su Box.
upload_file Carica un file su Box.
create_folder Crea una cartella su Box.

Limitazioni

Il piano Box e le impostazioni dell'amministratore influiscono su ciò che puoi configurare e usare:

  • Funzionalità dipendenti dal piano: non ogni piano Box include tutti gli ambiti e gli strumenti. Ad esempio, l'ambito docgen.readwrite richiede il piano Box Enterprise Advanced. Chiedi al tuo amministratore Box quali ambiti sono disponibili per la tua organizzazione.
  • Accesso alla Console di amministrazione: se non riesci a trovare le integrazioni o a configurare Box MCP, contatta un amministratore Box. Le autorizzazioni del co-amministratore e le funzionalità del piano Box possono influire sulla visibilità delle impostazioni.

Risoluzione dei problemi

Se la connessione non riesce, individua l'errore che ClickUp mostra:

Errore Azione
redirect_uri_mismatch Verifica che la voce delle credenziali Box abbia salvato l'URI di reindirizzamento esatto del Passaggio 3. Controllalo carattere per carattere, incluso https:// e senza barra finale. Se Box non salva i tuoi valori, chiedi aiuto al tuo amministratore Box o al supporto Box prima di connetterti.
invalid_client Consulta i suggerimenti nel Passaggio 2 e nel Passaggio 4.
insufficient_scope Consulta i suggerimenti nel Passaggio 2 e nel Passaggio 4.

Disconnetti o revoca l'accesso

Solo i titolari e gli amministratori dell'area di lavoro possono disconnettere una connessione dell'area di lavoro.

Per disconnettere Box da ClickUp:

  1. Apri l'App Center.
  2. Seleziona Server MCP.
  3. Apri la connessione Box MCP.
  4. Seleziona la scheda Personale o Area di lavoro.
  5. Seleziona l'icona dei puntini di sospensione ... accanto a Connesso.
  6. Seleziona Disconnetti.

La disconnessione in ClickUp rimuove solo la connessione ClickUp. Per revocare l'accesso in Box, chiedi al tuo amministratore Box di revocare il token per questa connessione, oppure contatta il supporto Box.

La revoca di un token usato anche da un altro client interrompe la connessione di quel client.

Considerazioni sulla sicurezza

Richiedi solo gli ambiti di accesso Box necessari per il tuo caso d'uso e verifica quale identità Box autorizza la connessione prima di renderla disponibile all'intera area di lavoro.

Box MCP non aggira le autorizzazioni Box esistenti dell'identità che ha autorizzato la connessione.