Integrationen der Organisation
MCP-Server freigeben, die Personen in Ihrer Organisation als Integrationen nutzen können.
Auf dieser Seite
Auf der Seite Integrationen im Bereich Organisation der Einstellungen geben Organisations-Admins MCP-Server für ihre Organisation frei. Über MCP (Model Context Protocol) kann AITEZA Werkzeuge externer Systeme nutzen. Die Personen der Organisation verbinden sich anschließend mit den freigegebenen Servern (siehe Integrationen) und wählen pro Nachricht, welche Integrationen AITEZA nutzen darf.
Serverliste
Die Seite listet die Server der Organisation mit ihrer URL und einer Zusammenfassung auf: Art der Anmeldung, Anzahl verbundener Personen und, wenn der Server ausgeschaltet ist, Ausgeschaltet. Server, die nur für bestimmte Gruppen freigegeben sind, zeigen diese Gruppen, zum Beispiel Nur Vertrieb, Einkauf.
- Server hinzufügen legt einen neuen Server an.
- Bearbeiten öffnet die Einstellungen des Servers in einem Seitenbereich. Änderungen gelten ab der nächsten Nachricht.
Vorschläge
Unter der Serverliste zeigt Vorschläge häufig genutzte MCP-Server, die von ihren Anbietern betrieben werden: AITEZA Docs, Linear, Notion, Jira & Confluence, Microsoft 365, Microsoft OneDrive, SharePoint, Outlook E-Mail und Kalender, Teams und Word, Google Drive, Gmail, Google Calendar, Docs, Sheets, Slides und Chat, GitHub, Slack, HubSpot, Box, Grafana, Figma, Canva und Microsoft Learn. Zuerst werden sechs angezeigt; Alle Anzahl Vorschläge anzeigen zeigt die übrigen. Bereits hinzugefügte Server (gleiche URL) erscheinen nicht mehr.
Jeder Vorschlag zeigt seine Art der Anmeldung und, wo zutreffend, diese Hinweise:
- App-Registrierung nötig: Der Dienst registriert AITEZA nicht automatisch. Legen Sie dort eine App mit der angezeigten Weiterleitungs-URI an und tragen Sie deren Client-ID und Client-Geheimnis ein.
- Tenant-ID nötig: Ersetzen Sie bei Microsoft-Servern den Platzhalter für die Tenant-ID in geschweiften Klammern in der URL bzw. beim Autorisierungsserver durch Ihre Microsoft-Entra-Tenant-ID. Solange der Platzhalter vorhanden ist, lässt sich das Formular nicht speichern.
- Vorschau: Der Anbieter bietet den Server noch als Vorschau an.
- Copilot-Lizenz nötig: Microsofts Agent-365-Server (OneDrive, SharePoint, Outlook, Teams, Word) lassen nur Personen mit Microsoft-365-Copilot-Lizenz in einem für die Vorschau freigeschalteten Tenant zu. Ohne diese Lizenz nutzen Sie Microsoft 365.
- Nur freigegebene Apps: Der Anbieter (derzeit Figma) lässt nur von ihm freigegebene Anwendungen zu; die Anmeldung kann scheitern, solange AITEZA nicht freigegeben ist.
Hinzufügen öffnet das Serverformular, vorausgefüllt mit Name, Beschreibung, URL, Transport und Anmeldung. Oben zeigt es die Hinweise und einen Link zur Einrichtungsanleitung des Anbieters. Prüfen Sie die Einstellungen und speichern Sie.
Einstellungen eines Servers
| Feld | Beschreibung |
|---|---|
| Name | Wird im Chat angezeigt. Er ist auch das Präfix der Werkzeugnamen in den Ausführungsschritten. |
| Beschreibung | Eine kurze Beschreibung des Servers. |
| Server-URL | Der MCP-Endpunkt des Servers, meist mit /mcp am Ende. Er muss https verwenden und darf nicht auf ein internes Netzwerk zeigen. |
| Transport | Streamable HTTP (aktuell) oder HTTP mit SSE (ältere Server). |
| Anmeldung | Wie sich Personen beim Server anmelden. Siehe unten. |
| In der Organisation verfügbar | Ausgeschaltet sieht niemand den Server. Bestehende Verbindungen bleiben erhalten. |
| Nur für bestimmte Gruppen | Aus: Alle in der Organisation können den Server verbinden. An: Nur Mitglieder der ausgewählten Gruppen sehen und nutzen ihn. Siehe Freigabe für Gruppen. |
Freigabe für Gruppen
Ist Nur für bestimmte Gruppen eingeschaltet, haken Sie eine oder mehrere Gruppen der Organisation an. Mindestens eine Gruppe muss angehakt sein („Wähle mindestens eine Gruppe aus.“). Ohne Gruppen ist der Server für die ganze Organisation verfügbar.
Personen außerhalb der ausgewählten Gruppen sehen den Server weder unter Einstellungen > Integrationen noch im Chat, können ihn nicht verbinden, und seine Werkzeuge werden für sie nie genutzt. So können Sie zum Beispiel OneDrive nur der Gruppe Vertrieb anbieten und nicht der Entwicklung.
Wird eine freigegebene Gruppe gelöscht, wird der Server nicht für alle geöffnet. Er hat dann nur eine Gruppe weniger; entfernen Sie die Gruppe aus der Auswahl.
Arten der Anmeldung
| Art | Wann Sie sie verwenden |
|---|---|
| Persönliche Anmeldung (OAuth) | Jede Person meldet sich mit ihrem eigenen Konto an. Nötig für Microsoft 365, Google, GitHub und die meisten Business-Tools. |
| Persönlicher Schlüssel | Jede Person gibt ihren eigenen API-Schlüssel oder ihr persönliches Zugriffstoken ein. |
| Schlüssel der Organisation | Ein von einem Admin hinterlegter Schlüssel wird für alle verwendet. Alle sehen dieselben Daten. |
| Keine Anmeldung | Öffentliche Server. |
Schlüssel
Bei den Optionen Persönlicher Schlüssel und Schlüssel der Organisation legt Schlüssel wird übergeben als fest, wohin AITEZA den Schlüssel sendet:
- Header: ein Header der Anfrage. Geben Sie unter Header den Namen (Standard
Authorization) und unter Präfix den Text vor dem Schlüssel an (StandardBearer). - Basic-Authentifizierung (Benutzer:Passwort): Der Schlüssel wird als
benutzer:passworteingegeben, zum Beispielemail:api-token. - URL-Parameter: ein Parameter der Server-URL. Geben Sie den Parameternamen an, zum Beispiel
token. Nutzen Sie dies nur, wenn der Dienst es verlangt: URLs können in Proxy- und Server-Logs landen, ein Header ist daher sicherer.
Der Schlüssel der Organisation kann nur geschrieben werden. Er wird verschlüsselt gespeichert und nie wieder angezeigt. Um den gespeicherten Schlüssel beim Bearbeiten zu behalten, lassen Sie das Feld leer.
Persönliche Anmeldung (OAuth)
Bei der Option Persönliche Anmeldung (OAuth) zeigt der Seitenbereich die Weiterleitungs-URI. Verlangt der Dienst eine registrierte App (Client), tragen Sie diese URI ein, wenn Sie die App dort anlegen.
| Feld | Beschreibung |
|---|---|
| Client-ID | Die ID der beim Dienst registrierten App. Lassen Sie das Feld leer, wenn der Dienst die automatische (dynamische) Client-Registrierung unterstützt. AITEZA registriert sich dann selbst. |
| Client-Geheimnis | Das Geheimnis der App. Kann wie der Schlüssel der Organisation nur geschrieben werden. |
| Berechtigungen (Scopes) | Durch Leerzeichen getrennt. Wenn leer, fordert AITEZA an, was der Server verlangt. AITEZA ergänzt offline_access, wenn der Dienst es anbietet, damit Verbindungen erneuert werden können. |
| Autorisierungsserver (optional) | Nur für Server, die ihren Autorisierungsserver nicht selbst angeben, zum Beispiel ein Microsoft-Entra-ID-Aussteller wie https://login.microsoftonline.com/<tenant-id>/v2.0. |
| Ressourcen-Angabe senden | Von der MCP-Spezifikation verlangt. Schalten Sie sie nur aus, wenn die Anmeldung mit einem Fehler zum Parameter resource scheitert. |
Server testen
Verbindung testen prüft die gespeicherten Einstellungen:
- Server ohne persönliche Anmeldung (Schlüssel der Organisation oder keine Anmeldung) werden verbunden, und ihre Werkzeuge werden aufgelistet.
- Bei Servern mit persönlicher Anmeldung ermittelt AITEZA den Autorisierungsserver.
- Bei Servern mit persönlichen Schlüsseln prüft AITEZA, ob der Server erreichbar ist.
Änderungen, die Verbindungen betreffen
- Eine Änderung der Server-URL, der Client-ID oder des Autorisierungsservers lässt die Verbindungen aller Personen ablaufen. Sie müssen sich dann neu verbinden.
- Eine Änderung der Art der Anmeldung entfernt alle Verbindungen.
- Entfernen löscht den Server und alle Verbindungen zu ihm. Die Bestätigung zeigt, wie viele Personen ihre Verbindung verlieren.
Alle Änderungen werden im Audit-Log im Bereich Verwaltung erfasst, mit den Aktionen MCP_SERVER_CREATE, MCP_SERVER_UPDATE, MCP_SERVER_DELETE, MCP_CONNECTION_CREATE und MCP_CONNECTION_DELETE. Die Einträge zu MCP_SERVER_CREATE und MCP_SERVER_UPDATE enthalten die freigegebenen Gruppen.
Microsoft 365
Der Vorschlag Microsoft 365 ist in AITEZA eingebaut. Er funktioniert mit jedem Microsoft-365-Business-Tarif; anders als bei Microsofts Agent-365-Servern brauchen Personen keine Microsoft-365-Copilot-Lizenz. AITEZA liest und schreibt über Microsoft Graph mit der Anmeldung der jeweiligen Person, sodass jede Person nur sieht, worauf sie in Microsoft 365 Zugriff hat. Sie verwalten ihn wie jeden anderen Server: Freigabe, Gruppen, Verbindungen und Audit-Log funktionieren gleich.
Die Werkzeuge durchsuchen und lesen E-Mails, listen Kalendertermine auf, durchsuchen und lesen Dateien und Ordner in OneDrive und SharePoint (Word, Excel, PowerPoint, PDF und Textdateien) und finden Kolleginnen und Kollegen. Entwürfe anlegen und ändern, E-Mails senden und beantworten, AITEZA-Dateien (Chat-Anhänge, Dateien aus Datenräumen, erzeugte Dateien) an E-Mails anhängen, AITEZA-Dateien in OneDrive oder SharePoint hochladen sowie Termine anlegen verändern Daten: Vor jeder dieser Aktionen fragt AITEZA die Person im Chat. Anhängen und hochladen lassen sich nur Dateien, die die Person in AITEZA öffnen darf; jeder dieser Zugriffe steht im Audit-Log.
Microsoft 365 einrichten
- 1
Registrieren Sie in Microsoft Entra eine App mit der Plattform Web und tragen Sie die im Serverformular angezeigte Weiterleitungs-URI ein. Haben Sie Microsoft 365 bereits für den Cloud-Speicher eingerichtet, können Sie diese App verwenden und die Weiterleitungs-URI dort ergänzen.
- 2
Erteilen Sie die delegierten Microsoft-Graph-Berechtigungen
offline_access,User.Read,Mail.ReadWrite,Mail.Send,Calendars.ReadWrite,Files.ReadWrite.All,Sites.ReadWrite.All,People.Readund die Administratoreinwilligung. Erstellen Sie ein Client-Geheimnis. Haben Sie Microsoft 365 mit den früheren reinen LeseberechtigungenFiles.Read.AllundSites.Read.Alleingerichtet, ersetzen Sie diese in Entra und bei den Bereichen des Servers; die Personen verbinden Microsoft 365 danach unter Einstellungen › Integrationen neu. - 3
Wählen Sie unter Vorschläge bei Microsoft 365 die Option Hinzufügen. Bereiche und Autorisierungsserver sind vorausgefüllt. Ersetzen Sie beim Autorisierungsserver den Platzhalter für die Tenant-ID durch die ID oder Domain Ihres Microsoft-Entra-Tenants.
- 4
Tragen Sie Client-ID und Client-Geheimnis ein. Ist Microsoft 365 bereits für den Cloud-Speicher eingerichtet, schalten Sie stattdessen Microsoft-App aus dem Cloud-Speicher übernehmen ein: AITEZA übernimmt Client-ID, Client-Geheimnis und Verzeichnis. Speichern Sie.
AITEZA Docs
Der Vorschlag AITEZA Docs ist in AITEZA eingebaut und braucht weder Anmeldung noch Schlüssel. Damit durchsucht und liest AITEZA diese Dokumentation auf Deutsch, Englisch und Polnisch, beantwortet Fragen zur Bedienung von AITEZA und verlinkt die passende Seite. Wählen Sie unter Vorschläge neben AITEZA Docs die Schaltfläche Hinzufügen und speichern Sie; danach steht der Server wie jeder andere zur Verfügung, auch mit Gruppen und Audit-Log. AITEZA lädt die veröffentlichte Dokumentation und prüft stündlich auf Änderungen.
Typische Einrichtungen
Die genauen Schritte hängen vom Dienst ab. Den MCP-Endpunkt und die Registrierung von Apps entnehmen Sie der Dokumentation des Dienstes.
Dienste mit automatischer Registrierung, zum Beispiel viele MCP-Server von SaaS-Anbietern:
- Geben Sie die Server-URL ein.
- Wählen Sie Persönliche Anmeldung (OAuth).
- Lassen Sie Client-ID leer.
Dienste, die eine registrierte App brauchen, zum Beispiel Microsoft 365 oder OneDrive über Microsoft Entra ID, GitHub, Google Workspace, Slack, Box oder HubSpot:
- Wählen Sie Persönliche Anmeldung (OAuth) und kopieren Sie die angezeigte Weiterleitungs-URI.
- Registrieren Sie beim Anbieter eine App mit dieser Weiterleitungs-URI und erteilen Sie ihr die nötigen Berechtigungen. Bei Microsoft muss meist ein Administrator in Entra ID die Administratorzustimmung erteilen.
- Tragen Sie Client-ID und Client-Geheimnis der App ein und bei Bedarf die Berechtigungen (Scopes) und den Autorisierungsserver.
Dienste mit API-Schlüsseln oder persönlichen Zugriffstokens:
- Wählen Sie Persönlicher Schlüssel (oder Schlüssel der Organisation, wenn alle einen gemeinsamen Schlüssel nutzen sollen).
- Wählen Sie unter Schlüssel wird übergeben als die Option Header und den Header, den der Dienst erwartet.
Gut zu wissen
- Werkzeuge von Integrationen funktionieren nur mit Modellen, die den Agent-Modus unterstützen (siehe Modelle der Organisation).
- Relay-Gäste nutzen nie Integrationen.
- AITEZA behandelt die Ergebnisse von Integrationen als nicht vertrauenswürdige externe Inhalte. Werkzeuge, die Daten ändern oder löschen, nutzt AITEZA nur, wenn eine Person das ausdrücklich verlangt.
