Manual

Integração com Claude

Integração com Claude

v1.11.0+

A Integração com Claude adiciona uma extensão ao aplicativo Claude para desktop (Windows e macOS) para que você use o GeckoFlag conversando com o Claude. É possível buscar, consultar, criar e atualizar tarefas, projetos, páginas wiki e notas, e exportar o gráfico de Gantt para o Excel. A extensão roda no computador do usuário e se comunica diretamente apenas com o GeckoFlag dele. Todas as operações são feitas com as permissões do usuário dono do token de API.

Configuração pelo administrador

  1. 1Abra Configurações no menu lateral e clique em Editar no cartão Integração com Claude.Tela de configurações, com o cartão “Claude Integration” destacado em vermelho
  2. 2Ative Ativar a Integração com Claude (vem desativado por padrão). Para que o Claude também crie e altere dados, ative também Permitir escrita e salve. Sem a permissão de escrita, todos os tokens passam a ser somente leitura.Tela de configurações da Integração com Claude, com as caixas “Enable Claude integration” e “Allow writing” destacadas em vermelho e, abaixo, o número de usuários com permissão e de tokens de API
  3. 3Em Usuários, abra Editar no usuário, ative Permitir a Integração com Claude (API) e clique em Atualizar. Essa configuração é separada do “Permitir cadastro assistido por IA”. Ao remover a permissão, todos os tokens de API do usuário são excluídos.Tela de edição de usuário, com “Users” no menu lateral e a caixa “Allow Claude integration (API)” destacados em vermelho

Criar um token de API

  1. 1Abra Perfil no menu lateral e, na seção Tokens de API, informe o nome do token, a validade (30 dias, 90 dias, 365 dias ou sem validade; o padrão é 90 dias) e a permissão (Somente leitura ou Leitura e escrita) e crie o token.Seção “API Tokens (Claude Integration)” da tela de perfil, com os campos Token name, Expires in e Permission destacados em vermelho
  2. 2Copie o token exibido (uma sequência que começa com gfk_). O token é exibido uma única vez, logo após a criação. Anote também o “URL para informar na extensão”, mostrado na mesma seção.
  • Cada pessoa pode criar até 5 tokens, e os que não forem mais usados podem ser excluídos a qualquer momento no perfil.
  • Ao criar um token, o próprio usuário recebe um e-mail de aviso. Ao mudar a senha, todos os tokens da pessoa são excluídos.

Configurar o aplicativo Claude para desktop

  1. 1No aplicativo Claude para desktop, abra Settings (Configurações) → Extensions (Extensões), arraste e solte o arquivo da extensão do GeckoFlag (.mcpb) e clique em Install (Instalar). Também é possível instalar clicando duas vezes no arquivo ou por Advanced settings (Configurações avançadas). O arquivo da extensão vem incluído no download que você recebe ao comprar o GeckoFlag.
  2. 2Na tela de configuração, preencha os itens a seguir e clique em Save (Salvar).
    • GeckoFlag URL (obrigatório): o URL anotado. É preciso usar https:// (http:// só é aceito para localhost, *.test e *.local).
    • API token (obrigatório): o token copiado. É salvo mascarado.
    • Export folder (opcional): onde salvar o Excel do gráfico de Gantt. Se ficar vazio, é salvo na pasta Downloads.
    Tela de configuração da extensão do GeckoFlag, com os campos GeckoFlag URL, API token e Export folder
  3. 3Peça ao Claude “verifique se você consegue se conectar ao GeckoFlag”. Se aparecerem o dono do token, a versão do GeckoFlag e se a escrita é permitida, está tudo pronto.

Para o passo a passo com capturas de tela, veja o guia de configuração da Integração com Claude. Recomendamos definir as operações de escrita como “sempre perguntar” nas configurações da extensão no Claude.

O que é possível fazer

  • Tarefas: buscar (por projeto, status, responsável, relator, prioridade, palavra-chave, data de vencimento e tarefa pai), consultar detalhes e comentários, criar (inclusive com tarefa pai e destinatários de notificação), alterar campos, publicar comentários e mudar o status.
  • Projetos: consultar a lista e os detalhes, criar (todos exceto convidados), alterar o nome, a descrição, o proprietário e o período, marcar como concluído ou não concluído e adicionar ou remover membros (proprietário e administradores).
  • Wiki: consultar, reescrever o título e o texto e acrescentar conteúdo ao final (membros do projeto e administradores).
  • Notas: listar, buscar, consultar, criar, reescrever e complementar as suas próprias notas.
  • Cadastros: adicionar tipos de tarefa, status, prioridades e cargos (departamentos) e alterar os nomes e as cores (administradores).
  • Gráfico de Gantt: salvar no computador as tarefas do projeto (até 5.000) em um arquivo do Excel. Acima de 120 dias, cada coluna passa a representar uma semana.
  • Buscar usuários: encontrar usuários pelo nome (retorna apenas o ID e o papel; endereços de e-mail não são retornados).

As tarefas podem ser indicadas pela chave, como “WEB-12”. Para escrever, são necessários tanto um token de “Leitura e escrita” quanto o “Permitir escrita” do site.

Limitações e limites

  • Não é possível excluir (projetos, tarefas, comentários, cadastros, páginas wiki, notas), editar comentários, anexar ou consultar imagens e arquivos, alterar a chave do projeto nem reordenar os cadastros.
  • 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 outros usuários (nem mesmo administradores).
  • A escrita é feita um item por vez. Para vários itens, o Claude os executa um a um. O tempo de espera por resposta é de 30 segundos, e as escritas não são repetidas automaticamente, para evitar registros duplicados.
  • O título da tarefa tem até 50 caracteres, e os nomes de cadastros, até 20 caracteres (até 10 itens de cada, com cores escolhidas entre 8). O texto da wiki tem até 65.535 bytes no total, e o texto de uma nota, até 1.000.000 bytes.
  • Nos textos lidos pelo Claude, descrições, páginas wiki e notas acima de 8.000 caracteres e comentários acima de 2.000 caracteres são truncados. Textos truncados não são regravados; em vez disso, o Claude sugere acrescentar conteúdo.
  • Buscas e listas retornam até 50 itens por página. O limite de solicitações é de 60 por minuto por token.
  • Só funciona enquanto o aplicativo Claude para desktop estiver aberto no computador.

Histórico e e-mails de notificação

  • Alterar campos de uma tarefa, assim como na edição pela tela, não deixa comentário de histórico nem envia e-mails. Se quiser registrar o histórico, peça “faça a alteração por meio de um comentário”.
  • Ao mudar o status ou outros campos por meio de um comentário, o histórico é registrado como na tela, e os membros que recebem notificações de todos os comentários recebem um e-mail.
  • Ao criar uma tarefa, só recebem e-mail os membros indicados como destinatários de notificação. Ao criar um projeto, os membros recebem um e-mail de convite (adições posteriores não enviam e-mail).
  • As operações ficam registradas como operações do dono do token, sem indicação de “via Claude”.

Segurança e tratamento dos dados

Com a Integração com Claude desativada, a API é tratada como um URL inexistente (404). Projetos e tarefas sem permissão também são tratados como “inexistentes”. O servidor guarda apenas o hash dos tokens, e a restrição de acesso por endereço IP do GeckoFlag também vale para a API. O conteúdo de tarefas, páginas wiki e notas lido pelo Claude é enviado à Anthropic como parte da conversa. 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. Se não conseguir se conectar, veja Se algo não funcionar.