Eigene KI-Anwendung verbinden

Sie können Ihren eigenen KI-Assistenten mit Ihrem roleALPHA-Konto verbinden. Danach kann er Ihre Organisationsdaten lesen und bearbeiten — im selben Gespräch, in dem Sie ohnehin arbeiten, ohne Fenster zu wechseln und ohne Daten von Hand zu kopieren.

Fragen, die dann möglich werden: „Welche Rollen hängen an unserem Beschwerdeprozess?” · „Wer ist für die Lieferantenbewertung verantwortlich, und welche Kompetenzen fehlen dort?” · „Entwirf eine neue Rolle für die Fachbereichsleitung und trag sie als Vorschlag ein.”

Voraussetzung: Ihr Unternehmen muss es erlauben

Die Funktion ist standardmäßig aus. Erst wenn ein Administrator sie für Ihren Mandanten freischaltet, erscheint in Ihrem Profil der Bereich Verbundene Anwendungen. Sehen Sie ihn dort nicht, wenden Sie sich an Ihre Administration (Zugang freischalten).

So verbinden Sie

1. Öffnen Sie Profil → Verbundene Anwendungen und kopieren Sie die dort angezeigte Adresse.
2. Tragen Sie die Adresse in Ihrer KI-Anwendung als neue Verbindung ein. Wo genau, steht weiter unten — je Abschnitt für Claude, ChatGPT, Gemini, Langdock, Mistral Le Chat und die Entwicklerwerkzeuge.
3. Es öffnet sich ein Browserfenster mit der gewohnten roleALPHA-Anmeldung — Passkey, E-Mail-Code oder Firmen-Anmeldung, je nachdem, was Ihr Mandant erlaubt (Anmeldeverfahren).
4. Danach sehen Sie eine Freigabeseite: welche Anwendung fragt, für welchen Mandanten, und was sie darf. Prüfen Sie den Namen und klicken Sie auf Zugriff erlauben.

Fertig. Ihre Anwendung sieht ab jetzt die roleALPHA-Werkzeuge.

Kopieren Sie die Adresse, tippen Sie sie nicht ab. Sie hängt davon ab, unter welcher Domain Ihr Unternehmen roleALPHA betreibt — eine abgetippte Adresse aus einer Anleitung passt womöglich nicht zu Ihrem Zugang.

Drei Angaben, nach denen manche Anwendungen fragen

Bevor Sie zu Ihrer Anwendung springen: Diese drei Antworten gelten überall gleich.

Die Frage	Die Antwort
SSE oder HTTP?	HTTP (oft „Streamable HTTP” oder „HTTP streamable”). Einen /sse-Zugang gibt es hier nicht.
Welche Authentifizierung?	OAuth. Kein API-Schlüssel, kein Bearer-Token von Hand.
Client-ID und Client-Secret?	Nichts eintragen, Felder leer lassen. Ihre Anwendung meldet sich selbst an; roleALPHA stellt grundsätzlich keine Secrets aus. Eine Anwendung, die beides zwingend verlangt, kann sich heute nicht verbinden.

Stand: September 2026. Die Menüwege unten gehören fremden Produkten und ändern sich dort ohne unser Zutun. Findet sich ein Punkt nicht mehr an der beschriebenen Stelle, gilt die Dokumentation des jeweiligen Anbieters — die Adresse und die drei Antworten oben bleiben gleich.

Claude

Funktioniert in Claude im Browser, in Claude Desktop und in Cowork — überall über dieselbe Stelle.

Mit Pro oder Max: Einstellungen → Connectors → + → Add custom connector → Adresse einfügen → Add.

Mit Team oder Enterprise: Eine Person mit Owner-Rechten legt den Connector einmal für die Organisation an — Organization settings → Connectors → Add → Custom → Web. Danach verbindet sich jede Person selbst unter Einstellungen → Connectors über Connect.

Zwei Hinweise:

• „Advanced settings” nicht öffnen. Dort stünden OAuth-Client-ID und -Secret. Beides gibt es hier nicht, und ein eingetragener Wert lässt die Verbindung scheitern.
• Claude verbindet sich aus der Cloud von Anthropic, nicht von Ihrem Rechner. Ist Ihr roleALPHA nur im Firmennetz erreichbar, kommt Claude nicht heran — fragen Sie Ihre Administration.

Im Gespräch schalten Sie den Connector über das + unten links ein.

ChatGPT

ChatGPT braucht zuerst den Developer Mode; ohne ihn lassen sich eigene Verbindungen nicht anlegen.

