O que é o ClickUp MCP?

Seus modelos e agentes de IA podem usar nosso servidor MCP oficial (Model Context Protocol) para acessar seus dados do ClickUp de forma simples e segura. Ele foi desenvolvido para funcionar perfeitamente com assistentes de IA populares como ChatGPT, Cursor e Claude.

O ClickUp MCP está disponível em todos os planos.

Você pode configurar o servidor ClickUp MCP com qualquer aplicativo que seja compatível com servidores MCP, como Claude, Cursor ou VS Code.

Os Espaços de trabalho estão sendo migrados para nossos novos planos. Nem todos os Espaços de trabalho foram migrados ainda. Saiba mais

O que posso fazer com o servidor ClickUp MCP?

  • Orquestrar fluxos de trabalho de tarefas: crie, enriqueça e encaminhe tarefas com responsáveis, Prioridades e datas de vencimento em Listas e Espaços.
  • Criar relatórios executivos: produza notas de versão, atualizações de status e resumos de portfólio consolidados a partir de tarefas, comentários e Documentos.
  • Rastrear tempo: inicie e pare cronômetros, registre entradas históricas e recupere entradas.
  • Responder perguntas sobre o trabalho: pesquise tarefas, Documentos e comentários para entregar respostas rápidas e ricas em contexto.
  • Colaborar em comentários e no Chat: resuma threads, extraia itens de ação e publique atualizações. Anexe arquivos e imagens a mensagens de Canal, Posts e respostas de threads de Canal.

Ferramentas disponíveis

O servidor MCP do ClickUp permite que assistentes de IA como ChatGPT, Claude, Cursor ou VS Code se integrem às ferramentas e aos dados do ClickUp. Isso significa que seu assistente de IA pode executar ações, recuperar informações e fornecer insights inteligentes e contextuais instantaneamente.

Para ver a lista completa de ferramentas compatíveis, leia este artigo para desenvolvedores.

Antes de conectar um cliente MCP, revise a seção de limites de taxa abaixo para saber quais limites se aplicam ao seu Espaço de trabalho e como o uso é contabilizado.

Exemplos de solicitações

Veja alguns exemplos de solicitações que você pode fazer depois de conectar seu assistente de IA ao servidor MCP do ClickUp:

  • Create a task for this bug we're working on.
  • Find all my incomplete tasks due this week.
  • List all milestones in the Product Launch project.
  • How many hours has the team spent on clients this month?

Instruções de configuração

Para instruções de configuração passo a passo, leia nosso artigo de instruções de configuração do servidor MCP.

Limites de taxa

O servidor MCP do ClickUp tem limites de taxa que dependem de dois critérios:

  1. Se o seu Espaço de trabalho adquiriu o complemento Everything AI.
  2. O plano do seu Espaço de trabalho.

Os limites de taxa do MCP e os limites de taxa da API pública são dois limites separados. A API pública limita as solicitações por minuto, por token. Sem o complemento Everything AI, o ClickUp MCP limita as chamadas por período contínuo de 24 horas.

Com o complemento Everything AI

Se o seu Espaço de trabalho adquiriu o complemento Everything AI, seus limites de taxa do MCP são os mesmos que os limites de taxa da nossa API pública, que variam de acordo com o plano.

Nos nossos novos planos que incluem o ClickUp AI, a IA já está incluída no plano, em vez de ser oferecida como complementos separados.

Com o complemento, o limite contínuo de 24 horas deixa de ser aplicado. Suas solicitações MCP contam para o mesmo limite por minuto e por token que a API pública:

  • Planos Free Forever, Unlimited e Business: 100 solicitações por minuto, por token.
  • Plano Business Plus: 1.000 solicitações por minuto, por token.
  • Plano Enterprise: 10.000 solicitações por minuto, por token.

Nos nossos novos planos que incluem o ClickUp AI, os limites diários do MCP variam de acordo com o plano.

Sem o complemento Everything AI

Se o seu Espaço de trabalho não adquiriu o complemento Everything AI, o uso do MCP está sujeito aos seguintes limites de taxa diários por plano:

  • Plano Free Forever: 100 chamadas por 24 horas.
  • Plano Unlimited: 300 chamadas por 24 horas.
  • Plano Business: 1.000 chamadas por 24 horas.
  • Plano Business Plus: 2.500 chamadas por 24 horas.
  • Plano Enterprise: 5.000 chamadas por 24 horas.

Cada pessoa tem seu próprio limite diário. Todos os clientes MCP que você conectar, como Claude e Cursor, compartilham esse limite.

Cada solicitação MCP conta para o limite, incluindo ações do dia a dia como ler, criar e atualizar tarefas. O limite não se restringe a ações geradas por IA.

Limites de taxa contínuos de 24 horas

O limite de taxa contínuo de 24 horas começa com a sua primeira solicitação.

Por exemplo, se a sua primeira solicitação MCP na segunda-feira for às 13h e você atingir o limite diário do seu plano na terça-feira às 11h, você ficará sujeito ao limite de taxa até as 13h de terça-feira — 24 horas após a sua primeira solicitação.

Tentar enviar solicitações enquanto o limite de taxa está ativo não estende a janela de 24 horas.

Os limites de taxa não podem ser redefinidos.

Quando você atinge o limite, as solicitações MCP retornam um erro 429 RATE_LIMIT_EXCEEDED até que a janela contínua de 24 horas seja reiniciada.

Perguntas frequentes

Perguntas frequentes sobre o servidor ClickUp MCP.

Posso monitorar quantas chamadas MCP meu Espaço de trabalho utilizou?

No momento, não.

Posso me autenticar com minhas próprias chaves de API ou tokens de acesso?

Não, apenas OAuth é compatível. OAuth é um protocolo padrão do setor que oferece acesso seguro e delegado. Ele permite que você conceda acesso limitado aos seus recursos sem compartilhar credenciais, dá suporte a permissões granulares e facilita a revogação do acesso.

As chaves de API são menos seguras porque são estáticas, geralmente têm acesso amplo e são mais difíceis de gerenciar ou revogar em caso de comprometimento.

Posso usar o ClickUp MCP para pesquisar aplicativos externos que conectei ao meu Espaço de trabalho do ClickUp?

Não, a Pesquisa conectada só pode ser usada dentro do seu Espaço de trabalho. Para ver a lista de todos os aplicativos externos compatíveis com a Pesquisa conectada, leia nosso artigo sobre Pesquisa conectada.

Os administradores precisam realizar alguma ação no ClickUp antes de configurar uma ferramenta externa como Claude ou ChatGPT?

Nenhuma ação é necessária no ClickUp. O ClickUp MCP fornecerá a lista de ferramentas disponíveis.

Meu LLM personalizado vai se conectar?

Sim, desde que sua equipe desenvolva uma implementação de cliente MCP que atenda aos seguintes critérios:

  • Implementa o protocolo JSON-RPC 2.0 via HTTP
  • Oferece suporte à autenticação OAuth 2.1 com PKCE
  • Segue a especificação MCP