Snowflake MCP für Notion einrichten

In diesem Hilfedokument

Erfahre, wie du Snowflake mit einem Custom Agent oder deinem Notion Agent verbindest, damit du Fragen zu den Daten deines Unternehmens in Notion stellen kannst.

Zu den FAQs

Einige Funktionen befinden sich in der Alpha-Phase.

Einige in diesem Artikel behandelte Funktionen, darunter im Workspace konfigurierte MCP-Verbindungen und die Autorisierung einzelner User in Custom Agents, befinden sich derzeit in der Alpha-Phase und sind möglicherweise in deinem Workspace noch nicht verfügbar.

Um Zugriff anzufordern, wende dich an das Support-Team von Notion oder bewirb dich für unser Early-Access-Programm für Daten-Agents →

Deine Custom Agents und dein Notion Agent können sich über einen MCP-Server (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.

  • Der/die Besitzer/-in oder Administrator/-in des Notion-Workspace konfiguriert die Snowflake-MCP-Verbindung 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 in diesem Artikel erklärten Schritte 1–10 sind für beide Vorgehensweisen identisch. Ab Schritt 11 unterscheidet sich das Vorgehen, je nachdem, welchen Agent du verbinden möchtest.

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

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

  • Für deinen Notion-Workspace ist ein Business- oder Enterprise-Plan erforderlich.

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

  • Dein Unternehmen benötigt ein Snowflake-Konto.

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

Eine gemeinsame Einrichtung bedeutet nicht, dass alle Zugriff auf dieselben Daten haben.

Der Workspace speichert Verbindungsdetails, einschließlich einer OAuth-Client-ID und eines Secrets. Diese Details konfigurieren die Verbindung, es handelt sich hierbei nicht um gemeinsame Anmeldedaten. Jede Person meldet sich mit ihrem eigenen Konto bei Snowflake an. Unabhängig davon, ob jemand einen Custom Agent oder ihren eigenen Notion Agent verwendet, kann der Agent nur auf die Daten zugreifen, auf die auch das Konto der entsprechenden Person Zugriff hat.

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 hier mit dem Admin deines Notion-Workspace zusammen: Notion stellt eine Redirect-URI bereit und Snowflake stellt eine OAuth-Client-ID sowie ein 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-Bereich und die Sicherheitsintegration und fügst eine Netzwerkrichtlinie hinzu, falls dein Unternehmen eine solche fordert.

Fülle dieses Worksheet gemeinsam mit dem Admin deines Notion-Workspace aus, bevor du beginnst. Mitglieder können diesen Schritt überspringen und sich nach Abschluss der Einrichtung mit ihrem eigenen Snowflake-Konto anmelden.

Halte das OAuth-Client-Secret privat.

Füge es nicht in Slack, Tickets, die Versionsverwaltung oder dem Terminalverlauf ein. Gib es ausschließlich über genehmigte sichere Kanäle weiter.

Feld

Wert

Besitzer/-in

Snowflake-Kontokennung

<organization-account>

Snowflake-Admin

MCP-Datenbank

<database_name>

Snowflake-Admin

MCP-Schema

<schema_name>

Snowflake-Admin

MCP-Server

<mcp_server_name>

Snowflake-Admin

Warehouse

<warehouse_name>

Snowflake-Admin

Zugriffsrolle

<mcp_access_role>

Snowflake-Admin

Server-URL

https://<account_host>/api/v2/databases/<database_name>/schemas/<schema_name>/mcp-servers/<mcp_server_name>

Snowflake-Admin

Geltungsbereich der Primärrolle

session:role:<mcp_access_role>

Snowflake-Admin

Umleitungs-URI

Kopiere die von Notion generierte URI

Admin des Notion-Workspace

OAuth-Client-ID

Aus Snowflake abrufen

Snowflake-Admin

OAuth-Client-Secret

Über einen genehmigten sicheren Kanal übertragen

Snowflake-Admin

Der Konto-Hostname verwendet Bindestriche statt 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 leichter zu verstehen und zu prüfen. Setze OAUTH_USE_SECONDARY_ROLES = NONE, gib ALLOWED_ROLES_LIST an und verwende den Notion-Geltungsbereich session:role:<mcp_access_role>.

Standardmäßige sekundäre Rollen einer Person (optional). Verwende dieses Modell nur, wenn der Server Berechtigungen benötigt, die aus den Snowflake DEFAULT_SECONDARY_ROLES der jeweiligen Person stammen. Setze OAUTH_USE_SECONDARY_ROLES = IMPLICIT, lass ALLOWED_ROLES_LIST weg und verwende einen expliziten Geltungsbereich für die Primärrolle. Snowflake erlaubt keine sekundären Rollen mit IMPLICIT in Kombination mit ALLOWED_ROLES_LIST. Lass die Liste zulässiger Rollen bei diesem Modell daher weg.

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

Vergib diese Rolle über den üblichen Prozess zur Identitätsverwaltung. Wenn Okta oder SCIM die Snowflake-Rollenzugehörigkeit verwaltet, füge außerhalb dieses Prozesses keine Personen manuell hinzu.

Erstelle eine Datenbank und ein Schema oder wähle bestehende aus. Beide sollten dem Team gehören, das den Server betreibt.

Für Geschäftsfragen, die Governance-Vorgaben unterliegen, kannst du als Tool für die Mitglieder einen Cortex Agent bereitstellen. Er bündelt semantische Ansichten, verifizierte Abfragen, Suche und Orchestrierung. Ein Cortex Agent ist optional. Wenn du einen erstellst, verwende die folgende Spezifikation. Wenn du einen bestehenden Agent ersetzt, stelle sicher, dass der neue Agent der genehmigten Spezifikation entspricht.

execution_environment muss unter der Analyst-Tool-Ressource verschachtelt bleiben.

Wenn du warehouse auf der obersten Ebene platzierst, wird die Agent-Definition möglicherweise erstellt, aber dem Tool steht zur Laufzeit kein Ausführungs-Warehouse zur Verfügung.

Andere unterstützte Snowflake MCP-Tooltypen umfassen CORTEX_ANALYST_MESSAGE, CORTEX_SEARCH_SERVICE_QUERY, GENERIC und SYSTEM_EXECUTE_SQL.

Wenn du direkten SQL-Zugriff benötigst, richte ihn auf einem separaten MCP-Server mit einer eigenen Rolle mit möglichst wenigen Berechtigungen ein. Stelle sicher, dass diese Rolle nur Lesezugriff hat.

Das Hinzufügen von SYSTEM_EXECUTE_SQL zum Server des verwalteten Agents kann es Clients ermöglichen, dessen semantische Ansichten und verifizierte Abfragen zu umgehen.

Gib jedem Tool einen klaren Namen und eine Beschreibung. Erkläre, welche Daten es abdeckt, wie detailliert die Ergebnisse sind und wann es verwendet werden soll. So kann der Agent das passende Tool auswählen.

Mit der Berechtigung USAGE für einen MCP-Server kann sich eine Rolle mit dem Server verbinden und dessen Tools erkennen. Sie gewährt der Rolle keinen Zugriff auf das Warehouse, den Agent, die semantische Ansicht, den Cortex-Search-Dienst, die gespeicherte Prozedur oder die zugrunde liegenden Daten. Gewähre der Rolle Zugriff auf alle Ressourcen, die die Tools des Servers benötigen.

Gewähre nur Zugriff auf die zusätzlichen Ressourcen, die das jeweilige Tool benötigt. Gewähre beispielsweise SELECT für eine genehmigte semantische Ansicht, USAGE für einen Cortex-Search-Dienst oder USAGE für eine bestimmte Funktion oder Prozedur. Vergib die Rolle nicht an PUBLIC und gewähre keine weitreichenden Berechtigungen für bestehende oder künftige Objekte.

Prüfe den MCP-Server und die gewährten Berechtigungen, bevor du OAuth einrichtest:

Konfiguriere das MCP-Schema so, dass es genau die Rolle angibt, die Mitglieder anfordern sollen:

Verwende einen expliziten Rollengeltungsbereich. Verwende nicht session:role:all. Snowflake behandelt diesen Wert als primäre Standardrolle der jeweiligen Person, nicht als Zugriff auf alle Rollen. Richtlinien für privilegierte Rollen können den Wert zudem blockieren. Eine explizite Rolle macht den angeforderten Zugriff klarer und leichter überprüfbar.

Stimme dich vor der Ausführung dieses SQL-Codes mit dem Admin für deinen Notion-Workspace ab. Bitte die Person, die Snowflake-Server-URL im MCP-Einrichtungsformular des Workspace einzugeben und Authentifizierung manuell konfigurieren sowie Einen Workspace-geteilten OAuth-Client verwenden zu aktivieren. Notion generiert eine Redirect-URI. Kopiere sie und sende sie an den Snowflake-Admin. Sobald Snowflake die Client-ID und das Client-Secret erstellt hat, kann der Admin die Einrichtung der Verbindung abschließen.

Verwende die Redirect-URI genau so, wie Notion sie bereitstellt. Füge weder einen abschließenden Schrägstrich noch Abfrageparameter hinzu und ändere den Host nicht.

Wenn du das optionale Sekundärrollenmodell verwendest, setze OAUTH_USE_SECONDARY_ROLES = IMPLICIT und lasse ALLOWED_ROLES_LIST weg. Mit IS_AGENTIC = TRUE werden Sitzungen, die über diese Integration erstellt wurden, als Agent-Sitzungen markiert. Die Snowflake-Funktion IS_AGENT_ACTIVATED() gibt dann TRUE zurück. So kann Snowflake agentspezifische Audits und Governance anwenden.

Die Gültigkeitsdauer des Refresh-Tokens von 7776000 Sekunden entspricht 90 Tagen. Prüfe vor der Verwendung, ob sie den Richtlinien deiner Organisation zur erneuten Autorisierung und Token-Rotation entspricht. Vermeide bei routinemäßigen Änderungen CREATE OR REPLACE SECURITY INTEGRATION. Wenn du die Integration ersetzt, kann das bestehende Verbindungen unterbrechen.

Führe zur Überprüfung der Integration den folgenden Befehl aus, ohne dabei das Secret anzuzeigen:

Prüfe, ob die Integration aktiviert ist, die Redirect-URI genau übereinstimmt, die Rolle erlaubt und nicht blockiert ist, Refresh-Tokens 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 deine Organisation eine Netzwerkrichtlinie verlangt. Bitte die für Sicherheit oder Netzwerke verantwortliche Person, die aktuellen Bereiche für von Notion ausgehenden Datenverkehr zu genehmigen.

Die OAuth-Integration muss beide Notion-Pfade zulassen:

  1. der API-Pfad, über den OAuth-Callbacks verarbeitet und Autorisierungscodes ausgetauscht werden

  2. den Workspace-Laufzeitpfad, über den die Verbindung validiert, Tools ausgeführt und Token aktualisiert werden

Diese Pfade können unterschiedliche Notion-Egress-Adressen verwenden. Wenn du nur die Adresse zulässt, die beim ersten Token-Austausch verwendet wurde, kann die Anmeldung erfolgreich sein, während die Validierung oder Token-Aktualisierung fehlschlägt. Verwende die aktuellen, genehmigten Egress-Bereiche von Notion. Nimm keine einzelne IP-Adresse aus einem Browser oder Protokoll in eine produktive Allowlist auf.

Wende diese Netzwerkrichtlinie auf die OAuth-Integration an, nicht auf einzelne Personen. Ändere die kontoweiten Richtlinien für die Browser-Anmeldung, den VPN-Zugriff oder den Netzwerkzugriff von Personen nicht. Wenn eine Netzwerkrichtlinie eine Token-Anfrage blockiert, gibt Snowflake möglicherweise invalid_client zurück. Dieser Fehler bedeutet nicht zwangsläufig, dass die Client-ID oder das Secret falsch sind.

Führe den Befehl in einem sicheren Snowflake-Worksheet aus. Beim Integrationsnamen ist die Groß- und Kleinschreibung zu beachten. Er besteht normalerweise aus Großbuchstaben:

Teile die Client-ID und das zugehörige Secret über einen genehmigten sicheren Kanal mit dem Admin des Notion-Workspaces. Snowflake stellt zwei gültige Secrets bereit, die du ohne Ausfallzeit rotieren kannst. Füge keines der Secrets in Dokumentationen, Chats, Tickets oder die Versionsverwaltung ein.

Im Workspace konfigurierte MCP-Verbindungen sind eine Funktion, die sich derzeit in der Alpha-Phase befindet.

Wenn dein Workspace noch keinen Zugriff hat, wende dich an das Support-Team von Notion oder bewirb dich für unser Early-Access-Programm für Daten-Agents.

Sobald Snowflake bereit ist, fügt eine Person mit der Rolle Workspace-Besitzer/-in oder -Admin den Server einmal für den Workspace hinzu. Mitglieder können ihn dann finden, ohne das OAuth-Client-Secret zu sehen, ob sie Snowflake MCP nun mit einem Custom Agent verbinden oder mit dem eigenen Notion Agent.

  1. Öffne die Einstellungen des Workspace.

  2. Wähle Integrationen und Konnektoren → Im Workspace geteilte MCPs aus.

  3. Wähle Neuer Workspace-MCP aus.

Fülle diese Felder aus und wähle dann MCP-Server hinzufügen aus:

Feld

Was muss angegeben werden

Name

Ein eindeutiger Name, den Mitglieder sehen können, etwa Company Snowflake Data Agent

Beschreibung

Eine kurze Notiz zu den Daten und ihrer vorgesehenen Verwendung

Server-URL

Die exakte öffentliche Snowflake-MCP-URL aus dem Worksheet

Authentifizierung manuell konfigurieren

Aktiviere die Option. Notion erkennt die OAuth-Details von Snowflake.

Einen Workspace-geteilten OAuth-Client verwenden

Aktiviere die Option.

Umleitungs-URI

Von Notion generiert. Prüfe, dass sie mit der URI übereinstimmt, die du dem Snowflake-Admin gegeben hast.

Client-ID

Die Client-ID aus der Snowflake-OAuth-Integration

Client-Secret

Das passende Secret, das du über den genehmigten sicheren Kanal erhalten hast

OAuth-Bereiche

Wähle genau den Bereich session:role:<mcp_access_role> aus. Alle Bereiche ist nur dann geeignet, wenn Snowflake nur diesen einen genehmigten Bereich und keine weitergehenden Bereiche anbietet.

Prüfe nach dem Speichern, ob die neue Zeile unter Mit diesem Workspace geteilt erscheint und bei Workspace-OAuth-Client der Status Konfiguriert angezeigt wird.

Was diese Einrichtung bewirkt:

  • Hilft Mitgliedern, den genehmigten Server zu finden.

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

  • Stellt sicher, dass sich Mitglieder mit der Server-URL, dem Client und den Bereichen anmelden, die du genehmigt hast.

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

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

Wenn du diese Einrichtung entfernst, können neue Mitglieder den Server nicht mehr finden. Bestehende Verbindungen werden möglicherweise weiterhin angezeigt. Stimme das Entfernen daher mit dem Widerruf von Snowflake-Berechtigungen und dem Entfernen bestehender Verbindungen ab.

Sobald die Admins die Snowflake-MCP-Verbindung eingerichtet haben, gibt es zwei Möglichkeiten, sie zu nutzen. Wenn du sie für ein Team einrichtest, beginne mit Schritt 11A. Wenn du nur ein paar eigene Fragen stellen möchtest, starte direkt mit Schritt 11B. Es ist auch beides nebeneinander möglich. Die Verbindungen sind voneinander getrennt.

Ein Custom Agent bietet deinem Team einen zentralen Ort für Fragen zu Snowflake-Daten. Verbinde Snowflake einmal, füge Anweisungen zu Metriken und Tabellen hinzu und teile den Agent mit dem Team. Alle, die ihn nutzen, müssen sich mit ihren eigenen Anmeldeinformationen bei Snowflake anmelden. So erhalten sie nur Antworten auf Grundlage der Daten, auf die sie zugreifen dürfen.

Die benutzerbezogene Authentifizierung in Custom Agents befindet sich derzeit in der Alpha-Phase.

Wenn dein Workspace noch keinen Zugriff hat, wende dich an das Support-Team von Notion oder bewirb dich für unser Early-Access-Programm für Daten-Agents.

Snowflake mit einem Custom Agent verbinden

  1. Öffne deinen Custom Agent oder erstelle einen neuen.

  2. Gehe zu Einstellungen → Tools und Zugriff.

  3. Wähle Verbindung hinzufügen und dann den Snowflake-Server mit dem Label Workspace verwaltet aus. Wähle nicht Individueller MCP-Server aus und gib 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 Tools mit Schreibzugriff und CORTEX_AGENT_RUN auf „Um Genehmigung bitten“ eingestellt, bis du sie getestet hast.

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

Dem Agent Kontext geben

Die Verbindung gibt dem Agent Zugriff auf Snowflake. Deine Anweisungen legen fest, wie dein Unternehmen diese Daten nutzt. Beschreibe in den Anweisungen des Agents, welche Tools für welche Arten von Fragen verwendet werden sollen, wie dein Team wichtige Kennzahlen definiert und von welchen Tabellen oder semantischen Ansichten aus er starten soll. Ein paar geprüfte Beispielfragen sind sehr hilfreich. Einen fertigen Ausgangspunkt findest du im Leitfaden zum Data Scout-Toolkit.

Agent teilen

Teile den Agent mit deinem Team wie jeden anderen Custom Agent. Wer zum ersten Mal eine Frage stellt, für die Snowflake nötig ist, wird aufgefordert, sich mit dem eigenen Snowflake-Konto anzumelden. Eine Client-ID oder ein Client-Secret ist dafür nicht erforderlich.

Die benutzerbezogene Authentifizierung gilt, wenn jemand direkt mit dem Agent chattet.

Bei geplanten und ausgelösten Ausführungen ist niemand angemeldet. Deshalb können diese Ausführungen noch nicht über die Snowflake-Zugriffsrechte einzelner Personen laufen. Wenn du Snowflake-Daten nach einem Zeitplan benötigst, sprich vor der Einrichtung mit deinem Snowflake-Admin.

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

  1. Gehe zu Einstellungen → Notion AI.

  2. Wähle MCP-Server → MCP-Server hinzufügen aus.

  3. Wähle den Snowflake-Server mit dem Label Workspace verwaltet aus. Wähle nicht Individueller MCP-Server aus und gib die Server-URL nicht manuell ein.

  4. Klicke auf Verbinden.

  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. Überprüfe, dass der Serverstatus Verbunden und nicht Authentifizierung erforderlich lautet.

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

Du solltest auf keinem der beiden Wege nach einer OAuth-Client-ID oder einem OAuth-Client-Secret gefragt werden.

Wenn Notion dich nach einem der beiden fragt, hast du möglicherweise die individuelle MCP-Option statt des vom Workspace verwalteten Servers ausgewählt oder dein Admin hat Einen Workspace-geteilten OAuth-Client verwenden nicht aktiviert. Gehe zurück und wähle stattdessen den Server Workspace verwaltet aus.

  1. Stelle eine harmlose Frage mit bekannter Antwort, für die Snowflake verwendet werden soll.

  2. Prüfe, dass der Agent Snowflake verwendet und ein Ergebnis zurückgibt.

  3. Prüfe, dass du nicht auf Daten zugreifen kannst, die außerhalb der dir zugewiesenen Rolle liegen.

Wenn du einen Custom Agent eingerichtet hast, bitte auch ein Teammitglied mit einer eingeschränkteren Snowflake-Rolle, ihn auszuprobieren. Das Teammitglied sollte nur auf die eigenen Daten zugreifen können, nicht auf deine. So kannst du am schnellsten prüfen, ob der Agent den Zugriff der jeweiligen Person nutzt und nicht den der Person, die ihn erstellt hat.

Für eine gründlichere Prüfung bitte deinen Snowflake-Admin, deinen User, deine Rolle, dein Warehouse und deinen Abfrageverlauf zu überprüfen. Eine erfolgreiche Anmeldung bestätigt deine Identität, aber nicht, dass alle Berechtigungen korrekt sind.

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

  • „Wie hoch waren laut Snowflake unsere Anmeldungen im letzten Monat insgesamt?“

  • „Was waren laut Snowflake unsere zehn umsatzstärksten Accounts in diesem Quartal?“

Bei einem Custom Agent kannst du „laut Snowflake“ normalerweise weglassen, sofern er klare Anweisungen hat, wann er Snowflake verwenden soll. Bei deinem Notion Agent hilft die Nennung von Snowflake dabei, dass er die richtige Quelle auswählt.

Große Anfragen können länger dauern oder das Zeitlimit überschreiten. Wenn das passiert, stelle eine gezieltere Frage oder teile die Anfrage in kleinere Fragen auf.

Meistens bleibst du verbunden, ohne etwas tun zu müssen. Snowflake verwendet kurzlebige Zugriffstoken, die Notion im Hintergrund aktualisiert. Ein ablaufendes Zugriffstoken allein trennt deine Verbindung nicht.

Du musst dich erneut anmelden, wenn:

  • Dein Aktualisierungstoken abläuft oder ein Admin es widerruft

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

  • Deine Snowflake-Rolle entfernt wird

  • Ein Admin die Workspace-Einrichtung oder deine Verbindung entfernt

  • Eine Netzwerkrichtlinie die Token-Aktualisierung blockiert

Bei einem Custom Agent meldet sich jede Person separat an. Wenn sich eine Person erneut anmelden muss, hat das keine Auswirkungen auf andere. Die Person, die den Agent erstellt hat, muss nichts unternehmen.

Wenn du das Client-Secret rotierst: Verwende die Rotation mit zwei Secrets von Snowflake, statt die Integration zu ersetzen. Lass beide Secrets lange genug gültig, um die Workspace-Einrichtung zu aktualisieren und zu testen, bevor du das alte Secret außer Betrieb nimmst.

ALTER SECURITY INTEGRATION <oauth_integration_name>
REFRESH OAUTH_CLIENT_SECRET_2;

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

  • Du wirst nach einer Client-ID oder einem Client-Secret gefragt. Wahrscheinlich hast du die individuelle MCP-Option gewählt. Geh zurück und wähle stattdessen den Snowflake-Server mit dem Label Workspace verwaltet aus.

  • 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 normal. Wer einen verwalteten Custom Agent verwendet, muss sich mit den eigenen Snowflake-Anmeldeinformationen anmelden.

  • Ein Teammitglied erhält vom selben Custom Agent andere Ergebnisse. Das ist normal. Der Agent nutzt den Snowflake-Zugriff der jeweiligen Person. Deshalb sehen Personen mit unterschiedlichen Rollen unterschiedliche Daten.

  • Der Custom Agent funktioniert im Chat, aber nicht nach Zeitplan. Bei geplanten und ausgelösten Ausführungen ist keine Person angemeldet. Deshalb können diese Ausführungen noch nicht über die Snowflake-Zugangsdaten einzelner Personen laufen.

  • Du hast dich angemeldet, aber die Verbindung wird nicht hergestellt oder die Tools funktionieren nicht. Die Anmeldung bestätigt deine Identität, aber dein Zugriff hängt weiterhin von deinen Snowflake-Berechtigungen ab. Bitte deinen Snowflake-Admin zu prüfen, 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 Daten zugreifen, auf die auch dein Snowflake-Konto zugreifen kann. Prüfe deine Snowflake-Berechtigungen und gib den Tabellennamen in deiner Frage an.

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

Diese Fehler liegen meist an Snowflake-Einstellungen, nicht an Notion. Teile die Fehlermeldungen mit deinem Snowflake-Admin.

  • Die Server-URL sieht doppelt aus, etwa so: https://https%3A... Vor die Adresse wurde ein zusätzliches https:// gesetzt. Korrigiere die URL so, dass sie mit nur einem https:// beginnt.

  • Du siehst die Meldung „This server does not support OAuth authentication“ (Dieser Server unterstützt keine OAuth-Authentifizierung). 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 prüfen.

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

  • Die Anmeldung funktioniert, schlägt dann aber sofort fehl. Deine Rolle hat möglicherweise keinen Zugriff auf den Server oder eine Rollen- oder Netzwerkregel blockiert die Sitzung. Bitte deinen Admin, deine Berechtigungen und Richtlinien zu prüfen.

  • Du siehst „The role ALL requested has been explicitly blocked“ (Die angefragte Rolle ALL wurde explizit gesperrt). Die Verbindung hat alle Rollen gleichzeitig angefordert (session:role:all). Das ist blockiert. Verwende stattdessen genau eine Rolle mit ihrem tatsächlichen Namen, etwa session:role:analyst.

  • 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 exakten Notion-Wert zu setzen.

  • Du siehst Fehler 390311 wegen einer ungültigen Code-Challenge. Das deutet auf einen PKCE-Konflikt hin. Bitte deinen Admin zu prüfen, ob OAUTH_ENFORCE_PKCE in der Sicherheitsintegration korrekt eingestellt ist.

  • Du bist verbunden, aber es werden keine Tools angezeigt. Deiner Rolle fehlt möglicherweise die Berechtigung USAGE für den MCP-Server. Bitte deinen Admin, die Berechtigung zu prüfen. Führe dann DESCRIBE MCP SERVER aus, um die Einrichtung zu überprüfen.

  • Du kannst auf mehr oder weniger Daten zugreifen als erwartet. Sekundäre Rollen beeinflussen, auf welche Daten du in deiner Sitzung zugreifen kannst. Prüfe gemeinsam mit deinem Admin, welche Rollen in deiner Sitzung aktiv sind.

  • Vorher hat es funktioniert, doch seit einer Änderung des Client-Secret schlägt die Verbindung bei allen fehl. Das Client-Secret wurde ausgetauscht. Deshalb ist die gespeicherte Verbindung veraltet. Bitte deinen Admin um das neue Secret und stelle dann erneut eine Verbindung her.

  • Vorher hat es funktioniert, jetzt schlägt es nur bei mir fehl. Möglicherweise wurde eine Rolle, Berechtigung oder Richtlinie geändert oder deine Sitzung ist abgelaufen. Melde dich erneut an und bitte dann deinen Admin zu prüfen, ob sich deine Zugriffsrechte geändert haben.

  • Meine Kontokennung wird abgelehnt. Verwende das Format organization-account mit einem Bindestrich statt Punkten, zum Beispiel myorg-myaccount.

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

  • Snowflake ist in geplanten oder ausgelösten Ausführungen nicht verfügbar. Bei diesen Ausführungen ist niemand angemeldet. Deshalb können diese Ausführungen noch nicht über die Zugangsdaten einzelner Personen laufen. Führe deine Anfrage stattdessen im Chat aus.

  • Nach der Anmeldung über den Browser siehst du oauth_security_error. Möglicherweise blockiert eine Netzwerkrichtlinie auf Kontoebene die Anfrage. Dein Admin kann das mit folgendem Befehl überprüfen:

  • Die Anmeldung scheint zu funktionieren, aber du erhältst trotz des richtigen Bereichs einen Rollenfehler. Möglicherweise ist deine Standardrolle blockiert, zum Beispiel ACCOUNTADMIN oder eine Rolle in BLOCKED_ROLES_LIST. Dein Admin kann das überprüfen und beheben:

Mit diesen schreibgeschützten Befehlen kann dein Admin die Einrichtung überprüfen, ohne dabei etwas zu ändern. Führe sie in Snowflake aus.

ACCOUNT_USAGE-Ansichten können zeitverzögert aktualisiert werden. Eine fehlende Zeile belegt daher nicht, dass eine Anfrage nie gestellt wurde.

Rotiere keine Secrets, lockere keine Richtlinien und erweitere keine Berechtigungen, bevor du weißt, auf welcher Ebene der Fehler liegt.

Um die Einrichtung abzuschließen, kannst du folgende Snowflake-Anleitungen verwenden:


FAQs

Sollte ich einen Custom Agent einrichten oder Snowflake mit meinem Notion Agent verbinden?

Wenn du die Snowflake-MCP-Verbindung für dein Team einrichtest, erstelle einen Custom Agent. So bekommen alle dieselben Anweisungen, dieselben Definitionen für die Kennzahlen und eine zentrale Anlaufstelle für Fragen. Jede Person meldet sich trotzdem mit eigenen Snowflake-Anmeldeinformationen an. Wenn du nur selbst Fragen stellen möchtest, verbinde das Snowflake-MCP mit deinem Notion Agent. Du kannst auch beides tun.

Wird Snowflake durch die Verbindung mit meinem Notion Agent auch mit unserem Custom Agent verbunden?

Nein. Das sind voneinander getrennte Verbindungen, und jeder Custom Agent braucht eine eigene. Die Snowflake-Einrichtung aus den Schritten 1–10 gilt für beide, die Anmeldung erfolgt jeweils separat.

Sieht jeder im Team die gleichen Daten?

Nein. Jeder meldet sich mit seinen eigenen Anmeldeinformationen bei Snowflake an und der Agent kann nur auf das zugreifen, worauf auch das Konto dieser Person Zugriff hat. Das gilt auch für Custom Agents.

Muss ich mein Snowflake-Passwort mit meinem Team teilen?

Nein. Niemand teilt Anmeldeinformationen. Der Workspace speichert die OAuth-Client-Details einmalig, und jeder meldet sich selbst bei Snowflake an.


Feedback geben

War diese Ressource hilfreich?