Eu parei de arrastar cartãozinho. Hoje eu abro o Claude Code e falo o que precisa acontecer... ele cria a tarefa, monta o relatório, atualiza o quadro e ainda joga o plano de ação no lugar certo. Essa aula é o como, do jeito que eu faço todo dia.
Repara no que muda aqui, porque é simples e pouca gente fez. O ClickUp deixa de ser aquele lugar pra onde você corre dez vezes por dia pra mexer em tarefa. Vira uma operação que obedece uma ordem em português. Você fala "cria a tarefa, anexa o relatório e bota o plano como checklist", e tá feito. Você decide, a IA executa. O resto do seu tempo volta pro que dá dinheiro: oferta, criativo, escala.
ClickUp é fortíssimo, ninguém discute. O problema é o tanto de clique que ele cobra de você. Criar tarefa, mover status, escrever briefing, montar relatório, atualizar quadro... tudo no braço.
No fim do dia você trabalhou seis horas e não pensou em nada que faz o faturamento subir. A IA não troca o ClickUp. Ela tira você do clique e te devolve pro estratégico. Você sai de executor e vira o cara que comanda.
Reconheceu a cena?
Tem dois jeitos do Claude conversar com o seu ClickUp. Você não precisa casar com um pra sempre, dá pra usar os dois. Mas entender a diferença é o que separa quem tá brincando de quem opera de verdade.
Um plug que deixa o Claude falar com o ClickUp sem você escrever uma linha de código. Instala uma vez e é só pedir: cria a tarefa, move o status, me mostra o que vence hoje. Ele entende e faz. É o caminho de quase toda a Tropa.
A porta dos fundos oficial do ClickUp. O Claude monta a chamada certa e dispara. Dá controle fino, roda em lote, entra em automação. É o que sustenta relatório que se monta sozinho e o tráfego conversando com o ClickUp.
No fundo é simples: conversa do dia a dia é MCP, automação pesada é API.
| Quando você quer... | Use | Por quê |
|---|---|---|
| Tocar a operação do dia falando | MCP | Zero código, comando em português, resposta na hora |
| Gerar relatório a partir dos dados | API | Puxa tudo em lote e devolve estruturado |
| Criar dezenas de tarefas de criativo | API | Loop em lote, respeitando o limite |
| Conectar tráfego ao ClickUp | API + CLI meta | Fluxo automatizado ponta a ponta |
| Mover status, comentar, anexar | MCP | Ações pontuais numa frase |
Tudo começa com um token pessoal de API do ClickUp. É ele que autoriza o Claude a agir na sua conta. Pegar leva trinta segundos.
Clica no seu avatar e vai em Settings.
Gera o token. Copia o código que começa com pk_.
O número da URL do workspace: clickup.com/9013...
Quem tem esse token mexe em tudo na sua conta. Então nunca cola num print, nunca manda no WhatsApp, nunca sobe pro Git. Guarda numa variável de ambiente. Se vazar, você revoga e gera outro na hora, no mesmo lugar.
# nunca comite este arquivo CLICKUP_API_KEY=pk_12345678_ABCDEF... CLICKUP_TEAM_ID=9013100000
Com o token na mão você pluga as duas pontes. Pra começar, o MCP resolve: um comando só e o ClickUp já entende português.
# 1 comando, e o ClickUp vira linguagem natural claude mcp add clickup \ -e CLICKUP_API_KEY=pk_SEU_TOKEN \ -e CLICKUP_TEAM_ID=SEU_TEAM_ID \ -- npx -y @taazkareem/clickup-mcp-server@latest
# testa a chave: lista seus workspaces curl -s "https://api.clickup.com/api/v2/team" \ -H "Authorization: pk_SEU_TOKEN" # o token vai PURO. mandar "Bearer pk_" # na frente devolve erro na cara.
Reabre o Claude e manda essa frase. Se ele te devolver as suas tarefas, as duas pontas estão conversando. Daqui pra frente é só operar.
Você descreve a tarefa numa frase e ela nasce no lugar certo, com prioridade, responsável, prazo e os campos preenchidos.
POST /api/v2/list/{list_id}/task { "name": "Reel dor da agência", "status": "briefing", "priority": 2, "due_date": 1749168000000 }
Se tudo é urgente, nada é. O Claude respeita o número que você manda: urgente, alta, normal, baixa.
"Move pra aguardando aprovação e avisa o time." O status muda e o histórico fica na tarefa, não no WhatsApp.
Oferta, formato e ICP entram já na criação. Criar o campo em si segue sendo na tela, uma vez só.
Aqui a força da API aparece. O que você levaria meia hora clicando, sai em segundos. E o Claude ainda respeita o limite de cem chamadas por minuto do plano grátis.
Move o status assim que terminar a sua parte, não espera ninguém cobrar. E toda conversa sobre a tarefa vai no comentário dela, não no grupo. Assim o histórico fica, e o Claude lê depois o que rolou pra te dar contexto.
A API do ClickUp não cria nem edita aqueles dashboards visuais que você monta na tela. É limitação da plataforma, não tem endpoint pra isso. Quem te promete "o Claude monta seu dashboard nativo" tá vendendo o que não existe.
O que dá, e é melhor: o Claude puxa os dados das suas listas pela API e gera um dashboard próprio, com gráfico de verdade. Abre no navegador, manda pro grupo ou imprime em PDF. É assim que sai o relatório que eu mando pro time todo mês.
Ferramenta sem processo é bagunça organizada. Antes de automatizar, você precisa de fluxo de status que diz em que pé tá cada coisa. Essa é a estrutura que eu rodo.
O nome do responsável dentro do status: "a fazer copywriter", "aprovado head". Ninguém pergunta de quem é a bola.
O mesmo nome no ClickUp e no Meta. Aí o Claude liga a tarefa da campanha com as dos criativos, e você rastreia o que rodou onde.
Relatório bom não é o que tem mais número. É o que tem leitura: o que tá sangrando, o que é ouro, e o que fazer amanhã.
Você sobe o anúncio, puxa a performance, lê o que tá rolando e joga o relatório com o plano de ação dentro do ClickUp, já virando uma tarefa de otimização com checklist. Quatro passos, uma conversa só.
e revisa em 48h, voltando pro passo 2
Sempre pausado primeiro. Você revisa o preview e só então manda ativar. Número sem leitura é printscreen, então o Claude te entrega o diagnóstico junto.
| Campanha | Gasto | IC | CPA | ROAS | Leitura |
|---|---|---|---|---|---|
| CBO Escala | R$170 | 9 | R$24 | 2,61 | ouro |
| Teste DCT | R$120 | 2 | R$60 | 0,90 | sangra |
A regra que eu sigo: olha o IC primeiro, que é em tempo real. ROAS você lê depois, porque ele tem atraso de atribuição e mente pra baixo nas primeiras horas. Frequência alta com clique baixo é fadiga somada a público errado, candidato a corte.
Aqui o relatório para de morrer no grupo. Vira uma tarefa de otimização, com o relatório anexado como documento e o plano de ação como checklist marcável.
POST /list/{id}/task {"name":"Otimização F2A 03/06", "status":"otimização","priority":1} POST /task/{id}/checklist › Cortar Teste DCT (0,9 ROAS) › Escalar CBO +20% em 48h › Trocar criativo fadigado
Quando você subir o orçamento e validar dois ou três dias, é só pedir pra mover pra escalado. O ciclo inteiro fica registrado, com data, leitura e ação. Tudo rastreável.
Cada linha é uma ordem em português. O Claude resolve o tráfego e o ClickUp por baixo. Dez minutos, ciclo fechado, rastro completo.
Quem fica preso no operacional não perde por falta de esforço, perde por falta de estrutura. O ClickUp já é o seu cérebro de operação. Agora ele obedece uma ordem em português. Usa isso. Tamo junto.