MCP-tilkoblinger for Skreddersydde agenter

I dette hjelpedokumentet

Koble dine Skreddersydde agenter til eksterne systemer og datakilder med MCP 📶

Hopp til vanlige spørsmål

MCP-tilkoblinger (Model Context Protocol) lar din skreddersydd agent koble seg sikkert til eksterne apper. Med MCP-tilkoblinger kan agenten din lese informasjon og utføre handlinger ved hjelp av forhåndskonfigurerte tilkoblinger med apper som Linear, Ramp, Figma og mer – eller koble til hvilken som helst app ved å sette opp skreddersydde MCP-tilkoblinger.

Merk: MCP-tilkoblinger er kun tilgjengelige for Business- og Enterprise-abonnementer.

MCP-tilkoblinger lar Skreddersydde agenter samhandle med eksterne verktøy og tjenester gjennom Model Context Protocol. MCP-verktøy fungerer med alle utløsertyper, inkludert planlagte kjøringer, utløste kjøringer basert på Notion- eller Slack-hendelser, og manuelle kjøringer fra chat eller @omtaler.

Nøkkelfunksjoner:

  • Forhåndskonfigurerte servere: Koble raskt til populære apper uten ytterligere konfigurasjon.

  • Egendefinerte servere: Koble til ethvert verktøy som støtter en hostet MCP-server ved hjelp av offentlig tilgjengelige URL-er.

  • Tilpasning: Verktøy for hver tilkobling kan slås av eller på, og du kan velge om du vil kreve bekreftelse før kjøring, kjøre automatisk, eller permanent tillate alle verktøy fra en server.

Hver MCP-tilkobling er unik for én enkelt Skreddersydd agent og bruker legitimasjonen til personen som autentiserte den. Tilkoblinger deles ikke på tvers av agenter, selv om de kobler til samme tjeneste.

Dette betyr:

  • Hvis du setter opp en Figma-tilkobling for agent A, må agent B ha sin egen separate Figma-tilkobling.

  • Du må logge inn på hver MCP-server for hver agent du konfigurerer.

  • Å tilbakekalle en tilkobling i én agent påvirker ikke andre agenter.

Du kan koble til følgende apper uten ytterligere konfigurasjon:

  1. Åpne Innstillinger for din Skreddersydd agent.

  2. Gå til Verktøy og tilgang.

  3. Klikk på Legg til tilkoblingLegg til.

  4. Velg en forhåndskonfigurert server.

  5. Følg instruksjonene for autentisering for å koble til kontoen din.

  6. Velg hvilke verktøy fra serveren du vil at agenten din skal bruke. Disse vil variere basert på hvilken server du velger.

  7. Klikk på Koble til.

For å koble til en MCP-server som ikke er i den forhåndskonfigurerte listen, må en arbeidsområdeadministrator først slå på dette alternativet. Det er to separate innstillinger: én for å tillate egendefinerte MCP-servere, og én for å bestemme om medlemmer kan installere hvilken som helst tilkobling eller bare de du godkjenner.

Slik tillater du egendefinerte MCP-servere:

  1. Som arbeidsområdeadministrator går du til InnstillingerTilkoblinger.

  2. I fanen Administrer slår du på Aktiver egendefinerte MCP-servere.

Slik velger du om medlemmer kan installere hvilken som helst tilkobling eller bare administratorgodkjente tilkoblinger:

  1. Som arbeidsområdeadministrator går du til InnstillingerTilkoblinger.

  2. I fanen Administrer finner du delen Administrer tilgang.

  3. Ved siden av Begrens hvilke tilkoblinger medlemmer kan installere, velger du ett alternativ:

    • Godkjent og anbefalt: Godkjenn automatisk alle tilkoblinger som anbefales av Notion.

    • Kun godkjent: Velg manuelt hver tilkobling som medlemmer kan installere.

  4. Velg Godkjente tilkoblinger for å se gjennom hva medlemmer kan installere.

  5. Velg Legg til godkjent tilkobling, og velg deretter hva du vil tillate:

    • Tilkoblinger: Søk etter en tilkobling etter navn eller ID og legg den til i listen over godkjente.

    • Egendefinert MCP-server: Legg til en spesifikk URL for en egendefinert MCP-server du vil tillate.

  6. Klikk på Lagre.