1. Profilbild → Settings → Apps & Connectors → Advanced Settings → Developer Mode einschalten. Das setzt Pro, Team, Enterprise oder Edu voraus.
2. Settings → Connectors → Add custom connector.
3. Name vergeben, die Adresse einfügen, als Authentifizierung OAuth wählen und die Vertrauensabfrage bestätigen.

Fragt ChatGPT nach der Art des Zugangs: Die Adresse endet auf /api/mcp, das ist HTTP streamable — nicht /sse.

Gemini

gemini.google.com → unten Einstellungen & Hilfe → Verbundene Apps → unter Eigene Apps auf Eigene App hinzufügen → Adresse einfügen → Weiter → im Browser bestätigen.

Zwei Voraussetzungen von Googles Seite:

• Ein persönliches Google-Konto. Mit einem Arbeits- oder Schulkonto steht der Punkt nicht zur Verfügung.
• Die Aktivitätenspeicherung muss eingeschaltet sein, sonst verbindet Gemini nicht.

Eingerichtet wird am Rechner; benutzen können Sie die Verbindung danach auch in der Gemini-App am Telefon. Trennen ebenfalls unter Verbundene Apps.

Langdock

Integrations → Add Integration → Start from scratch → als Typ Connect remote MCP wählen → Adresse einfügen.

Bei der Authentifizierung ist die Auswahl entscheidend:

• Richtig: „OAuth 2.0 (Dynamic Client Registration)”. Damit meldet sich Langdock selbst an, und Sie werden nur noch zur Anmeldung geführt.
• Falsch: „OAuth 2.0 Manual”. Dieser Weg verlangt Client-ID, Client-Secret, Authorization- und Token-URL. roleALPHA stellt keine Secrets aus — die Einrichtung läuft hier in eine Sackgasse.

Langdock liest anschließend die verfügbaren Werkzeuge aus und lässt Sie auswählen, welche die Integration nutzen darf (bis zu 60 je Integration).

Mistral Le Chat

Intelligence → Connectors → Add connector → Reiter Add custom connector → Adresse einfügen.

Le Chat versucht die Verbindung sofort und führt Sie durch die Anmeldung. Weitere Angaben sind nicht nötig.

Entwicklerwerkzeuge

Claude Code

claude mcp add --transport http rolealpha <Adresse aus Ihrem Profil>

Danach im Gespräch /mcp eingeben, den Eintrag auswählen und die Anmeldung im Browser bestätigen.

VS Code

Über die Befehlspalette MCP: Open User Configuration die mcp.json öffnen und ergänzen:

{
  "servers": {
    "rolealpha": { "type": "http", "url": "<Adresse aus Ihrem Profil>" }
  }
}

Der Wurzelschlüssel heißt servers. Steht dort mcpServers, ignoriert VS Code den Eintrag — ohne Fehlermeldung. Anschließend über Auth oberhalb des Eintrags anmelden.

Cursor

Eine .mcp.json im Projektverzeichnis mit demselben Aufbau ("type": "http").

Jede andere Anwendung

Unterstützt Ihre Anwendung das Model Context Protocol, genügen die Adresse und die drei Antworten oben: HTTP als Zugang, OAuth als Authentifizierung, keine Client-ID und kein Secret.

Was Ihre Anwendung nach der Anmeldung zu sehen bekommt, steht in Was Ihre Anwendung über Ihr Modell erfährt.

Wenn es nicht klappt

Im Profil gibt es keinen Bereich „Verbundene Anwendungen”. Ihr Mandant hat die Funktion nicht freigeschaltet (Zugang freischalten).

Auf der Freigabeseite steht „Ihr Unternehmen hat die Anbindung externer Anwendungen nicht freigeschaltet”. Sie sind in keinem Mandanten, für den die Funktion aktiv ist. Arbeiten Sie in mehreren, wählen Sie oben auf der Freigabeseite den richtigen aus.

Die Anwendung meldet einen Fehler statt der Anmeldeseite. Fast immer ist die Adresse nicht die aus Ihrem Profil. Kopieren Sie sie neu, ohne Leerzeichen am Ende.

Die Anwendung meldet „missing permission”. Sie hat versucht, etwas anzulegen, für dessen Modul Ihnen das Schreibrecht fehlt — bei einer Zuordnung für beide beteiligten Module, denn eine Verbindung verändert beide Seiten. Das ist dieselbe Schranke wie in der Oberfläche; Ihre Administration vergibt das Recht.

Es erscheinen weniger Werkzeuge als erwartet. Welche Werkzeuge eine Anwendung sieht, hängt an drei Dingen: der Datenfreigabe Ihres Mandanten, den gebuchten Modulen und Ihren eigenen Rechten. Eine feste Zahl gibt es nicht.

