MCP-Verbindungen für personalisierte Agenten

Mit MCP-Verbindungen (Model Context Protocol) können deine personalisierten Agenten sicher mit externen Apps verbunden werden. Mit MCP-Verbindungen können deine Agenten Infos lesen und Maßnahmen ergreifen, indem sie vorkonfigurierte Verbindungen mit Apps wie Linear, Ramp, Canva und anderen nutzen – oder sich mit jeder beliebigen App verbinden, indem sie individuelle MCP-Verbindungen einrichten.

Hinweis: MCP-Verbindungen sind nur im Business und Enterprise Plan verfügbar.

MCP-Verbindungen machen es personalisierten Agenten möglich, über das Model Context Protocol mit externen Tools und Diensten zu interagieren. MCP-Tools funktionieren mit allen Arten von Auslösern, wie zum Beispiel geplanten Ausführungen, Ausführungen, die durch Notion- oder Slack-Ereignisse ausgelöst werden, und manuellen Ausführungen über Chat oder @Erwähnungen.

Wichtigste Funktionen:

• Vorkonfigurierte Server: Schnell mit beliebten Apps verbinden, ohne was extra einrichten zu müssen.

• Individuelle Server: Du kannst über öffentlich zugängliche URLs eine Verbindung mit jedem Tool herstellen, das einen gehosteten MCP-Server unterstützt.

• Anpassung: Du kannst die Tools für jede Verbindung ein- oder ausschalten und entscheiden, ob vor dem Ausführen eine Bestätigung erfolgen muss oder ob sie automatisch ausgeführt werden sollen.

Jede MCP-Verbindung gehört zu einem bestimmten personalisierten Agenten und nutzt die Anmeldedaten der Person, die sich damit angemeldet hat. Verbindungen werden nicht unter Agenten geteilt, auch wenn sie mit demselben Dienst verbunden sind.

Das bedeutet:

• Wenn du eine Figma-Verbindung für Agent A einrichtest, braucht Agent B eine eigene Figma-Verbindung.

• Du musst dich für jeden Agent, den du konfigurierst, bei jedem MCP-Server anmelden.

• Wenn du eine Verbindung in einem Agenten beendest, hat das keinen Einfluss auf die anderen Agenten.

Du kannst dich ohne zusätzliche Einstellungen mit den folgenden Apps verbinden:

• Linear

• Ramp

• Figma

• GitHub

• Stripe

• Sentry

• Attio

• HubSpot

• Amplitude

• Intercom

• Wiz

1. Öffne die Einstellungen deines personalisierten Agenten.

2. Gehe zu Tools und Zugriff.

3. Klicke auf Verbindung hinzufügen → Hinzufügen.

4. Wähle einen vorkonfigurierten Server aus.

5. Folge den Anweisungen zur Authentifizierung, um dein Konto zu verbinden.

6. Wähle aus, welche Tools von deinem Server dein Agent nutzen soll. Diese hängen von dem Server ab, den du wählst.

7. Klicke auf Speichern.

Wenn du eine Verbindung mit einem MCP-Server herstellen willst, der nicht in der vorkonfigurierten Liste steht:

1. Um MCP-Verbindungen für personalisierte Agenten nutzen zu können, muss ein Workspace-Admin diese unter Einstellungen → Notion-KI → KI-Konnektoren → Individuelle MCP-Server aktivieren erlauben.

2. Sobald der Workspace-Admin individuelle MCP-Verbindungen erlaubt hat, öffne die Einstellungen deines personalisierten Agenten.

3. Gehe zu Tools und Zugriff.

4. Klicke auf Verbindung hinzufügen → Individueller MCP-Server.

5. Gib die URL des MCP-Servers ein.

6. Gib einen Anzeigenamen für die Verbindung an.

7. Gib alle erforderlichen Authentifizierungsdaten ein.

8. Klicke auf Speichern.

Individuelle MCP-Server unterstützen möglicherweise eine oder beide der folgenden Anmeldemethoden:

• OAuth

• Header-basierte Authentifizierung

  (z. B. API-Schlüssel oder Bearer-Token)

Einige OAuth-Server unterstützen keine dynamische Client-Registrierung (DCR). Das bedeutet, dass Notion eine Client-Anwendung beim Drittanbieterdienst vorregistrieren muss, bevor die OAuth-Anmeldung funktionieren kann. Wenn der Server, den du verwenden möchtest, DCR nicht unterstützt, überprüfe in der Dokumentation, ob du stattdessen einen API-Schlüssel oder ein Bearer-Token verwenden kannst. Wenn keine der beiden Optionen verfügbar ist, kann der MCP-Server nicht mit personalisierten Agenten verwendet werden.

Du kannst in den Einstellungendeines Agenten underTools und Zugriff festlegen, wie ein personalisierter Agent eine MCP-Verbindung nutzen soll. Erweitere den MCP-Verbindungseintrag, um die verfügbaren Tools anzuzeigen und zu sehen, wie sie funktionieren. Die Tools kannst du mit dem Schalter daneben (de)aktivieren.

Lesen- und Schreiben-Tools

• Lesen-Tools (z. B. Suche, Abruf, Auflistung, Anzeige) ermöglichen dem personalisierten Agenten, Infos abrufen oder anzeigen, ohne Änderungen an externen Systemen vorzunehmen.

• Schreiben-Tools (z. B. Erstellen, Aktualisieren, Löschen, Senden, Posten) ermöglichen das Ändern von Daten in externen Systemen. Standardmäßig

  ist eine Bestätigung erforderlich, bevor der Agent die Aktion ausführt.

