MCP

Mit dem Claude-Konnektor verbinden

Alt ist im Verzeichnis der Claude-Konnektoren gelistet, deshalb brauchst du den Endpunkt weiter unten in der Regel gar nicht. Öffne in Claude Customize → Connectors, suche nach Alt und wähle Connect.

• Bestätige den Zugriff auf dem Zustimmungsdialog von Alt und wähle den einen Workspace, den der Connector lesen darf — deine persönlichen Notizen oder einen einzelnen Team-Space.
• Nichts einzufügen, kein API-Key anzulegen. Claude registriert sich selbst über OAuth.
• Erfordert ein Alt-Konto mit kostenpflichtigem Tarif. Kostenlose Konten erreichen den Zustimmungsdialog, erhalten beim Bestätigen aber den Fehler plan_required.
• Von Grund auf nur lesend: listet Notizen und liest Transkripte und Zusammenfassungen, schreibt nie. Jederzeit widerrufbar in der Kontoverwaltung.

1. Mit OAuth verbinden (empfohlen)

Füge nur den Endpunkt ohne Header hinzu. Dein Client findet den Alt-Autorisierungsserver, registriert sich selbst und öffnet die Zustimmungsseite im Browser.

• Alt unterstützt Dynamic Client Registration und PKCE, sodass kompatible Clients OAuth automatisch konfigurieren.
• Prüfe vor der Freigabe die angeforderten Lese-Scopes und den Workspace im Browser.
• Für die Verbindung ist ein Alt-Konto mit kostenpflichtigem Tarif nötig. Kostenlose Konten erreichen den Zustimmungsdialog, erhalten beim Bestätigen aber den Fehler plan_required.

2. Client verbinden

Verwende für OAuth die Konfiguration nur mit URL. Eine OAuth-Client-ID oder ein Secret ist nicht nötig; nutze einen API-Schlüssel nur, wenn dein Client OAuth nicht abschließen kann.

https://mcp.altalt.io/mcp

Claude / Claude Desktop / Cowork

Einen benutzerdefinierten Konnektor brauchst du nur für eine andere Alt-Umgebung: Customize → Connectors → Add custom connector öffnen, den obigen Endpunkt eintragen und OAuth-Client-ID und Secret leer lassen.

Claude Code

claude mcp add --transport http alt https://mcp.altalt.io/mcp

Öffne nach dem Hinzufügen des Servers /mcp in Claude Code, wähle Alt und schließe die Browser-Authentifizierung ab.

Codex CLI

codex mcp add alt --url https://mcp.altalt.io/mcp
codex mcp login alt

# ~/.codex/config.toml
[mcp_servers.alt]
url = "https://mcp.altalt.io/mcp"

Beim Hinzufügen des Servers wird die Browser-Authentifizierung normalerweise abgeschlossen. Falls sie nicht startet, führe codex mcp login alt aus.

Cursor

Ein-Klick-Installation nur mit URL. Wähle in den MCP-Einstellungen von Cursor „Connect“ oder „Needs authentication“ und bestätige die Browser-Zustimmung.

Andere Clients und API-Schlüssel-Alternative

Beginne mit der OAuth-Konfiguration nur mit URL. Unterstützt ein Client kein MCP-OAuth, verwende stattdessen die Bearer-API-Schlüssel-Konfiguration.

{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp",
      "headers": { "Authorization": "Bearer alt_live_..." }
    }
  }
}

API-Schlüssel bleiben für Automatisierung und ältere Clients verfügbar. Erstelle einen in der Kontokonsole, vergib nur benötigte Scopes, halte ihn aus geteilten Konfigurationen heraus und lies Sicherheit zur Schlüsselverwaltung.

3. Tools

Vier rein lesende Tools, die die REST-API spiegeln und dieselben Scopes durchsetzen.

• list_notes — Listet die für den Schlüssel sichtbaren Notizen auf, mit Cursor-Paginierung und updated_after-Filter (notes:read).
• get_note — Ruft die Metadaten einer Notiz ab: Titel, Status von Transkript/Zusammenfassung, Zeitstempel (notes:read).
• get_note_transcript — Ruft das vollständige Transkript als zeitgestempelte Segmente mit Sprecherlabels ab (transcripts:read).
• get_note_summary — Ruft die KI-Zusammenfassung als Markdown ab (summaries:read).

Notizen erscheinen, sobald eine Aufnahme beendet oder eine Zusammenfassung erstellt wurde — reine Memo-Notizen werden nicht exportiert. Vorher liefern die Tools transcript_not_ready / summary_not_ready, damit Agenten später erneut anfragen.