Zum Inhalt springen

Dokumentation · MCP-Connector

Verbinden Sie Ihre KI‑Apps mit Ihrem Bayan Flow-Wissen

Durchsuchen Sie Ihr Firmenwissen, schreiben und aktualisieren Sie Dokumente und überprüfen Sie Ihren Arbeitsbereich von Claude, ChatGPT oder jeder anderen MCP-App aus. Sie melden sich mit Ihrem Bayan Flow-Konto an, legen fest, was die App tun darf, und behalten die Kontrolle.

  • OAuth 2.0 mit PKCE
  • Remote-MCP · Streamable HTTP
  • Besitzerfreigabe für riskante Änderungen

Serveradresse

https://bayanflow.tech/api/v1/mcp

Fügen Sie diese Adresse als benutzerdefinierten MCP-Connector in Ihre KI-App ein. Mehr müssen Sie nicht kopieren.

Was KI-Apps mit Bayan Flow tun können

Bayan Flow macht unternehmenseigene Dokumente zu präzisen Antworten für das Support-Team. Dieser MCP-Konnektor ermöglicht es KI-Apps wie Claude und ChatGPT, mit den von Ihnen gewählten Wissensdatenbanken und Arbeitsbereichen zu arbeiten – streng nach Ihren Berechtigungen und nicht darüber hinaus.

  • Antwort aus eigenen Dokumenten

    Die App durchsucht die von Ihnen freigegebenen Wissensbasen und liest die relevanten Passagen, sodass ihre Antworten auf Ihren Richtlinien und Produktinformationen basieren – nicht auf Vermutungen.

  • Wissen aktuell halten

    Erstellen Sie Wissensdatenbanken und Dokumente und speichern Sie Bearbeitungen als neue Versionen. Auf diese Weise wird nichts je gelöscht.

  • Verstehen Sie Ihren Arbeitsbereich

    Mitglieder (mit maskierter E-Mail-Adresse), Teams, Nutzung und das Aktivitätsprotokoll anzeigen. Es werden niemals Geheimnisse oder Zahlungsdaten angezeigt.

  • Die App schlägt vor, Sie entscheiden

    Die App kann vorschlagen, Mitglieder hinzuzufügen oder zu entfernen, Rollen zu ändern, Einstellungen zu bearbeiten oder Wissen zu löschen. Jeder Vorschlag wartet auf den Workspace-Inhaber, der ihn in Bayan Flow mit seinem Passwort genehmigt.

Dinge, die Sie Ihrer KI-App fragen können

  • Durchsuche mein Bayan Flow-Wissen nach unserer Rückerstattungsrichtlinie und fasse sie in drei Stichpunkten zusammen.
  • Welche Dokumente erwähnen Lieferzeiten? Listen Sie sie mit der jeweiligen Wissensbasis auf.
  • Erstelle ein Dokument namens „Checkliste für Retouren“ in der Hilfebereichs-Datenbasis mit den Schritten, auf die wir uns gerade geeinigt haben.
  • Diesen Monatsverbrauch und die letzten zehn Einträge des Aktivitätsprotokolls anzeigen.
  • Schlagen Sie vor, das Mitglied zu entfernen, das das Unternehmen verlassen hat. Ich werde es in Bayan Flow genehmigen.

Claude in drei Schritten verbinden

Dies ist für Claude.ai und Claude Desktop gedacht. Es gibt keinen Schlüssel zum Kopieren: Sie melden sich bei Bayan Flow an und genehmigen die Verbindung.

Sie benötigen ein Bayan Flow-Konto, das ein Workspace-Besitzer ist, oder einen Admin, dem der Besitzer die Verwaltung von Integrationen erlaubt hat. Alle anderen sehen, dass sie keine App verbinden können und können den Besitzer anfragen.

  1. Den Connector in Claude hinzufügen

    Öffnen Sie Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen, fügen Sie die Serveradresse unten ein und speichern Sie.

    https://bayanflow.tech/api/v1/mcp
  2. Verbinden

    Eine Bayan Flow-Seite öffnet sich in Ihrem Browser. Melden Sie sich an, falls Sie dazu aufgefordert werden.

  3. Wählen Sie den Arbeitsbereich und die Berechtigungen

    Wählen Sie den Arbeitsbereich, aktivieren Sie die gewünschten Berechtigungen für Claude und klicken Sie auf Zulassen. Alles über das Lesen hinaus erfordert Ihr Passwort, und Sie werden automatisch zu Claude zurückgeleitet.

