Perguntas frequentes

Geral

O que é o Almirant?

Almirant é seu centro de controle para gerenciar projetos em que humanos e agentes de IA trabalham juntos. Não é "mais uma ferramenta de gestão de projetos com IA integrada". É o lugar onde você define o que precisa ser feito, atribui trabalho a agentes de IA e acompanha, em tempo real, como eles o executam.

A diferença principal é a conexão bidirecional com seu IDE via MCP (Model Context Protocol). Seu agente de IA lê as tarefas, implementa código e atualiza o quadro sem que você saia do editor.

É gratuito?

O Almirant tem um plano gratuito com recursos completos para pequenas equipes. Se precisar de mais usuários, integrações avançadas ou limites maiores, há planos pagos. Consulte almirant.ai/pricing para ver os detalhes.

Quais navegadores são compatíveis?

Almirant funciona nas versões recentes dos principais navegadores:

Navegador	Versão mínima
Chrome	90+
Firefox	90+
Safari	15+
Edge	90+

Posso usar o Almirant sem IA?

Sim. Boards Kanban, work items, sprints, documentação, Seeds, Goals, Todos e Expenses funcionam perfeitamente sem integração de IA. A IA é opcional: você a ativa quando e onde quiser.

Projetos e Boards

Posso ter vários boards em um projeto?

Sim. Cada projeto pode ter quantos boards você precisar. É comum ter um board principal de desenvolvimento e boards adicionais para QA, design ou equipes específicas. Cada board tem suas próprias colunas configuráveis.

Posso transferir um projeto entre organizações?

Sim. Administradores podem transferir projetos completos entre organizações. A transferência inclui todos os work items, boards, colunas, sprints e documentos associados. Vá para Configurações do projeto > General > Transferir projeto.

Posso personalizar as colunas do board?

Sim. As colunas de cada board são totalmente personalizáveis. Você pode adicionar, remover, renomear e reordenar colunas. Também pode marcar colunas como "concluída" para que os work items nessa coluna sejam considerados finalizados.

O que são os modelos de board?

Ao criar um novo board, você pode escolher entre modelos predefinidos (Kanban básico, Scrum, Bug tracking) ou criar um do zero. Os modelos configuram colunas e fluxos iniciais que você pode modificar depois.

Work Items

Qual é a diferença entre Story e Task?

Os work items seguem uma hierarquia de quatro níveis:

Tipo	Finalidade	Exemplo
Epic	Iniciativa grande que agrupa features	"Módulo de faturamento"
Feature	Funcionalidade completa dentro de um epic	"Geração de faturas em PDF"
Story	História de usuário com valor de negócio	"Como admin, quero gerar faturas em PDF"
Task	Trabalho técnico específico e implementável	"Implementar serviço de geração de PDF"

Na prática, as stories descrevem o que o usuário precisa, e as tasks descrevem como isso é implementado tecnicamente.

Como funcionam os estados dos work items?

Os work items não têm um campo de estado próprio. O estado é derivado da coluna do board em que se encontram. Se um work item está na coluna "In Progress", seu estado é "In Progress". Se você o move para "Done", o estado muda automaticamente. Isso simplifica a gestão e garante que o quadro sempre reflita a realidade.

Posso arquivar work items?

Sim. Você pode arquivar work items que já não são relevantes sem excluí-los. Os itens arquivados desaparecem do board, mas continuam acessíveis no filtro "Arquivados". Você pode desarquivá-los a qualquer momento.

Posso criar dependências entre work items?

Sim. O Almirant oferece dependências do tipo "bloqueado por" entre work items. Se um item depende de outro que ainda não foi concluído, um indicador visual é exibido no quadro. Consulte o guia de Dependências para mais detalhes.

Seeds, Goals e Planning

O que são Seeds?

Seeds são matéria-prima para brainstorming. São ideias brutas que você registra rapidamente antes de esquecê-las: uma feature que surgiu no banho, feedback de um usuário ou algo que a IA gerou. Depois, você as revisa, refina e transforma em work items reais quando estiverem prontas.

Seeds podem estar em vários estados: draft (rascunho), active (em revisão ativa), to_review (aguardando revisão), approved (pronta para converter), archived (guardada para depois) ou rejected (descartada).

De onde vêm as Seeds?

Elas podem vir de diversas fontes:

• Manual: você as cria diretamente
• Feedback: vêm de comentários ou sugestões de usuários
• AI generated: a IA as gera durante sessões de planning
• Import: importadas de outras ferramentas

O que são Goals e Milestones?

Goals permitem acompanhar o progresso em alto nível. São objetivos grandes que agrupam vários work items: "Lançar v2.0", "Integração com Stripe", "MVP para demonstração com investidores".

Cada Goal tem um estado (planned, in_progress, completed, on_hold, cancelled), work items vinculados e uma porcentagem de progresso calculada automaticamente de acordo com a quantidade de itens concluídos.

O que são Planning Sessions?

Planning Sessions são chats com IA para planejar trabalho. Você descreve o que quer construir, a IA faz perguntas e, juntos, vocês decompõem o trabalho em tarefas concretas.

