Snowflake MCP für Notion einrichten

Deine Custom Agents und dein Notion Agent können sich über einen MCP (Model Context Protocol)-Server, den Snowflake betreibt, mit Snowflake verbinden. Sobald dies eingerichtet ist, kannst du deinen Agent nach deinen Snowflake-Warehouse-Daten fragen und Antworten direkt in Notion erhalten.

Die Einrichtung erfolgt in Phasen, für die jeweils unterschiedliche Personen zuständig sind:

• Ein Snowflake-Admin richtet die Rolle, das Warehouse und den von Snowflake verwalteten MCP-Server ein.

• Ein Notion-Workspace-Besitzer/-in oder -Admin konfiguriert die Snowflake-MCP-Verbindungen für den Workspace.

• Workspace-Mitglieder können sich dann von Custom Agents aus mit ihren eigenen Snowflake-Anmeldeinformationen mit dem Snowflake-MCP verbinden oder Snowflake direkt mit ihrem Notion Agent verbinden. Die Schritte 1–10 dieses Artikels sind für beide Pfade gleich. Die Pfade trennen sich ab Schritt 11, je nachdem, welchen Agent du verbinden möchtest.

• Die verfügbaren Tools können je nach Snowflake-Cloud-Region variieren.

• Der verwaltete MCP-Server von Snowflake ist in Festlandchina oder in Regierungsregionen nicht verfügbar.

• Dein Notion-Workspace muss im Business oder Enterprise Plan sein.

• Verwende Notion im Web oder auf dem Desktop. Diese Funktion ist auf Mobilgeräten nicht verfügbar.

• Dein Unternehmen benötigt ein Snowflake-Konto.

• Um einen Custom Agent zu erstellen, benötigst du die Berechtigung, Agents in deinem Workspace zu erstellen.

Bevor dein Team Snowflake mit Notion verbinden kann, muss ein Snowflake-Admin den Zugriff einrichten. Dies ist der aufwendigste Schritt, den du nur einmal durchführen musst. Arbeite mit deinem Notion-Workspace-Admin zusammen: Notion stellt eine Umleitungs-URI bereit, und Snowflake stellt eine OAuth-Client-ID und ein OAuth-Client-Secret bereit.

Du richtest eine Rolle und ein Warehouse ein, erstellst den von Snowflake verwalteten MCP-Server, erteilst ihm Zugriff auf die benötigten Ressourcen, konfigurierst den OAuth-Scope und die Sicherheitsintegration und fügst eine Netzwerkrichtlinie hinzu, falls dein Unternehmen eine solche benötigt.

Fülle dieses Arbeitsblatt mit deinem Notion-Workspace-Admin aus, bevor du beginnst. Mitglieder können diesen Schritt überspringen und sich mit ihren eigenen Snowflake-Konten anmelden, sobald die Einrichtung abgeschlossen ist.

Der Hostname des Kontos verwendet Bindestriche, keine Unterstriche. Stelle sicher, dass jeder Objektname in der Server-URL mit dem entsprechenden Objektnamen in Snowflake übereinstimmt.

Verwende nach Möglichkeit eine dedizierte Rolle mit minimalen Berechtigungen und ein genehmigtes Warehouse.

Eingeschränkte Rolle ohne sekundäre Rollen (empfohlen). Dieses Modell ist einfacher zu verstehen und zu prüfen. Setze OAUTH_USE_SECONDARY_ROLES = NONE, gib ALLOWED_ROLES_LIST an und verwende den Notion-Scope session:role:<mcp_access_role>.

Die standardmäßigen sekundären Rollen eines Benutzers (optional). Verwende dieses Modell nur, wenn der Server Berechtigungen benötigt, die von den Snowflake-DEFAULT_SECONDARY_ROLES jedes Benutzers geerbt wurden. Setze OAUTH_USE_SECONDARY_ROLES = IMPLICIT, lass ALLOWED_ROLES_LIST weg und verwende einen expliziten Scope für die primäre Rolle. Snowflake erlaubt keine IMPLICIT sekundären Rollen mit ALLOWED_ROLES_LIST, lass die Zulassungsliste also weg, wenn du dieses Modell verwendest.

