Määritä Snowflake-MCP Notionia varten

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

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

• Snowflake-ylläpitäjä määrittää roolin, tietovaraston 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 sitten muodostaa yhteyden Snowflake-MCP:hen mukautetuista palvelijoista omilla Snowflake-tunnuksillaan tai yhdistää Snowflaken suoraan Notion-palvelijaansa. Tämän artikkelin vaiheet 1–10 ovat samat molemmissa vaihtoehdoissa. Vaihtoehdot eroavat toisistaan vaiheessa 11 sen mukaan, minkä palvelijan haluat yhdistää.

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

• Snowflaken hallinnoima MCP-palvelin ei ole saatavilla Manner-Kiinassa eikä viranomaiskäyttöön tarkoitetuilla pilvialueilla.

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

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

• Yritykselläsi on oltava Snowflake-tili.

• Jotta voit rakentaa mukautetun palvelijan, sinulla on oltava käyttöoikeus 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, ja se tarvitsee tehdä vain kerran. Tee yhteistyötä Notion-työtilan ylläpitäjän kanssa: Notion tarjoaa uudelleenohjauksen URI-osoitteen, ja Snowflake tarjoaa OAuth-asiakastunnuksen ja -salaisuuden.

Määrität roolin ja tietovaraston, 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 sitä vaatii.

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

Tilin isäntänimessä käytetään yhdysviivoja, ei alaviivoja. Varmista, että jokainen palvelimen URL-osoitteessa oleva objektinimi vastaa Snowflakessa olevaa objektinimeä.

Käytä mahdollisuuksien mukaan erillistä, mahdollisimman vähäoikeuksista roolia ja yhtä hyväksyttyä tietovarastoa.

Suositus: rajoitettu rooli ilman toissijaisia rooleja. Tätä mallia on helpompi ymmärtää ja auditoida. Määritä OAUTH_USE_SECONDARY_ROLES = NONE, määritä ALLOWED_ROLES_LIST ja käytä Notion-laajuutta session:role:<mcp_access_role>.

Valinnainen vaihtoehto: käyttäjän oletusarvoiset toissijaiset roolit. 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 määritä ensisijaisen roolin laajuus erikseen. Snowflake ei salli IMPLICIT-asetuksella määritettyjä toissijaisia rooleja yhdessä ALLOWED_ROLES_LIST -asetuksen kanssa. Jätä siis sallittujen roolien lista pois, kun käytät tätä mallia.

Käytä MCP-palvelimelle mahdollisuuksien mukaan erillistä, mahdollisimman vähäoikeuksista roolia.

Myönnä tämä rooli organisaatiosi tavanomaisen käyttäjähallinnan kautta. Jos Okta tai SCIM hallinnoi Snowflaken roolijäsenyyksiä, älä lisää käyttäjiä käsin tämän käytännön ohi.

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

Hallittuja liiketoimintakysymyksiä varten voit tuoda Cortex Agentin jäsenten käytettäväksi työkaluksi. Se pitää semanttiset näkymät, vahvistetut kyselyt, haun ja orkestroinnin yhdessä paikassa. Cortex Agent on valinnainen. Jos luot sellaisen, käytä alla olevaa määritystä. Jos korvaat aiemman Cortex Agentin, varmista, että uusi vastaa hyväksyttyä määritystäsi.

Muita Snowflake-MCP:n tukemia työkalutyyppejä ovat CORTEX_ANALYST_MESSAGE, CORTEX_SEARCH_SERVICE_QUERY, GENERIC ja SYSTEM_EXECUTE_SQL.

Anna jokaiselle työkalulle selkeä nimi ja kuvaus. Selitä, mitä tietoja se kattaa, kuinka yksityiskohtaisia sen tulokset ovat ja milloin sitä tulee käyttää. Tämä auttaa palvelijaa valitsemaan oikean työkalun.

