Integre servidores MCP (Model Context Protocol) externos, como GitHub MCP ou Atlassian MCP, ao seu Espaço de trabalho do ClickUp e permita que seus Super Agents e o ClickUp Brain usem ferramentas de aplicativos externos.

Por exemplo, você pode conectar o servidor MCP do seu CRM ao seu Espaço de trabalho. Seus Super Agents e o Brain poderão usar as ferramentas MCP disponíveis para executar ações como criar registros no CRM, provisionar contas ou sincronizar dados de clientes — tudo direto do ClickUp.

Para saber os limites de chamadas MCP por plano, consulte Disponibilidade e limites dos recursos de IA do ClickUp.

Este artigo explica como conectar o ClickUp a servidores MCP externos por meio do App Center (conexões de saída). A conexão ao servidor MCP do ClickUp, na qual um cliente de IA externo acessa seus dados do ClickUp, é um recurso separado, regido pelas permissões do Token de API pessoal.

Você pode conectar um servidor MCP externo em qualquer plano.

Somente proprietários e administradores do Espaço de trabalho podem configurar conexões do Espaço de trabalho.

Membros podem configurar conexões pessoais pelo App Center, caso os administradores habilitem a permissão Conectar servidor MCP pessoal.

Convidados e membros com acesso limitado não podem configurar integrações.

No momento, você só pode conectar servidores MCP pelo aplicativo web do ClickUp.

Tipos de conexão

Ao conectar um servidor MCP externo, você precisará selecionar um tipo de conexão:

• Só para mim: conexão pessoal. Vincule sua conta do servidor MCP externo à sua conta de usuário do ClickUp em cada Espaço de trabalho que você criou ou ingressou. Somente você poderá usar as ferramentas desta conexão nos Super Agents e no Brain.
• Para todos os membros: conexão do Espaço de trabalho, que só pode ser habilitada por um proprietário ou administrador do Espaço de trabalho. Todos no Espaço de trabalho poderão usar as ferramentas desta conexão nos Super Agents e no Brain.

Controles de administrador para conexões

Espaços de trabalho que usam permissões de função personalizada podem desativar a opção de adicionar conexões de servidor MCP do Espaço de trabalho ou pessoais.

Conectar um servidor MCP externo

Antes de conectar, consulte seu provedor MCP para saber qual método de autenticação e quais cabeçalhos são esperados. Reproduza essas configurações ao conectar o servidor no ClickUp.

Os servidores MCP precisam ter uma URL pública para se conectar.

O ClickUp não usa endereços IP de saída fixos para conexões do Brain e dos Super Agents a servidores MCP externos. O tráfego de saída usa endereços IP de nuvem atribuídos dinamicamente, portanto, a inclusão de IPs em listas de permissões não é compatível. Proteja o endpoint do seu servidor MCP com autenticação OAuth ou por chave de API.

Para conectar um servidor MCP externo ao seu Espaço de trabalho:

1. Abra o App Center:

   

   • No canto superior esquerdo, clique no avatar do seu Espaço de trabalho e selecione Apps.
   • Na sua Navegação global, clique em Mais e selecione Apps.
   • Use o comando Abrir App Center na Barra de comandos de IA.
2. Na barra lateral do App Center, selecione Custom MCP.
3. Clique em Add New na parte inferior ou selecione um dos modelos.
4. Escolha o tipo de conexão:
   • Aba Para todos os membros ou Espaço de trabalho: configure uma conexão do Espaço de trabalho.
   • Aba Só para mim ou Pessoal: configure uma conexão pessoal.
5. Clique em Próximo.
6. Preencha as informações do servidor nos campos necessários ou autorize sua conta se estiver usando um dos nossos modelos. Para servidores personalizados, é obrigatório incluir um nome, uma URL e um método de autenticação. Opcionalmente, você pode adicionar um ícone e uma descrição ao servidor.

7. Ao conectar um servidor MCP personalizado, você pode escolher entre três métodos de autorização:
   • OAuth: você será redirecionado para o fluxo OAuth do provedor e voltará ao ClickUp em seguida. Alguns provedores exigem que uma URL de redirecionamento/callback seja registrada antes da conexão. Use https://search.clickup-prod.com/connect/mcp.
   • Chave de API: insira sua chave de API. Se o seu provedor exigir, insira os cabeçalhos personalizados. Se forem válidos, o ClickUp se conectará e exibirá as ferramentas disponíveis.
   • Sem autenticação: conecte o ClickUp diretamente. Se o seu provedor exigir, insira os cabeçalhos personalizados. Se forem válidos, o ClickUp se conectará e exibirá as ferramentas disponíveis.
8. Ao conectar um servidor MCP personalizado, você pode personalizar o Client ID, o Client Secret e os Escopos na seção Configuração avançada.

9. Após a conexão, você verá todas as ferramentas disponíveis listadas na seção Ferramentas de IA do aplicativo — prontinhas para adicionar aos Super Agents e usar no Brain.

Usar um modelo MCP

O ClickUp oferece modelos para facilitar a conexão com alguns dos servidores MCP mais populares.

Para conectar um servidor MCP externo usando um desses modelos:

1. Abra o App Center:
   • No canto superior esquerdo, clique no avatar do seu Espaço de trabalho e selecione Apps.
   • Na sua Navegação global, clique em Mais e selecione Apps.
   • Use o comando Abrir App Center na Barra de comandos de IA.
2. Na barra lateral do App Center, selecione MCP Servers.
3. Clique no modelo que deseja usar.
4. Por padrão, você estará na aba Pessoal. Para configurar uma conexão do Espaço de trabalho, clique na aba Espaço de trabalho.
5. Selecione Conectar.
6. Conclua as etapas de autorização para conectar o servidor MCP externo.

Adicionar ferramentas MCP aos Super Agents

Agora que seu servidor MCP está conectado, as ferramentas dele estão disponíveis para uso nos seus Super Agents.

A disponibilidade e o comportamento das ferramentas dependem do provedor do servidor MCP externo.

Adicionar ferramentas MCP a um Super Agent existente

Para adicionar ferramentas de um servidor MCP conectado a um Super Agent existente:

1. Abra o perfil do seu Super Agent.
2. Na seção Ferramentas, clique em Adicionar ferramentas.
3. Pesquise e selecione um modelo MCP ou clique em Servidor MCP personalizado para adicionar um personalizado.
4. Adicione as ferramentas MCP:
   • Para adicionar todas as ferramentas do servidor MCP, clique em Adicionar tudo no topo do menu.
   • Para adicionar ferramentas individualmente, selecione cada uma delas.

Não se esqueça de atualizar também as instruções do Super Agent!

Adicionar ferramentas MCP ao criar um Super Agent

Se você mencionar um fluxo de trabalho envolvendo um servidor MCP conectado ao criar um Super Agent, as ferramentas desse servidor serão adicionadas automaticamente ao Super Agent após a criação.

Logs de auditoria do Espaço de trabalho e servidores MCP

Os logs de auditoria do Espaço de trabalho incluem informações sobre os servidores MCP externos configurados no Espaço de trabalho. Quem tiver acesso aos logs de auditoria do Espaço de trabalho poderá visualizar as seguintes informações sobre servidores MCP externos:

• Quem conectou um servidor MCP externo e a data e hora em que isso foi feito
• Quem desconectou um servidor MCP externo e a data e hora em que isso foi feito
• Quem atualizou um servidor MCP externo e a data e hora em que isso foi feito
• Se a conexão do servidor MCP externo é do Espaço de trabalho ou pessoal
• Os detalhes do servidor MCP externo:
  • Nome
  • URL do servidor
  • Tipo de autorização