Verwende für den MCP-Server nach Möglichkeit eine dedizierte Rolle mit minimalen Berechtigungen.

Gewähre diese Rolle über deinen normalen Identitätsverwaltungsprozess. Wenn Okta oder SCIM die Snowflake-Rollenzugehörigkeit verwaltet, füge Benutzer nicht manuell außerhalb dieses Prozesses hinzu.

Erstelle oder wähle eine Datenbank und ein Schema, die dem Team gehören, das den Server betreiben wird.

Für gesteuerte Geschäftsfragen kannst du einen Cortex Agent als Tool bereitstellen, das von den Mitgliedern verwendet wird. Er fasst semantische Ansichten, verifizierte Abfragen, Search und Orchestrierung an einem Ort zusammen. Ein Cortex Agent ist optional. Wenn du einen erstellst, verwende die unten stehende Spezifikation. Wenn du einen bestehenden Agent ersetzt, stelle sicher, dass der Ersatz deiner genehmigten Spezifikation entspricht.

Weitere unterstützte Snowflake-MCP-Tooltypen sind CORTEX_ANALYST_MESSAGE, CORTEX_SEARCH_SERVICE_QUERY, GENERIC und SYSTEM_EXECUTE_SQL.

Gib jedem Tool einen klaren Namen und eine klare Beschreibung. Erkläre, welche Daten es abdeckt, wie detailliert seine Ergebnisse sind und wann es zu verwenden ist. So hilfst du dem Agenten, das richtige Tool auszuwählen.

Das USAGE-Privileg auf einem MCP-Server ermöglicht es einer Rolle, eine Verbindung zum Server herzustellen und dessen Tools zu entdecken. Es gewährt der Rolle keinen Zugriff auf das Warehouse, den Agent, die semantische Ansicht, den Search-Service, die gespeicherte Prozedur oder die zugrunde liegenden Daten. Gewähren Sie der Rolle Zugriff auf jede Ressource, die die Tools des Servers benötigen.

Gewähre Zugriff nur auf die zusätzlichen Ressourcen, die das jeweilige Tool benötigt. Gewähre beispielsweise SELECT auf eine genehmigte semantische Ansicht, USAGE auf einen Cortex Search-Service oder USAGE auf eine bestimmte Funktion oder Prozedur. Weise der Rolle PUBLIC nicht zu und füge keine umfassenden Privilegien für aktuelle oder zukünftige Objekte hinzu.

Überprüfe vor dem Einrichten von OAuth den MCP-Server und dessen Berechtigungen:

Konfiguriere das MCP-Schema so, dass die exakte Rolle angegeben wird, die Mitglieder anfordern sollen:

Verwende einen expliziten Rollenbereich. Verwende nicht session:role:all. Snowflake behandelt diesen Wert als die primäre Rolle des Benutzers, nicht als Zugriff auf jede Rolle, und Richtlinien für privilegierte Rollen können dies blockieren. Eine explizite Rolle macht den angeforderten Zugriff eindeutig und leichter überprüfbar.

Koordinieren Sie sich vor dem Ausführen dieses SQL mit Ihrem Notion-Workspace-Admin. Bitten Sie ihn, die Snowflake-Server-URL im MCP-Setup-Formular des Workspaces einzugeben und Manually configure authentication sowie Use a workspace-shared OAuth client zu aktivieren. Notion generiert eine Redirect-URL. Kopieren Sie diese und senden Sie sie an den Snowflake-Admin. Nachdem Snowflake die Client-ID und das Secret erstellt hat, kann der Workspace-Admin die Einrichtung der Verbindung abschließen.

Verwenden Sie die Redirect-URL exakt so, wie Notion sie bereitstellt. Fügen Sie keinen abschließenden Schrägstrich oder Abfrageparameter hinzu und ändern Sie nicht den Host.

