MCP-yhteydet mukautetuille palvelijoille

MCP-yhteydet (Model Context Protocol) mahdollistavat mukautetun palvelijan turvallisen yhdistämisen ulkoisiin sovelluksiin. MCP-yhteyksien avulla palvelijasi voi lukea tietoja ja suorittaa toimintoja käyttämällä esikonfiguroituja yhteyksiä sovelluksiin, kuten Linear, Ramp, Figma ja muihin – tai yhdistää mihin tahansa sovellukseen määrittämällä mukautettuja MCP-yhteyksiä.

Huomio: MCP-yhteydet ovat käytettävissä vain Business- ja Enterprise-sopimuksissa.

MCP-yhteydet mahdollistavat mukautettujen palvelijoiden vuorovaikutuksen ulkoisten työkalujen ja palveluiden kanssa Model Context Protocol -protokollan kautta. MCP-työkalut toimivat kaikilla käynnistintyypeillä, mukaan lukien ajoitetut suoritukset, Notion- tai Slack-tapahtumiin perustuvat käynnistykset sekä manuaaliset suoritukset keskustelusta tai @-mainituksista.

Tärkeimmät ominaisuudet:

• Esikonfiguroidut palvelimet: Yhdistä nopeasti suosittuihin sovelluksiin ilman lisämäärityksiä.

• Mukautetut palvelimet: Yhdistä mihin tahansa työkaluun, joka tukee isännöityä MCP-palvelinta julkisesti saatavilla olevien URL-osoitteiden avulla.

• Mukauttaminen: Kunkin yhteyden työkalut voidaan ottaa käyttöön tai poistaa käytöstä, ja voit valita, vaaditaanko vahvistus ennen suorittamista, suoritetaanko ne automaattisesti vai sallitaanko kaikki palvelimen työkalut pysyvästi.

Jokainen MCP-yhteys on yksilöllinen yhdelle mukautetulle palvelijalle, ja se käyttää sen henkilön tunnistetietoja, joka on todentanut yhteyden. Yhteyksiä ei jaeta palvelijoiden kesken, vaikka ne muodostaisivat yhteyden samaan palveluun.

Tämä tarkoittaa seuraavaa:

• Jos määrität Figma-yhteyden palvelijalle A, palvelija B tarvitsee oman erillisen Figma-yhteyden.

• Sinun on kirjauduttava jokaiseen MCP-palvelimeen jokaisen määrittämäsi palvelijan kohdalla.

• Yhteyden peruuttaminen yhdessä palvelijassa ei vaikuta muihin palvelijoihin.

Voit muodostaa yhteyden seuraaviin sovelluksiin ilman lisämäärityksiä:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. Avaa mukautetun agenttisi Asetukset.

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

3. Napsauta Lisää yhteys → Lisää.

4. Valitse valmiiksi määritetty palvelin.

5. Seuraa todennuskehotteita tilisi yhdistämiseksi.

6. Valitse, mitä palvelimen työkaluja haluat agenttisi käyttävän. Nämä vaihtelevat valitsemasi palvelimen mukaan.

7. Valitse Yhdistä.

Jotta voit muodostaa yhteyden MCP-palvelimeen, joka ei ole valmiiksi määritettyjen listassa, työtilan ylläpitäjän on ensin otettava tämä vaihtoehto käyttöön. Asetuksia on kaksi erillistä: yksi mukautettujen MCP-palvelimien sallimiseksi ja toinen sen päättämiseksi, voivatko jäsenet asentaa minkä tahansa yhteyden vai vain hyväksymäsi yhteydet.

Mukautettujen MCP-palvelinten salliminen:

1. Siirry työtilan ylläpitäjänä kohtaan Asetukset → Yhteydet.

2. Kytke Hallinta-välilehdellä päälle Ota käyttöön mukautetut MCP-palvelimet.

Sen valitseminen, voivatko jäsenet asentaa minkä tahansa yhteyden vai vain ylläpitäjän hyväksymät yhteydet:

1. Siirry työtilan ylläpitäjänä kohtaan Asetukset → Yhteydet.

2. Etsi Hallinta-välilehdeltä Käyttöoikeuksien hallinta -osio.

3. Valitse kohdan Rajoita jäsenten asennettavissa olevia yhteyksiä vierestä jokin seuraavista:

   • Hyväksytyt ja suositellut: Hyväksy automaattisesti kaikki Notionin suosittelemat yhteydet.

   • Vain hyväksytyt: Valitse manuaalisesti jokainen yhteys, jonka jäsenet voivat asentaa.

