Ir para o conteúdo
Promovaweb
Projeto de código aberto da Promovaweb

ClickUpfy Seu agente lê a tarefa e registra o andamento.

O ClickUpfy é uma ferramenta de linha de comando com servidor MCP que liga os agentes de código ao ClickUp. O agente lê a tarefa, faz o trabalho no repositório e comenta o andamento ali mesmo, sem você copiar a descrição entre telas.

Código aberto sob licença AGPL 3.0, mantido pela Promovaweb no GitHub. Assuntos conferidos na versão 1.1.2.

Você acompanha o plano e o tempo na própria tarefa. O agente consulta e altera tarefas só na lista fixada para o projeto.
  1. Tarefas no terminalO script recebe a tarefa em JSON pelo terminal.
  2. Acesso por projetoO agente de um repositório só altera a List dele.
  3. Registro do trabalhoO agente publica o plano e marca o tempo.
  4. Credencial localA API key fica cifrada fora do repositório.

Seu agente de código lê a tarefa que você acompanha no ClickUp

Um único executável com CLI, TUI e servidor MCP, feito para o agente consultar e atualizar as tarefas do ClickUp pelo terminal.

A CLI e o servidor MCP falam direto com a API do ClickUp

Depois de alterar o código, o agente também precisa registrar o andamento no lugar que você acompanha. O ClickUpfy oferece comandos e ferramentas MCP para ler a tarefa, publicar comentários e atualizar o trabalho no ClickUp. O registro continua no workspace existente.

A CLI usa a sintaxe recurso e ação, com saída em texto ou JSON. O servidor MCP expõe essas funções aos clientes de agentes. As skills orientam a sequência de trabalho, enquanto os perfis locais guardam a referência ao workspace e usam a API key cifrada fora do repositório.

A descrição da tarefa chega ao agente sem passar pela sua área de transferência

  • Copiar a descrição da tarefa para o agente. O agente consulta a tarefa pela CLI ou pelo MCP e recebe a tarefa do ClickUp no ambiente de desenvolvimento.
  • Registrar o avanço depois de programar. Comentários, checklists e registros de tempo podem ser atualizados pelo agente durante o trabalho autorizado.
  • Apontar outro projeto para a List errada. O servidor MCP fixa a List do projeto e recusa chamadas com IDs fora do escopo configurado.
  • Espalhar uma API key nos repositórios. O perfil usa a credencial do cofre local. A configuração do projeto guarda os IDs e o nome do perfil.

O servidor MCP confere o escopo do projeto antes de chamar o ClickUp

Uma chamada MCP atravessa a configuração do projeto e usa a credencial local para acessar a API do ClickUp.

  1. AgenteO cliente chama uma ferramenta do servidor MCP com os argumentos da ação.
  2. Servidor MCPO processo valida os argumentos e o escopo fixado para o projeto.
  3. Perfil e cofreO executável resolve o perfil e lê a API key cifrada no computador.
  4. ClickUpA API consulta ou atualiza o recurso e devolve o resultado ao agente.
O modo read-only esconde as ferramentas de escrita. O acesso também depende das permissões da credencial no ClickUp.
Entenda o servidor MCP por projeto

As tarefas do projeto precisam estar no ClickUp para ele fazer sentido

  • O projeto já usa tarefas no ClickUp. O agente pode consultar a descrição e registrar a execução no mesmo lugar que você acompanha.
  • Uma automação precisa de saída estruturada. A CLI responde em JSON e usa exit codes documentados para os scripts tratarem o resultado.

Onde ele não substitui o ClickUp

  • Um gerenciador de tarefas local e offline. O ClickUpfy acessa as APIs do ClickUp. Ele não mantém uma cópia local das tarefas para substituir o serviço.

Permissões e Sprints continuam na interface do ClickUp

  • Permissões e ClickApps. A administração do workspace permanece no ClickUp. Uma credencial não recebe permissões adicionais por usar a CLI.
  • Funções ausentes na API pública. O ClickUpfy não cria Sprints nem habilita o Sprint ClickApp. Essas ações continuam na interface do ClickUp.
Licença da referência
AGPL 3.0
Mantenedor
Promovaweb
Versão de referência
v1.1.2, a mesma usada nos assuntos deste portal.

Ações do ClickUp disponíveis ao agente

Entenda as ferramentas MCP

O trabalho do agente registrado na tarefa

Entenda a leitura das tarefas, a atualização do andamento e a separação do acesso entre os projetos.

Changelog

Últimas versões do ClickUpfy

Ver o changelog completo
  1. ClickUpfy 1.1.4StableLer as notas
  2. ClickUpfy 1.1.2StableLer as notas
  3. ClickUpfy 1.1.1StableLer as notas
  4. ClickUpfy 1.1.0Breaking changeLer as notas

Portais relacionados

Sistemas ligados a este nas stacks e nos projetos, cada um com o próprio portal.

Continue na comunidade

Leve ao Discord da Promovaweb a chamada que falhou no ClickUpfy, com a mensagem de erro e a versão do binário. A comunidade pode comparar o comando com o escopo configurado no projeto.

Comandos e opções na documentação

Um comando recusado ou uma chamada MCP sem acesso precisa ser comparada com as opções da versão usada. A documentação reúne a instalação, os argumentos e as mensagens de erro para essa consulta.

Abrir a documentaçãoConhecer a formação Vibe Coding

A formação Vibe Coding faz parte do Plano IA Makers.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.