
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.
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.
- AgenteO cliente chama uma ferramenta do servidor MCP com os argumentos da ação.
- Servidor MCPO processo valida os argumentos e o escopo fixado para o projeto.
- Perfil e cofreO executável resolve o perfil e lê a API key cifrada no computador.
- ClickUpA API consulta ou atualiza o recurso e devolve o resultado ao agente.
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.
- Guia da licença
- O que a licença permite, o que proíbe e exemplos de uso
Ações do ClickUp disponíveis ao agente
Entenda as ferramentas MCPO 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.
- O que é o ClickUpfyUm único executável que leva o ClickUp ao seu terminal e dá ao agente de código acesso às tarefas pelo MCP.
- Para que serve o ClickUpfyA tarefa do ClickUp lida como fila executável, com cada item fechado pelo agente na ordem da lista.
- Comandos e recursosA tarefa e o andamento consultados pelo terminal, com JSON e exit codes para o script tratar o resultado.
- O servidor MCP por projetoO servidor que cada projeto inicia com a própria List fixada, recusa IDs de fora desse escopo e esconde a escrita em read-only.
- Skills dos agentesAs instruções que orientam o agente a ler a tarefa e registrar o trabalho no ClickUp durante a execução.
- Perfis, workspaces e cofreComo o ClickUpfy guarda vários perfis, cada um com o workspace e a API key cifrada no cofre local, fora do repositório.
Últimas versões do ClickUpfy
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.
A formação Vibe Coding faz parte do Plano IA Makers.
