Klavis MCP — Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Gehostete MCPs für Slack, Salesforce, Notion, Jira, Gmail, Drive, Calendar, HubSpot, Asana u. a.
OAuth 2.0 vollständig gehandhabt — kein Token-Jonglieren pro Nutzer
Einzelner MCP-Endpunkt unabhängig von der Anzahl aktivierter Apps
Audit-Log jedes Tool-Aufrufs pro Mandant
Self-Hosting-Option via Docker für compliance-kritische Umgebungen

Live-Demo

In der Praxis

klavis.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "klavis",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "klavis": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add klavis -- npx -y mcp-remote https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Klavis

Einen Agent shippen, der 5 SaaS-Tools nutzt — ohne 5 Auth-Flows

👤 Produktentwickler, die Claude in ihre App einbetten ⏱ ~45 min intermediate

Wann einsetzen: Deine Nutzer wollen, dass Claude Gmail liest, HubSpot aktualisiert und in Jira kommentiert — und du willst für jede App keinen OAuth-Kleber schreiben.

Voraussetzungen

Klavis-Konto + API-Key — Registrierung auf klavis.ai, Key im Dashboard holen
Gewünschte Server aktiviert — Gmail, HubSpot, Jira im Klavis-UI einschalten

Ablauf

Gateway einbinden

Füge Klavis als MCP-Server mit meinem Token hinzu. Liste die jetzt verfügbaren Tools auf.✓ Kopiert

→ Tool-Liste nennt Gmail-, HubSpot- und Jira-Endpunkte
Endnutzer verbinden

Generiere die Connect-Gmail-URL für user_id=xyz. Bestätige nach Rückkehr, dass die Auth erfolgreich war.✓ Kopiert

→ OAuth-URL zurückgegeben; Post-Callback zeigt connected:true
App-übergreifende Aktion

Erstelle für die neueste Gmail von acme.com einen HubSpot-Kontakt und ein Jira-Ticket mit einer Zusammenfassung des Threads.✓ Kopiert

→ Alle drei APIs in einem Flow angesprochen, mit Audit-Trail

Ergebnis: Ein funktionierender Multi-SaaS-Agent mit nutzerbezogener Auth und einer Konfigurations-URL.

Fallstricke

Nutzer-Tokens laufen stillschweigend ab — Den auth_expired-Webhook abonnieren und den Nutzer zur Neuverbindung auffordern

Kombinieren mit: gmail · slack

Interner Ops-Bot — Tickets erstellen, CRM aktualisieren, Slack-Nachrichten aus einem Chat

👤 Teams für interne Werkzeuge ⏱ ~30 min intermediate

Wann einsetzen: Du willst einen einzigen Claude-Chat, der „den Papierkram“ über deinen gesamten SaaS-Stack erledigen kann.

Voraussetzungen

Admin-OAuth für alle Apps einmalig einrichten — Jede App vom Team-Konto verbinden, nicht pro Nutzer

Ablauf

Stack verbinden

Füge Klavis hinzu. Bestätige, dass Salesforce, Jira und Slack alle verbunden sind.✓ Kopiert

→ Alle drei zeigen verbundenen Status
E-Mail triagieren

Erstelle für die Kundenbeschwerde in der letzten Slack-#support-Nachricht einen Salesforce-Case, einen Jira-Bug und antworte im Thread mit den Ticket-Links.✓ Kopiert

→ Case und Bug angelegt; Slack-Antwort verlinkt beides

Ergebnis: App-übergreifende Aktion in einem Chat erledigt, mit Belegen in jedem System.

Fallstricke

Rate-Limits bei Slack — Klavis-Dashboard zeigt App-Kontingente; Operationen nach Möglichkeit bündeln

Kombinieren mit: slack · linear

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

klavis + gmail

Lokaler Gmail MCP für persönliche Nutzung, Klavis für Multi-User

Nutze meinen lokalen Gmail MCP für mich, Klavis für Kundendaten.✓ Kopiert

klavis + slack

Statusupdates aus Ops-Flows posten

Nach Erstellung des Salesforce-Cases eine Zusammenfassung in #customers via Klavis posten.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
list_connected_apps	user_id?: str	Prüfen, welche Apps ein bestimmter Nutzer verbunden hat	free
get_auth_url	app: str, user_id: str	OAuth-Flow für einen Nutzer starten	free
proxy_tool_call	app, tool, args, user_id	Beliebiger nachgelagerter Tool-Aufruf — Klavis leitet ihn weiter	varies by app

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Free-Tier: 1.000 Aufrufe/Monat. Pro: 100.000/Monat.
Tokens pro Aufruf: 100–2000 je nach App
Kosten in €: Freemium + nutzungsbasiert
Tipp: Auditieren, welche Apps den Großteil der Aufrufe verursachen, und App-Kontingente im Dashboard setzen

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: read (per app) write-scoped (per app)

Credential-Speicherung: Klavis hält OAuth-Tokens; verschlüsselt im Ruhezustand

Datenabfluss: api.klavis.ai + jeweilige nachgelagerte SaaS

Niemals gewähren: admin scopes unless truly needed

Für SOC2-Anforderungen Docker selbst hosten — die gehostete Ebene sieht den gesamten Traffic

Fehlerbehebung

Häufige Fehler und Lösungen

401 von proxy_tool_call

OAuth des Nutzers abgelaufen — erneut get_auth_url aufrufen und Nutzer zur Neuverbindung auffordern

Prüfen: Call list_connected_apps, check status==connected

Server „notion“ nicht im Gateway

Zuerst im Klavis-Dashboard aktivieren, dann MCP-Client neu starten, um neue Tools zu laden

Rate-Limit bei einer einzelnen App

Klavis gibt 429 mit retry_after zurück; zurückhalten oder bündeln

Alternativen

Klavis vs. andere

Alternative	Wann stattdessen	Kompromiss
Composio MCP	Du willst eine ähnliche gehostete Integrationsplattform mit anderem Preismodell	Andere App-Abdeckung; ähnliches Auth-Modell
Self-hosted individual MCPs	Einzelnutzer, wenige Apps, compliance-sensibel	Du selbst bist für den OAuth-Kleber jeder App verantwortlich

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen