Määritä Snowflake-MCP-yhteys Notioniin

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 Snowflaken laskentavaraston tiedoista ja saada vastauksia suoraan Notionissa.

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

• Snowflake-ylläpitäjä määrittää roolin, laskentavaraston ja Snowflaken ylläpitämän 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 kummassakin tapauksessa. Ohjeet eroavat vaiheesta 11 alkaen sen mukaan, kumman palvelijan haluat yhdistää.

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

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

• Notion-työtilasi on oltava Business- tai Enterprise-sopimuksella.

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

• Yritykselläsi on oltava Snowflake-tili.

• Tarvitset käyttöoikeuden luoda palvelijoita työtilassasi, jotta voit luoda mukautetun palvelijan.

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, mutta se tarvitsee tehdä vain kerran. Tee yhteistyötä Notion-työtilan ylläpitäjän kanssa: Notion tarjoaa uudelleenohjaus-URI:n ja Snowflake OAuth-asiakastunnuksen ja -salaisuuden.

Määrität roolin ja laskentavaraston, luot Snowflaken ylläpitämän MCP-palvelimen, myönnät roolille pääsyn tarvittaviin resursseihin, määrität OAuth-käyttöalueen ja tietoturvaintegraation sekä lisäät verkkokäytännön, jos organisaatiosi vaatii sellaisen.

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

Tilin isäntänimessä käytetään tavuviivoja, ei alaviivoja. Varmista, että jokainen palvelimen URL-osoitteen objektinimi vastaa vastaavaa objektinimeä Snowflakessa.

Käytä mahdollisuuksien mukaan erillistä roolia, jolla on vain välttämättömät käyttöoikeudet, ja yhtä hyväksyttyä laskentavarastoa.

Rajoitettu rooli ilman toissijaisia rooleja – suositus. Tämä malli on helpompi ymmärtää ja auditoida. Määritä OAUTH_USE_SECONDARY_ROLES = NONE ja ALLOWED_ROLES_LIST sekä käytä Notionin käyttöaluetta session:role:<mcp_access_role>.

Käyttäjän oletusarvoiset toissijaiset roolit – valinnainen malli. Käytä tätä mallia vain, jos palvelin tarvitsee kunkin käyttäjän Snowflaken DEFAULT_SECONDARY_ROLES -asetuksesta periytyviä käyttöoikeuksia. Määritä OAUTH_USE_SECONDARY_ROLES = IMPLICIT, jätä ALLOWED_ROLES_LIST pois ja käytä erikseen määritettyä ensisijaisen roolin käyttöaluetta. 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 välttämättömät 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 tarjota Cortex Agentin jäsenille työkaluksi. Se kokoaa semanttiset näkymät, vahvistetut kyselyt, haun 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 tuettuja Snowflake MCP -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 työkalu kattaa, kuinka tarkkoja sen tulokset ovat ja milloin sitä kannattaa käyttää. Näin palvelija osaa valita oikean työkalun.

MCP-palvelimen USAGE-oikeus antaa roolille mahdollisuuden muodostaa yhteyden palvelimeen ja löytää sen työkalut. Se ei anna roolille käyttöoikeutta laskentavarastoon, palvelijaan, semanttiseen näkymään, hakupalveluun, tallennettuun proseduuriin tai taustalla oleviin tietoihin. Myönnä roolille käyttöoikeus kaikkiin resursseihin, joita 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 nykyisille tai tuleville objekteille.

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

Määritä MCP-skeemaan täsmällinen rooli, jota jäsenten tulee pyytää:

Määritä rooli erikseen käyttöoikeuden laajuudessa. Älä käytä arvoa session:role:all. Snowflake tulkitsee sen käyttäjän oletusarvoiseksi ensisijaiseksi rooliksi, ei oikeudeksi käyttää kaikkia rooleja. Etuoikeutettuja rooleja koskevat käytännöt voivat myös estää sen käytön. Kun määrität roolin erikseen, pyydetty käyttöoikeus on selkeä ja helppo tarkistaa.

Ennen kuin suoritat tämän SQL-lauseen, sovi asiasta Notion-työtilan ylläpitäjän kanssa. Pyydä häntä syöttämään Snowflake-palvelimen URL-osoite työtilan MCP-asetuslomakkeeseen sekä ottamaan käyttöön todennuksen määritys käsin ja työtilan yhteinen OAuth-asiakasohjelma. Notion luo uudelleenohjaus-URI:n. Kopioi se ja lähetä 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:a täsmälleen sellaisena kuin Notion sen antaa. Älä lisää loppuun vinoviivaa tai kyselyparametreja äläkä muuta isäntänimeä.

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

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

