Pesquisa

Me pergunte qualquer coisa

Conecte o servidor Box MCP ao seu Espaço de trabalho

Conecte o ClickUp ao servidor MCP hospedado do Box para que suas ferramentas de IA possam pesquisar, ler, fazer upload e organizar conteúdo do Box. A configuração leva cerca de 10 minutos.

Os escopos do Box e as permissões da conta do Box que autorizou a conexão se aplicam a todas as solicitações.

O que você vai precisar

  • Um Espaço de trabalho no ClickUp e o aplicativo de navegador do ClickUp.
  • Um plano Box Business ou superior. O Business Starter não é compatível. Funcionalidades ou escopos individuais do MCP podem exigir um plano superior.
  • Um administrador ou co-administrador do Box que possa configurar integrações e credenciais de MCP.
  • Proprietário ou administrador do Espaço de trabalho para uma conexão de Espaço de trabalho. Os membros precisam da permissão Conectar servidor MCP pessoal para uma conexão pessoal. Convidados e membros com acesso limitado não podem conectar servidores MCP.

Etapa 1: Abrir Integrações no Admin Console

Um administrador ou co-administrador do Box conclui as Etapas 1 a 4:

  1. Faça login no Admin Console do Box.
  2. Selecione Integrações.
  3. Pesquise por Servidor MCP personalizado do Box.
  4. Passe o cursor sobre ele e selecione Configurar.

Captura de tela da página de Integrações

Etapa 2: Adicionar credenciais de integração

Para criar a entrada de credenciais:

  1. Em Configuração adicional, selecione + Adicionar credenciais de integração.

Captura de tela da aba Configuração

  1. Insira um nome para a entrada e selecione Salvar.
  2. Expanda a nova entrada.
  3. Copie o ID do cliente e o Segredo do cliente para um local seguro.

Se o ClickUp exibir um erro invalid_client, o ID do cliente e o Segredo do cliente não correspondem a uma mesma entrada de credenciais. Copie os dois valores novamente da mesma entrada.

Não inclua o Segredo do cliente em comentários, capturas de tela ou documentos compartilhados.

Etapa 3: Adicionar o URI de redirecionamento

Para adicionar o URI de redirecionamento:

  1. Em URIs de redirecionamento, adicione https://search.clickup-prod.com/connect/boxmcp.
  2. Deixe a entrada de credenciais aberta.

Insira o URI exatamente como mostrado, sem barra no final. Um URI de redirecionamento MCP genérico falha com redirect_uri_mismatch.

Captura de tela das credenciais desfocadas

Etapa 4: Selecionar escopos de acesso

Os escopos disponíveis dependem do seu plano do Box e das configurações do administrador. Para selecionar escopos:

  1. Selecione apenas os Escopos de acesso necessários para o trabalho que você quer que o ClickUp realize no Box.

Captura de tela da configuração e do URI

  1. Selecione Salvar.
  2. Confirme que a entrada salva exibe o URI de redirecionamento e os escopos.

Os escopos do Box definem as ações máximas que a integração pode solicitar. Eles não concedem acesso a conteúdos que a identidade do Box que autorizou a conexão ainda não possa acessar.

Se o ClickUp exibir um erro insufficient_scope, peça ao administrador do Box para selecionar e salvar os escopos das ferramentas que você precisa. Os administradores do Box também podem desativar ferramentas.

Se a conexão for estabelecida mas não exibir ferramentas, o ClickUp precisa de pelo menos uma ferramenta do servidor. Verifique se pelo menos um escopo está salvo e peça ao administrador do Box para confirmar se as ferramentas que você precisa estão ativadas.

Conectar no ClickUp