Das Setzen von IS_AGENTIC = TRUE markiert Sitzungen, die über diese Integration erstellt wurden, als Agent-Sitzungen. Die Funktion IS_AGENT_ACTIVATED() von Snowflake gibt dann TRUE zurück, wodurch Snowflake agentenspezifische Überprüfungen und Governance anwenden kann. Wenn Sie das optionale Modell für Sekundär-Rollen verwenden, setzen Sie OAUTH_USE_SECONDARY_ROLES = IMPLICIT und lassen Sie ALLOWED_ROLES_LIST weg.

Der Wert für die Gültigkeit des Refresh-Tokens von 7776000 Sekunden entspricht 90 Tagen. Bestätigen Sie vor der Verwendung, dass dies den Richtlinien Ihres Unternehmens zur Reautorisierung und Token-Rotation entspricht. Vermeiden Sie bei routinemäßigen Änderungen CREATE OR REPLACE SECURITY INTEGRATION. Das Ersetzen der Integration kann bestehende Verbindungen unterbrechen.

Um die Integration zu überprüfen, ohne deren Secret anzuzeigen, führen Sie Folgendes aus:

Bestätigen Sie, dass die Integration aktiviert ist, die Redirect-URL exakt übereinstimmt, die Rolle erlaubt und nicht blockiert ist, Refresh-Token und PKCE aktiviert sind und sowohl der Autorisierungs- als auch der Token-Endpunkt den öffentlichen Konto-Host von Snowflake verwenden.

Dieser Schritt ist nur erforderlich, wenn Ihr Unternehmen eine Netzwerkrichtlinie verlangt. Bitten Sie Ihren Sicherheits- oder Netzwerkverantwortlichen, die aktuellen Egress-Bereiche von Notion zu genehmigen.

Die OAuth-Integration muss beide Notion-Pfade zulassen:

1. den API-Pfad, der OAuth-Callbacks verarbeitet und Autorisierungscodes austauscht

2. den Workspace-Laufzeitpfad, der die Verbindung validiert, Tools ausführt und Tokens aktualisiert

Diese Pfade können unterschiedliche Egress-Adressen von Notion verwenden. Wenn Sie nur die Adresse zulassen, die während des anfänglichen Token-Austauschs verwendet wurde, kann die Anmeldung zwar erfolgreich sein, die Validierung oder Token-Aktualisierung kann jedoch fehlschlagen. Verwenden Sie die aktuellen, genehmigten Egress-Bereiche von Notion. Fügen Sie keine einmalige IP-Adresse aus einem Browser oder Protokoll zu einer Produktions-Allowlist hinzu.

Wenden Sie diese Netzwerkrichtlinie auf die OAuth-Integration an, nicht auf einzelne Benutzer. Ändern Sie nicht Ihre kontoweiten Richtlinien für die Browser-Anmeldung, den VPN-Zugriff oder den Benutzernetzwerkzugriff. Wenn eine Netzwerkrichtlinie eine Token-Anforderung blockiert, gibt Snowflake möglicherweise invalid_client zurück. Dieser Fehler bedeutet nicht zwangsläufig, dass die Client-ID oder das Secret falsch ist.

Führen Sie dies in einem sicheren Snowflake-Arbeitsblatt aus. Der Integrationsname unterscheidet zwischen Groß- und Kleinschreibung und ist normalerweise in Großbuchstaben gehalten:

Teilen Sie die Client-ID und das zugehörige Secret über einen genehmigten sicheren Kanal mit Ihrem Notion-Workspace-Administrator. Snowflake stellt zwei gültige Secrets bereit, sodass Sie diese ohne Ausfallzeiten rotieren können. Fügen Sie niemals eines der Secrets in Dokumentationen, Chats, Tickets oder die Quellcodeverwaltung ein.

Sobald Snowflake bereit ist, fügt ein Workspace-Besitzer/-in oder Admin den Server einmalig für den Workspace hinzu. Mitglieder können ihn dann finden, ohne das OAuth-Client-Secret zu sehen, unabhängig davon, ob sie den Snowflake-MCP mit einem Custom Agent oder ihrem eigenen Notion Agent verbinden.

1. Gehen Sie zu Einstellungen für den Workspace.

2. Wählen Sie Integrationen und Konnektoren → Workspace-geteilte MCPs.

3. Wählen Sie Neuer Workspace MCP.