Automatisch ausführen oder immer fragen

• Automatisch ausführen ermöglicht die Ausführung des Tools, ohne dass eine Bestätigung

  durch Nutzer/-innen erforderlich ist. Diese Einstellung eignet sich am besten für Lesen-Tools (Suchen, Abrufen, Auflisten, Anzeigen), da diese keine Daten ändern.

• Immer fragen erfordert, dass Nutzer/-innen eine Aktion genehmigen müssen oder abbrechen können, bevor sie ausgeführt wird. Dies ist die Standardeinstellung für Schreiben-Tools (Erstellen, Aktualisieren, Löschen, Senden), um unbeabsichtigte Änderungen zu verhindern.

So entfernst du eine MCP-Verbindung

1. Öffne die Einstellungen deines Agenten.

2. Gehe zu Tools und Zugriff.

3. Finde die MCP-Verbindung und klicke auf Entfernen.

4. Klicke auf Speichern.

5. Teste deinen Agenten immer, nachdem du Änderungen vorgenommen hast. Du kannst die Verbindung jederzeit wiederherstellen, indem du sie erneut authentifizierst.

Hinweis: Wenn du eine Verbindung löschst, kann der Agent nicht mehr auf diesen Dienst zugreifen, und geplante Ausführungen, die von diesem Server abhängen, können fehlschlagen. Die Workflows deines Agenten könnten unterbrochen werden, wenn du eine Verbindung entfernst, noch bevor du auf „Speichern“ klickst.

MCP-Verbindungen halten sich an die Berechtigungsstufen, die du in deinem personalisierten Agenten festgelegt hast. Folgendes kann mit den MCP-Tools je nach Berechtigungsstufe gemacht werden:

Nutzer/-innen mit Vollzugriff und Bearbeitungsberechtigungen für einen Agenten können:

• Neue MCP-Verbindungen zum Agenten hinzufügen

• Mit dem Agenten chatten und alle verbundenen Tools verwenden, auch wenn sie keinen Zugriff auf das Tool außerhalb des personalisierten Agenten haben

• Das Aktivitätsprotokoll des Agenten und die Nutzung des MCP-Tools anzeigen

• Vorhandene MCP-Verbindungen entfernen

• Die Verbindung zum MCP-Server wiederherstellen oder die Anmeldeinformationen aktualisieren

Und für MCP-Verbindungen, die sie einrichten, können Nutzer/-innen mit Vollzugriff und Bearbeitungsberechtigungen:

• Konfigurieren, welche Tools aktiviert oder deaktiviert sind, und die Einstellungen für die Tool-Ausführung ändern (automatisch ausführen oder immer fragen)

Hinweis: Sobald eine MCP-Verbindung hergestellt wurde, kann nur die Person, die sich über die MCP-Verbindung anmeldet, die Tool-Einstellungen konfigurieren und aktualisieren – auch wenn andere Personen über die Berechtigungen „Vollständiger Zugriff“ oder „Kann bearbeiten“ für den Agenten verfügen. Der Agent verwendet die Anmeldedaten und Berechtigungen dieser Person, wenn er auf den externen Dienst zugreift.

Nutzer/-innen mit der Berechtigungsstufe „Kann anzeigen und interagieren“ können:

• Mit dem Agenten chatten und alle verbundenen Tools verwenden, auch wenn sie keinen Zugriff auf die Tools außerhalb des personalisierten Agenten haben

• Sowohl Lese- als auch Schreibaktionen über den Agenten auslösen

• Schreibaktionen genehmigen oder abbrechen, wenn eine Bestätigung erforderlich ist

• Anzeigen, welche MCP-Server verbunden sind (in den Agenteneinstellungen)

Nutzer/-innen mit der Berechtigungsstufe „Kann anzeigen und interagieren“ können nicht:

• MCP-Verbindungen hinzufügen oder entfernen

• Ändern, welche Tools aktiviert sind

• Die Einstellungen für die Tool-Ausführung ändern

• Das vollständige Aktivitätsprotokoll des Agenten anzeigen

Hinweis: Schreibaktionen (wie das Erstellen oder Aktualisieren von Elementen) erfordern standardmäßig eine Bestätigung, um unbeabsichtigte Änderungen zu verhindern. Die Nutzer/-innen sehen eine Meldung, die genau anzeigt, welche Aktion der Agent ausführen wird, bevor diese ausgeführt wird.

Wenn Tools nach der Verbindung nicht angezeigt werden:

• Aktualisiere die Seite mit den Agenteneinstellungen.

• Überprüfe, ob der MCP-Server erfolgreich authentifiziert wurde (suche nach einem grünen Häkchen oder dem Status „Verbunden“).

• Stelle sicher, dass der Server online ist und Tool-Metadaten zurückgibt.

• Versuche, den Server erneut zu verbinden oder die Verbindung zu trennen und ihn erneut hinzuzufügen.

Wenn Agentenausführungen mit MCP-Fehlern fehlschlagen:

• Überprüfe den Tab Aktivität auf bestimmte Fehlermeldungen.

• Stelle sicher, dass deine Verbindung noch gültig ist (Token sind möglicherweise abgelaufen).

• Stelle sicher, dass die Verbindung in den Einstellungen des Agenten weiterhin aktiviert ist.

• Versuche, den MCP-Server erneut zu verbinden, um die Anmeldeinformationen zu aktualisieren.

• Aktualisiere die Anweisungen deines Agenten, um den Server- oder Tool-Namen zu erwähnen, den du verwenden möchtest. Zum Beispiel: „Verwende Linear MCP, um Metadaten für dieses Mockup abzurufen“.