Mit mehreren Konten arbeiten

Das CLI unterstützt gleichzeitig N Konten. Typische Anwendungsfälle:

• Persönliches Konto im SaaS und Unternehmenskonto in einer anderen Organisation.
• SaaS-Konto für Kunden und Self-Hosted-Instanz für die interne Entwicklung.
• Mehrere Self-Hosted-Instanzen (Produktion, Staging, lokaler Rechner).

Alle befinden sich in ~/.almirant/config.json.

Mentales Modell

Jedes Konto hat vier wichtige Bestandteile:

Feld	Zweck
id	Stabile Kennung. Diese schreibt almirant link in .mcp.json.
label	Lokaler Name für Menschen, etwa prod-saas oder local-m1pro.
apiBaseUrl	Backend, mit dem das CLI kommuniziert.
apiKey	Geheimes Token; wird niemals vollständig ausgegeben.

Die E-Mail-Adresse reicht als Kennung nicht aus, weil derselbe Benutzer in mehreren Instanzen vorhanden sein kann.

Konfigurierte Konten anzeigen

almirant accounts list
# o, por compatibilidad:
almirant config accounts list

Typische Ausgabe:

[*]  1  local-m1pro       [email protected]                  https://macbook-m1-pro.tailnet.ts.net/api  alm_***
[ ]  2  prod-saas         [email protected]                  https://api.almirant.ai                    alm_***

Info

Der vollständige API-Schlüssel wird niemals ausgegeben. Du siehst nur ein Präfix oder eine Statusanzeige.

Ein neues Konto hinzufügen

# SaaS
almirant login

# Bestimmtes Backend
almirant login --api-url https://almirant.miempresa.com/api

# Gleichwertiger Alias
almirant accounts add --api-url https://almirant.miempresa.com/api

Konten mit nützlichen Bezeichnungen umbenennen

almirant accounts rename 1 prod-saas
almirant accounts rename 2 local-m1pro
almirant accounts rename prod-saas clientes

Bezeichnungen sind lokal. Sie beschreiben die Instanz oder den Zweck und müssen weder mit der E-Mail-Adresse noch mit der URL übereinstimmen.

Aktives Konto wechseln

# Interaktiver Selektor
almirant use

# Direkt über Bezeichnung, ID, eindeutige E-Mail oder Index
almirant use local-m1pro
almirant use 2

# Aktives Konto anzeigen
almirant current

Das aktive Konto wird von Befehlen verwendet, wenn du kein explizites Konto übermittelst.

Aktives Konto und im Repository festgelegtes Konto

Es gibt zwei gültige Modi:

1. Festgelegtes Konto - Standardmodus von almirant init / almirant link. Die .mcp.json enthält --account <account-id>, sodass das Repository immer mit derselben Instanz kommuniziert, auch wenn du später in einem anderen Kontext almirant use ausführst.
2. Aktives Konto - Erweiterter Modus. Wenn du --account aus den Proxy-Argumenten entfernst, folgt das Repository dem mit almirant use ausgewählten aktiven Konto.

Wir bevorzugen den festgelegten Modus: Er verhindert, dass ein altes Repository Erinnerungen, Aufgaben oder Kommentare in der falschen Instanz speichert.

MCP ohne Geheimnisse

Die erzeugte .mcp.json enthält keine API-Schlüssel:

{
  "mcpServers": {
    "almirant": {
      "type": "stdio",
      "command": "almirant",
      "args": ["mcp", "proxy", "--project-id", "<project-id>", "--account", "<account-id>"]
    }
  }
}

almirant mcp proxy liest das Konto aus ~/.almirant/config.json und hängt das Bearer-Token im Speicher an.

Codex .codex/config.toml

[mcp_servers.almirant]
command = "almirant"
args = ["mcp", "proxy", "--project-id", "<project-id>", "--account", "local-m1pro"]

Speichere keine Tokens in .codex/config.toml oder in .zshrc / .bashrc. Wenn du die Instanz wechseln musst, wechsle das aktive Konto mit almirant use oder aktualisiere --account des Projekts.

Ein Konto entfernen

almirant accounts remove <ref>
almirant accounts remove <ref> --yes

Dadurch wird das Konto aus der lokalen Konfiguration entfernt. Wenn du auch das Token im Backend ungültig machen möchtest, rotiere oder widerrufe den API-Schlüssel in Almirant.

API-Schlüssel eines Kontos rotieren

almirant config rotate api-key --account <ref>

Erzeugt einen neuen Schlüssel, ersetzt den bisherigen in der lokalen Konfiguration und macht den vorherigen auf dem Server ungültig. Da Repositories den Proxy verwenden und keine Tokens speichern, musst du .mcp.json nach der Rotation normalerweise nicht neu schreiben.

API-URL eines Kontos ändern

Nützlich, wenn du deine Self-Hosted-Instanz auf eine andere Domain verschoben hast:

almirant config set api-url https://nueva-url.example.com/api --account local-m1pro

Alles zurücksetzen

Um von vorn zu beginnen (löscht alle lokalen Konten):

almirant config reset
almirant config reset -y