Es lief, und plötzlich geht nichts mehr. Entweder wurde die Verbindung getrennt, die Funktion für den Mandanten abgeschaltet, Ihr Konto deaktiviert — oder die Anwendung fragt den falschen Mandanten. In allen Fällen hilft: neu verbinden.

„Zu viele Anfragen”. Pro Verbindung sind 120 Aufrufe je Minute möglich. Das reicht für jedes Gespräch, aber nicht für einen Massenabgleich.

Nach einer Pause wird erneut eine Anmeldung verlangt. Normal: Der Zugang wird stündlich erneuert, eine untätige Sitzung endet nach 30 Minuten. Ihre Anwendung regelt das selbst, solange die Verbindung besteht — nach 90 Tagen ohne Nutzung binden Sie neu an.

Die Anwendung sagt, sie habe etwas angelegt — in roleALPHA ist nichts zu sehen. Sie hat einen Entwurf angelegt, keinen Datensatz. Er wartet auf der Entwurfsseite auf Freigabe.

Was die Anwendung sehen und tun darf

Genau das, was Sie selbst dürfen — keine Entität mehr, kein Feld mehr. Mandantengrenze, Sichtbarkeitsstufen und Ihre Rollenrechte gelten unverändert. Verlieren Sie ein Recht, verliert es die Anwendung mit, beim nächsten Aufruf.

Zwei Dinge sollten Sie wissen:

• Sie umfasst auch das Ändern. Eine verbundene Anwendung kann Entwürfe anlegen und Daten bearbeiten, soweit Sie das dürfen. Änderungen laufen dabei über denselben Entwurfs- und Freigabeweg wie sonst auch.
• Eine Verbindung gilt für genau einen Mandanten. Arbeiten Sie in mehreren, legen Sie mehrere Verbindungen an.

Eigene Entwürfe verlinken. Eine Anwendung kann gezielt nach Ihren eigenen Entwürfen suchen — etwa um einen davon an ein Besprechungsthema zu heften. Sie bekommt dabei nur Titel, Typ, Status und einen Link, der den Entwurf auf der Drafts-Seite öffnet; Entwürfe anderer Personen sind in dieser Suche nie enthalten, auch wenn Sie sie sehen dürften.

Den Namen der Anwendung prüfen

Auf der Freigabeseite und in der Liste steht neben dem Namen der Hinweis „Name nicht bestätigt”. Das ist ernst gemeint: Den Namen gibt die Anwendung selbst an — auch eine fremde Anwendung könnte sich „roleALPHA Support” nennen.

Erlauben Sie den Zugriff nur, wenn Sie die Verbindung gerade selbst gestartet haben. Bekommen Sie eine Freigabeseite oder eine Benachrichtigung, ohne etwas getan zu haben, klicken Sie auf Ablehnen und melden Sie es Ihrer Administration.

Verbindung trennen

Unter Profil → Verbundene Anwendungen trennen Sie jede Verbindung mit einem Klick. Das wirkt sofort, auch auf eine gerade laufende Sitzung — nicht erst, wenn die Anwendung das nächste Mal startet.

Ihre Administration kann Verbindungen ebenfalls trennen und die Funktion für den ganzen Mandanten abschalten.

Was protokolliert wird

Jeder Aufruf Ihrer verbundenen Anwendung wird festgehalten: Mandant, Person, Name der Anwendung, aufgerufene Funktion, Zeitpunkt und Ergebnis. Ändernde Aufrufe stehen zusätzlich in der Änderungshistorie. Das dient der Nachvollziehbarkeit gegenüber Ihrem Unternehmen — es wird kein Inhalt Ihrer Fragen gespeichert.

Auch nicht die Werte, die die Anwendung übergibt. Vom Aufruf selbst hält die Änderungshistorie nur fest, welche Felder betroffen waren, nicht was darin stand — aus Vorname: Anna wird also Vorname und die Angabe „Text, 4 Zeichen“. Die Werte bleiben beim zuständigen Datenknoten, der sie ohnehin vollständig protokolliert.

Wohin Ihre Daten dabei fließen

Was Ihre KI-Anwendung mit den gelesenen Daten macht, entscheidet diese Anwendung, nicht roleALPHA. Schickt sie Inhalte an einen KI-Anbieter, geschieht das außerhalb der Plattform und auf Grundlage des Vertrags, den Ihr Unternehmen oder Sie mit diesem Anbieter haben. Verbinden Sie deshalb nur Anwendungen, deren Einsatz Ihr Unternehmen erlaubt.

Die Nennung einer Anwendung auf dieser Seite ist keine Empfehlung — welche Anwendungen eingesetzt werden dürfen, entscheidet Ihr Unternehmen.