MCP-Verbindungen für personalisierte Agenten

MCP-Verbindungen (Model Context Protocol) ermöglichen es deinem Custom Agent, sich sicher mit externen Apps zu verbinden. Mit MCP-Verbindungen kann dein Agent Informationen lesen und Aktionen ausführen, indem er vorkonfigurierte Verbindungen zu Apps wie Linear, Ramp, Figma und weiteren nutzt – oder sich mit einer beliebigen App verbinden, indem du benutzerdefinierte MCP-Verbindungen einrichtest.

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

MCP-Verbindungen ermöglichen es Custom Agents, über das Model Context Protocol mit externen Tools und Diensten zu interagieren. MCP-Tools funktionieren mit allen Arten von Auslösern, einschließlich geplanter Ausführungen, ausgelöster Ausführungen basierend auf Notion- oder Slack-Ereignissen sowie manueller Ausführungen aus dem Chat oder durch @-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 der Ausführung eine Bestätigung erforderlich ist, ob sie automatisch ausgeführt werden soll, oder ob alle Tools eines Servers dauerhaft zugelassen werden sollen.

Jede MCP-Verbindung ist für einen einzelnen Custom Agent einzigartig und verwendet die Anmeldeinformationen der Person, die sie authentifiziert hat. Verbindungen werden nicht zwischen Agents geteilt, selbst wenn sie eine Verbindung zum selben Dienst herstellen.

Das bedeutet:

• Wenn du eine Figma-Verbindung für Agent A einrichtest, benötigt 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:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. Öffne die Einstellungen deines personalisierten Agenten.

2. Gehe zu Tools & 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 vom Server dein Agent verwenden soll. Diese variieren je nach gewähltem Server.

7. Klicke auf Verbinden.

Um eine Verbindung zu einem MCP-Server herzustellen, der nicht in der vorkonfigurierten Liste enthalten ist, muss ein Workspace-Admin diese Option zuerst aktivieren. Es gibt zwei separate Einstellungen: eine, um benutzerdefinierte MCP-Server zuzulassen, und eine, um festzulegen, ob Mitglieder beliebige Verbindungen oder nur von dir genehmigte Verbindungen installieren dürfen.

So erlaubst du benutzerdefinierte MCP-Server:

1. Gehe als Workspace-Admin zu Einstellungen → Verbindungen.

2. Aktiviere im Tab Verwalten die Option Benutzerdefinierte MCP-Server aktivieren.

So entscheidest du, ob Mitglieder beliebige Verbindungen oder nur von Admins genehmigte Verbindungen installieren dürfen:

1. Gehe als Workspace-Admin zu Einstellungen → Verbindungen.

2. Suche im Tab Verwalten den Bereich Berechtigungen verwalten.

3. Wähle neben Einschränken, welche Verbindungen Mitglieder installieren können eine Option aus:

   • Genehmigt & empfohlen: Alle von Notion empfohlenen Verbindungen automatisch genehmigen.

   • Nur genehmigte: Wähle manuell jede Verbindung aus, die Mitglieder installieren können.

4. Wähle Genehmigte Verbindungen, um zu überprüfen, was Mitglieder installieren können.

5. Wähle Genehmigte Verbindung hinzufügen und entscheide dann, was du erlauben möchtest:

   • Verbindungen: Suche nach einer Verbindung anhand des Namens oder der ID und füge sie der Liste der genehmigten Verbindungen hinzu.

   • Custom MCP-Server: Füge eine spezifische MCP-Server-URL hinzu, die du zulassen möchtest.

6. Klicke auf Speichern.

Sobald dies festgelegt ist, kann jeder im Workspace eine Verbindung zu den genehmigten Optionen herstellen, wenn er einen Custom Agent einrichtet. Die Authentifizierung erfolgt mit den eigenen Anmeldeinformationen.

So fügst du einem Custom Agent einen Custom MCP hinzu:

1. Öffne die Einstellungen deines Custom Agent.

2. Gehe zu Tools & Zugriff.

3. Klicke auf Verbindung hinzufügen → Custom MCP-Server.

4. Du musst die URL des MCP-Servers des Tools oder Anbieters eingeben, mit dem du eine Verbindung herstellst (zum Beispiel: das interne Tool-Team deines Unternehmens).