Når dette er angitt, kan alle i arbeidsområdet koble til de godkjente alternativene når de setter opp en skreddersydd agent. De vil autentisere med sine egne legitimasjoner.

Slik legger du til en skreddersydd MCP-tilkobling for en skreddersydd agent:

  1. Åpne Innstillinger for din skreddersydd agent.

  2. Gå til Verktøy og tilgang.

  3. Klikk på Legg til tilkoblingEgendefinert MCP-server.

  4. Du må skrive inn MCP-serverens URL fra verktøyet eller leverandøren du kobler til (for eksempel: bedriftens interne verktøyteam).

  5. Oppgi et visningsnavn for tilkoblingen (valgfritt).

  6. Legg til eventuelle påkrevde autentiseringsdetaljer.

  7. Klikk på Koble til.

Autentisering for skreddersydde MCP-tilkoblinger

Egendefinerte MCP-tjenere kan støtte én eller begge av følgende påloggingsmetoder:

  • OAuth

  • Hodebasert autentisering

    (for eksempel API-nøkler eller bearer-tokener)

Noen OAuth-tjenere støtter ikke dynamisk klientregistrering (DCR). Dette betyr at Notion må forhåndsregistrere en klientapplikasjon hos tredjepartstjenesten før OAuth-pålogging kan fungere. Hvis tjeneren du vil bruke ikke støtter DCR, sjekk dokumentasjonen for å se om du kan bruke en API-nøkkel eller et bearer-token i stedet. Hvis ingen av alternativene er tilgjengelige, kan ikke MCP-serveren brukes med skreddersydde agenter.

Du kan bestemme hvordan en skreddersydd agent skal bruke en MCP-tilkobling i agentens Innstillinger under Verktøy og tilgang. Utvid MCP-tilkoblingsoppføringen for å se tilgjengelige verktøy og bestemme hvordan de kjøres. Verktøy kan aktiveres eller deaktiveres ved hjelp av veksleknappen ved siden av.

Les og skriv-verktøy

  • Read tools (f.eks. søk, hent, liste, vis) lar den skreddersydde agenten hente eller se informasjon uten å gjøre endringer i eksterne systemer.

  • Skriveverktøy (f.eks. opprett, oppdater, /slett, send, innlegg) gjør endringer i data i eksterne systemer. Som standard krever bekreftelse før agenten utfører handlingen.

Kjør automatisk eller spør alltid

  • Kjør automatisk lar verktøyet kjøre uten at det kreves bekreftelse fra brukeren. Denne innstillingen er best for leseverktøy (søk, hent, liste, vis) siden de ikke endrer data.

  • Spør alltid krever at en bruker godkjenner eller avbryter en handling før den utføres. Dette er standardinnstillingen for skriveverktøy (opprett, oppdater, slett, send) for å forhindre utilsiktede endringer.

  • Tillat alltid godkjenner permanent alle verktøy fra en server og fjerner fremtidige bekreftelsesforespørsler.

Slik fjerner du en MCP-tilkobling

  1. Åpne agentens Innstillinger.

  2. Gå til Verktøy og tilgang.

  3. Finn MCP-tilkoblingen og klikk på Koble fra.

  4. Klikk på Koble fra for å bekrefte.

  5. Test alltid agenten etter at du har gjort endringer. Du kan koble til igjen når som helst ved å autentisere på nytt.

Merk: Hvis du fjerner en tilkobling, kan ikke agenten lenger få tilgang til den tjenesten, og planlagte kjøringer som avhenger av den serveren, kan mislykkes. Agentens arbeidsflyter kan slutte å fungere så snart du kobler fra. Du kan koble til igjen når som helst ved å autentisere på nytt.

MCP-tilkoblinger respekterer brukertilgangsnivåene som er satt for din Skreddersydde agent. Her er hva hvert tilgangsnivå kan gjøre med MCP-tilkoblede verktøy.

Brukere med Full tilgang og Kan redigere-tillatelser til en Skreddersydd agent kan:

  • Legg til nye MCP-tilkoblinger til den Skreddersydde agenten.

  • Chatt med agenten og bruk alle tilkoblede verktøy, selv om de ikke har tilgang til verktøyet utenfor agenten.

  • Se agentens aktivitetslogg og bruk av MCP-verktøy.

  • Fjern eksisterende MCP-tilkoblinger.

  • Koble til på nytt eller oppdater legitimasjonen for MCP-serveren.

