Määritä Snowflake-MCP Notionille

Mukautetut palvelijasi ja Notion-palvelijasi voivat muodostaa yhteyden Snowflakeen Snowflaken ylläpitämän MCP (Model Context Protocol) -palvelimen kautta. Kun yhteys on määritetty, voit kysyä palvelijaltasi Snowflake-virtuaalivarastosi tiedoista ja saada vastaukset suoraan Notionissa.

Määritys tapahtuu vaiheittain, ja jokaisella vaiheella on eri vastuuhenkilö:

• Snowflake-ylläpitäjä määrittää roolin, virtuaalivaraston ja Snowflaken hallinnoiman MCP-palvelimen.

• Notion-työtilan omistaja tai ylläpitäjä määrittää Snowflake-MCP-yhteyden työtilalle.

• Työtilan jäsenet voivat sen jälkeen muodostaa yhteyden Snowflake-MCP:hen mukautetuista palvelijoista käyttämällä omia Snowflake-tunnuksiaan tai yhdistää Snowflaken suoraan Notion-palvelijaansa. Tämän artikkelin vaiheet 1–10 ovat samat molemmissa tapauksissa. Ohjeet eroavat vaiheesta 11 alkaen sen mukaan, kumman palvelijan haluat yhdistää.

• Käytettävissä olevat työkalut voivat vaihdella Snowflake-pilvialueesi mukaan.

• Snowflaken hallinnoitu MCP-palvelin ei ole käytettävissä Manner-Kiinassa eikä viranomaiskäyttöön tarkoitetuilla pilvialueilla.

• Notion-työtilallasi on oltava Business- tai Enterprise-sopimus.

• Käytä Notionia verkossa tai työpöytäsovelluksella. Tämä ominaisuus ei ole käytettävissä mobiililaitteilla.

• Yritykselläsi on oltava Snowflake-tili.

• Jotta voit luoda mukautetun palvelijan, tarvitset käyttöoikeuden palvelijoiden luomiseen työtilassasi.

Ennen kuin tiimisi voi yhdistää Snowflaken Notioniin, Snowflake-ylläpitäjän on määritettävä käyttöoikeudet. Tämä on työläin vaihe, ja se tarvitsee tehdä vain kerran. Tee yhteistyötä Notion-työtilan ylläpitäjän kanssa: Notion tarjoaa uudelleenohjauksen URI-osoitteen ja Snowflake OAuth-asiakastunnuksen ja -salaisuuden.

Määrität roolin ja virtuaalivaraston, luot Snowflaken hallinnoiman MCP-palvelimen, myönnät sille pääsyn tarvittaviin resursseihin, määrität OAuth-laajuuden ja tietoturvaintegraation sekä lisäät verkkokäytännön, jos organisaatiosi vaatii sellaisen.

Täytä tämä lomake Notion-työtilan ylläpitäjän kanssa ennen kuin aloitat. Jäsenet voivat ohittaa tämän ja kirjautua sisään omilla Snowflake-tileillään, kun määritys on valmis.

Tilin isäntänimessä käytetään yhdysmerkkejä, ei alaviivoja. Varmista, että palvelimen URL-osoitteen objektien nimet vastaavat niiden nimiä Snowflakessa.

Käytä mahdollisuuksien mukaan erillistä roolia, jolla on vain tarvittavat käyttöoikeudet, ja yhtä hyväksyttyä virtuaalivarastoa.

Rajoitettu rooli ilman toissijaisia rooleja. Tätä suositellaan. Malli on helppo ymmärtää ja auditoida. Aseta OAUTH_USE_SECONDARY_ROLES = NONE, määritä ALLOWED_ROLES_LIST ja käytä Notionissa laajuutta session:role:<mcp_access_role>.

Käyttäjän oletusarvoiset toissijaiset roolit (valinnainen). Käytä tätä mallia vain, kun palvelin tarvitsee kunkin käyttäjän Snowflaken DEFAULT_SECONDARY_ROLES -asetuksesta perittyjä oikeuksia. Määritä OAUTH_USE_SECONDARY_ROLES = IMPLICIT, jätä ALLOWED_ROLES_LIST pois ja käytä eksplisiittistä ensisijaisen roolin laajuutta. Snowflake ei salli IMPLICIT toissijaisia rooleja ALLOWED_ROLES_LIST -asetuksen kanssa, joten jätä sallittujen roolien lista pois, kun käytät tätä mallia.