Starten Sie einen neuen Chat und fragen Sie: „Durchsuche meine Bayan Flow-Wissensbasis nach den Richtlinien für Rückerstattungen.“

Claude Code

Fügen Sie den Server hinzu, führen Sie dann /mcp in Claude Code aus und wählen Sie Authenticate. Dadurch wird dieselbe Bestätigungsseite geöffnet.

claude mcp add --transport http bayan-flow https://bayanflow.tech/api/v1/mcp

Clients, die keine Anmeldeseite öffnen können

Für Cursor, VS Code oder ein Skript erstellen Sie einen MCP-Schlüssel unter Integrationen → MCP und senden diesen als Bearer-Header. Bewahren Sie ihn in einer Umgebungsvariablen auf, niemals in einer gemeinsam genutzten Datei.

Authorization: Bearer $BAYAN_MCP_KEY

Um die Verbindung zu trennen, öffnen Sie Integrations → MCP in Bayan Flow und widerrufen Sie die Verbindung. Die App verliert sofort den Zugriff.

ChatGPT und andere KI-Apps

Jede App, die externe MCP-Server über HTTPS unterstützt, kann eine Verbindung herstellen. Apps mit OAuth-Anmeldung nutzen denselben Ein-Link-Ablauf wie Claude. Menübezeichnungen unterscheiden sich je nach App und können sich ändern: Suchen Sie nach „Benutzerdefinierter Connector“, „Entwicklermodus“ oder „MCP-Server hinzufügen“.

ChatGPT

Verfügbar in den kostenpflichtigen ChatGPT-Planen, die benutzerdefinierte MCP-Connectoren erlauben. In einem Unternehmensarbeitsbereich muss ein Administrator dies möglicherweise zuerst freigeben.

  1. In den ChatGPT-Einstellungen den Entwicklermodus aktivieren (unter Connectors oder Sicherheit).
  2. Erstellen Sie einen neuen Connector (oder eine App): Fügen Sie die Serveradresse ein und wählen Sie OAuth als Authentifizierung. Keine Client-ID oder kein Secret erforderlich, da ChatGPT sich selbst registriert.
  3. Klicken Sie auf Verbinden. Eine Bayan Flow-Seite öffnet sich: wählen Sie den Arbeitsbereich und die Berechtigungen aus, anschließend auf Erlauben klicken.
https://bayanflow.tech/api/v1/mcp

Andere Apps mit OAuth

Fügen Sie die Serveradresse ein und belassen Sie die Authentifizierung auf OAuth oder automatisch. Die App registriert sich selbst und leitet Sie zur Freigabeseite von Bayan Flow weiter.

Apps, die nur lokale Server ausführen

Verwenden Sie den mcp-remote-Helfer (erfordert Node.js), der einen Remoteserver in einen lokalen Server umwandelt. Vorkonfigurierte Snippets finden Sie unter Integrationen → MCP.

Apps, die einen Schlüssel verwenden

Cursor, VS Code, Windsurf, Gemini CLI, Codex CLI und ähnliche Tools akzeptieren einen benutzerdefinierten Header. Erstellen Sie einen MCP-Schlüssel unter Integrationen → MCP und speichern Sie ihn in einer Umgebungsvariable. Die Einstellungsnamen unterscheiden sich je nach App leicht; wichtig sind die Adresse und der Header.

{
  "mcpServers": {
    "bayan-flow": {
      "url": "https://bayanflow.tech/api/v1/mcp",
      "headers": { "Authorization": "Bearer ${BAYAN_MCP_KEY}" }
    }
  }
}

Die Bestätigungsseite zeigt den Namen der App und die Rücksprungadresse. Apps von Anthropic und OpenAI sind als verifiziert gekennzeichnet; überprüfen Sie bei allen anderen Apps die Adresse, bevor Sie den Zugriff erlauben.

Tools

25 Tools, alle unten aufgeführt. Jeder hat einen Titel und ist als schreibgeschützt oder nicht gekennzeichnet, damit die App und ihre Nutzer wissen, was ein Tool tut, bevor es ausgeführt wird.

LesenTools, die nur lesen

