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/mcpFü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.
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/mcpVerbinden
Eine Bayan Flow-Seite öffnet sich in Ihrem Browser. Melden Sie sich an, falls Sie dazu aufgefordert werden.
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/mcpClients, 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_KEYUm 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.
- In den ChatGPT-Einstellungen den Entwicklermodus aktivieren (unter Connectors oder Sicherheit).
- 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.
- 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/mcpAndere 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:readListet die Wissensdatenbanken auf, die dieser Schlüssel lesen darf, zusammen mit ihrer Zugriffsebene und der Anzahl der Dokumente.
knowledge_searchknowledge:readDurchsucht Ihr Wissen und liefert die passendsten Abschnitte mit ihren Quellen zurück. Nur Abruf: kein KI-Text, keine Credits.
knowledge_list_documentsknowledge:readZeigt die Dokumente einer Wissensbasis an.
knowledge_get_documentknowledge:readLiest den Text eines Dokuments Seite für Seite.
workspace_getworkspace:readName des Workspaces, Sprachen, Tarif und Sitzplatznutzung.
workspace_list_membersworkspace:readMitglieder mit ihrer Rolle und ihrem Status. E-Mail-Adressen werden maskiert.
workspace_list_teamsworkspace:readTeams und die Anzahl ihrer Mitglieder.
workspace_usageworkspace:readGesamtzahlen für Anfragen, Guthaben und Aktivitäten der letzten Tage.
workspace_audit_logworkspace:readLetzte Einträge des Aktivitätslogs: wer was getan hat, niemals der Inhalt.
workspace_list_pending_actionsworkspace:readDie vorgeschlagenen Änderungsschlüssel und was aus ihnen wurde.
store_order_statusworkspace:readDer 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:writeErstellt eine Unternehmens-Wissensdatenbank. Nicht für Schlüsseln, die auf gewählte Basen beschränkt sind.
knowledge_create_documentknowledge:writeFügt ein neues Dokument zur Wissensdatenbank hinzu. Es wird im Hintergrund indexiert.
knowledge_update_documentknowledge:writeSpeichert 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:adminSchlägt das Löschen eines Dokuments vor. Nichts wird gelöscht, bis der Eigentümer zustimmt.
knowledge_archive_baseworkspace:adminSchlägt die Archivierung einer Wissensdatenbank vor, damit sie keine Antworten mehr liefert.
member_inviteworkspace:adminSchlägt vor, eine Person per E-Mail einzuladen. Wird erst nach Genehmigung gesendet.
member_change_roleworkspace:adminSchlägt die Änderung der Rolle eines Mitglieds zu Admin oder Mitglied vor. Niemals zum Inhaber.
member_disableworkspace:adminSchlägt das Deaktivieren eines Mitglieds vor: Das Mitglied verliert den Zugriff und der Sitzplatz wird freigegeben.
member_removeworkspace:adminSchlägt vor, ein Mitglied aus dem Workspace zu entfernen.
team_createworkspace:adminSchlägt das Erstellen eines Teams vor.
team_updateworkspace:adminSchlägt die Umbenennung eines Teams oder die Änderung seiner Beschreibung vor.
team_deleteworkspace:adminSchlägt das Löschen eines Teams vor.
team_set_membersworkspace:adminSchlägt das Ersetzen der Mitgliederliste eines Teams vor.
workspace_update_settingsworkspace:adminSchlä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:readSuchen 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:writeWissensdatenbanken und Dokumente erstellen sowie Bearbeitungen als neue Versionen speichern. Löscht niemals Inhalte.
Fordert Ihr Passwort an.
Arbeitsbereich lesen
workspace:readMitglieder (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.