Käytä MCP-palvelimelle mahdollisuuksien mukaan erillistä roolia, jolla on vain tarvittavat käyttöoikeudet.

Myönnä tämä rooli normaalin identiteetinhallintaprosessisi kautta. Jos Okta tai SCIM hallitsee Snowflaken roolijäsenyyksiä, älä lisää käyttäjiä manuaalisesti prosessin ulkopuolella.

Luo tai valitse tietokanta ja skeema, jotka ovat palvelinta ylläpitävän tiimin omistuksessa.

Hallittuja liiketoimintakysymyksiä varten voit antaa jäsenille Cortex Agentin työkaluksi. Se kokoaa semanttiset näkymät, vahvistetut kyselyt, hakutoiminnot ja orkestroinnin yhteen paikkaan. Cortex Agent on valinnainen. Jos luot sellaisen, käytä alla olevaa määritystä. Jos korvaat olemassa olevan palvelijan, varmista, että uusi palvelija vastaa hyväksyttyä määritystä.

Muita Snowflaken MCP-palvelimen tukemia työkalutyyppejä ovat CORTEX_ANALYST_MESSAGE, CORTEX_SEARCH_SERVICE_QUERY, GENERIC ja SYSTEM_EXECUTE_SQL.

Anna jokaiselle työkalulle selkeä nimi ja kuvaus. Kerro, mitä tietoja se kattaa, kuinka tarkkoja sen tulokset ovat ja milloin sitä kannattaa käyttää. Näin palvelija osaa valita oikean työkalun.

MCP-palvelimen USAGE-käyttöoikeus antaa roolille mahdollisuuden muodostaa yhteyden palvelimeen ja löytää sen työkalut. Se ei anna roolille käyttöoikeutta virtuaalivarastoon, palvelijaan, semanttiseen näkymään, hakupalveluun, tallennettuun proseduuriin tai taustalla oleviin tietoihin. Myönnä roolille käyttöoikeus jokaiseen resurssiin, jota palvelimen työkalut tarvitsevat.

Myönnä pääsy vain niihin lisäresursseihin, joita kukin työkalu tarvitsee. Myönnä esimerkiksi SELECT-oikeus hyväksyttyyn semanttiseen näkymään, USAGE-oikeus Cortex Search -palveluun tai USAGE-oikeus tiettyyn funktioon tai proseduuriin. Älä myönnä roolia PUBLIC-roolille äläkä lisää laajoja oikeuksia nykyisiin tai tuleviin objekteihin.

Ennen kuin määrität OAuthin, tarkista MCP-palvelin ja sen myönnetyt oikeudet:

Määritä MCP-skeema ilmoittamaan täsmälleen se rooli, jota jäsenten tulee pyytää:

Käytä tarkasti määritettyä roolilaajuutta. Älä käytä arvoa session:role:all. Snowflake tulkitsee sen käyttäjän ensisijaiseksi oletusrooliksi, ei pääsyksi kaikkiin rooleihin. Etuoikeutettuja rooleja koskevat käytännöt voivat myös estää sen käytön. Kun määrität roolin tarkasti, pyydetty käyttöoikeus on selkeä ja helppo tarkistaa.

Ennen kuin suoritat tämän SQL-koodin, sovi asiasta Notion-työtilan ylläpitäjän kanssa. Pyydä ylläpitäjää syöttämään Snowflake-palvelimen URL-osoite työtilan MCP-asetuslomakkeeseen ja ottamaan käyttöön valinnat Määritä todennus itse ja Käytä työtilan yhteistä OAuth-asiakasohjelmaa. Notion luo uudelleenohjaus-URI:n. Kopioi se ja lähetä se Snowflaken ylläpitäjälle. Kun Snowflake on luonut asiakastunnuksen ja asiakassalaisuuden, työtilan ylläpitäjä voi viimeistellä yhteyden määrityksen.

Käytä uudelleenohjaus-URI-osoitetta täsmälleen sellaisena kuin Notion sen antaa. Älä lisää loppuviivaa tai kyselyparametreja, äläkä muuta isäntää.