4. Valitse Hyväksytyt yhteydet tarkistaaksesi, mitä jäsenet voivat asentaa.

5. Valitse Lisää hyväksytty yhteys ja valitse sitten, mitä haluat sallia:

   • Yhteydet: Etsi yhteys nimen tai tunnisteen perusteella ja lisää se hyväksyttyjen listaan.

   • Mukautettu MCP-palvelin: Lisää tietty mukautettu MCP-palvelimen URL-osoite, jonka haluat sallia.

6. Napsauta Tallenna.

Kun tämä on määritetty, kuka tahansa työtilassa voi muodostaa yhteyden hyväksyttyihin vaihtoehtoihin määrittäessään mukautettua agenttia. He todennustautuvat omilla kirjautumistiedoillaan.

Mukautetun MCP-palvelimen lisääminen mukautettuun agenttiin:

1. Avaa mukautetun agenttisi Asetukset.

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

3. Napsauta Lisää yhteys → Mukautettu MCP-palvelin.

4. Sinun on syötettävä sen työkalun tai palveluntarjoajan MCP-palvelimen URL-osoite, johon olet muodostamassa yhteyttä (esimerkiksi yrityksesi sisäinen työkalutiimi).

5. Anna yhteydelle näyttönimi (valinnainen).

6. Lisää tarvittavat todennustiedot.

7. Valitse Yhdistä.

Mukautetut MCP-palvelimet voivat tukea yhtä tai molempia seuraavista kirjautumistavoista:

• OAuth

• Otsikkopohjainen todennus

  (esimerkiksi API-avaimet tai bearer-tunnisteet)

Jotkin OAuth-palvelimet eivät tue dynaamista asiakasrekisteröintiä (DCR). Tämä tarkoittaa, että Notionin on rekisteröitävä asiakassovellus etukäteen kolmannen osapuolen palveluun, ennen kuin OAuth-kirjautuminen voi toimia. Jos palvelin, jota haluat käyttää, ei tue DCR-toimintoa, tarkista sen dokumentaatiosta, voitko käyttää sen sijaan API-avainta tai bearer-tunnistetta. Jos kumpikaan vaihtoehto ei ole käytettävissä, MCP-palvelinta ei voi käyttää mukautettujen agenttien kanssa.

Voit päättää, miten mukautettu agentti käyttää MCP-yhteyttä agenttisi asetuksissa kohdassa Työkalut ja käyttöoikeudet. Laajenna MCP-yhteyden merkintä nähdäksesi käytettävissä olevat työkalut ja määrittääksesi, miten ne toimivat. Työkalut voidaan ottaa käyttöön tai poistaa käytöstä viereisellä valintakytkimellä.

Luku- ja kirjoitustyökalut

• Luku-työkalut (esim. haku, nouto, luettelo, näkymä) sallivat mukautetun agentin hakea tai tarkastella tietoja tekemättä muutoksia ulkoisiin järjestelmiin.

• Kirjoitustyökalut (esim. luonti, päivitys, poisto, lähetys, julkaisu) tekevät muutoksia ulkoisten järjestelmien tietoihin. Oletusarvoisesti nämä vaativat vahvistuksenennen kuin palvelija suorittaa toiminnon.

Suorita automaattisesti tai kysy aina

• Suorita automaattisesti sallii työkalun suorittamisen ilman käyttäjän vahvistusta. Tämä asetus on paras luku-työkaluille (haku, nouto, luettelo, näkymä), koska ne eivät muokkaa tietoja.

• Kysy aina vaatii käyttäjää hyväksymään tai peruuttamaan toiminnon ennen sen suorittamista. Tämä on kirjoitus-työkalujen (luonti, päivitys, poisto, lähetys) oletusasetus tahattomien muutosten estämiseksi.

• Salli aina hyväksyy pysyvästi kaikki palvelimen työkalut ja poistaa tulevat vahvistuskehotteet.

MCP-yhteyden poistaminen

1. Avaa palvelijasi asetukset.

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

3. Etsi MCP-yhteys ja napsauta Katkaise yhteys.

4. Vahvista napsauttamalla Katkaise yhteys.

5. Testaa palvelijaasi aina muutosten tekemisen jälkeen. Voit muodostaa yhteyden uudelleen milloin tahansa tunnistautumalla uudelleen.

