Ir para o conteúdo
Promovaweb

Perguntas frequentes

Como instalo o ClickUpfy?

Pelo npm, com npm install -g @promovaweb/clickupfy. O pacote funciona como launcher: na primeira execução, ele baixa o binário da sua plataforma, confere o SHA256 contra o SHA256SUMS da GitHub Release e mantém o arquivo em cache. O Node.js 18.17 ou superior serve só para esse download. Cada release também publica binários avulsos para Linux, macOS e Windows. Fonte oficial.

Onde o ClickUpfy guarda a minha API key do ClickUp?

No cofre ~/.clickupfy/credentials.json, cifrado com AES-256-GCM, com o nome clickup.<perfil>.api_key. A chave do cofre vem da variável CLICKUPFY_MASTER_KEY ou do arquivo ~/.clickupfy/master.key. Os comandos status e account show exibem só a versão mascarada da API key. Fonte oficial.

Posso versionar o .mcp.json que o ClickUpfy gera?

Pode, quando os IDs do ClickUp não forem informação sensível para o seu projeto. O .mcp.json e o .codex/config.toml guardam só o nome do perfil e os IDs da hierarquia autorizada. A API key fica no cofre da sua pasta de usuário e nunca entra nesses arquivos. Fonte oficial.

Como impeço que o agente altere tarefas no ClickUp?

Inicie o servidor MCP com --read-only. Nesse modo, o servidor não registra as ferramentas de escrita, que somem da resposta de tools/list. O agente continua lendo tarefas, comentários, Sprints e Docs, mas não enxerga nenhuma ferramenta que cria ou altera itens. Fonte oficial.

O que acontece quando o agente usa um ID de outra List?

O servidor MCP recusa a chamada com isError: true, a mensagem e o exit code equivalente da CLI. Quando a ferramenta omite o ID, o servidor usa o valor fixado no projeto. A comparação vale para perfil, workspace, Space, Folder, List e Sprint Folder. Fonte oficial.

Quais clientes MCP o ClickUpfy configura?

O comando clickupfy mcp setup grava a entrada do servidor no .mcp.json do Claude Code, no .codex/config.toml do Codex, no .gemini/settings.json do Gemini CLI e no opencode.json do OpenCode. A entrada nova é mesclada com as que já existem, sem apagar outros servidores. Fonte oficial.

Quais skills vêm com o ClickUpfy?

Cinco skills em português do Brasil: clickupfy-setup, clickupfy-dev, clickup-issue-create, clickup-issue-implement e clickupfy-release. O comando clickupfy agent skill install instala as cinco em .agents/skills/ pelo npx skills add, que registra a origem no skills-lock.json. Fonte oficial.

O ClickUpfy cria Sprints no ClickUp?

Não, porque a API pública do ClickUp não oferece endpoint para criar Sprints nem para habilitar o Sprint ClickApp. Você cria o Sprint Folder e as Sprints na interface do ClickUp e usa o ClickUpfy para consultar a Sprint ativa, associar tarefas e definir Sprint Points. Fonte oficial.

Como uso dois workspaces do ClickUp no mesmo computador?

Crie um perfil para cada workspace com clickupfy setup. A opção --account escolhe o perfil num único comando, a variável PROMOVAWEB_CLICKUPFY_ACCOUNT escolhe nas automações e clickupfy account use troca o perfil ativo. Cada projeto fixa o próprio perfil nos arquivos do cliente MCP. Fonte oficial.

Qual é a licença do ClickUpfy?

Desde a versão 1.1.0, o ClickUpfy é distribuído sob a GNU AGPL 3.0 (AGPL-3.0-only). As versões anteriores continuam sob a licença com que foram publicadas. O código fica no repositório promovaweb/clickupfy, no GitHub, mantido pela Promovaweb. Fonte oficial.

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.