Füllen Sie diese Felder aus und wählen Sie dann MCP-Server hinzufügen:

Bestätigen Sie nach dem Speichern, dass die neue Zeile unter Geteilt mit diesem Workspace erscheint und dass Workspace OAuth-Client den Status konfiguriert anzeigt.

Was diese Einrichtung bewirkt:

• Hilft Mitgliedern dabei, den genehmigten Server zu finden.

• Speichert das OAuth-Client-Secret einmalig im verschlüsselten Verbindungsspeicher von Notion.

• Stellt sicher, dass sich Mitglieder mit der von Ihnen genehmigten Server-URL, dem Client und den Scopes anmelden.

• Erstellt keine geteilte Snowflake-Sitzung und umgeht nicht die Zugriffskontrollen von Snowflake.

• Verbindet nicht automatisch jedes Mitglied. Jede Person muss sich separat anmelden.

Wenn Sie diese Einrichtung entfernen, können neue Mitglieder den Server nicht mehr finden. Bestehende Verbindungen werden möglicherweise weiterhin angezeigt. Stimmen Sie diese Änderung daher mit dem Widerruf von Snowflake-Berechtigungen und dem Entfernen bestehender Verbindung ab.

Sobald Ihre Administratoren die Snowflake-MCP-Verbindung eingerichtet haben, gibt es zwei Möglichkeiten, diese zu nutzen. Wenn Sie dies für ein Team einrichten, beginnen Sie mit 11A. Wenn Sie nur Ihre eigenen Fragen stellen möchten, fahren Sie mit 11B fort. Sie können beides tun; es handelt sich um separate Verbindungen.

Ein Custom Agent bietet Ihrem Team einen zentralen Ort, um Fragen zu Snowflake-Daten zu stellen. Sie verbinden Snowflake einmal, fügen Anweisungen zu Ihren Metriken und Tabellen hinzu und teilen den Agenten mit Ihrem Team. Jeder, der ihn verwendet, muss sich mit seinen eigenen Anmeldeinformationen bei Snowflake anmelden, sodass jede Person nur Antworten basierend auf den Daten erhält, die sie sehen darf.

Snowflake mit einem Custom Agent verbinden

1. Öffnen Sie Ihren Custom Agent oder erstellen Sie einen neuen.

2. Gehen Sie zu Einstellungen → Tools & Zugriff.

3. Wählen Sie Verbindungen hinzufügen aus und wählen Sie dann den Snowflake-Server mit der Bezeichnung Workspace Managed aus. Wählen Sie nicht Custom MCP-Server aus und geben Sie die Server-URL nicht manuell ein.

4. Melde dich in deinem Browser bei Snowflake an. Möglicherweise erscheint die übliche Okta- oder SSO-Anmeldung deines Unternehmens.

5. Überprüfe und genehmige die angeforderte Snowflake-Rolle.

6. Wähle aus, welche Tools der Agent verwenden darf. Lass schreibfähige Tools und CORTEX_AGENT_RUN so eingestellt, dass sie eine Genehmigung anfordern, bis du sie getestet hast.

7. Wähle Verbinden aus und bestätige, dass die Verbindung als Verbunden angezeigt wird.

Gib dem Agent Kontext

Die Verbindung gibt dem Agent Zugriff auf Snowflake. Deine Anweisungen sagen ihm, wie dein Unternehmen diese Daten verwendet. In den Anweisungen des Agent beschreibe, welche Tools für welche Arten von Fragen zu verwenden sind, wie dein Team wichtige Metriken definiert und von welchen Tabellen oder semantischen Ansichten aus begonnen werden soll. Einige verifizierte Beispiel-Fragen bewirken viel. Für einen fertigen Ausgangspunkt sieh dir die Data Scout Toolkit-Anleitung an.

Agent teilen

Teile den Agent mit deinem Team auf die gleiche Weise, wie du jeden anderen Custom Agent teilst. Beim ersten Mal, wenn jemand dem Agent eine Frage stellt, für die Snowflake erforderlich ist, wird er aufgefordert, sich mit seinem eigenen Snowflake-Konto anzumelden. Er wird nicht nach einer Client-ID oder einem Secret gefragt.

