# Primeiros passos Este guia leva você da criação da conta até um projeto com o seu time trabalhando junto. Ele explica a configuração guiada, organizações, times, papéis e permissões, convites, notificações, o app no celular e a segurança da conta. Serve para quem está começando no KrakenDock e para quem administra uma organização e precisa decidir quem pode fazer o quê. > Versão em Markdown puro deste guia: [https://app.krakendock.com/docs/getting-started.md?lang=pt-BR](https://app.krakendock.com/docs/getting-started.md?lang=pt-BR). Use-a para colar num assistente de IA ou na documentação interna do seu time. ## Visão geral | Etapa | Onde | Detalhes | | ------------------------ | ------------------------------------------ | ----------------------------------------------------- | | Criar a conta | `/signup` | [Criar a conta](#criar-a-conta) | | Configuração guiada | `/me/welcome`, logo depois do cadastro | [Configuração guiada](#configuracao-guiada) | | Criar uma organização | **Nova organização** no início, ou `/new` | [Organizações](#organizacoes) | | Criar o primeiro projeto | **Novo projeto** no início, ou `/new` | [Criar o primeiro projeto](#criar-o-primeiro-projeto) | | Convidar pessoas | Configurações da organização ou do projeto | [Convidar pessoas](#convidar-pessoas) | | Ajustar notificações | Configurações → **Notificações** | [Notificações](#notificacoes) | | Proteger a conta | Configurações → **Conta** | [Segurança da conta](#seguranca-da-conta) | Dois conceitos ajudam a entender o resto: - **Conta pessoal**: todo usuário tem uma. Os projetos pessoais ficam em `https://app.krakendock.com/seu-usuario`. - **Organização**: um espaço do time, com membros, times, papéis e projetos próprios, em `https://app.krakendock.com/sua-organizacao`. Você pode participar de várias. ## Criar a conta ### E-mail e senha 1. Abra [https://app.krakendock.com/signup](https://app.krakendock.com/signup). 2. Preencha **Nome**, **E-mail** e **Senha**. A senha tem de 8 a 72 caracteres, e senhas que já vazaram na internet são recusadas. 3. O **Nome de usuário (opcional)** forma as suas URLs. Em branco, o KrakenDock cria um a partir do seu nome (nunca do e-mail). Veja as regras em [Nome de usuário e URLs](#nome-de-usuario-e-urls). 4. Aceite os Termos de Uso e a Política de Privacidade e clique em **Criar conta**. ### Login com Google ou GitHub Na tela de login ou de cadastro, use os botões "Continuar com Google" ou "Continuar com GitHub". - Se já existe uma conta com o mesmo e-mail, o login social se liga a ela, desde que o provedor confirme que o e-mail é verificado. - Uma conta criada pelo login social não tem senha. Para também entrar com e-mail e senha, vá em Configurações → **Conta** e use **Enviar link para definir senha**. - Se a conta tem autenticação em dois fatores, o código também é pedido depois do login social. ### Verificar o e-mail Depois do cadastro, você recebe um e-mail com um link de verificação. O link vale 48 horas. Enquanto o e-mail não é verificado, um aviso aparece no topo do app, com o botão **Reenviar e-mail**. Algumas ações exigem o e-mail verificado: - convidar pessoas e aceitar convites dentro do app; - gerar cards com IA e enviar reuniões; - assinar um plano; - comentar, propor cards ou pedir para trabalhar em cards de projetos públicos de outras pessoas. Quem se cadastra pelo link de um convite recebido por e-mail já começa com o e-mail verificado. Esqueceu a senha? Use **Esqueceu a senha?** na tela de login. O link de redefinição vale 1 hora, e redefinir a senha encerra as sessões em todos os aparelhos. ## Configuração guiada Logo depois do cadastro, o KrakenDock abre a configuração guiada em `/me/welcome`. Ela leva cerca de 2 minutos: | Passo | O que você faz | | ---------------------- | ---------------------------------------------------------------------------------------------------- | | **Boas-vindas** | uma apresentação rápida | | **Seu perfil** | confirma o nome e o **Nome de usuário** | | **Espaço de trabalho** | escolhe **Só eu, por enquanto** (conta pessoal) ou **Com o meu time** (cria uma organização na hora) | | **Primeiro projeto** | cria o projeto, com Scrum ou Kanban ou a partir de um template | | **Experimente a IA** | gera cards a partir de um texto de exemplo, ou segue com **Ir para o board sem usar a IA** | - **Pular configuração** fecha o assistente a qualquer momento. - O passo da IA consome créditos de IA do plano e exige o e-mail verificado. - Depois, o início mostra o checklist **Primeiros passos**, até você concluir os itens ou dispensá-lo. O link **Refazer configuração guiada** abre o assistente de novo. - Se você chegou por um convite, o cadastro volta para a tela do convite em vez do assistente. ## Nome de usuário e URLs Usuários e organizações dividem o mesmo espaço de nomes. O nome de usuário de uma pessoa e o identificador de uma organização formam as URLs: ```text https://app.krakendock.com/seu-usuario https://app.krakendock.com/sua-organizacao/CHAVE https://app.krakendock.com/sua-organizacao/CHAVE/cards/CHAVE-12 ``` Regras: - de 2 a 48 caracteres: letras minúsculas, números e hífen; - sem hífen no início, no fim ou duplo; - alguns nomes são reservados pelo sistema, como `admin`, `api`, `settings` e `docs`. Você troca o nome de usuário em Configurações → **Perfil**, e o identificador de uma organização em Configurações da organização → **Geral**. Na troca, as URLs antigas param de funcionar na hora, sem redirecionamento, e o nome antigo fica livre para outra pessoa. ## Organizações Use uma organização quando mais de uma pessoa vai trabalhar nos projetos. Ela reúne membros, times, papéis, cobrança e integrações num lugar só. ### Criar uma organização 1. No início, clique em **Nova organização** (ou abra `/new` e escolha **Organização**). 2. Preencha o **Nome**. O **Identificador (opcional)** vira a URL, e em branco é derivado do nome. 3. Se quiser, preencha descrição, site, e-mail de contato público e logo. 4. Clique em **Criar organização**. Você entra como Owner. Cada pessoa pode ter só uma organização no plano gratuito. Para criar outra, assine um plano pago na primeira. As configurações ficam em Configurações da organização, com as seções **Geral**, **Membros**, **Times**, **Roles**, **Convites**, **Plano e uso**, **Chaves de IA**, **Integrações** e **Templates de projeto**. Qualquer membro vê as seções. Quem não tem a permissão vê tudo em modo só leitura, com um aviso dizendo qual permissão falta. ### Times Um time agrupa membros da organização e dá a todos eles o mesmo acesso a vários projetos. 1. Em Configurações da organização → **Times**, clique em **Novo time**. 2. Abra o time e use **Adicionar membros**. Só membros da organização entram em times. 3. Na aba **Projetos**, clique em **Vincular projetos**, escolha os projetos e o **Papel padrão** do time neles. Também dá para fazer o caminho inverso: nas configurações do projeto, em **Colaboradores e times**, use **Conceder acesso a um time**. Times só existem em organizações, e dar acesso a um projeto exige a permissão de gerenciar os acessos dele. ## Papéis e permissões O KrakenDock controla o acesso com papéis (roles). Um papel é um conjunto de permissões. Há papéis de organização e papéis de projeto. ### Papéis de projeto Valem num projeto, dados a um colaborador direto ou a um time. | Permissão | Admin | Write | Triage | Contributor | Read | | ------------------------------------------- | ----- | ----- | ------ | -------------- | ---- | | Ver projeto | sim | sim | sim | sim | sim | | Editar cards (e comentar) | sim | sim | sim | só os próprios | — | | Excluir cards | sim | — | — | — | — | | Triagem de propostas e denúncias | sim | — | sim | — | — | | Gerenciar sprints | sim | sim | — | — | — | | Editar wiki | sim | sim | — | — | — | | Gerar com IA e enviar reuniões | sim | sim | — | — | — | | Gerenciar acessos | sim | — | — | — | — | | Gerenciar projeto (configurações, exclusão) | sim | — | — | — | — | - Write é o papel do dia a dia: trabalha em cards, sprints, wiki e IA, mas não exclui cards nem mexe nas configurações. - Triage cuida da caixa de triagem e das denúncias e edita qualquer card (labels, prioridade, duplicados). Não exclui cards nem gerencia membros, sprints, wiki ou configurações. - Contributor comenta, propõe cards e edita ou move só os cards atribuídos a ele ou criados por ele. É pensado para quem colabora de fora. Veja [Projetos open source](https://app.krakendock.com/docs/open-source). - Read só lê. ### Papéis de organização | Papel | O que pode | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Owner | tudo na organização: dados e logo, membros, roles, times, criar e gerenciar todos os projetos, cobrança, chaves de IA e integrações. Só um Owner exclui a organização | | Member | nenhuma permissão de organização. Vê a organização, os membros, os times e os papéis, e acessa só os projetos que recebeu por um time ou como colaborador | Regras do Owner: - Só um Owner dá ou tira o papel Owner, convida alguém como Owner ou remove outro Owner. - A organização sempre mantém pelo menos um Owner. Rebaixar, remover ou deixar sair o último Owner falha. ### Roles personalizadas Numa organização, quem pode gerenciar roles cria papéis próprios em Configurações da organização → **Roles** → **Novo role**. - Escolha o escopo (**Organização** ou **Projeto**) e marque as permissões daquele escopo. - As permissões de organização são **Gerenciar organização**, **Gerenciar membros**, **Gerenciar roles**, **Gerenciar times**, **Criar projetos**, **Gerenciar projetos** (acesso total a todos os projetos), **Gerenciar cobrança**, **Gerenciar credenciais de IA** e **Gerenciar integrações**. - O nome não pode repetir o de outro papel, nem o de um papel do sistema. - Os papéis do sistema não podem ser editados. - Um papel em uso por membros, times, colaboradores ou convites não pode ser excluído. Exemplo: um papel de organização "Gestor de projetos" com **Criar projetos** e **Gerenciar times**, sem acesso à cobrança. Projetos pessoais usam só os papéis do sistema. ### Como o acesso é calculado A permissão de uma pessoa num projeto é a soma de tudo o que ela recebeu: 1. o dono de um projeto pessoal tem todas as permissões; 2. numa organização, quem tem **Gerenciar projetos** tem todas as permissões em todos os projetos dela; 3. os papéis dos times da pessoa no projeto; 4. o papel de colaborador direto. - Num projeto de organização, todo acesso exige ser membro da organização. Quem sai ou é removido da organização perde os times, as colaborações e os convites abertos dela. - Num projeto público, qualquer pessoa, mesmo sem conta, pode ver o conteúdo. Para escrever, é preciso um papel. - Quem não é membro de um projeto privado recebe "não encontrado", sem saber que ele existe. Para dar a alguém acesso a só alguns projetos da organização, use o papel Member e conceda os projetos por um time ou como colaborador direto. ## Criar o primeiro projeto 1. No início, clique em **Novo projeto** (ou abra `/new`). 2. Escolha o **Dono**: a sua conta pessoal ou uma organização em que você pode criar projetos. 3. Escolha um **Template**, ou **Em branco**. 4. Preencha o **Nome** e a **Chave**. A chave é o prefixo dos cards (por exemplo, `APP-12`): de 2 a 10 letras maiúsculas ou números, começando com letra. Ela não muda depois. 5. Num projeto em branco, escolha a **Metodologia da primeira board**: Scrum (sprints, backlog e planejamento em ciclos) ou Kanban (fluxo contínuo, sem sprints). Você pode criar outras boards depois, cada uma com a sua metodologia. 6. Escolha a **Visibilidade** e clique em **Criar projeto**. Em **Detalhes opcionais** ficam a descrição, a imagem, o site e os tópicos do projeto. ### Visibilidade | Opção | Quem vê | Limite do plano | | ----------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------- | | **Privado** | só quem tem acesso ao projeto | as pessoas com acesso contam no limite do plano (veja [Limites por plano](#limites-por-plano)) | | **Público** | qualquer pessoa na internet, mesmo sem conta | não conta em limite nenhum | - Num projeto público, você escolhe se permite **Permitir comentários de não-membros** e **Permitir sugestões de cards de não-membros**. Os dois exigem login com e-mail verificado. - Tornar um projeto público expõe cards (inclusive os arquivados), comentários, sprints, o histórico da wiki e a lista de membros. Reuniões, transcrições, IA e a lista de acessos continuam privados. - A visibilidade muda depois em Configurações do projeto → **Visibilidade**. Num projeto pessoal, só o dono muda. Numa organização, só quem tem **Gerenciar projetos**. ### Templates O template define a metodologia e a estrutura inicial: boards e colunas, labels, campos, templates de card e a sprint inicial. Cards, páginas da wiki e membros não são copiados. Além dos templates prontos, você pode salvar um projeto existente como template e reusá-lo nos próximos. Veja [Campos e templates](https://app.krakendock.com/docs/fields-templates). O projeto também pode nascer com as issues de um repositório do GitHub. Veja [GitHub](https://app.krakendock.com/docs/github). ## Convidar pessoas Todo convite vai por e-mail, vale 7 dias e precisa ser aceito pela pessoa. Nada é aceito sozinho: nem o cadastro, nem o login aceitam um convite. Quem convida precisa ter o e-mail verificado. O formulário aceita até 20 e-mails por envio, separados por vírgula, ponto e vírgula, espaço ou linha. ### Convidar para a organização 1. Em Configurações da organização → **Membros**, clique em **Convidar pessoas** (ou vá direto em **Convites**). 2. Informe os e-mails e o **Papel** de organização. 3. Clique em **Enviar convites**. É preciso a permissão **Gerenciar membros**. Só um Owner convida alguém como Owner. ### Convidar para um projeto 1. Em Configurações do projeto → **Colaboradores e times**, use **Convidar por e-mail**. 2. Informe os e-mails e o **Papel** de projeto, e envie. O que acontece depende de quem é a pessoa: | Caso | Resultado | | --------------------------------------------------- | ---------------------------------------------------------------------- | | Projeto de organização, e a pessoa já é membro dela | entra direto no projeto e recebe a notificação | | Projeto de organização, e a pessoa não é membro | recebe um convite. Ao aceitar, entra também na organização como Member | | Projeto pessoal | recebe um convite | Convidar para um projeto exige a permissão **Gerenciar acessos**. Se o convite traz alguém novo para a organização, é preciso também **Gerenciar membros**. ### Aceitar um convite A pessoa convidada recebe um e-mail com o botão para ver o convite. - Sem conta: escolhe **Criar conta**. O e-mail fica travado no endereço convidado e, depois do cadastro, ela volta ao convite para aceitar. - Com conta: escolhe **Já tenho conta**, entra e responde. - Logada com outro e-mail: o KrakenDock avisa e oferece trocar de conta. O convite só pode ser aceito pela conta do e-mail convidado. Na tela do convite, use **Aceitar convite** ou **Recusar**. Quem já tem conta também vê os convites pendentes num aviso no início, no sino de notificações e em Configurações → **Convites**. ### Gerenciar convites pendentes A lista **Convites pendentes** fica em Configurações da organização → **Convites** e, para projetos, em **Colaboradores e times**. - **Reenviar** gera um link novo, renova a validade e manda o e-mail de novo. Espere 1 minuto entre dois envios para o mesmo e-mail. - **Copiar link** gera um link novo sem mandar e-mail, para você enviar por outro canal. O link anterior para de funcionar. Quem aceita por esse link precisa ter o e-mail já verificado. - **Revogar** cancela o convite. Um convite pendente já ocupa vaga no limite do plano. Se o limite acabar, o envio é recusado com um link para os planos. ## Notificações O sino no topo mostra as notificações mais recentes e o número de não lidas. A página completa fica em [https://app.krakendock.com/notifications](https://app.krakendock.com/notifications), com filtro de não lidas e por tipo. Tudo se atualiza em tempo real, sem recarregar a página. ### Preferências Em Configurações → **Notificações** ([https://app.krakendock.com/settings/notifications](https://app.krakendock.com/settings/notifications)), escolha os canais de cada tipo: **No app**, **Por e-mail** e **Push**. As mudanças são salvas na hora. | Tipo | Ligado por padrão | | ----------------------------------------------------------------------------------- | ---------------------------------------------- | | Atribuição | no app, por e-mail e push | | Menções | no app, por e-mail e push | | Adicionado a um projeto | no app, por e-mail e push | | Prazo vencendo ou vencido | no app; prazo vencido também por e-mail e push | | Conquistas | no app e push | | Webhook desativado | no app e por e-mail | | Comentários, convites, sprints, propostas de card e pedidos para trabalhar em cards | só no app | - Você nunca é notificado das próprias ações. - Comentários seguidos no mesmo card, em 5 minutos, viram uma notificação só. - Os lembretes de prazo seguem o seu fuso horário, que o KrakenDock sincroniza com o do navegador. - Todo e-mail de notificação tem um link para cancelar aquele tipo de e-mail com um clique. - **Avisos neste navegador** liga ou desliga o aviso na tela quando chega uma notificação. Vale só para o navegador em uso. ## App no celular (PWA) O KrakenDock pode ser instalado na tela inicial do celular ou do computador e abre em janela própria, como um aplicativo. ### Instalar o app - Android e computador (Chrome, Edge): no menu do usuário, use **Instalar app**. No celular, um aviso também oferece **Instalar**. - iPhone e iPad: abra no Safari, toque em Compartilhar e escolha Adicionar à Tela de Início. O aviso **Como instalar** mostra o passo a passo. Quando sai uma versão nova, o app mostra **Nova versão disponível**. Clique em **Atualizar** quando quiser: o app nunca recarrega sozinho, para você não perder o que está editando. Sem conexão, o app mostra o que já foi carregado, mas não salva alterações até a rede voltar. ### Notificações push Quando o push está disponível, Configurações → **Notificações** mostra o interruptor **Notificações neste aparelho** e a coluna **Push** na tabela. 1. Ligue **Notificações neste aparelho**. O navegador pede permissão. 2. Escolha na coluna **Push** quais tipos devem chegar no aparelho. - Vale para cada aparelho e navegador separadamente. - No iPhone e no iPad, o push só funciona com o app instalado na tela de início (iOS 16.4 ou mais novo). - Redefinir a senha desliga o push em todos os aparelhos. Trocar a senha desliga nos outros aparelhos e mantém o atual. ## Segurança da conta ### Autenticação em dois fatores Com a autenticação em dois fatores (2FA), o login pede um código de 6 dígitos do seu aplicativo autenticador além da senha (ou do login social). 1. Vá em Configurações → **Conta** → **Autenticação em dois fatores** e clique em **Ativar**. 2. Escaneie o QR code com um aplicativo autenticador, como Google Authenticator, 1Password ou Authy. Se preferir, digite a chave mostrada. 3. Digite o código de 6 dígitos que o aplicativo mostra. 4. Guarde os 10 códigos de recuperação (**Baixar .txt**) e clique em **Já guardei**. Eles não aparecem de novo. - Sem o celular, use **Usar um código de recuperação** na tela do código. Cada código vale uma vez. - Com poucos códigos sobrando, use **Gerar novos códigos**. Os antigos deixam de valer. - **Desativar** pede um código e, se a conta tem senha, a senha atual. Na mesma página você altera a senha (**Alterar senha** encerra as outras sessões), exporta os seus dados e exclui a conta. ### Exigir 2FA na organização No plano Business, o Owner pode exigir 2FA de todos os membros em Configurações da organização → **Geral** → **Exigir 2FA**. - O Owner precisa ter o 2FA ativo na própria conta antes. - Antes de confirmar, o KrakenDock lista quem ainda não usa 2FA. - Membros sem 2FA perdem o acesso à organização e aos projetos dela até ativarem. Eles veem um aviso com o atalho para ativar. - A lista de **Membros** mostra quem usa 2FA. ## Atalhos de teclado Aperte `?` em qualquer página para ver os atalhos disponíveis ali, ou use **Atalhos de teclado** no menu do usuário. Os atalhos não funcionam enquanto você digita num campo. | Onde | Tecla | O que faz | | ------- | ----------------------------------- | ------------------------------------------ | | Geral | `Ctrl` `K` (no Mac, `⌘` `K`) ou `/` | abre a paleta de comandos e a busca | | Geral | `?` | mostra os atalhos | | Geral | `[` | recolhe ou expande a barra lateral | | Projeto | `g` depois `b` | vai para o board | | Projeto | `g` depois `l` | vai para a lista de cards | | Projeto | `g` depois `w` | vai para a wiki | | Projeto | `g` depois `a` | vai para a IA | | Projeto | `g` depois `t` | vai para a triagem (para quem faz triagem) | | Board | `c` | adiciona um card na primeira coluna | | Lista | `/` | busca na lista | | Lista | `j` / `k` | próximo card / card anterior | | Card | `e` | edita o título | | Card | `a` | atribui o card a você | | Card | `f` | finaliza ou reabre o card | | Card | `m` | muda a coluna do card | | Card | `j` / `k` | abre o próximo card / o anterior, na lista | Usa leitor de tela ou atalhos próprios? Desligue em **Ativar atalhos de teclado**, na janela de atalhos. ## Limites por plano Projetos, projetos públicos e times não têm limite de plano. O que o plano limita são as pessoas com acesso a projetos privados. Conta pessoal: | | Free | Pro | | --------------------------------------------------------- | ---- | --- | | Pessoas distintas nos projetos privados (sem contar você) | 10 | 30 | Organização: | | Free | Pro | Business | | ---------------------- | ---- | ----------------------- | ------------------------ | | Membros | 15 | 25, com assentos extras | 100, com assentos extras | | Exigir 2FA dos membros | — | — | sim | - Na conta pessoal, contam os colaboradores e os e-mails com convite pendente nos projetos privados. - Na organização, contam os membros e os e-mails com convite pendente. O limite só vale enquanto a organização tem algum projeto privado: uma organização só com projetos públicos não tem limite de membros. - Cada pessoa cria no máximo uma organização no plano Free. - O uso fica em **Plano e uso**, nas configurações da conta ou da organização. Veja os planos e os preços em [https://app.krakendock.com/pricing](https://app.krakendock.com/pricing). ## Perguntas frequentes ### Não recebi o e-mail de verificação. E agora? Confira a caixa de spam. Depois, use **Reenviar e-mail** no aviso do topo do app. O link vale 48 horas. ### Conta pessoal ou organização? Comece pela conta pessoal se você trabalha sozinho ou quer só experimentar. Crie uma organização quando o time chegar: ela tem membros, times, papéis personalizados e cobrança própria. ### Como dou acesso a só alguns projetos da organização? Convide a pessoa com o papel Member, que não tem nenhuma permissão de organização. Depois, conceda os projetos por um time ou como colaborador direto, com um papel de projeto. ### Por que não consigo convidar ninguém? Confira, nesta ordem: 1. Seu e-mail está verificado? 2. Você tem a permissão (**Gerenciar membros** na organização, **Gerenciar acessos** no projeto)? 3. O limite do plano acabou? Convites pendentes também ocupam vaga. 4. Você reenviou para o mesmo e-mail há menos de 1 minuto? ### O convite expirou. O que faço? Peça a quem convidou para usar **Reenviar** ou **Copiar link** na lista de convites pendentes. O convite volta a valer por mais 7 dias. ### Perdi o celular com o aplicativo autenticador Entre com um código de recuperação (**Usar um código de recuperação**). Depois, desative e ative o 2FA de novo no celular novo, e gere novos códigos. ### Como saio de uma organização ou de um projeto? Na organização, use **Sair da organização** em Configurações da organização → **Geral**. Num projeto, use **Sair do projeto** em **Colaboradores e times**. O último Owner de uma organização não pode sair antes de passar o papel a outra pessoa. ## Próximos passos | Quero… | Guia | | ------------------------------------------------- | -------------------------------------------- | | organizar o trabalho em boards, backlog e sprints | [Boards e sprints](https://app.krakendock.com/docs/boards) | | criar campos customizados e templates | [Campos e templates](https://app.krakendock.com/docs/fields-templates) | | gerar cards e páginas da wiki com IA | [IA](https://app.krakendock.com/docs/ai) | | ligar o projeto a um repositório do GitHub | [GitHub](https://app.krakendock.com/docs/github) | | avisar outros sistemas quando algo muda | [Webhooks](https://app.krakendock.com/docs/webhooks) | | conectar um assistente de IA ao KrakenDock | [Servidor MCP](https://app.krakendock.com/docs/mcp) | | abrir o projeto para contribuições externas | [Projetos open source](https://app.krakendock.com/docs/open-source) | | receber pedidos de clientes | [Helpdesk](https://app.krakendock.com/docs/helpdesk) | Ainda com dúvidas? Fale com a gente em [https://app.krakendock.com/help](https://app.krakendock.com/help).