MCP-palvelimen USAGE-oikeus antaa roolille mahdollisuuden muodostaa yhteys palvelimeen ja löytää sen työkalut. Se ei anna roolille pääsyä tietovarastoon, palvelijaan, semanttiseen näkymään, Search-palveluun, tallennettuun proseduuriin tai taustalla olevaan dataan. Myönnä roolille pääsy 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 nykyisille tai tuleville objekteille.

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

Määritä MCP-skeema niin, että se ilmoittaa tarkasti, mitä roolia jäsenten tulee pyytää:

Käytä täsmällistä roolilaajuutta. Älä käytä arvoa session:role:all. Snowflake tulkitsee kyseisen arvon käyttäjän oletusarvoiseksi ensisijaiseksi rooliksi, ei käyttöoikeudeksi kaikkiin rooleihin, ja etuoikeutettuja rooleja koskevat käytännöt voivat estää sen. Täsmällinen rooli selventää pyydettyä käyttöoikeutta ja helpottaa sen tarkistamista.

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 yhteinen OAuth-asiakas. Notion luo uudelleenohjaus-URI:n. Kopioi se ja lähetä se Snowflaken ylläpitäjälle. Kun Snowflake on luonut asiakastunnuksen ja asiakkaan salaisen avaimen, 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 palvelinosoitetta.

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 soveltaa palvelijakohtaista auditointia ja hallintaa. Jos käytät valinnaista toissijaisen roolin mallia, aseta OAUTH_USE_SECONDARY_ROLES = IMPLICIT ja jätä ALLOWED_ROLES_LIST pois.

Päivitystunnuksen voimassaoloaika 7776000 sekuntia vastaa 90 päivää. Varmista ennen sen käyttöä, että se vastaa organisaatiosi uudelleenvaltuutus- ja tunnusten 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 salaista avainta suorittamalla:

Varmista, että integraatio on käytössä, uudelleenohjaus-URI täsmää tarkalleen, rooli on sallittu eikä estetty, päivitystunnukset ja PKCE ovat käytössä ja sekä valtuutus- että tunnuspäätepisteet käyttävät Snowflake-tilin julkista palvelinosoitetta.

Tämä vaihe tarvitaan vain, jos organisaatiosi edellyttää verkkokäytäntöä. 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ää tunnukset

Nämä polut voivat käyttää Notionin lähtevässä liikenteessä eri IP-osoitteita. Jos sallit vain ensimmäisessä tunnusten vaihdossa käytetyn osoitteen, kirjautuminen saattaa onnistua, mutta vahvistus tai tunnuksen päivittäminen voi epäonnistua. Käytä Notionin nykyisiä, hyväksyttyjä lähtevän liikenteen IP-osoitealueita. Älä lisää selaimesta tai lokista poimittua kertaluonteista IP-osoitetta tuotantoympäristön sallittujen IP-osoitteiden luetteloon.

Liitä tämä verkkokäytäntö OAuth-integraatioon, älä yksittäisiin käyttäjiin. Älä muuta koko Snowflake-tiliä koskevia käytäntöjä selaimella kirjautumista, VPN-käyttöä tai käyttäjien verkkokäyttöä varten. Jos verkkokäytäntö estää tunnuspyynnön, Snowflake saattaa palauttaa invalid_client. Tämä virhe ei välttämättä tarkoita, että asiakastunnus tai asiakkaan salainen avain on virheellinen.

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

Jaa asiakastunnus ja sitä vastaava asiakkaan salainen avain Notion-työtilan ylläpitäjälle hyväksytyn suojatun kanavan kautta. Snowflake tarjoaa kaksi kelvollista salaista avainta, joten voit vaihtaa niitä ilman käyttökatkoa. Älä koskaan liitä kumpaakaan salaista avainta dokumentaatioon, keskusteluun, tukipyyntöihin tai versionhallintaan.