Es wird nichts geändert und es werden keine Credits verbraucht.

  • knowledge_list_basesknowledge:read

    Listet die Wissensdatenbanken auf, die dieser Schlüssel lesen darf, zusammen mit ihrer Zugriffsebene und der Anzahl der Dokumente.

  • knowledge_searchknowledge:read

    Durchsucht Ihr Wissen und liefert die passendsten Abschnitte mit ihren Quellen zurück. Nur Abruf: kein KI-Text, keine Credits.

  • knowledge_list_documentsknowledge:read

    Zeigt die Dokumente einer Wissensbasis an.

  • knowledge_get_documentknowledge:read

    Liest den Text eines Dokuments Seite für Seite.

  • workspace_getworkspace:read

    Name des Workspaces, Sprachen, Tarif und Sitzplatznutzung.

  • workspace_list_membersworkspace:read

    Mitglieder mit ihrer Rolle und ihrem Status. E-Mail-Adressen werden maskiert.

  • workspace_list_teamsworkspace:read

    Teams und die Anzahl ihrer Mitglieder.

  • workspace_usageworkspace:read

    Gesamtzahlen für Anfragen, Guthaben und Aktivitäten der letzten Tage.

  • workspace_audit_logworkspace:read

    Letzte Einträge des Aktivitätslogs: wer was getan hat, niemals der Inhalt.

  • workspace_list_pending_actionsworkspace:read

    Die vorgeschlagenen Änderungsschlüssel und was aus ihnen wurde.

  • store_order_statusworkspace:read

    Der Status einer Bestellung des verbundenen Shops: Versand, Sendungsverfolgung, Positionen, Gesamtsumme. Keine Kundendaten.

SchreibvorgängeTools, die Wissen schreiben

Sie erstellen oder bearbeiten Wissen. Bearbeitungen werden als neue Versionen gespeichert und nichts wird gelöscht.

  • knowledge_create_baseknowledge:write

    Erstellt eine Unternehmens-Wissensdatenbank. Nicht für Schlüsseln, die auf gewählte Basen beschränkt sind.

  • knowledge_create_documentknowledge:write

    Fügt ein neues Dokument zur Wissensdatenbank hinzu. Es wird im Hintergrund indexiert.

  • knowledge_update_documentknowledge:write

    Speichert neuen Text als neue Version. Ältere Versionen bleiben erhalten, nichts wird gelöscht.

Benötigt GenehmigungTools, die Änderungen vorschlagen

Sie ändern nie selbst etwas. Sie erstellen einen Vorschlag, den der Arbeitsbereichsinhaber in Bayan Flow genehmigt oder ablehnt.

  • knowledge_delete_documentworkspace:admin

    Schlägt das Löschen eines Dokuments vor. Nichts wird gelöscht, bis der Eigentümer zustimmt.

  • knowledge_archive_baseworkspace:admin

    Schlägt die Archivierung einer Wissensdatenbank vor, damit sie keine Antworten mehr liefert.

  • member_inviteworkspace:admin

    Schlägt vor, eine Person per E-Mail einzuladen. Wird erst nach Genehmigung gesendet.

  • member_change_roleworkspace:admin

    Schlägt die Änderung der Rolle eines Mitglieds zu Admin oder Mitglied vor. Niemals zum Inhaber.

  • member_disableworkspace:admin

    Schlägt das Deaktivieren eines Mitglieds vor: Das Mitglied verliert den Zugriff und der Sitzplatz wird freigegeben.

  • member_removeworkspace:admin

    Schlägt vor, ein Mitglied aus dem Workspace zu entfernen.

  • team_createworkspace:admin

    Schlägt das Erstellen eines Teams vor.

  • team_updateworkspace:admin

    Schlägt die Umbenennung eines Teams oder die Änderung seiner Beschreibung vor.

  • team_deleteworkspace:admin

    Schlägt das Löschen eines Teams vor.

  • team_set_membersworkspace:admin

    Schlägt das Ersetzen der Mitgliederliste eines Teams vor.

  • workspace_update_settingsworkspace:admin

    Schlägt Änderungen am Namen, den Sprachen oder den Befugnissen von Admins vor. Nie Integrationen oder Abrechnung.

Die App sieht nur die Tools, die Ihre Berechtigungen erlauben. Wenn ein Tool fehlt, stellen Sie die Verbindung erneut her und aktivieren Sie weitere Berechtigungen.