5. Gib einen Anzeigenamen für die Verbindung an (optional).

6. Gib alle erforderlichen Authentifizierungsdaten ein.

7. Klicke auf Verbinden.

Custom 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 Anwendung beim Drittanbieter-Dienst vorregistrieren muss, bevor die OAuth-Anmeldung funktionieren kann. Wenn der Server, den du verwenden möchtest, DCR nicht unterstützt, prüfe in dessen 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 Custom Agent verwendet werden.

Du kannst in den Einstellungen deines Agent unter Tools & Zugriff festlegen, wie ein Custom Agent eine MCP-Verbindung nutzen soll. Klappe den Eintrag der MCP-Verbindung aus, um die verfügbaren Tools zu sehen und zu bestimmen, wie sie ausgeführt werden. Tools können über den daneben befindlichen Schalter aktiviert oder deaktiviert werden.

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.

• Schreib-Tools (z. B. erstellen, aktualisieren, löschen, senden, posten) nehmen Änderungen an Daten in externen Systemen vor. Standardmäßig erfordern diese eine Bestätigung, bevor der Agent die Aktion ausführt.

Automatisch ausführen oder immer fragen

• Automatisch ausführen ermöglicht es dem Tool, ohne Bestätigung durch den Benutzer ausgeführt zu werden. Diese Einstellung eignet sich am besten für Lese-Tools (suchen, abrufen, auflisten, anzeigen), da diese keine Daten ändern.

• Immer fragen erfordert, dass ein Benutzer eine Aktion genehmigt oder abbricht, bevor sie ausgeführt wird. Dies ist die Standardeinstellung für Schreib-Tools (erstellen, aktualisieren, löschen, senden), um unbeabsichtigte Änderungen zu verhindern.

• Immer zulassen genehmigt dauerhaft alle Tools eines Servers und entfernt zukünftige Bestätigungsaufforderungen.

So entfernst du eine MCP-Verbindung

1. Öffne die Einstellungen deines Agenten.

2. Gehe zu Tools & Zugriff.

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

4. Klicke auf Verbindung trennen, um zu bestätigen.

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

Hinweis: Wenn du eine Verbindung entfernst, kann der Agent nicht mehr auf diesen Dienst zugreifen und geplante Ausführungen, die von diesem Server abhängen, schlagen möglicherweise fehl. Die Workflows deines Agenten könnten unterbrochen werden, sobald du die Verbindung trennst. Du kannst die Verbindung jederzeit wiederherstellen, indem du dich erneut authentifizierst.

MCP-Verbindungen respektieren die Berechtigungsstufen, die für deinen Custom Agent festgelegt wurden. Hier erfährst du, was die einzelnen Berechtigungsstufen mit MCP-verbundenen Tools tun können.

Nutzer/-innen mit Vollzugriff und Kann bearbeiten-Berechtigungen für einen Custom Agent können:

• Neue MCP-Verbindungen zum Custom Agent hinzufügen.

• Mit dem Agenten chatten und alle verbundenen Tools verwenden, auch wenn sie keinen Zugriff auf das Tool außerhalb des 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 'Kann bearbeiten'-Berechtigungen:

• 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 ist, kann nur die Person, die die MCP-Verbindung authentifiziert, die Tooleinstellungen konfigurieren und aktualisieren – selbst wenn andere Vollzugriff oder Kann bearbeiten-Berechtigungen für den Custom Agent haben. Der Agent verwendet die Anmeldeinformationen und Berechtigungen dieser Person beim Zugriff auf den externen Dienst.

Nutzer/-innen mit der Berechtigungsstufe „Kann anzeigen und interagieren“ für einen Custom Agent können:

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

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

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

• Anzeigen, welche MCP-Server verbunden sind (in den Einstellungen des Custom Agent).

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. Nutzer/-innen sehen einen Prompt, der genau anzeigt, welche Aktion der Agent ausführen wird, bevor er sie durchführt.

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 Ausführungen des Custom Agent 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 Custom Agent, um den Server- oder Toolnamen zu erwähnen, den du verwenden möchtest. Zum Beispiel: „Verwende Linear MCP, um Metadaten für dieses Mock abzurufen.“