Entwicklerdokumentation

MCP

Verbinde Claude, Codex und andere MCP-Clients mit deinen Alt-Notizen.

Alt stellt einen gehosteten MCP-Server (Model Context Protocol) bereit. OAuth-fähige Clients verbinden sich per Browser-Anmeldung; API-Schlüssel bleiben als Alternative verfügbar. Beide Methoden erzwingen dieselben Lese-Scopes und Workspace-Grenzen.

Hier starten

Starten Sie den interaktiven Einrichtungsassistenten im Projektordner. Er führt durch die MCP-Verbindung, die Prüfung von API-Schlüssel und Webhooks sowie die Übergabe an einen Coding-Agenten.

npx

npx altalt --mcp-only

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.
OAuth ist derzeit nur für Alt-Administratoren verfügbar. Falls eine ältere Alt-OAuth-Verbindung nach diesem Upgrade nicht mehr authentifiziert, entferne sie im Client und füge sie einmal neu hinzu.

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.

MCP URL

https://mcp.altalt.io/mcp

Claude / Claude Desktop / Cowork

Öffne Customize → Connectors → Add custom connector, gib den obigen Endpunkt ein, lasse OAuth-Client-ID und Secret leer und wähle Connect.

Claude Code

shell

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

shell

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

config.toml

# ~/.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

Zu Cursor hinzufügen

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.

OAuth

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

API-Schlüssel

{
  "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.