Ota Snowflaken MCP käyttöön Notionissa

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

Määritys etenee vaiheittain, ja jokaisesta vaiheesta vastaa eri henkilö:

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

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

• Työtilan jäsenet voivat sen jälkeen yhdistää mukautetut palvelijansa Snowflaken MCP-palvelimeen omilla Snowflake-tunnuksillaan tai yhdistää Snowflaken suoraan Notion-palvelijaansa. Tämän artikkelin vaiheet 1–10 ovat samat molemmissa vaihtoehdoissa. Vaiheessa 11 ohjeet eroavat 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 tai viranomaisille tarkoitetuilla pilvialueilla.

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

• Käytä Notionia selaimessa tai työpöytäsovelluksessa. Ominaisuus ei ole käytettävissä mobiililaitteilla.

• Yritykselläsi on oltava Snowflake-tili.

• Tarvitset mukautetun palvelijan luomiseen käyttöoikeuden, jolla voit luoda palvelijoita 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, mutta se tarvitsee tehdä vain kerran. Tee yhteistyötä Notion-työtilan ylläpitäjän kanssa: Notion antaa uudelleenohjaus-URI:n ja Snowflake OAuth-asiakastunnuksen sekä -salaisuuden.

Määrität roolin ja laskentavaraston, 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ä taulukko Notion-työtilan ylläpitäjän kanssa ennen kuin aloitat. Jäsenet voivat ohittaa sen ja kirjautua omille Snowflake-tileilleen, kun määritys on valmis.

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

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

Suositus: rajoitettu rooli ilman toissijaisia rooleja. Tämä malli on helpompi ymmärtää ja auditoida. Määritä OAUTH_USE_SECONDARY_ROLES = NONE ja ALLOWED_ROLES_LIST sekä käytä Notionin laajuutta session:role:<mcp_access_role>.

Käyttäjän oletusarvoiset toissijaiset roolit – valinnainen vaihtoehto. Käytä tätä mallia vain, jos palvelin tarvitsee oikeuksia, jotka kukin käyttäjä saa Snowflaken DEFAULT_SECONDARY_ROLES -asetuksesta. Määritä OAUTH_USE_SECONDARY_ROLES = IMPLICIT, jätä ALLOWED_ROLES_LIST pois ja määritä ensisijaisen roolin laajuus erikseen. Snowflake ei salli toissijaisia rooleja IMPLICIT-asetuksella yhdessä ALLOWED_ROLES_LIST-asetuksen kanssa. Jätä siksi 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 tavanomaisen käyttäjähallintaprosessinne kautta. Jos Snowflaken roolien jäsenyyksiä hallitaan Oktalla tai SCIMillä, älä lisää käyttäjiä käsin tämän 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, 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 Snowflaken 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 se kattaa, kuinka yksityiskohtaisia tuloksia se antaa ja milloin sitä kannattaa käyttää. Näin palvelija osaa valita oikean työkalun.

MCP-palvelimen USAGE-oikeudella rooli voi muodostaa yhteyden palvelimeen ja nähdä 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-skeema ilmoittamaan täsmällisesti, mitä roolia jäsenten tulee pyytää:

Käytä nimenomaista roolilaajuutta. Älä käytä arvoa session:role:all. Snowflake tulkitsee sen käyttäjän ensisijaiseksi oletusrooliksi, ei pääsyksi kaikkiin rooleihin. Lisäksi etuoikeutettujen roolien käytännöt voivat estää sen käytön. Kun nimeät roolin erikseen, 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 sekä ottamaan käyttöön todennuksen manuaalinen määritys ja työtilan jaettu OAuth-asiakasohjelma. 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:a täsmälleen sellaisena kuin Notion sen antaa. Älä lisää loppuviivaa 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 käyttää palvelijakohtaista auditointia ja hallintaa. Jos käytät valinnaista toissijaisten roolien mallia, aseta OAUTH_USE_SECONDARY_ROLES = IMPLICIT ja jätä ALLOWED_ROLES_LIST pois.

Päivitystunnuksen voimassaoloaika 7776000 sekuntia vastaa 90:tä päivää. Varmista ennen sen käyttöä, että se vastaa organisaatiosi uudelleenvaltuutusta ja tunnusten vaihtamista koskevia käytäntöjä. Vältä rutiinimuutoksissa komentoa CREATE OR REPLACE SECURITY INTEGRATION. Integraation korvaaminen voi katkaista olemassa olevat yhteydet.

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

Varmista, että integraatio on käytössä, uudelleenohjaus-URI täsmää tarkasti, rooli on sallittu eikä sitä ole estetty ja päivitystunnukset sekä PKCE ovat käytössä. Tarkista myös, että valtuutus- ja tunnuspäätepisteet käyttävät Snowflake-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 uusii tunnukset

Nämä polut voivat käyttää Notionin lähtevässä liikenteessä eri osoitteita. Jos sallit vain alkuperäisessä tunnusten vaihdossa käytetyn osoitteen, sisäänkirjautuminen voi onnistua mutta yhteyden vahvistaminen tai tunnuksen uusiminen epäonnistua. Käytä Notionin nykyisiä, hyväksyttyjä lähtevän liikenteen IP-osoitealueita. Älä lisää yksittäistä selaimesta tai lokista poimittua 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ä, jotka koskevat selaimessa sisäänkirjautumista, VPN-yhteyttä tai käyttäjien verkkoyhteyksiä. Jos verkkokäytäntö estää tunnuspyynnön, Snowflake saattaa palauttaa invalid_client. Tämä virhe ei välttämättä tarkoita, että asiakastunnus tai asiakassalaisuus olisi virheellinen.

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