Huomio: Jos poistat yhteyden, palvelija ei voi enää käyttää kyseistä palvelua, ja kyseisestä palvelimesta riippuvat ajoitetut suoritukset saattavat epäonnistua. Palvelijasi työnkulut saattavat rikkoutua heti, kun katkaiset yhteyden. Voit muodostaa yhteyden uudelleen milloin tahansa tunnistautumalla uudelleen.

MCP-yhteydet noudattavat mukautetun palvelijasi määritettyjä käyttäjän käyttöoikeustasoja. Tässä on, mitä kukin käyttöoikeustaso voi tehdä MCP-yhteyksien kautta käytettävillä työkaluilla.

Käyttäjät, joilla on mukautetun palvelijan täydet käyttöoikeudet ja muokkausoikeudet, voivat:

• Lisää uusia MCP-yhteyksiä mukautettuun palvelijaan.

• Keskustele palvelijan kanssa ja käytä kaikkia yhdistettyjä työkaluja, vaikka sinulla ei olisi käyttöoikeutta työkaluun palvelijan ulkopuolella.

• Tarkastele palvelijan toimintalokia ja MCP-työkalujen käyttöä.

• Poista olemassa olevat MCP-yhteydet.

• Yhdistä uudelleen tai päivitä MCP-palvelimen tunnistetiedot.

Ja MCP-yhteyksien osalta käyttäjät, joilla on Täydet käyttöoikeudet ja muokkausoikeudet, voivat:

• Määritä, mitkä työkalut ovat käytössä tai poissa käytöstä, ja muuta työkalujen suoritusasetuksia (suorita automaattisesti vs. kysy aina)

Huomio: Kun MCP-yhteys on muodostettu, vain MCP-yhteyden todentava henkilö voi määrittää ja päivittää työkaluasetuksia – vaikka muilla olisi Täydet käyttöoikeudet tai muokkausoikeudet mukautettuun palvelijaan. Palvelija käyttää kyseisen henkilön tunnistetietoja ja käyttöoikeuksia käyttäessään ulkoista palvelua.

Käyttäjät, joilla on Tarkastelu sallittu- ja vuorovaikutusoikeudet mukautettuun palvelijaan, voivat:

• Keskustele mukautetun palvelijan kanssa ja käytä kaikkia yhdistettyjä työkaluja, vaikka sinulla ei olisi käyttöoikeutta työkaluihin mukautetun palvelijan ulkopuolella.

• Käynnistä sekä luku- että kirjoitustoimintoja palvelijan kautta.

• Hyväksy tai peruuta kirjoitustoimintoja, kun vahvistus vaaditaan.

• Tarkastele, mitkä MCP-palvelimet on yhdistetty (mukautetun palvelijan asetuksissa).

Käyttäjät, joilla on Tarkastelu sallittu- ja vuorovaikutusoikeudet, eivät voi:

• Lisää tai poista MCP-yhteyksiä.

• Muuta käytössä olevia työkaluja.

• Muokkaa työkalujen suoritusasetuksia.

• Tarkastele palvelijan koko toimintalokia.

Huomio: Kirjoitustoiminnot (kuten kohteiden luominen tai päivittäminen) vaativat oletusarvoisesti vahvistuksen tahattomien muutosten estämiseksi. Käyttäjille näytetään kehote, joka osoittaa tarkalleen, minkä toiminnon palvelija suorittaa ennen sen toteuttamista.

Jos työkaluja ei näy yhdistämisen jälkeen:

• Päivitä palvelijan asetussivu.

• Tarkista, että MCP-palvelin on todennettu onnistuneesti (etsi vihreää valintamerkkiä tai ”Yhdistetty”-tilaa).

• Varmista, että palvelin on verkossa ja palauttaa työkalun metatiedot.

• Kokeile yhdistää palvelin uudelleen tai katkaista yhteys ja lisätä se uudelleen.

Jos mukautetun palvelijan suoritukset epäonnistuvat MCP-virheiden vuoksi:

• Tarkista Aktiviteetti-välilehti tarkkojen virheilmoitusten varalta.

• Varmista, että yhteytesi on edelleen voimassa (tunnisteet ovat saattaneet vanhentua).

• Varmista, että yhteys on edelleen käytössä palvelijan asetuksissa.

• Kokeile yhdistää MCP-palvelin uudelleen tunnistetietojen päivittämiseksi.

• Päivitä mukautetun palvelijan ohjeet mainitsemaan palvelimen tai työkalun nimi, jota haluat käyttää. Esimerkiksi: ”Käytä Linear MCP:tä tämän mock-tiedon metatietojen hakemiseen.”