As sessões são multi-turn (conversa contínua), guardam o histórico, têm streaming em tempo real e podem gerar work items diretamente no seu board quando vocês chegam a algo concreto.

Todos e Expenses

O que são Todos?

Todos são tarefas pessoais simples. Não são work items, que vivem em boards e têm toda a formalidade de um projeto. São coisas que você precisa fazer: "Revisar a PR do João", "Responder ao e-mail do cliente", "Comprar domínio".

Estados simples: pending, in_progress, done, blocked. Sem sprints, sem boards, sem atribuições. Apenas sua lista pessoal.

Para que serve Expenses?

Expenses permite acompanhar os custos do projeto. Assinaturas de serviços, hospedagem, APIs pagas, freelancers, o que for. Você pode:

• Categorizar despesas por tipo
• Marcar despesas recorrentes (mensais, anuais)
• Usar várias moedas (EUR, USD, GBP etc.)
• Anexar faturas
• Ver relatórios de despesas por período

IA e integrações

Quais modelos de IA o Almirant oferece?

Almirant funciona com qualquer IDE ou ferramenta compatível com MCP (Model Context Protocol). Os modelos mais comuns são:

• Claude (via Claude Code) -- Recomendado. Suporte completo a MCP
• GPT-4 (via Cursor) -- Compatível via MCP
• Qualquer outro modelo acessível em um IDE compatível com MCP

O planejamento integrado de IA na interface web usa modelos da OpenAI ou Anthropic, configuráveis nas conexões do projeto.

Preciso do Claude Code para usar o Almirant?

Não é obrigatório, mas é o IDE com a melhor integração. O Claude Code oferece suporte nativo a MCP, o que permite usar as skills integradas (/implement, /review-task etc.) diretamente. Se preferir outro IDE, pode usar qualquer um que ofereça suporte a MCP.

Funciona com o Cursor?

Sim. O Cursor oferece suporte a MCP e você pode conectá-lo ao Almirant da mesma forma que o Claude Code. Configure o servidor MCP nas configurações do Cursor com a URL e a API key do seu projeto.

Funciona com outros IDEs?

Almirant funciona com qualquer ferramenta que ofereça suporte ao protocolo MCP. Atualmente, os mais comuns são Claude Code e Cursor, mas a lista de IDEs compatíveis cresce continuamente.

O Almirant substitui Claude, Cursor ou Codex?

Não. O Almirant dá a eles um plano e coordena seu trabalho. Você já usa agentes de IA. O problema não é a IA, e sim que eles não têm contexto sobre o que precisa ser feito, em qual ordem nem onde relatar o progresso. O Almirant é o centro de controle que falta a eles.

MCP (Model Context Protocol)

O que é MCP?

MCP (Model Context Protocol) é um protocolo aberto que permite que ferramentas de IA se comuniquem com serviços externos de modo padronizado. No caso do Almirant, o MCP permite que seu IDE leia tarefas, crie work items, mova itens entre colunas e gerencie sprints diretamente do editor.

Como conecto meu IDE ao Almirant via MCP?

1. Gere uma API key em Configurações > API Keys do seu projeto
2. Copie a URL do servidor MCP: https://api.almirant.ai/mcp?projectId=<tu-project-id>
3. Configure o servidor MCP no seu IDE (.mcp.json para Claude Code, configurações do Cursor)
4. Verifique a conexão executando um comando como list_projects

Consulte o guia completo em Conectar ao Claude Code.

A conexão MCP é segura?

Sim. A conexão MCP usa HTTPS com autenticação via API key. Cada key tem um escopo limitado a um projeto específico. Você pode revogar keys a qualquer momento nas configurações do projeto. Os dados são transmitidos criptografados e as API keys nunca são expostas nos logs.

Posso limitar o acesso MCP a um único projeto?

Sim. Ao configurar a URL do MCP, inclua o parâmetro projectId para limitar o escopo. As ferramentas MCP só poderão ver e modificar dados desse projeto específico. Sem projectId, o acesso é a todos os projetos da organização.

Cobrança e planos

Quanto custa o Almirant?

O Almirant oferece vários planos adaptados a necessidades diferentes. O plano gratuito inclui recursos completos para pequenas equipes. Os planos pagos ampliam os limites de projetos, membros, integrações e armazenamento. Visite almirant.ai/pricing para ver os preços atualizados.

Há um plano gratuito?

Sim. O plano gratuito inclui:

• Projetos e boards ilimitados
• Work items e sprints
• Seeds, Goals e Todos
• Acompanhamento de Expenses
• Integração MCP básica
• 1 usuário

Os planos pagos adicionam mais usuários, integrações avançadas, webhooks, mais armazenamento e suporte prioritário.

Posso mudar de plano a qualquer momento?

Sim. Você pode aumentar ou reduzir seu plano a qualquer momento em Configurações > Cobrança. As mudanças são aplicadas imediatamente e o custo é rateado conforme os dias restantes do ciclo de cobrança.