almirant init
Configura a integração MCP do Almirant para o repositório atual. É o fluxo completo: inclui autenticação quando necessário, seleção de conta, seleção de projeto e geração de arquivos de configuração.
Uso
almirant init [--api-url <url>] [--app-url <url>] [--name <nome>]
O que faz
- Detecta o tipo de projeto.
- Verifica se
.mcp.jsonjá existe e, se existir, pergunta se deve continuar e mesclar a entrada do Almirant. - Permite escolher uma conta armazenada ou adicionar uma nova.
- Valida as credenciais com o servidor.
- Mostra os projetos disponíveis para selecionar ou criar.
- Gera
.mcp.jsonusandoalmirant mcp proxysem gravar tokens. - Copia skills para
.claude/skills/e.agents/skills/.
Arquivo .mcp.json gerado
{
"mcpServers": {
"almirant": {
"type": "stdio",
"command": "almirant",
"args": ["mcp", "proxy", "--project-id", "<project-id>", "--account", "<account-id>"]
}
}
}
A API key não aparece no repositório. O proxy lê a conta de ~/.almirant/config.json e anexa o bearer token apenas em memória.
Quando usar init ou link
- Use
initquando estiver configurando o Almirant em uma máquina pela primeira vez ou quiser que a CLI o guie, incluindo o login. - Use
linkquando já tiver credenciais armazenadas e quiser apenas vincular rapidamente um novo repositório.