Kun Snowflake on valmis, työtilan omistaja tai ylläpitäjä lisää palvelimen työtilaan kerran. Jäsenet löytävät sen sen jälkeen näkemättä OAuth-asiakkaan salaista avainta riippumatta siitä, yhdistävätkö he Snowflaken MCP-palvelimen mukautettuun palvelijaan vai omaan Notion-palvelijaansa.

1. Siirry työtilan Asetuksiin.

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:

Varmista tallennuksen jälkeen, että uusi rivi näkyy kohdassa Jaettu tämän työtilan kanssa ja että työtilan OAuth-asiakkaan tila on määritetty.

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

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

• Tallentaa OAuth-asiakkaan salaisen avaimen vain kerran Notionin salattuun yhteyksien tallennustilaan.

• Varmistaa, että jäsenet kirjautuvat sisään käyttämällä hyväksymääsi palvelimen URL-osoitetta, asiakasohjelmaa ja 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. Nykyiset yhteydet voivat silti näkyä, joten peruuta samalla Snowflaken käyttöoikeudet ja poista nykyiset yhteydet.

Kun ylläpitäjät ovat määrittäneet Snowflake-MCP-yhteyden, voit käyttää sitä kahdella tavalla. Jos määrität yhteyttä tiimille, aloita kohdasta 11A. Jos haluat esittää vain omia kysymyksiäsi, siirry kohtaan 11B. Voit tehdä molemmat, sillä kyse on erillisistä yhteyksistä.

Mukautettu palvelija tarjoaa tiimillesi yhden paikan kysyä Snowflake-tiedoista. 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, joita hänellä on lupa tarkastella.

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 -vaihtoehtoa ä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ää. Aseta kirjoittamiseen pystyvät työkalut ja CORTEX_AGENT_RUN pyytämään hyväksyntää, kunnes olet testannut ne.

7. Valitse Yhdistä ja vahvista, että yhteyden tilana näkyy Yhdistetty.

Anna palvelijalle taustatietoa

Yhteys antaa palvelijalle pääsyn Snowflakeen. Ohjeesi kertovat sille, miten yrityksesi käyttää kyseistä dataa. 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 pitkälle. Valmiin aloituspisteen löydät Data Scout -työkalupakin oppaasta.

Jaa palvelija

Jaa palvelija tiimillesi samalla tavalla kuin mikä tahansa mukautettu palvelija. Kun joku esittää sille ensimmäisen Snowflakea edellyttävän kysymyksen, häntä pyydetään kirjautumaan omalle Snowflake-käyttäjätililleen. Häneltä ei kysytä asiakastunnusta eikä 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 tarkastella.

1. Siirry kohtaan Asetukset → Notion AI.

2. Valitse kohdassa MCP-palvelimet vaihtoehto Lisää MCP-palvelin.

3. Valitse Snowflake-palvelin, jonka kohdalla lukee Työtilan hallinnoima. Älä valitse Mukautettu MCP-palvelin -vaihtoehtoa ä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 eikä Vaatii todennuksen.

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

1. Esitä helppo testikysymys, johon tiedät vastauksen 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 olet määrittänyt 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 pääsy, ei kaikkia sinun näkemiäsi tietoja. Näin varmistat nopeimmin, että palvelija käyttää kunkin käyttäjän omia käyttöoikeuksia eikä palvelijan luojan käyttöoikeuksia.

Pyydä Snowflake-ylläpitäjää tarkistamaan käyttäjätunnuksesi, roolisi, virtuaalivarastosi ja kyselyhistoriasi, jos haluat varmistaa asian tarkemmin. Onnistunut kirjautuminen vahvistaa henkilöllisyytesi, mutta ei sitä, että kaikki myönnetyt käyttöoikeudet ovat oikein.

Esitä palvelijalle jokin tietty 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 suurimman liikevaihdon asiakastiliä?”

Mukautetun palvelijan kanssa voit yleensä jättää ilmauksen ”Snowflake-tietojen mukaan” pois, kun ohjeista käy 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, tai ne voivat aikakatketa. Jos näin käy, esitä rajatumpi kysymys tai jaa pyyntö pienempiin osiin.