Para conectar o servidor MCP no ClickUp:

  1. No aplicativo de navegador do ClickUp, abra o App Center.
  2. Pesquise e selecione Box MCP.
  3. Selecione Pessoal ou Espaço de trabalho:
    • Pessoal (Somente para mim): Só você pode usar as ferramentas desta conexão. Use quando cada pessoa precisar de acesso ao Box com a própria conta.
    • Espaço de trabalho (Para todos os membros): Um proprietário ou administrador do Espaço de trabalho configura a conexão e todos os membros podem usar suas ferramentas. Cada membro age como a conta do Box que autorizou a conexão, por isso verifique se o acesso dessa conta é seguro para compartilhar.
  4. Selecione Conectar.
  5. Insira o ID do cliente e o Segredo do cliente que você copiou na Etapa 2.

Captura de tela da conexão no App Center

  1. Faça login no Box com a conta que deseja usar para a conexão e permita o acesso.
  2. Aguarde o ClickUp validar a conexão.

A validação leva até 15 segundos e falha se o Box não retornar nenhuma ferramenta.

A conexão do Box MCP usa https://mcp.box.com. Você não precisa de um aplicativo OAuth separado.

O fluxo OAuth padrão do Box MCP age como o usuário do Box que o autoriza. O Box continua aplicando o acesso, as permissões de colaboração e os escopos selecionados pelo administrador para essa identidade.

Ferramentas disponíveis

As ferramentas disponíveis dependem dos seus escopos do Box, do plano, das configurações do administrador e das permissões da conta do Box que autorizou a conexão. Veja alguns exemplos de ferramentas:

Ferramenta Capacidade
search_files_keyword Pesquisa arquivos no Box por palavra-chave, com filtros opcionais e escopo de pasta.
get_file_content Recupera o conteúdo de um arquivo do Box.
upload_file Faz upload de um arquivo para o Box.
create_folder Cria uma pasta no Box.

Limitações

O plano do Box e as configurações do administrador afetam o que você pode configurar e usar:

  • Funcionalidades dependentes do plano: Nem todo plano do Box inclui todos os escopos e ferramentas. Por exemplo, o escopo docgen.readwrite exige o plano Box Enterprise Advanced. Pergunte ao administrador do Box quais escopos estão disponíveis para a sua organização.
  • Acesso ao Admin Console: Se você não encontrar Integrações ou não conseguir configurar o Box MCP, peça ajuda a um administrador do Box. As permissões de co-administrador e as funcionalidades do plano do Box podem afetar quais configurações ficam visíveis.

Solução de problemas

Se a conexão falhar, identifique o erro que o ClickUp exibe:

Erro Ação
redirect_uri_mismatch Confirme que a entrada de credenciais do Box salvou o URI de redirecionamento exato da Etapa 3. Verifique caractere por caractere, incluindo https:// e sem barra no final. Se o Box não salvar seus valores, peça ajuda ao administrador do Box ou ao Suporte do Box antes de conectar.
invalid_client Consulte as dicas da Etapa 2 e da Etapa 4.
insufficient_scope Consulte as dicas da Etapa 2 e da Etapa 4.

Desconectar ou revogar acesso

Somente proprietários e administradores do Espaço de trabalho podem desconectar uma conexão de Espaço de trabalho.

Para desconectar o Box do ClickUp:

  1. Abra o App Center.
  2. Selecione Servidores MCP.
  3. Abra a conexão do Box MCP.
  4. Selecione a aba Pessoal ou Espaço de trabalho.
  5. Selecione o ícone de reticências ... ao lado de Conectado.
  6. Selecione Desconectar.

Desconectar no ClickUp remove apenas a conexão do ClickUp. Para revogar o acesso no Box, peça ao administrador do Box para revogar o token desta conexão ou entre em contato com o Suporte do Box.

Revogar um token que outro cliente também usa interrompe a conexão desse cliente.

Considerações de segurança

Solicite apenas os escopos de acesso do Box necessários para o seu caso de uso e verifique qual identidade do Box autoriza a conexão antes de disponibilizá-la para todo o Espaço de trabalho.

O Box MCP não contorna as permissões existentes do Box da identidade que autorizou a conexão.