Asetus IS_AGENTIC = TRUE merkitsee tämän integraation kautta luodut istunnot palvelijaistunnoiksi. Snowflaken IS_AGENT_ACTIVATED()-funktio palauttaa tällöin arvon TRUE, jolloin Snowflake voi valvoa ja hallita palvelijoiden toimintaa erikseen. Jos käytät valinnaista toissijaisten roolien mallia, aseta OAUTH_USE_SECONDARY_ROLES = IMPLICIT ja jätä ALLOWED_ROLES_LIST pois.

Päivitystunnisteen voimassaoloaika 7776000 sekuntia vastaa 90 päivää. Varmista ennen sen käyttöä, että se vastaa organisaatiosi uudelleenvaltuutus- ja tunnisteiden kierrätyskäytäntöjä. Vältä rutiinimuutoksissa komentoa CREATE OR REPLACE SECURITY INTEGRATION. Integraation korvaaminen voi keskeyttää olemassa olevat yhteydet.

Tarkista integraatio näyttämättä sen asiakassalaisuutta suorittamalla seuraava komento:

Varmista, että integraatio on käytössä, uudelleenohjaus-URI täsmää täsmälleen, rooli on sallittu eikä estetty, päivitystunnisteet ja PKCE ovat käytössä ja sekä valtuutus- että tunnistepäätepiste käyttävät Snowflaken julkista käyttäjätilin isäntänimeä.

Tämä vaihe on tarpeen vain, jos organisaatiosi vaatii verkkokäytännön. Pyydä tietoturva- tai verkkovastaavaasi hyväksymään Notionin nykyiset lähtevän liikenteen IP-osoitealueet.

OAuth-integraation on sallittava molemmat Notion-polut:

1. API-polku, joka käsittelee OAuth-takaisinkutsut ja vaihtaa valtuutuskoodit

2. työtilan ajonaikainen polku, joka vahvistaa yhteyden, suorittaa työkaluja ja päivittää tunnisteet

Nämä polut voivat käyttää Notionin lähtevässä liikenteessä eri osoitteita. Jos sallit vain alkuperäisessä tunnisteiden vaihdossa käytetyn osoitteen, sisäänkirjautuminen saattaa onnistua, mutta yhteyden vahvistus tai tunnisteen päivitys voi epäonnistua. Käytä Notionin nykyisiä, hyväksyttyjä lähtevän liikenteen IP-osoitealueita. Älä lisää selaimesta tai lokista poimittua yksittäistä IP-osoitetta tuotantoympäristön sallittujen osoitteiden listalle.

Liitä tämä verkkokäytäntö OAuth-integraatioon, älä yksittäisiin käyttäjiin. Älä muuta koko käyttäjätiliä koskevia käytäntöjä, jotka koskevat selaimella kirjautumista, VPN-yhteyttä tai käyttäjien verkkoyhteyksiä. Jos verkkokäytäntö estää tunnistepyynnön, Snowflake saattaa palauttaa virheen invalid_client. Se ei välttämättä tarkoita, että asiakastunnus tai asiakassalaisuus olisi virheellinen.

Suorita tämä suojatussa Snowflake-työarkissa. Integraation nimessä kirjainkoolla on merkitystä, ja nimi kirjoitetaan yleensä isoilla kirjaimilla:

Jaa asiakastunnus ja sitä vastaava asiakassalaisuus Notion-työtilan ylläpitäjälle hyväksyttyä suojattua kanavaa käyttäen. Snowflake tarjoaa kaksi kelvollista asiakassalaisuutta, joten voit vaihtaa niitä ilman käyttökatkoa. Älä koskaan liitä kumpaakaan asiakassalaisuutta dokumentaatioon, keskusteluun, tukipyyntöihin tai versionhallintaan.

Kun Snowflake on valmis, työtilan omistaja tai ylläpitäjä lisää palvelimen työtilaan. Sen jälkeen jäsenet löytävät palvelimen näkemättä OAuth-asiakassalaisuutta. Tämä pätee sekä silloin, kun he yhdistävät Snowflaken MCP-palvelimen mukautettuun palvelijaan, että silloin, kun he yhdistävät sen omaan Notion-palvelijaansa.

1. Siirry työtilan Asetukset-kohtaan.

2. Valitse Yhteydet → Työtilan jaetut MCP:t.