Wenn du deine eigenen Fragen in deinem eigenen Chat stellen möchtest, verbinde Snowflake mit deinem Notion Agent. Du meldest dich mit deinem eigenen Snowflake-Konto an, sodass dein Agent nur auf das zugreift, was du sehen darfst.

1. Geh zu Einstellungen → Notion-KI.

2. Wähle unter MCP-Server die Option MCP-Server hinzufügen aus.

3. Wähle den Snowflake-Server mit der Bezeichnung Workspace Managed aus. Wähle nicht benutzerdefinierten MCP-Server aus und gib die Server-URL nicht manuell ein.

4. Wähle Verbinden aus.

5. Melde dich in deinem Browser bei Snowflake an. Möglicherweise erscheint die übliche Okta- oder SSO-Anmeldung deines Unternehmens.

6. Überprüfe und genehmige die angeforderte Snowflake-Rolle.

7. Wenn dein Browser fragt, ob Notion geöffnet werden soll, wähle Notion öffnen aus.

8. Bestätige, dass der Serverstatus Verbunden ist und nicht Authentifizierung erforderlich.

Nachdem du die Verbindung hergestellt hast, erscheint Snowflake im Chat unter Alle Quellen → MCP-Server.

1. Stelle eine harmlose Frage mit einer bekannten Antwort, bei der Snowflake verwendet werden sollte.

2. Bestätige, dass der Agent Snowflake verwendet und ein Ergebnis zurückliefert.

3. Bestätige, dass du nicht auf Daten außerhalb der dir zugewiesenen Rolle zugreifen kannst.

Wenn du einen Custom Agent eingerichtet hast, bitte auch ein Teammitglied mit einer eingeschränkteren Snowflake-Rolle, ihn auszuprobieren. Es sollte nur seine eigenen Daten sehen, nicht deine. Das ist der schnellste Weg, um zu bestätigen, dass der Agent den Zugriff der jeweiligen Person nutzt und nicht den des Erstellers.

Für eine gründlichere Überprüfung bitte deinen Snowflake-Admin, deinen Benutzer, deine Rolle, dein Warehouse und deinen Abfrageverlauf zu bestätigen. Eine erfolgreiche Anmeldung bestätigt deine Identität, gewährleistet jedoch nicht, dass jede Berechtigung korrekt ist.

Stelle dem Agent eine spezifische Frage zu deinen Snowflake-Daten. Zum Beispiel:

• „Aus Snowflake, wie hoch waren unsere gesamten Anmeldungen im letzten Monat?“

• „Aus Snowflake, welches waren unsere 10 umsatzstärksten Konten in diesem Quartal?“

Mit einem Custom Agent kannst du „aus Snowflake“ normalerweise weglassen, sobald dessen Anweisungen klar machen, wann er verwendet werden soll. Mit deinem Notion Agent hilft die Nennung von Snowflake dem Agent, die richtige Quelle auszuwählen.

Große Anfragen können länger dauern oder zu einer Zeitüberschreitung führen. Wenn das passiert, stelle eine präzisere Frage oder teile deine Anfrage in kleinere Fragen auf.

Die meiste Zeit bleibst du verbunden, ohne etwas zu tun. Snowflake verwendet kurzlebige Zugriffstoken, und Notion aktualisiert diese im Hintergrund. Ein ablaufendes Zugriffstoken allein trennt dich nicht.

Du musst dich erneut anmelden, wenn:

• Dein Aktualisierungstoken abläuft oder ein Admin es widerruft

• Ein Admin ersetzt die OAuth-Integration oder das Client-Geheimnis

• Deine Snowflake-Rolle wird entfernt

• Ein Admin entfernt die Workspace-Einrichtung oder deine Verbindung

• Eine Netzwerkrichtlinie blockiert die Token-Aktualisierung

Bei einem Custom Agent ist die Anmeldung für jede Person separat. Wenn eine Person aufgefordert wird, sich erneut anzumelden, betrifft das niemanden sonst, und die Person, die den Agent erstellt hat, muss nichts unternehmen.