Voit tarkistaa integraation näyttämättä sen salaisuutta suorittamalla seuraavan komennon:

Varmista, että integraatio on käytössä, uudelleenohjaus-URI vastaa täsmälleen määritettyä osoitetta, rooli on sallittu eikä estetty, päivitystokenit ja PKCE ovat käytössä ja sekä valtuutus- että token-päätepiste käyttävät Snowflaken käyttäjätilin julkista 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ää tokenit

Nämä polut voivat käyttää eri Notionin lähtevän liikenteen IP-osoitteita. Jos sallit vain alkuperäisessä tokeninvaihdossa käytetyn osoitteen, sisäänkirjautuminen saattaa onnistua, mutta yhteyden vahvistus tai tokenin 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 luetteloon.

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ä selaimella kirjautumista, VPN-käyttöä tai käyttäjien verkkoyhteyksiä varten. Jos verkkokäytäntö estää tokenpyynnön, Snowflake saattaa palauttaa virheen invalid_client. Se ei välttämättä tarkoita, että asiakastunnus tai asiakassalaisuus on virheellinen.

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

Jaa asiakastunnus ja sitä vastaava asiakassalaisuus Notion-työtilan ylläpitäjälle hyväksyttyä suojattua kanavaa pitkin. Snowflake tarjoaa kaksi kelvollista asiakassalaisuutta, joten voit vaihtaa niiden välillä ilman käyttökatkoja. Ä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 kerran. Jäsenet voivat sitten löytää sen näkemättä OAuth-asiakassalaisuutta riippumatta siitä, yhdistävätkö he Snowflaken MCP-palvelimen mukautettuun palvelijaan vai 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ä Työtilan OAuth-asiakasohjelma näyttää tilan Määritetty.

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

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

• Tallentaa OAuth-asiakassalaisuuden kerran Notionin salattuun yhteyksien tallennustilaan.

• Varmistaa, että jäsenet kirjautuvat sisään käyttämällä hyväksymääsi palvelimen URL-osoitetta ja asiakasohjelmaa sekä hyväksymiäsi käyttöoikeusalueita.

• 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. Aiemmat yhteydet saattavat silti näkyä, joten sovita muutos yhteen Snowflaken käyttöoikeuksien peruuttamisen ja aiempien yhteyksien poistamisen kanssa.

Kun ylläpitäjäsi ovat saaneet Snowflaken MCP-yhteyden valmiiksi, 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, sillä kyseessä ovat erilliset yhteydet.

Mukautettu palvelija tarjoaa tiimillesi yhden paikan, josta kysyä Snowflake-tietoja. Yhdistät Snowflaken kerran, lisäät ohjeet mittareistasi ja taulukoistasi ja jaat palvelijan tiimillesi. Jokaisen sitä käyttävä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 sitten Snowflake-palvelin, jonka kohdalla lukee Työtilan hallinnoima. Älä valitse Mukautettu MCP-palvelin äläkä syötä palvelimen URL-osoitetta itse.

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ä tietoja muokkaavat 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 taustatietoja

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 äläkä syötä palvelimen URL-osoitetta itse.

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, ei Todennus vaaditaan.

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

1. Esitä vaaraton kysymys, jonka vastauksen tiedät ja johon vastaamiseen palvelijan 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 tiedot, joihin hänellä on käyttöoikeus – ei kaikkia tietoja, joihin sinulla on pääsy. Näin varmistat nopeimmin, että palvelija käyttää kunkin käyttäjän eikä sen luojan käyttöoikeuksia.

Jos haluat tarkistaa asian perusteellisemmin, pyydä Snowflake-ylläpitäjää tarkistamaan käyttäjätilisi, roolisi, tietovarastosi ja kyselyhistoriasi. Onnistunut kirjautuminen vahvistaa henkilöllisyytesi, mutta ei sitä, että kaikki käyttöoikeudet ovat oikein.

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

• ”Kuinka paljon rekisteröitymisiä meillä oli yhteensä viime kuussa Snowflaken mukaan?”

• ”Mitkä olivat Snowflake-tietojemme mukaan tämän vuosineljänneksen kymmenen eniten liikevaihtoa tuottanutta asiakastiliä?”

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

Laajojen pyyntöjen käsittely voi kestää kauemmin tai ylittää aikarajan. Jos näin käy, esitä rajatumpi kysymys tai jaa pyyntö pienempiin kysymyksiin.

Yhteys pysyy yleensä toiminnassa ilman, että sinun tarvitsee tehdä mitään. Snowflake käyttää lyhytikäisiä pääsytunnuksia, jotka Notion päivittää taustalla. Pääsytunnuksen vanheneminen ei yksin katkaise yhteyttä.

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 määrityksen tai yhteytesi

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