3. Valitse Uusi työtilan MCP.

Täytä nämä kentät ja valitse sitten Lisää MCP-palvelin:

Kun olet tallentanut, varmista, että uusi rivi näkyy kohdassa Jaettu tämän työtilan kanssa ja että kohdassa Työtilan OAuth-asiakasohjelma näkyy tila Määritetty.

Mitä tämä määritys tekee:

• Auttaa jäseniä löytämään hyväksytyn palvelimen.

• Tallentaa OAuth-asiakassalaisuuden Notionin salattuun yhteyksien tallennustilaan vain kerran.

• Varmistaa, että jäsenet kirjautuvat sisään hyväksymälläsi palvelimen URL-osoitteella, asiakasohjelmalla ja käyttöoikeusalueilla.

• Ei luo jaettua Snowflake-istuntoa eikä ohita Snowflaken pääsynvalvontaa.

• Ei yhdistä jokaista jäsentä automaattisesti. Jokaisen on kirjauduttava sisään erikseen.

Jos poistat tämän määrityksen, uudet jäsenet eivät enää löydä palvelinta. Nykyiset yhteydet voivat silti näkyä, joten sovita muutos yhteen Snowflake-käyttöoikeuksien peruuttamisen ja nykyisten yhteyksien poistamisen kanssa.

Kun ylläpitäjät ovat valmistelleet Snowflaken MCP-yhteyden, voit käyttää sitä kahdella tavalla. Jos määrität yhteyttä tiimille, aloita kohdasta 11A. Jos haluat vain esittää omia kysymyksiäsi, siirry kohtaan 11B. Voit tehdä molemmat: yhteydet ovat erilliset.

Mukautettu palvelija tarjoaa tiimillesi yhden paikan Snowflake-tietoja koskeville kysymyksille. Yhdistät Snowflaken kerran, lisäät ohjeet mittareistasi ja taulukoistasi ja jaat palvelijan tiimillesi. Jokaisen käyttäjän on kirjauduttava Snowflakeen omilla tunnuksillaan, joten kukin saa vastauksia vain niiden tietojen perusteella, jotka hänellä on lupa nähdä.

Yhdistä Snowflake mukautettuun palvelijaan

1. Avaa mukautettu palvelijasi tai luo uusi.

2. Siirry kohtaan Asetukset → Työkalut ja käyttöoikeudet.

3. Valitse Lisää yhteys ja valitse sitten Snowflake-palvelin, jonka kohdalla lukee Työtilan hallinnoima. Älä valitse Mukautettu MCP-palvelin tai syötä palvelimen URL-osoitetta manuaalisesti.

4. Kirjaudu Snowflakeen selaimessasi. Organisaatiosi tavallinen Okta- tai SSO-kirjautuminen saattaa tulla näkyviin.

5. Tarkista ja hyväksy pyydetty Snowflake-rooli.

6. Valitse, mitä työkaluja palvelija voi käyttää. Jätä kirjoitustoimintoja tukevat työkalut ja CORTEX_AGENT_RUN pyytämään hyväksyntää, kunnes olet testannut ne.

7. Valitse Yhdistä ja vahvista, että yhteys näkyy tilassa Yhdistetty.

Anna palvelijalle taustatietoa

Yhteys antaa palvelijalle pääsyn Snowflakeen. Ohjeesi kertovat sille, miten yrityksesi käyttää kyseisiä tietoja. Kuvaile palvelijan ohjeissa, mitä työkaluja käytetään mihinkin kysymyksiin, miten tiimisi määrittelee keskeiset mittarit ja mistä taulukoista tai semanttisista näkymistä kannattaa aloittaa. Muutama vahvistettu esimerkkikysymys auttaa paljon. Valmiin aloituspisteen löydät Data Scout -työkalupakin oppaasta.

Jaa palvelija

Jaa palvelija tiimillesi samalla tavalla kuin jaat minkä tahansa mukautetun palvelijan. Kun joku kysyy siltä ensimmäistä kertaa kysymyksen, joka vaatii Snowflakea, häntä pyydetään kirjautumaan sisään omalla Snowflake-käyttäjätilillään. Häneltä ei kysytä asiakastunnusta tai asiakassalaisuutta.