Wenn du das Client-Geheimnis rotierst: Verwende die Zwei-Geheimnis-Rotation von Snowflake, anstatt die Integration zu ersetzen. Halte beide Geheimnisse lange genug gültig, um die Workspace-Einrichtung zu aktualisieren und zu testen, bevor du das alte Geheimnis außer Betrieb nimmst.

ALTER SECURITY INTEGRATION <oauth_integration_name>
REFRESH OAUTH_CLIENT_SECRET_2;

• Die Snowflake-MCP-Verbindung ist nicht aufgeführt. Dein Workspace-Admin hat sie möglicherweise noch nicht hinzugefügt, oder dein Workspace schränkt benutzerdefinierte Server ein. Bitte frage deinen Admin um Hilfe.

• Du wirst nach einer Client-ID oder einem Secret gefragt. Wahrscheinlich hast du die Option für benutzerdefinierte MCPs gewählt. Geh zurück und wähle stattdessen den Snowflake-Server, der mit Workspace Managed gekennzeichnet ist.

• Du wirst aufgefordert, dich erneut anzumelden. Deine Snowflake-Sitzung ist möglicherweise abgelaufen oder ein Admin hat die Verbindung aktualisiert. Melde dich erneut bei Snowflake an.

• Du hast einen Custom Agent geöffnet und wurdest aufgefordert, dich bei Snowflake anzumelden. Das ist beim ersten Mal zu erwarten. Jede Person, die einen verwalteten Custom Agent verwendet, muss sich mit ihren eigenen Snowflake-Anmeldedaten anmelden.

• Ein Teammitglied erhält andere Ergebnisse vom selben Custom Agent. Das ist zu erwarten. Der Agent verwendet den Snowflake-Zugriff der jeweiligen Person, sodass Personen mit unterschiedlichen Rollen unterschiedliche Daten sehen.

• Der Custom Agent funktioniert im Chat, aber nicht im Zeitplan. Geplante und ausgelöste Ausführungen haben keine angemeldete Person, daher können sie Snowflake mit der persönlichen Anmeldung noch nicht nutzen.

• Du hast dich angemeldet, aber es erfolgt keine Verbindung oder die Tools schlagen fehl. Die Anmeldung weist deine Identität nach, aber dein Zugriff hängt weiterhin von deinen Snowflake-Berechtigungen ab. Bitte frage deinen Snowflake-Admin, ob deine Rolle auf den Server, das Warehouse, den Agent und die Daten zugreifen kann.

• Der Agent kann eine Tabelle nicht finden. Der Agent kann nur auf die Daten zugreifen, auf die dein Snowflake-Konto zugreifen kann. Überprüfe deine Snowflake-Berechtigungen und gib den Tabellennamen in deine Frage ein.

• Eine Anfrage überschreitet das Zeitlimit. Stelle eine spezifischere Frage oder teile deine Anfrage in kleinere Fragen auf.

Diese Fehler stammen normalerweise aus den Snowflake-Einstellungen, nicht aus Notion. Teile sie mit deinem Snowflake-Admin.

• Die Server-URL sieht doppelt aus, wie https://https%3A... Die Adresse wurde mit einem zusätzlichen https:// am Anfang eingefügt. Korrigiere sie, sodass die URL nur mit einem https:// beginnt.

• Du siehst „This server does not support OAuth authentication.“ Die Sicherheitsintegration ist nicht für OAuth eingerichtet oder die Server-URL ist falsch. Bitte deinen Snowflake-Admin, die OAuth-Sicherheitsintegration und die Server-URL zu überprüfen.

• Du siehst invalid_client während der Anmeldung oder Aktualisierung. Die Client-ID oder das Secret ist falsch oder das Secret wurde geändert. Bitte deinen Admin um die aktuelle Client-ID und das Secret.

• Die Anmeldung funktioniert, schlägt aber sofort fehl. Deine Rolle erreicht möglicherweise den Server nicht, oder eine Rolle oder Netzwerkregel blockiert die Sitzung. Bitte deinen Admin, deine Berechtigungen und Richtlinien zu überprüfen.