Berechtigungen

Sie wählen diese auf der Bestätigungsseite aus. Eine Verbindung kann niemals mehr tun, als Sie ausgewählt haben, und Sie können sie jederzeit widerrufen.

  • Wissen lesen

    knowledge:read

    Suchen und Lesen in den Wissensdatenbanken, die der Schlüssel verwenden darf. Es wird nichts geändert und es wird kein Guthaben verbraucht.

    Ein Klick zum Zulassen.

  • Wissen verfassen

    knowledge:write

    Wissensdatenbanken und Dokumente erstellen sowie Bearbeitungen als neue Versionen speichern. Löscht niemals Inhalte.

    Fordert Ihr Passwort an.

  • Arbeitsbereich lesen

    workspace:read

    Mitglieder (Namen, Rollen, maskierte E-Mail-Adresse), Teams, Nutzung und das Aktivitätsprotokoll anzeigen. Keine Secrets und keine Zahlungsdaten.

    Ein Klick zum Zulassen.

  • Workspace-Änderungen vorschlagen

    workspace:admin

    Änderungen an Mitgliedern, Teams, Einstellungen und das Löschen von Wissen vorschlagen. Jede Änderung wartet auf die Genehmigung des Eigentümers.

    Nur für Workspace-Inhaber, fordert Ihr Passwort an, und jede Änderung benötigt weiterhin die Zustimmung des Inhabers.

Sicherheit und Datenschutz

Der Konnektor ist so konzipiert, dass ein Fehler, ein geleaktes Token oder ein fehlerhaftes Assistenzsystem nur minimale Auswirkungen hat.

  • Login, den Sie kontrollieren

    OAuth 2.0 Authorization Code mit PKCE. Die App sieht Ihr Passwort nie, und Bayan Flow sieht nie die Anmeldedaten der App. Die Genehmigungsseite zeigt den App-Namen und die Rücksprung-Adresse.

  • Nur das, was Sie erlauben

    Eine Verbindung ist auf einen Arbeitsbereich und die von Ihnen gewählten Berechtigungen beschränkt. Die Person, die sie genehmigt hat, muss dort weiterhin Integrationen verwalten können, sonst endet die Verbindung.

  • Inhaber-Genehmigung

    Risikoreiche Änderungen sind nur Vorschläge. Der Inhaber genehmigt diese mit seinem Passwort; 5 falsche Versuche sperren die Genehmigung für 15 Minuten, und ein Vorschlag, über den niemand entscheidet, läuft nach 24 Stunden ab.

  • Kurzlebiger Zugriff

    Zugriffstoken gelten eine Stunde und werden automatisch erneuert. Wenn eine Kopie eines Erneuerungstokens jemals ein zweites Mal verwendet wird, wird die gesamte Verbindung gekündigt.

  • Beliebig widerrufen

    Die Verbindung unter Integrationen → MCP oder in der App widerrufen. Wartende Vorschläge werden abgelehnt und der Zugriff endet sofort.

  • Ein Audit-Trail

    Bayan Flow protokolliert, welches Werkzeug aufgerufen wurde und wie es endete, niemals den Inhalt. Arbeitsbereichsinhaber erhalten zudem eine E-Mail, wenn eine Verbindung hergestellt wird.

Ihre Daten

Abschnitte, die die App abfragt, werden an den Anbieter der App gesendet und unter den Bedingungen Ihres Plans mit ihnen gehandhabt, sodass Sie nur Assistenten verbinden sollten, denen Ihr Unternehmen vertraut. Text aus Ihren Dokumenten wird als Daten, nicht als Anweisungen gekennzeichnet, um Prompt-Injektionen zu verhindern. Bayan Flow erkennt die von der App getätigten Tool‑Aufrufe, nicht Ihre Unterhaltung mit ihr.

Niemals über MCP möglich, egal was Sie zulassen

  • Workspace wird gelöscht
  • Übertragung von Eigentum oder Änderung des Eigentümers
  • Passwörter, Sitzungen, Zwei-Faktor‑Verifizierung und Anmelden
  • Erstellen, Auflisten oder Widerrufen von API-Schlüsseln
  • Integrationen ein- oder ausschalten oder festlegen, wer sie verwaltet
  • Tarife, Arbeitsplätze, Zahlungsmethoden, Rechnungen und Rückerstattungen
  • Exportieren von personenbezogenen Daten
  • Alles auf Ebene der Bayan-Plattform
  • Alles in einem anderen Workspace