Jos haluat esittää omia kysymyksiäsi omassa keskustelussasi, yhdistä Snowflake Notion-palvelijaasi. Kirjaudut sisään omalla Snowflake-käyttäjätililläsi, joten palvelijasi pääsee käsiksi vain siihen, mitä sinulla on lupa nähdä.

1. Siirry kohtaan Asetukset → Notion AI.

2. Valitse kohdasta MCP-palvelimetLisää MCP-palvelin.

3. Valitse Snowflake-palvelin, jonka kohdalla lukee Työtilan hallinnoima. Älä valitse Mukautettu MCP-palvelin tai syötä palvelimen URL-osoitetta manuaalisesti.

4. Valitse Yhdistä.

5. Kirjaudu Snowflakeen selaimessasi. Organisaatiosi tavallinen Okta- tai SSO-kirjautuminen saattaa tulla näkyviin.

6. Tarkista ja hyväksy pyydetty Snowflake-rooli.

7. Kun selaimesi kysyy, avataanko Notion, valitse Avaa Notion.

8. Vahvista, että palvelimen tila on Yhdistetty eikä Vaatii todennuksen.

Kun olet muodostanut yhteyden, Snowflake näkyy keskustelussa kohdassa Kaikki lähteet → MCP-palvelimet.

1. Esitä harmiton kysymys, johon tiedät vastauksen ja johon vastaamisessa pitäisi käyttää Snowflakea.

2. Vahvista, että palvelija käyttää Snowflakea ja palauttaa tuloksen.

3. Vahvista, ettet pääse käsiksi tietoihin, jotka ovat sinulle annetun roolin ulkopuolella.

Jos määrität mukautetun palvelijan, pyydä myös tiimin jäsentä, jolla on rajatumpi Snowflake-rooli, kokeilemaan sitä. Hänen pitäisi nähdä vain omat tietonsa, ei sinun tietojasi. Se on nopein tapa vahvistaa, että palvelija käyttää kunkin henkilön omia käyttöoikeuksia eikä palvelijan luojan käyttöoikeuksia.

Tarkempaa tarkistusta varten pyydä Snowflake-ylläpitäjääsi vahvistamaan käyttäjätunnuksesi, roolisi, tietovarastosi ja kyselyhistoriasi. Onnistunut sisäänkirjautuminen vahvistaa henkilöllisyytesi, mutta se ei vahvista, että kaikki myönnetyt käyttöoikeudet ovat oikein.

Esitä palvelijalle jokin tietty kysymys Snowflake-tiedoistasi. Esimerkiksi:

• ”Kuinka paljon rekisteröitymisiä meillä oli yhteensä viime kuussa Snowflake-tietojen mukaan?”

• ”Mitkä kymmenen asiakastiliä tuottivat eniten liikevaihtoa tällä vuosineljänneksellä Snowflake-tietojen mukaan?”

Mukautetun palvelijan kanssa voit yleensä jättää ilmauksen ”Snowflake-tietojen mukaan” pois, kun sen ohjeista käy selvästi ilmi, milloin Snowflakea käytetään. Notion-palvelijan kanssa Snowflaken mainitseminen auttaa palvelijaa valitsemaan oikean lähteen.

Laajojen pyyntöjen käsittely voi kestää kauan, ja aikakatkaisu voi keskeyttää sen. Jos näin käy, esitä rajatumpi kysymys tai jaa pyyntö pienempiin osiin.

Useimmiten pysyt yhdistettynä tekemättä mitään. Snowflake käyttää lyhytikäisiä pääsytunnuksia, ja Notion päivittää ne taustalla. Vanheneva pääsytunnus ei itsessään katkaise yhteyttäsi.

Sinun on kirjauduttava uudelleen sisään, jos:

• Päivitystunnuksesi vanhenee tai ylläpitäjä peruuttaa sen

• Ylläpitäjä korvaa OAuth-integraation tai asiakassalaisuuden

• Snowflake-roolisi poistetaan

• Ylläpitäjä poistaa työtilan asetukset tai yhteytesi

• Verkkokäytäntö estää tunnuksen päivittämisen

Mukautetun palvelijan kohdalla jokainen kirjautuu sisään erikseen. Jos yhtä henkilöä pyydetään kirjautumaan uudelleen, se ei vaikuta muihin, eikä palvelijan luoneen henkilön tarvitse tehdä mitään.

