Automação com IA

O Projectura não vive só na tela. O mesmo board, as mesmas tarefas, releases e documentos que você opera no /app podem ser operados por uma IA — do Claude, do Cursor, do Windsurf ou de qualquer ferramenta que fale MCP (Model Context Protocol). Você descreve o que quer em português; a IA traduz isso em ações reais no seu workspace. É o diferencial do Projectura: em vez de clicar, você conversa com o seu gerenciador de projetos.

O que é "operar por IA"

MCP é um padrão aberto que conecta assistentes de IA a ferramentas externas. O Projectura expõe um conector MCP: um endereço que a sua IA acessa, com um token seu, para ler e escrever no seu workspace. Na prática, isso significa pedir coisas como:

• "Cria no projeto Web as tarefas do épico Checkout, cada uma com a label checkout."
• "Abre a release v1.2 com tudo que está em revisão e marca o deploy para staging."
• "Me dá o status do projeto: o que está em andamento, o que está bloqueado, o que falta pra fechar a release."

A IA faz o trabalho braçal — criar, mover, vincular, comentar, resumir — e você revisa. Tudo que ela faz aparece no app normalmente, como se você tivesse feito à mão. Tarefas, documentos, releases e comentários surgem no app aberto em cerca de 12 segundos; projetos e equipes aparecem ao recarregar a página.

Passo 1 — Gere um token nas Configurações

O conector só funciona com um token de acesso pessoal (PAT). Ele é a sua credencial: identifica você e define o que a IA pode fazer. Os tokens ficam dentro do app, no contexto da sua conta.

1. No app, abra Configurações (ícone ⚙️) → aba Integrações → seção Conector MCP.
2. Em Seus tokens, clique em Gerar token. Dê um nome (ex.: "Claude Code") e escolha o escopo: somente leitura ou leitura e escrita.
3. Copie o token na hora. Ele começa com pj_ e aparece uma única vez — depois disso o Projectura guarda só uma versão cifrada e não consegue mostrá-lo de novo. Se perder, é só gerar outro.

A mesma seção já traz, para copiar e colar, o endpoint e os blocos de configuração — então na prática você nem precisa montar nada à mão. (A página pública /mcp explica o conector e leva você direto a essa tela.)

Passo 2 — Conecte no seu cliente de IA

Com o token em mãos, registre o conector na ferramenta que você usa. Troque pj_SEU_TOKEN pelo token que você acabou de gerar.

Claude Code

Em qualquer pasta, rode um comando só:

claude mcp add --transport http projectura https://projectura-next.vercel.app/api/mcp \
  --header "Authorization: Bearer pj_SEU_TOKEN"

Pronto — na próxima conversa o Claude já enxerga o Projectura e pode operar nele.

Cursor / Windsurf (e outros clientes com mcp.json)

Cole este bloco na configuração de servidores MCP do cliente:

{
  "mcpServers": {
    "projectura": {
      "url": "https://projectura-next.vercel.app/api/mcp",
      "headers": { "Authorization": "Bearer pj_SEU_TOKEN" }
    }
  }
}

Claude Desktop

Vá em Settings → Developer → Edit Config, cole o mesmo bloco mcpServers acima e reinicie o aplicativo. O Projectura aparece na lista de ferramentas disponíveis.

O que dá para pedir

Por trás da conversa, o conector oferece à IA um conjunto de ações organizadas por área do produto. Você não precisa conhecê-las — basta pedir em linguagem natural —, mas vale saber o que está ao alcance.

• Contexto. A IA começa entendendo quem é você e em qual workspace está operando, e consegue listar todos os workspaces de que você participa.
• Projetos. Listar, abrir, criar, renomear e ajustar projetos — incluindo cor, chave e os repositórios do GitHub vinculados.
• Tarefas (o coração do dia a dia). Listar e filtrar (por status, prioridade, projeto, responsável, label ou busca), abrir com comentários, criar, editar (título, prazo, estimativa, responsáveis, labels, descrição), mover entre colunas, comentar, lançar horas e quebrar em subtarefas.
• Releases. Abrir uma release, avançar o ciclo (planejamento → revisão → aprovação → deploy) e vincular tarefas.
• Equipes. Listar, abrir, criar e editar squads, definir o líder e adicionar ou remover membros.
• Documentos. Criar, ler, atualizar e organizar documentos em markdown, em qualquer escopo — ótimo para a IA salvar um relatório como doc.
• Notificações. Consultar a sua inbox: quantas pendências não-lidas há e quais exigem ação.

Exemplos de pedidos

A graça é que tudo isso se combina numa frase só. Alguns pedidos que o conector resolve ponta a ponta:

• Quebrar um épico: "No Projectura, crie no projeto Web as tarefas do épico 'Checkout v2' — uma por item da lista — cada uma com a label checkout."
• Abrir uma release: "Abra a release v1.2.0 no projeto Web com as tarefas que estão em revisão e defina o deploy target como staging."
• Triar a inbox: "Triage minha inbox do Projectura: resuma as não-lidas e me diga o que está bloqueado."
• Planejar o sprint: "Monte o próximo sprint: pegue as tarefas abertas de alta prioridade e distribua entre o time."
• Status report: "Gere o status report da semana e salve como doc."
• Lançar horas: "Lance 2h na tarefa X e 1h30 na Y, com data de hoje."
• Visão rápida: "Me dá o status do projeto Web: contagem por coluna e o que está em deploy."

Segurança — o token é seu, e você manda nele

O conector foi desenhado para nunca dar à IA mais poder do que você quer. Três garantias importam:

• O token tem escopo. Gere um token somente leitura para integrações que apenas consultam (relatórios, dashboards): com ele, qualquer tentativa de alterar dados é recusada. Só conceda leitura e escrita quando realmente quiser que a IA mude coisas.
• Você só enxerga o que é seu. A IA herda exatamente os seus acessos — ela nunca vê nem toca em workspace de que você não é membro. Cada ação revalida isso no servidor, não só na hora de conectar.
• Ações destrutivas são explícitas. Apagar tarefas, releases, projetos, equipes ou documentos é marcado como operação destrutiva: clientes de IA pedem sua confirmação antes de executar, então nada some sem você aprovar.