Og for MCP-tilkoblinger de setter opp, kan brukere med Full tilgang og Kan redigere-tillatelser:

  • Konfigurere hvilke verktøy som er aktivert eller deaktivert, og endre innstillinger for verktøykjøring (kjøring automatisk kontra alltid spør)

Merk: Når en MCP-tilkobling er opprettet, er det bare personen som autentiserer MCP-tilkoblingen som kan konfigurere og oppdatere verktøyinnstillinger – selv om andre har Full tilgang og Kan redigere-tillatelser til den Skreddersydde agenten. Agenten bruker denne personens legitimasjon og tilgang når den får tilgang til den eksterne tjenesten.

Brukere med Kan se og samhandle-tillatelser til en Skreddersydd agent kan:

  • Chat med Skreddersydd agent og bruk alle tilkoblede verktøy, selv om de ikke har tilgang til verktøyene utenfor Skreddersydd agent.

  • Utløs både lese- og skrivehandlinger gjennom agenten.

  • Godkjenn eller avbryt skrivehandlinger når bekreftelse er påkrevd.

  • Se hvilke MCP-servere som er tilkoblet (i innstillingene for den Skreddersydde agenten).

Brukere med Kan se og samhandle-tillatelser kan ikke:

  • Legg til eller fjern MCP-tilkoblinger.

  • Endre hvilke verktøy som er aktivert.

  • Endre innstillinger for verktøykjøring.

  • Se agentens fullstendige aktivitetslogg.

Merk: Skrivehandlinger (som å opprette eller oppdatere elementer) krever som standard bekreftelse for å forhindre utilsiktede endringer. Brukere vil se en melding som viser nøyaktig hvilken handling agenten vil utføre før den kjøres.

Hvis verktøy ikke vises etter tilkobling:

  • Oppdater siden for agentinnstillinger.

  • Kontroller at MCP-serveren ble autentisert (se etter et grønt merke eller «Tilkoblet»-status).

  • Bekreft at serveren er på nett og returnerer verktøymetadata.

  • Prøv å koble til serveren på nytt, eller koble fra og legg den til igjen.

Hvis kjøring av Skreddersydd agent feiler med MCP-feil:

  • Sjekk Aktivitet fane for spesifikke feilmeldinger.

  • Bekreft at tilkoblingen din fortsatt er gyldig (tokener kan ha utløpt).

  • Sørg for at tilkoblingen fortsatt er aktivert i agentens innstillinger.

  • Prøv å koble til MCP-serveren på nytt for å oppdatere legitimasjon.

  • Oppdater instruksjonene for din Skreddersydd agent slik at de nevner serveren eller verktøynavnet du ønsker å bruke. For eksempel: «Bruk Linear MCP for å hente metadata for denne mock-en.»


Vanlige spørsmål

Kan jeg dele MCP-tilkoblinger på tvers av flere Skreddersydde agenter?

Nei. Hver Skreddersydd agent krever sin egen tilkobling til hver MCP-server. Dette holder sikkerhetsmodellen enkel og sikrer at hver agent har passende tilgangskontroller.

Kan jeg koble til flere kontoer for samme tjeneste?

Ikke innenfor en enkelt agent. Hvis du trenger å bruke flere kontoer, må du opprette separate Skreddersydde agenter, hver med sin egen tilkobling.

Hva skjer hvis MCP-serveren er nede eller utilgjengelig?

Hvis MCP-serveren er utilgjengelig:

  • Agenten vil rapportere en feil i kjøringsloggen.

  • Verktøy fra den serveren vil feile, men vil ikke krasje hele agenten.

  • Sjekk fanen Aktivitet for spesifikke feilmeldinger.

Hva er forskjellen på MCP-servere og innebygde Notion-integrasjoner?

Innebygde integrasjoner(som Slack) er bygget direkte inn i Notion og må først godkjennes av en arbeidsområdeeier (Eier). De tilbyr lese- og skrivetilgang samt utløserfunksjonalitet.

MCP-serverefølger en åpen protokoll og kan legges til av ethvert medlem av arbeidsområdet. De har lese- og skrivetilgang, men ingen utløserfunksjonalitet.

Begge fungerer med Skreddersydde agenter, men MCP-servere tilbyr mer fleksibilitet for tilkobling av egendefinerte verktøy og tjenester.


Gi tilbakemelding

Var denne ressursen nyttig?


Powered by Fruition