Jos vaihdat asiakassalaisuuden: Käytä Snowflaken kahden salaisuuden vaihtomenetelmää sen sijaan, että korvaisit integraation. Pidä molemmat salaisuudet voimassa niin kauan, että ehdit päivittää ja testata työtilan määritykset ennen vanhan salaisuuden poistamista käytöstä.

ALTER SECURITY INTEGRATION <oauth_integration_name>
REFRESH OAUTH_CLIENT_SECRET_2;

• Snowflake MCP -yhteyttä ei ole luettelossa. Työtilan ylläpitäjä ei ehkä ole vielä lisännyt sitä, tai työtilasi saattaa rajoittaa mukautettuja palvelimia. Pyydä apua ylläpitäjältäsi.

• Sinulta pyydetään asiakastunnusta tai asiakassalaisuutta. Valitsit todennäköisesti mukautetun MCP-vaihtoehdon. Palaa takaisin ja valitse sen sijaan Snowflake-palvelin, jossa on merkintä Workspace Managed.

• Sinua pyydetään kirjautumaan uudelleen. Snowflake-istuntosi on saattanut vanhentua tai ylläpitäjä on saattanut päivittää yhteyden. Kirjaudu Snowflakeen uudelleen.

• Avasit mukautetun palvelijan, joka pyysi sinua kirjautumaan Snowflakeen. Tämä on normaalia ensimmäisellä kerralla. Jokaisen hallittua mukautettua palvelijaa käyttävän on kirjauduttava sisään omilla Snowflake-tunnuksillaan.

• Tiimin jäsen saa samalta mukautetulta palvelijalta eri tuloksia. Se on normaalia. Palvelija käyttää kunkin käyttäjän Snowflake-käyttöoikeuksia, joten eri rooleissa olevat näkevät eri tietoja.

• Mukautettu palvelija toimii keskustelussa mutta ei ajoitettuna. Ajoitetuissa ja käynnistetyissä suorituksissa ei ole sisäänkirjautunutta käyttäjää, joten ne eivät vielä voi käyttää Snowflakea henkilökohtaisella kirjautumisella.

• Kirjauduit sisään, mutta yhteys ei muodostu tai työkalut eivät toimi. Sisäänkirjautuminen todistaa henkilöllisyytesi, mutta käyttöoikeutesi riippuvat silti Snowflake-oikeuksistasi. Pyydä Snowflake-ylläpitäjääsi vahvistamaan, että roolillasi on pääsy palvelimeen, tietovarastoon, palvelijaan ja tietoihin.

• Palvelija ei löydä taulukkoa. Palvelija pääsee vain niihin tietoihin, joihin Snowflake-käyttäjätililläsi on pääsy. Tarkista Snowflake-käyttöoikeutesi ja sisällytä taulukon nimi kysymykseesi.

• Pyyntö aikakatkeaa. Esitä tarkempi kysymys tai jaa pyyntösi pienempiin kysymyksiin.

Nämä virheet johtuvat yleensä Snowflaken asetuksista, eivät Notionista. Jaa ne Snowflake-ylläpitäjäsi kanssa.

• Palvelimen URL-osoite näyttää kaksinkertaiselta, kuten https://https%3A... Osoitteen alkuun on liitettäessä lisätty ylimääräinen https://. Korjaa osoite niin, että URL-osoitteen alussa on vain yksi https://.

• Näet virheen ”This server does not support OAuth authentication.” Tietoturvaintegraatiota ei ole määritetty OAuthia varten tai palvelimen URL-osoite on väärä. Pyydä Snowflake-ylläpitäjääsi tarkistamaan OAuth-tietoturvaintegraatio ja palvelimen URL-osoite.

• Näet virheen invalid_client kirjautumisen tai päivityksen aikana. Asiakastunnus tai asiakassalaisuus on väärä, tai asiakassalaisuus on vaihdettu. Pyydä ylläpitäjältäsi nykyinen asiakastunnus ja asiakassalaisuus.

• Kirjautuminen onnistuu, mutta yhteys katkeaa heti. Roolillasi ei ehkä ole pääsyä palvelimeen, tai rooli tai verkkosääntö estää istunnon. Pyydä ylläpitäjääsi tarkistamaan käyttöoikeutesi ja käytännöt.

