KI-Apps verbinden

Du kannst Claude, ChatGPT, Cursor, Codex oder einen anderen KI-Client, der MCP spricht, selbst mit VentionDesk verbinden — ohne API-Schlüssel. Die App meldet sich über dein VentionDesk-Konto an, und du legst bei der Verbindung fest, was sie darf. Das geht für Inhaber und Mitarbeitende; Kundenkonten des Kundenportals können keine KI-App verbinden.

English version for international users and app directories: Connect AI apps to VentionDesk — with the list of all tools and example prompts.

So läuft eine Verbindung ab

1. Adresse eintragen. In der KI-App fügst du einen MCP-Server (oft „Connector" oder „Integration" genannt) mit dieser Adresse hinzu: https://api.ventiondesk.com/mcp. Mehr braucht die App nicht — sie findet den Weg zur Anmeldung selbst.
2. Anmelden. Die App öffnet ein Browserfenster mit der Anmeldung von VentionDesk. Bist du schon angemeldet, geht es direkt weiter.
3. Zustimmen. VentionDesk zeigt eine Zustimmungsseite mit dem Namen der App (unter /oauth/zustimmen). Dort wählst du:
   • den Betrieb, falls du mehreren angehörst,
   • die Rechte — als Mitarbeiter nur die, die der Inhaber für KI-Apps freigegeben hat,
   • die Projekte — alle (auch künftige) oder eine Auswahl.
4. Verbunden. Nach deiner Zustimmung kehrst du zur App zurück. Sie arbeitet ab jetzt mit genau diesen Rechten — nicht mit deinen eigenen. Lehnst du ab, bricht die Verbindung ab, ohne dass etwas gespeichert wird.

Die App bekommt dieselben Werkzeuge wie ein Agenten-Schlüssel (siehe Claude und MCP); was ein Werkzeug darf, bestimmen die Rechte, die du gewählt hast. Was die App liest, geht an ihren Anbieter — etwa Anthropic, OpenAI oder Anysphere. Ob dein Betrieb das darf, entscheidet er selbst; für Vorgänge, Kundendaten und Zeiten mit Namen brauchst du mit dem Anbieter in der Regel einen Auftragsverarbeitungsvertrag.

Claude

claude.ai und Claude Desktop: Unter Einstellungen › Connectors einen eigenen Connector hinzufügen, als Name „VentionDesk" und als Adresse https://api.ventiondesk.com/mcp. Danach „Verbinden" — es folgen Anmeldung und Zustimmung wie oben. Ob eigene Connectors in deinem Tarif und deiner Organisation freigeschaltet sind, entscheidet Anthropic bzw. dein Claude-Administrator.

Claude Code: im Terminal

claude mcp add --transport http ventiondesk https://api.ventiondesk.com/mcp

und danach in Claude Code /mcp aufrufen und „ventiondesk" anmelden. Wer lieber mit einem festen Schlüssel arbeitet, folgt Claude und MCP.

Aufgaben abarbeiten wie mit /aufgaben — auch in der App ohne Dateisystem: „Work on the next open VentionDesk task“ (oder „Arbeite die nächste offene VentionDesk-Aufgabe ab“). Claude übernimmt die nächste Aufgabe nach derselben Regel wie der Aufgaben-Runner, liest Beschreibung, Verlauf und Projekt, holt Bildschirmfotos nur bei Bedarf, meldet das Ergebnis mit Beleg und schließt den Lauf. Dafür braucht die Verbindung die Rechte der Vorlage „Claude-Runner“ (Aufgaben lesen und zurückmelden, Läufe führen, Projekte lesen).

ChatGPT

In den Einstellungen unter Connectors (je nach Fassung „Apps & Connectors"; eigene MCP-Server verlangen den Entwicklermodus) einen neuen Connector anlegen: Adresse https://api.ventiondesk.com/mcp, Authentifizierung OAuth. Beim ersten Benutzen folgen Anmeldung und Zustimmung. Welche Tarife eigene Connectors erlauben, legt OpenAI fest.

Cursor

In ~/.cursor/mcp.json (für alle Projekte) oder .cursor/mcp.json (nur dieses Projekt):

{
  "mcpServers": {
    "ventiondesk": {
      "url": "https://api.ventiondesk.com/mcp"
    }
  }
}

Cursor zeigt den Server danach unter Einstellungen › MCP mit einem Hinweis zur Anmeldung; ein Klick darauf startet Anmeldung und Zustimmung.

Codex

In ~/.codex/config.toml:

[mcp_servers.ventiondesk]
url = "https://api.ventiondesk.com/mcp"

Danach codex mcp login ventiondesk — der Browser öffnet Anmeldung und Zustimmung. Ältere Fassungen von Codex sprechen MCP über HTTP nur mit einem zusätzlichen Schalter; sieh im Zweifel in die Hilfe deiner Codex-Fassung.

Andere Clients

Jeder Client, der MCP über HTTP („Streamable HTTP") mit OAuth beherrscht, findet den Weg selbst: Auf eine Anfrage ohne Anmeldung antwortet https://api.ventiondesk.com/mcp mit 401 und verweist auf https://api.ventiondesk.com/.well-known/oauth-protected-resource; dort steht der Anmeldedienst von VentionDesk. Der Client registriert sich dort selbst — es gibt nichts, was du vorher anlegen musst.

Die OAuth-Scopes, die ein Client dabei anfragt (openid, email, profile), betreffen nur die Anmeldung. Was die App in VentionDesk darf, wählst du auf der Zustimmungsseite.

Trennen und Ablauf

Unter Einstellungen › Meine KI-Apps siehst du deine Verbindungen in allen Betrieben: App, Rechte, Projekte, verbunden am und zuletzt benutzt. „Trennen" beendet eine Verbindung sofort — auch eine schon ausgestellte Anmeldung der App gilt danach nicht mehr. Bei deiner eigenen Verbindung nimmt VentionDesk zugleich die Freigabe bei der Anmeldung zurück; verbindest du die App neu, fragt dich VentionDesk wieder.

Eine Verbindung, die 90 Tage nicht benutzt wurde, endet von selbst. Verbinde die App einfach neu, wenn du sie wieder brauchst.

Als Inhaber siehst du dort zusätzlich die Verbindungen aller Personen deines Betriebs und kannst jede trennen. Außerdem legst du fest, welche Rechte Mitarbeitende einer KI-App geben dürfen. Ab Werk sind das die Rechte der Vorlagen „Nur lesen" und „Claude-Runner" — Projekte, Aufgaben und Deployments lesen, Aufgaben zurückmelden und Läufe führen —, nichts Heikles. Du selbst darfst jedes Recht vergeben, außer dem Vermerken von Zugriffen, das nur dem Betreiber zusteht. Engst du die Freigabe ein, gilt sie für bestehende Verbindungen ab dem nächsten Token der App — in der Regel binnen einer Stunde.

Jede Verbindung und jedes Trennen steht im Protokoll deines Betriebs; Änderungen, die eine App vornimmt, stehen dort, soweit VentionDesk sie protokolliert — jeweils mit App und Person, etwa „KI-App: Claude · Anna Schmidt".

KI-App oder API-Schlüssel?