Lesen Sie unsere Datenschutzrichtlinie · Nutzungsbedingungen

Fehlerbehebung

Der „Erlauben“-Button ist ausgegraut

Wählen Sie zuerst einen Arbeitsbereich. Wenn Sie mehrere haben, wird keiner automatisch ausgewählt. Eine Zeile über dem Button zeigt, was fehlt.

Auf der Genehmigungsseite ist kein Arbeitsbereich aufgeführt

Nur Arbeitsbereichsinhaber und Admins, denen der Inhaber die Verwaltung von Integrationen erlaubt hat, können eine App verbinden. Bitten Sie den Inhaber, sie zu verbinden oder Ihnen diese Berechtigung zu erteilen.

Auf der Seite wird angezeigt, dass die Integration deaktiviert ist

Bayan Flow hat MCP für diesen Arbeitsbereich deaktiviert. Wenden Sie sich über die Kontaktseite an den Support.

Die App meldet, dass die Verbindung abgelaufen ist oder Sie sich erneut anmelden müssen

Verbindungen erneuern sich automatisch, solange sie genutzt werden. Nach einem Jahr oder wenn die Verbindung widerrufen wurde, drücken Sie in der App erneut auf „Verbinden“.

Warum wurde nach meinem Passwort gefragt?

Alles über das Lesen hinaus fordert Ihr Passwort an, genau wie das Erstellen eines API-Schlüssels. Wenn Sie sich nur mit Google anmelden, legen Sie zuerst in Einstellungen → Sicherheit ein Passwort fest.

Ein erwartetes Tool fehlt

Die App sieht nur die Tools, die Ihre Berechtigungen zulassen. Erneut verbinden und weitere Berechtigungen aktivieren.

Die App meldet zu viele Anfragen

Jede Verbindung erlaubt 120 Tool-Aufrufe und 30 Schreibvorgänge pro Minute. Warten Sie einen Moment und versuchen Sie es erneut.

Der Arbeitsbereich hat bereits die maximale Anzahl an Verbindungen.

Ein Arbeitsbereich kann gleichzeitig bis zu fünf MCP-Verbindungen haben. Widerrufen Sie eine, die Sie nicht mehr nutzen, in Integrations → MCP.

Sie kommen nicht weiter? Schreiben Sie uns über den Kontaktseite

Technische Referenz

Für Entwickler und Prüfer zur Überprüfung der Verbindung.

Serveradresse
https://bayanflow.tech/api/v1/mcp
Transport
Streaming-fähiges HTTP, zustandslos: Nur POST, keine Sitzungen und kein Event-Stream.
MCP-Protokollversionen
2025-11-25, 2025-06-18, 2025-03-26
Autorisierung
OAuth 2.0 Authorization Code mit PKCE (S256), öffentliche Clients, dynamische Client-Registrierung (RFC 7591), Discovery gemäß RFC 9728 und RFC 8414.
Geschützte Ressourcen-Metadaten
https://bayanflow.tech/.well-known/oauth-protected-resource/api/v1/mcp
Metadaten des Autorisierungsservers
https://bayanflow.tech/.well-known/oauth-authorization-server
Autorisierungs-Endpunkt
https://bayanflow.tech/oauth/authorize
Token-Endpunkt
https://bayanflow.tech/api/oauth/token
Client-Registrierung
https://bayanflow.tech/api/oauth/register
Widerrufs-Endpunkt
https://bayanflow.tech/api/oauth/revoke
Tokens
Zugriffstoken eine Stunde. Refresh-Token wird bei jeder Verwendung rotiert: 60 Tage ab letzter Verwendung, maximal ein Jahr. Der vorherige Refresh-Token ist ungültig.
Scopes
knowledge:read, knowledge:write, workspace:read, workspace:admin
Limits
Pro Verbindung: 120 Tool-Aufrufe und 30 Schreibvorgänge pro Minute. Eine Antwort wird bei 100 KB abgeschnitten.

Bereit zum Verbinden?

Erstellen Sie einen Arbeitsbereich oder melden Sie sich an, und folgen Sie dann den drei Schritten oben.

MCP-Connector für Claude, ChatGPT und KI-Apps · Bayan Flow