• Näet viestin ”The role ALL requested has been explicitly blocked.” Yhteys pyysi kaikkia rooleja kerralla (session:role:all), mikä on estetty. Määritä sen sijaan yksi rooli, esimerkiksi session:role:analyst, ja käytä oman roolisi nimeä.

• Näet uudelleenohjausvirheen (virhe 390307). Snowflakessa tallennettu uudelleenohjaus-URL ei vastaa Notionin käyttämää URL-osoitetta. Pyydä ylläpitäjääsi asettamaan tietoturvaintegraation uudelleenohjaus-URL täsmälleen Notionin arvoa vastaavaksi.

• Näet virheen 390311, joka koskee virheellistä koodihaastetta. Tämä on PKCE-yhteensopivuusvirhe. Pyydä ylläpitäjääsi vahvistamaan, että OAUTH_ENFORCE_PKCE on asetettu oikein tietoturvaintegraatiossa.

• Olet yhteydessä, mutta työkaluja ei näy. Rooliltasi saattaa puuttua USAGE-oikeus MCP-palvelimeen. Pyydä ylläpitäjääsi vahvistamaan käyttöoikeus ja suorita sitten DESCRIBE MCP SERVER asetusten tarkistamiseksi.

• Pääset käsiksi odotettua laajempaan tai suppeampaan tietomäärään. Toissijaiset roolit muuttavat sitä, mitä istuntosi voi nähdä. Tarkista ylläpitäjäsi kanssa, mitkä roolit ovat aktiivisina istunnossasi.

• Yhteys toimi aiemmin, mutta asiakassalaisuuden vaihtamisen jälkeen se ei toimi kenelläkään. Tallennettu yhteys käyttää vanhaa asiakassalaisuutta. Pyydä ylläpitäjältäsi uusi asiakassalaisuus ja muodosta yhteys uudelleen.

• Yhteys toimi aiemmin, mutta nyt se ei toimi sinulla. Rooli, käyttöoikeus tai käytäntö on saattanut muuttua, tai istuntosi on vanhentunut. Kirjaudu uudelleen ja pyydä ylläpitäjääsi tarkistamaan, ovatko käyttöoikeutesi muuttuneet.

• Käyttäjätilisi tunniste hylätään. Käytä yhdysviivallista organisaatio-tili-muotoa, esimerkiksi myorg-myaccount. Älä käytä pisteitä.

• PrivateLink-tili ei voi muodostaa yhteyttä. PrivateLink-tilit vaativat ylimääräisiä verkkoasetuksia. Kysy ylläpitäjältäsi, salliiko PrivateLink Notion-yhteyden.

• Snowflake ei ole käytettävissä ajoitetuissa tai käynnistetyissä suorituksissa. Näissä suorituksissa ei ole sisäänkirjautunutta käyttäjää, joten ne eivät vielä voi käyttää henkilökohtaista kirjautumista. Suorita pyyntösi sen sijaan keskustelussa.

• Näet virheen oauth_security_error kirjauduttuasi selaimessa. Käyttäjätilin verkkokäytäntö saattaa estää pyynnön. Ylläpitäjäsi voi tarkistaa asian seuraavalla komennolla:

• Kirjautuminen näyttää toimivan, mutta saat roolivirheen, vaikka käytössäsi on oikea laajuus. Oletusroolisi saattaa olla estetty, esimerkiksi ACCOUNTADMIN tai jokin BLOCKED_ROLES_LIST-listalla oleva rooli. Ylläpitäjäsi voi tarkistaa ja korjata sen:

Näillä komennoilla ylläpitäjäsi voi tarkistaa asetukset muuttamatta mitään. Suorita komennot Snowflakessa.

Käytä näitä Snowflake-oppaita asetusten viimeistelyyn:

• Snowflaken hallinnoima MCP-palvelin

• Luo Snowflake OAuth -tietoturvaintegraatio

• Snowflake OAuth -todennus mukautetuille asiakasohjelmille

• Snowflake OAuth -yleiskatsaus

• Snowflake-tilin tunnisteet

• Mukautetut palvelijat

• MCP-yhteydet mukautetuille palvelijoille

• Yhdistä MCP-palvelimet Notion-palvelijaasi

• Palvelijayhteyksien tietoturvan parhaat käytännöt