Resumo
- O conector leva seus projetos do Kanban Pesquisa para o ChatGPT e o Claude. Você pede em linguagem natural: prazos da semana, pauta da orientação, novas tarefas, referências por DOI, citações.
- Por padrão, a conexão abrange todos os seus projetos, inclusive os que você criar ou em que entrar depois, e permite editar. Você pode limitá-la a projetos escolhidos ou só a consulta. O Kanban confere suas permissões em cada pedido.
- Para criar ou editar vários itens, o assistente monta uma revisão de alterações. Nada muda no projeto até você confirmar.
- A conexão vale por 90 dias e pode ser revogada a qualquer momento em Integrações.
1. O que você precisa
- Uma conta no Kanban Pesquisa e participação em pelo menos um projeto. O projeto de exemplo, com dados fictícios, também pode ser conectado, somente para consulta.
- Uma conta no Claude ou no ChatGPT que permita conectores. A disponibilidade varia conforme o plano e as políticas do workspace.
2. Conectar no Claude
Funciona no Claude na web, no computador e no celular. Depois de conectar pela web ou pelo computador, o conector aparece também no celular.
- No Claude, abra Personalização → Conectores. Procure Kanban Pesquisa no diretório de conectores. Se ele ainda não aparecer, clique em +, escolha Adicionar conector personalizado, informe o nome “Kanban Pesquisa” e a URL
https://kanbanpesquisa.com.br/api/mcp. Deixe as configurações avançadas em branco. - Clique em Conectar. O Kanban abre para você entrar com sua conta e conferir os projetos (todos os seus, por padrão) e a opção Permitir alterações, que vem ligada. Confirme e volte ao Claude.
- Numa conversa nova, clique em +, abra Conectores e confira se Kanban Pesquisa está ativo.
Nos planos Team e Enterprise, um proprietário da organização adiciona o conector uma vez; depois, cada integrante clica em Conectar e autoriza a própria conta. No Claude Code, use claude mcp add --transport http kanban-pesquisa https://kanbanpesquisa.com.br/api/mcp e autentique com /mcp.
3. Conectar no ChatGPT
- No ChatGPT, procure Kanban Pesquisa nos apps. Se ele ainda não aparecer, ative o Modo de desenvolvedor em Configurações → Segurança e login e crie uma conexão personalizada com o nome “Kanban Pesquisa”, a URL
https://kanbanpesquisa.com.br/api/mcpe autenticação OAuth, deixando ID e segredo do cliente em branco. - Autorize no Kanban: entre com sua conta e confira os projetos (todos os seus, por padrão) e a opção Permitir alterações, que vem ligada.
- Numa conversa nova, adicione Kanban Pesquisa pelo menu de ferramentas.
O Codex e o Work usam a mesma URL. Os passos de cada aplicativo ficam em Integrações, depois de entrar na sua conta.
4. Permissões e revogação
- Projetos: por padrão, todos de que você participa, inclusive os que você criar ou em que entrar depois; o projeto de exemplo fica de fora. Se preferir, escolha projetos específicos: aí projetos novos não entram, e para incluí-los é preciso criar outra conexão.
- Consulta ou edição: Permitir alterações vem ligada; desligada, o assistente só lê. Com a permissão, pode criar e editar tarefas, comentários, documentos e referências e, se você administra o projeto, o orçamento e as configurações. A conexão nunca convida pessoas, muda acessos ou apaga projetos.
- Papel no projeto: a conexão nunca dá mais acesso do que você tem no site. Quem só consulta um projeto continua só consultando pelo assistente, e o projeto de exemplo é sempre somente para consulta.
- Solicitações de projetos: exigem uma autorização à parte. O assistente envia o pedido em seu nome, mas a criação depende da aprovação dos administradores do hub.
- Histórico: as alterações aparecem no histórico do projeto com o seu nome, marcadas como feitas pela integração.
- Revogação: em Integrações → Suas conexões, a qualquer momento. A autorização expira em 90 dias. Sair do site não desconecta o assistente.
5. O que pedir
Alguns pedidos que funcionam bem:
- “O que vence esta semana nos meus projetos do Kanban Pesquisa?”
- “Quais tarefas do projeto Dissertação estão atrasadas ou bloqueadas?”
- “Monte a pauta da próxima reunião de orientação do projeto Dissertação.”
- “Crie três tarefas no projeto Dissertação para a revisão de literatura, com prazo na próxima sexta.”
- “Inclua a referência com DOI 10.1590/… no projeto Dissertação e gere a citação em ABNT.”
- “Faça o resumo da semana do projeto Dissertação.”
O assistente consulta o projeto antes de alterar. Títulos, comentários e documentos dos projetos são tratados como dados, nunca como instruções.
6. Painel na conversa
No Claude e no ChatGPT, as respostas do Kanban aparecem num painel dentro da conversa, com o visual do próprio aplicativo:
- Listas de tarefas, prazos, documentos e referências mostram os números principais e os itens mais urgentes, com Ver tudo para a lista completa em tela cheia e Abrir no Kanban.
- A tarefa mostra situação, prioridade, prazo, responsáveis, checklist e comentários. Perguntar sobre a tarefa leva a tarefa para a conversa; no ChatGPT, ela vai para o campo de mensagem sem ser enviada.
- A revisão de alterações lista tudo o que vai mudar, com o antes e o depois de cada campo. O botão Aplicar grava tudo de uma vez; a revisão vale por 15 minutos e só pode ser aplicada uma vez.
No app do ChatGPT para computador, quando o recurso estiver disponível na sua conta, o Kanban também abre na barra lateral, com seus projetos, o quadro de cada um e as pendências da semana.
7. Ferramentas
O assistente escolhe a ferramenta conforme o pedido. As de consulta nunca alteram dados.
| Grupo | Ferramentas |
|---|---|
| Consulta | Listar projetos, Consultar projeto, Listar tarefas, Listar tarefas que podem começar, Consultar tarefa, Minhas pendências, Prazos da semana, Listar documentos, Listar referências, Consultar orçamento, Consultar atividades, Consultar notificações e Gerar citação. |
| Edição | Criar tarefa, Editar tarefa, Arquivar ou restaurar tarefa, Comentar tarefa, Incluir documento, Editar documento, Vincular documento a tarefas, Incluir referência por DOI, Incluir lançamento, Editar lançamento, Editar projeto, Preparar e Aplicar alterações em lote e Marcar notificações como lidas. |
| Solicitações | Solicitar projeto e Listar minhas solicitações, com autorização à parte. |
| Pedidos prontos | Resumo da semana do projeto e Pauta da reunião de orientação, nos aplicativos que oferecem pedidos prontos. |
8. Privacidade
Quando você usa uma ferramenta, o Kanban envia ao assistente os registros necessários para responder ao pedido. O Kanban não recebe suas conversas, apenas os pedidos que o assistente faz às ferramentas. Na OpenAI e na Anthropic, o tratamento segue também as políticas de cada empresa. Os detalhes estão na Política de Privacidade e nos Termos de Uso.
9. Problemas comuns
- “Não foi possível abrir” ou painel antigo: o aplicativo guardou a lista de ferramentas de antes de uma atualização. Atualize o conector nas configurações (ou desconecte e conecte de novo) e abra uma conversa nova.
- Projeto não autorizado: a conexão foi feita com projetos escolhidos e não inclui este. Crie uma nova conexão, com todos os projetos ou incluindo este, e revogue a anterior.
- Conexão somente para consulta: para editar, crie uma nova conexão com Permitir alterações.
- Revisão vencida: peça uma nova revisão na conversa; depois de 15 minutos, a anterior não pode mais ser aplicada.
- Conexão expirada: depois de 90 dias, conecte de novo.
10. Suporte
Dúvidas e problemas: suporte@kanbanpesquisa.com.br, ou pela página de Contato. Informe o aplicativo (Claude ou ChatGPT) e o pedido que você fez, sem enviar senhas.