Mukautettua palvelijaa käytettäessä jokainen kirjautuu sisään erikseen. Jos yhtä käyttäjää pyydetään kirjautumaan uudelleen, se ei vaikuta muihin eikä palvelijan luojan tarvitse tehdä mitään.

Jos vaihdat asiakassalaisuuden: Käytä Snowflaken kahden salaisuuden vaihtomenetelmää sen sijaan, että korvaisit integraation. Pidä molemmat salaisuudet voimassa riittävän pitkään, jotta ehdit päivittää ja testata työtilan määrityksen 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 luultavasti mukautetun MCP-vaihtoehdon. Palaa takaisin ja valitse sen sijaan Snowflake-palvelin, jossa lukee 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, ja se pyysi sinua kirjautumaan Snowflakeen. Se kuuluu asiaan ensimmäisellä kerralla. Jokaisen hallittua mukautettua palvelijaa käyttävän on kirjauduttava sisään omilla Snowflake-tunnuksillaan.

• Tiimin jäsen saa eri tuloksia samasta mukautetusta palvelijasta. Se on normaalia. Palvelija käyttää kunkin käyttäjän Snowflake-käyttöoikeuksia, joten eri rooleissa näkyy eri tietoja.

• Mukautettu palvelija toimii keskustelussa mutta ei ajoitettuna. Ajastetuissa tai käynnistetyissä suorituksissa kukaan ei ole kirjautuneena sisään, joten niissä ei voi vielä käyttää Snowflakea henkilökohtaisella kirjautumisella.

• Kirjauduit sisään, mutta yhteys ei muodostu tai työkalut eivät toimi. Kirjautuminen vahvistaa henkilöllisyytesi, mutta Snowflake-käyttöoikeutesi ratkaisevat, mihin pääset käsiksi. Pyydä Snowflake-ylläpitäjää tarkistamaan, että roolillasi on pääsy palvelimeen, tietovarastoon, palvelijaan ja tietoihin.

• Palvelija ei löydä taulukkoa. Palvelija pääsee vain niihin tietoihin, joihin Snowflake-tilisi pääsee. 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. Kerro niistä Snowflake-ylläpitäjälle.

• Palvelimen URL-osoite näyttää kaksinkertaiselta, kuten https://https%3A... Osoitteen alkuun on liitetty ylimääräinen https://. Korjaa osoite niin, että URL-osoite alkaa vain yhdellä 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ää 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ä ajantasainen 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. Käytä sen sijaan vain yhtä roolia, esimerkiksi session:role:analyst, ja korvaa esimerkin roolinimi omallasi.

• Näet uudelleenohjausvirheen 390307. Snowflakeen tallennettu uudelleenohjausosoite ei vastaa Notionin käyttämää osoitetta. Pyydä ylläpitäjää asettamaan tietoturvaintegraation uudelleenohjausosoite täsmälleen samaksi kuin Notionissa.

• 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-käyttöoikeus MCP-palvelimeen. Pyydä ylläpitäjää tarkistamaan käyttöoikeus. Tarkista sitten asetukset komennolla DESCRIBE MCP SERVER.

• Näet enemmän tai vähemmän tietoja kuin odotit. Toissijaiset roolit vaikuttavat siihen, mitä näet istunnossasi. Tarkista ylläpitäjän kanssa, mitkä roolit ovat aktiivisia.

• Se toimi aiemmin, mutta asiakassalaisuuden vaihtamisen jälkeen yhteys ei enää toimi kenelläkään. Asiakassalaisuus vaihdettiin, joten tallennettu yhteys on vanhentunut. Pyydä ylläpitäjältäsi uusi asiakassalaisuus ja muodosta yhteys uudelleen.

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

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

• PrivateLink-tili ei voi muodostaa yhteyttä. PrivateLink-tilit edellyttävät verkon lisämäärityksiä. 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 kirjautunutta henkilöä, joten ne eivät voi vielä käyttää henkilökohtaista kirjautumista. Suorita pyyntösi sen sijaan keskustelussa.

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

• Kirjautuminen näyttää onnistuvan, mutta saat roolivirheen, vaikka laajuus on oikea. Oletusroolisi voi olla estetty. Se voi olla esimerkiksi ACCOUNTADMIN tai jokin BLOCKED_ROLES_LIST-listan rooleista. Ylläpitäjäsi voi tarkistaa ja korjata asian:

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

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

• Snowflaken hallinnoima MCP-palvelin

• Luo Snowflake OAuth -tietoturvaintegraatio

• Snowflake OAuth 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