Jaa asiakastunnus ja sitä vastaava asiakassalaisuus Notion-työtilasi ylläpitäjälle hyväksytyn suojatun kanavan kautta. 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 riippumatta siitä, yhdistävätkö he Snowflake MCP:n 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ä 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 kerran Notionin salattuun yhteyksien tallennustilaan.

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

• 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 voi enää löytää palvelinta. Aiemmat yhteydet saattavat yhä näkyä, joten sovita tämä muutos yhteen Snowflaken käyttöoikeuksien peruuttamisen ja aiempien yhteyksien poistamisen kanssa.

Kun ylläpitäjät ovat määrittäneet 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, sillä yhteydet ovat erillisiä.

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

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ää. Määritä 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 taustatiedot

Yhteys antaa palvelijalle pääsyn Snowflakeen. Ohjeissa kerrot sille, miten yrityksesi käyttää näitä tietoja. Kuvaile palvelijan ohjeissa, mitä työkaluja käytetään eri kysymyksiin, miten tiimisi määrittelee keskeiset mittarit ja mistä taulukoista tai semanttisista näkymistä kannattaa aloittaa. Muutama tarkistettu esimerkkikysymys auttaa paljon. Valmiin pohjan 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 Vaatii todennuksen.

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

1. Esitä harmiton kysymys, jonka vastauksen tiedät ja johon vastaaminen edellyttää Snowflaken käyttöä.

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ä sen luojan käyttöoikeuksia.

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

Esitä palvelijalle tarkka kysymys Snowflake-tiedoistasi. Esimerkiksi:

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

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

Mukautettua palvelijaa käyttäessäsi voit yleensä jättää ilmauksen ”Snowflake-tietojen mukaan” pois, kun sen 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ää kauan, ja pyyntö voi aikakatketa. Jos näin käy, esitä rajatumpi kysymys tai jaa pyyntö pienempiin osiin.

Useimmiten yhteys pysyy auki ilman, että sinun tarvitsee tehdä mitään. Snowflake käyttää lyhyen aikaa voimassa olevia pääsytunnuksia, jotka Notion päivittää taustalla. Pelkkä pääsytunnuksen vanheneminen ei 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äivityksen

Mukautetun palvelijan kohdalla jokaisen henkilön sisäänkirjautuminen on erillinen. Jos yhtä henkilöä pyydetään kirjautumaan uudelleen, se ei vaikuta muihin, eikä palvelijan rakentaneen henkilön tarvitse tehdä mitään.

Jos kierrätät asiakassalaisuutta: Käytä Snowflaken kahden salaisuuden kiertoa integraation korvaamisen sijaan. Pidä molemmat salaisuudet voimassa riittävän pitkään, jotta voit päivittää ja testata työtilan asetukset ennen vanhan 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 salaisuutta. Valitsit todennäköisesti mukautetun MCP-vaihtoehdon. Palaa takaisin ja valitse Snowflake-palvelin, joka on merkitty 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ä käyttökerralla. Jokaisen hallittua mukautettua palvelijaa käyttävän on kirjauduttava sisään omilla Snowflake-tunnuksillaan.

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

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

• Kirjauduit sisään, mutta yhteyttä 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.

• Pyynnön aikaraja ylittyy. 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ällesi.

• Palvelimen URL-osoite näyttää kaksinkertaiselta, kuten https://https%3A... Osoitteen alkuun on liitettäessä tullut 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 salaisuus on väärä, tai salaisuus on vaihdettu. Pyydä ylläpitäjältäsi nykyinen asiakastunnus ja salaisuus.

• 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äntösi.

• 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 tietty rooli, esimerkiksi session:role:analyst, ja korvaa esimerkin roolinimi omallasi.

• Näet uudelleenohjausvirheen 390307. Snowflakeen tallennettu uudelleenohjaus-URL ei vastaa Notionin käyttämää osoitetta. Pyydä ylläpitäjääsi asettamaan tietoturvaintegraation uudelleenohjaus-URL täsmälleen Notionin käyttämäksi osoitteeksi.

• 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.

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

• Yhteys toimi aiemmin, mutta asiakassalaisuuden vaihdon 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.

• Se toimi aiemmin, mutta nyt se epäonnistuu vain sinun kohdallasi. Rooli, käyttöoikeus tai käytäntö on saattanut muuttua, tai istuntosi on vanhentunut. Kirjaudu sisään uudelleen ja pyydä ylläpitäjääsi vahvistamaan, ettei käyttöoikeutesi ole muuttunut.

• Käyttäjätilisi tunniste hylätään. Käytä muotoa organization-account, jossa osat erotetaan yhdysviivalla, kuten myorg-myaccount. Älä käytä pisteitä.

• PrivateLink-käyttäjätili ei voi muodostaa yhteyttä. PrivateLink-käyttäjätilit vaativat lisä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 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 kirjauduttuasi sisään selaimen kautta. Käyttäjätilitason verkkokäytäntö saattaa estää pyynnön. Ylläpitäjäsi voi varmistaa asian suorittamalla seuraavan komennon:

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

Nämä komennot auttavat ylläpitäjääsi tarkistamaan 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 OAuthin yleiskatsaus

• Snowflake-tilin tunnisteet

• Mukautetut palvelijat

• MCP-yhteydet mukautetuille palvelijoille

• Yhdistä MCP-palvelimet Notion-palvelijaasi

• Palvelijayhteyksien tietoturvan parhaat käytännöt