A Integração com Claude do GeckoFlag adiciona uma extensão ao aplicativo Claude para desktop para que você use o GeckoFlag conversando com o Claude. Peça com as suas palavras, como “quais tarefas atribuídas a mim vencem esta semana?” ou “acrescente as anotações da reunião de hoje à wiki”, e o Claude escolhe as operações necessárias para buscar, consultar, criar e atualizar tarefas, projetos, páginas wiki e notas. Também é possível exportar o gráfico de Gantt para o Excel.
Diferença em relação ao “Criar com IA”
O GeckoFlag já tem um recurso com IA, o “Criar com IA”. O “Criar com IA” propõe conteúdo dentro das telas do GeckoFlag; a Integração com Claude permite usar o GeckoFlag a partir de uma conversa com o Claude. As configurações dos dois são independentes.
| Criar com IA | Integração com Claude | |
|---|---|---|
| Onde se usa | Nas telas de cadastro do GeckoFlag | Em conversas no aplicativo Claude para desktop |
| O que faz | Propõe o conteúdo de tarefas, comentários, projetos e páginas wiki (quem salva são as pessoas) | Busca, consulta, cria e atualiza tarefas, projetos, páginas wiki e notas, exporta o gráfico de Gantt para o Excel e mais |
| O que você precisa | Uma chave de API da Anthropic (cadastrada pelo administrador na tela de configurações) | O aplicativo Claude para desktop e um token de API para cada usuário |
| Custo | Cobrança conforme o uso da API (paga à Anthropic) | Sem custo adicional no GeckoFlag (é preciso ter um plano do Claude) |
| Versão compatível | v1.9.0 ou posterior | v1.11.0 ou posterior |
O que a Integração com Claude faz
O Claude escolhe automaticamente as operações do GeckoFlag de acordo com a conversa. Criar e alterar dados só é possível quando tanto o administrador quanto o usuário permitem a escrita.
- Buscar e consultar tarefas — busca filtrando por projeto, status, responsável, relator, prioridade, palavra-chave, data de vencimento e tarefa pai, e lê os detalhes e os comentários.
- Criar e atualizar tarefas — cria tarefas (inclusive com tarefa pai e destinatários de notificação), altera campos, publica comentários e muda o status. Também pode mudar o responsável, a prioridade e as datas junto com um comentário.
- Projetos — consulta a lista e os detalhes, cria projetos, altera o nome, a descrição, o proprietário e o período, marca como concluído ou não concluído e adiciona ou remove membros (sempre confirmando antes de remover).
- Wiki — lê a wiki do projeto, reescreve o texto ou acrescenta conteúdo ao final.
- Notas — lista, busca, consulta, cria, reescreve e complementa as suas próprias notas.
- Configurações de cadastro (administradores) — adiciona tipos de tarefa, status, prioridades e cargos (departamentos) e altera os nomes e as cores.
- Exportar o gráfico de Gantt para o Excel — salva as tarefas do projeto no computador em um arquivo do Excel em formato de gráfico de Gantt.
- Tarefas pela chave — você pode indicar uma tarefa pela chave, como “WEB-12”. Nas respostas, o Claude mostra a chave da tarefa junto com o URL da tela.
- Formatação preservada — lê e escreve descrições, comentários, páginas wiki e notas mantendo títulos, listas, tabelas, links, negrito e outras formatações.
- No seu idioma — o Claude responde no idioma em que você escrever.
Exemplos de pedidos
Não é preciso decorar comandos especiais. Peça com as suas palavras, e o Claude escolhe e executa as operações necessárias.
| O que você quer fazer | Exemplo de pedido |
|---|---|
| Encontrar tarefas | “Quais tarefas atribuídas a mim vencem esta semana?” |
| Criar uma tarefa | “Crie no projeto WEB uma tarefa chamada Corrigir o formulário de contato” |
| Registrar o andamento | “Comente na WEB-3 o que foi feito e mude o status para Concluído” |
| Criar um projeto | “Crie um projeto com a chave SAMPL e o nome ‘Projeto de exemplo’” |
| Adicionar membros | “Adicione a Ana Souza ao SAMPL” |
| Registrar na wiki | “Acrescente as anotações da reunião de hoje à wiki do SAMPL” |
| Ajustar configurações | “Adicione o status ‘Aguardando revisão’ na cor roxa” |
| Gráfico de Gantt | “Exporte o gráfico de Gantt do projeto WEB para o Excel” |
| Resumir | “Escreva o relatório desta semana do SAMPL” “Transforme as pendências da wiki em tarefas” |
Exportar o gráfico de Gantt para o Excel
Peça “exporte o gráfico de Gantt para o Excel”, e as tarefas do projeto (até 5.000) são salvas no computador em um arquivo do Excel em formato de gráfico de Gantt.
- Hierarquia fácil de ver — cada tarefa ocupa uma linha, e as subtarefas aparecem recuadas logo abaixo da tarefa pai. A linha do tempo fica à direita.
- Períodos longos — você pode definir o período e a unidade (dia ou semana). Acima de 120 dias, cada coluna passa automaticamente a representar uma semana (até cerca de 5 anos).
- Ajustável no Excel — ao alterar as datas de início e de término, as barras acompanham (as mudanças não voltam para o GeckoFlag).
- Tarefas sem datas também aparecem — são usadas datas alternativas, como a data de cadastro, exibidas em itálico cinza com o motivo.
- 15 idiomas — títulos e demais textos são exportados no idioma definido nas configurações do usuário no GeckoFlag (em árabe, a planilha fica da direita para a esquerda).
- Sem sobrescrever — se já existir um arquivo com o mesmo nome, o novo é salvo com outro nome, com um número.
O que você precisa
- GeckoFlag v1.11.0 ou posterior — a Integração com Claude foi adicionada na v1.11.0. Se você usa uma versão anterior, atualize primeiro.
- Aplicativo Claude para desktop (Windows e macOS) — é nele que se adiciona a extensão do GeckoFlag (arquivo .mcpb). O arquivo da extensão vem incluído no download que você recebe ao comprar o GeckoFlag. O Node.js necessário para a extensão já vem incluído no aplicativo, então não é preciso instalá-lo à parte.
- Um plano do Claude — não há custo adicional no GeckoFlag. Para usar o Claude, é preciso ter um plano do Claude, da Anthropic.
- GeckoFlag publicado com HTTPS — a extensão precisa de HTTPS para se conectar ao GeckoFlag.
Como começar
- O administrador ativa o recurso em “Configurações → Integração com Claude” no GeckoFlag e, se necessário, permite a escrita.
- O administrador ativa “Permitir a Integração com Claude (API)” para cada pessoa que for usar.
- O usuário cria um token de API na tela de perfil.
- O usuário instala a extensão no aplicativo Claude para desktop e informa o URL do GeckoFlag e o token de API.
- Peça ao Claude “verifique se você consegue se conectar ao GeckoFlag”, e tudo estará pronto.
Ver o guia de configuração (com capturas de tela)
Permissões e segurança
- Só funciona com três autorizações — o recurso só pode ser usado quando há as três coisas: “ativação pelo administrador”, “permissão para o usuário” e “token de API do usuário”. Com o recurso desativado, a API simplesmente não existe.
- As mesmas permissões da tela — todas as operações são feitas com as permissões do dono do token de API. O que não se pode ver ou fazer nas telas do GeckoFlag também não se pode pelo Claude. Projetos e tarefas sem permissão são tratados como “inexistentes”.
- Escrita com dupla autorização — criar e alterar dados exige tanto o “Permitir escrita” do site quanto um token de “Leitura e escrita”. Também é possível usar apenas para leitura.
- O Claude não exclui nada — não é possível excluir projetos, tarefas, comentários, páginas wiki, notas etc. pelo Claude. Se você pedir uma exclusão, ele orienta a fazê-la nas telas do GeckoFlag.
- Tokens gerenciados com segurança — o token de API é um valor aleatório impossível de adivinhar, e o servidor guarda apenas o hash. Ele é exibido uma única vez, logo após a criação, e o próprio usuário recebe um e-mail de aviso quando um token é criado. Ao mudar a senha, todos os tokens da pessoa são invalidados.
- Limite de solicitações e restrição de acesso — cada token pode fazer até 60 solicitações por minuto, e origens que enviam tokens errados repetidamente são bloqueadas temporariamente. A restrição de acesso por endereço IP do GeckoFlag também vale para a API.
- Confirmação antes de cada escrita — se você definir as operações de escrita do GeckoFlag como “sempre perguntar” nas configurações do Claude, a confirmação será sempre solicitada antes da execução (configuração recomendada).
Tratamento dos dados
- A extensão roda no seu computador — a extensão se comunica diretamente apenas com o seu GeckoFlag. Ela não passa por servidores do desenvolvedor do GeckoFlag nem de terceiros.
- O que o Claude lê é enviado à Anthropic — o conteúdo de tarefas, páginas wiki, notas etc. lido pelo Claude é enviado à Anthropic (Claude) como parte da conversa. O Claude é instruído a ler as notas somente quando o usuário pedir.
- Instruções escritas nos dados são ignoradas — o Claude é instruído a tratar o texto de tarefas e afins como “dados” e a não seguir instruções escritas nele.
- Registro das operações — as operações feitas pelo Claude ficam registradas como operações do dono do token de API (não há indicação de “via Claude”).
- Verifique antes de adotar — antes de começar a usar, verifique se as normas internas e os contratos com clientes não restringem o envio de informações a serviços externos.
Limitações e cuidados no uso
- Não é possível excluir (projetos, tarefas, comentários, cadastros, páginas wiki, notas), editar comentários nem anexar ou consultar imagens e arquivos.
- Não é possível adicionar ou editar usuários, alterar as configurações do site, usar o quadro Kanban, os favoritos ou as configurações de notificação, nem ler as notas de outras pessoas (nem mesmo administradores).
- A escrita é feita um item por vez. Se você pedir várias tarefas de uma vez, o Claude as executa uma a uma.
- Ao mudar o status ou outros campos por meio de um comentário, o histórico é registrado e os e-mails de notificação são enviados, como nas operações pela tela.
- Como a extensão roda no computador, ela só funciona no computador em que o aplicativo Claude para desktop estiver aberto.
- As respostas da IA podem conter erros. Confira também nas telas do GeckoFlag o que foi criado ou alterado.
Conhecer o “Criar com IA”, já disponível
Voltar para Recursos