• Du siehst „The role ALL requested has been explicitly blocked.“ Die Verbindung hat alle Rollen gleichzeitig angefordert (session:role:all), was blockiert wurde. Verwende stattdessen eine genaue Rolle, wie session:role:analyst, mit deinem tatsächlichen Rollennamen.

• Du siehst einen Weiterleitungsfehler (Fehler 390307). Die in Snowflake gespeicherte Weiterleitungs-URL stimmt nicht mit der von Notion verwendeten überein. Bitte deinen Admin, die Weiterleitungs-URL in der Sicherheitsintegration auf den genauen Notion-Wert zu setzen.

• Du siehst Fehler 390311 bezüglich einer ungültigen Code-Challenge. Dies ist ein PKCE-Konflikt. Bitte deinen Admin, zu bestätigen, dass OAUTH_ENFORCE_PKCE in der Sicherheitsintegration korrekt eingestellt ist.

• Du bist verbunden, aber es werden keine Tools angezeigt. Deiner Rolle fehlt möglicherweise USAGE auf dem MCP-Server. Bitte deinen Admin, die Berechtigung zu bestätigen, und führe dann DESCRIBE MCP SERVER aus, um die Einrichtung zu überprüfen.

• Du kannst mehr oder weniger Daten erreichen, als du erwartet hast. Sekundäre Rollen beeinflussen, was in deiner Sitzung sichtbar ist. Überprüfe mit deinem Admin, welche Rollen in deiner Sitzung aktiv sind.

• Es hat vorher funktioniert, und jetzt schlägt es bei allen nach einer Geheimnisänderung fehl. Das Client-Geheimnis wurde rotiert, daher ist die gespeicherte Verbindung veraltet. Bitte deinen Admin um das neue Geheimnis und stelle dann erneut eine Verbindung her.

• Es hat vorher funktioniert, und jetzt schlägt es nur bei dir fehl. Eine Rolle, Berechtigung oder Richtlinie wurde möglicherweise geändert, oder deine Sitzung ist abgelaufen. Melde dich erneut an und bitte deinen Admin, zu bestätigen, dass sich dein Zugriff nicht geändert hat.

• Deine Konto-Kennung wird abgelehnt. Verwende das Format organization-account mit einem Bindestrich, wie myorg-myaccount, und nicht mit Punkten.

• Ein PrivateLink-Konto kann keine Verbindung herstellen. PrivateLink-Konten erfordern eine zusätzliche Netzwerkeinrichtung. Frag deinen Admin, ob PrivateLink die Notion-Verbindung zulässt.

• Snowflake ist in geplanten oder ausgelösten Ausführungen nicht verfügbar. Diese Ausführungen haben keine angemeldete Person und können daher noch keine personenbezogene Anmeldung verwenden. Führe deine Anfrage stattdessen im Chat aus.

• Du siehst oauth_security_error nach der Anmeldung über den Browser. Eine Netzwerkrichtlinie auf Kontoebene blockiert möglicherweise die Anfrage. Dein Admin kann dies durch Ausführen des folgenden Befehls bestätigen:

• Die Anmeldung scheint zu funktionieren, aber du erhältst einen Rollenfehler, selbst mit dem richtigen Geltungsbereich. Deine Standardrolle ist möglicherweise blockiert, zum Beispiel ACCOUNTADMIN oder eine Rolle in BLOCKED_ROLES_LIST. Dein Admin kann dies überprüfen und beheben:

Diese schreibgeschützten Befehle helfen deinem Admin, die Einrichtung zu bestätigen, ohne etwas zu ändern. Führe sie in Snowflake aus.

Verwende diese Snowflake-Anleitungen, um die Einrichtung abzuschließen:

• Von Snowflake verwalteter MCP-Server

• Erstellen einer Snowflake OAuth-Sicherheitsintegration

• Snowflake OAuth für benutzerdefinierte Clients

• Übersicht zu Snowflake OAuth

• Snowflake-Konto-Identifikatoren

• Custom Agent

• MCP-Verbindungen für Custom Agent

• Verbinde MCP-Server mit deinem Notion Agent

• Bewährte Sicherheitsverfahren für Agent-Verbindungen