Useimmiten yhteys pysyy voimassa 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ää tunnuksen päivityksen

Mukautettujen palvelijoiden 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 kiertomenetelmää sen sijaan, että korvaisit integraation. Pidä molemmat salaisuudet voimassa, kunnes olet päivittänyt ja testannut työtilan määrityksen. Poista vanha salaisuus käytöstä vasta sitten.

ALTER SECURITY INTEGRATION <oauth_integration_name>
REFRESH OAUTH_CLIENT_SECRET_2;

• Snowflake MCP -yhteyttä ei näy listassa. Työtilan ylläpitäjä ei ehkä ole vielä lisännyt sitä, tai työtilassasi voi olla rajoituksia mukautetuille palvelimille. Pyydä apua ylläpitäjältä.

• Sinulta pyydetään asiakastunnusta tai asiakassalaisuutta. Valitsit luultavasti mukautetun MCP-vaihtoehdon. Palaa takaisin ja valitse sen sijaan Snowflake-palvelin, joka on merkitty työtilan hallinnoimaksi.

• 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 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. Ajoitettuihin ja käynnistettyihin suorituksiin ei liity kirjautunutta käyttäjää, 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 käyttöoikeutesi riippuvat silti Snowflake-käyttöoikeuksistasi. 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-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älle.

• Palvelimen URL-osoite näyttää kaksinkertaiselta, kuten https://https%3A... Osoite liitettiin siten, että edessä on ylimääräinen https://. Korjaa se 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 yhteyden päivittämisen aikana. Asiakastunnus tai asiakassalaisuus on väärä, tai asiakassalaisuus on vaihdettu. Pyydä ylläpitäjältä 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ää tarkistamaan käyttöoikeutesi ja voimassa olevat 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 muodossa session:role:analyst ja korvaa analyst oman roolisi nimellä.

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

• Näet virheen 390311, joka koskee virheellistä koodihaastetta. PKCE-määritykset eivät täsmää. Pyydä ylläpitäjää tarkistamaan, että OAUTH_ENFORCE_PKCE on määritetty 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 odotettua enemmän tai vähemmän tietoja. Toissijaiset roolit vaikuttavat siihen, mitä näet istunnossa. Tarkista ylläpitäjän kanssa, mitkä roolit ovat aktiivisia istunnossasi.

• Se toimi aiemmin, mutta nyt yhteys epäonnistuu kaikilla asiakassalaisuuden vaihtamisen jälkeen. Asiakassalaisuus vaihdettiin, joten tallennettu yhteys on vanhentunut. Pyydä ylläpitäjältäsi uusi asiakassalaisuus ja muodosta yhteys uudelleen.

• Se toimi aiemmin, mutta nyt vain sinulla on ongelmia. Rooli, käyttöoikeus tai käytäntö on saattanut muuttua, tai istuntosi on vanhentunut. Kirjaudu uudelleen ja pyydä ylläpitäjää tarkistamaan, etteivät käyttöoikeutesi ole muuttuneet.

• Käyttäjätilisi tunniste hylätään. Käytä yhdysviivallista organization-account-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 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 selaimen kautta kirjautumisen jälkeen. Käyttäjätilin verkkokäytäntö saattaa estää pyynnön. Ylläpitäjä voi tarkistaa asian suorittamalla seuraavan komennon:

• Kirjautuminen näyttää onnistuvan, mutta saat roolivirheen, vaikka käytössä on oikea laajuus. Oletusroolisi saattaa olla estetty. Se voi olla esimerkiksi ACCOUNTADMIN tai BLOCKED_ROLES_LIST-listaan kuuluva rooli. Ylläpitäjä voi tarkistaa ja korjata asian:

Nämä tietoja vain lukevat komennot auttavat ylläpitäjääsi vahvistamaan 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