MCP-forbindelser til Tilpassede agenter

MCP-forbindelser (Model Context Protocol) lader din Tilpassede agent sikkert oprette forbindelse til eksterne apps. Med MCP-forbindelser kan din agent læse information og udføre handlinger ved hjælp af prækonfigurerede forbindelser med apps som Linear, Ramp, Figma og flere – eller oprette forbindelse til enhver app ved at opsætte tilpassede MCP-forbindelser.

Bemærk: MCP-forbindelser er kun tilgængelige på Business- og Enterprise-abonnementer.

MCP-forbindelser lader Tilpassede agenter interagere med eksterne værktøjer og tjenester via Model Context Protocol. MCP-værktøjer fungerer med alle udløsertyper, herunder planlagte kørsel, udløste kørsel baseret på Notion- eller Slack-hændelser og manuel kørsel fra chat eller @-omtaler.

Nøglefunktioner:

• Prækonfigurerede MCP-servere: Opret hurtigt forbindelse til populære apps uden yderligere konfiguration.

• Brugerdefinerede MCP-servere: Opret forbindelse til ethvert værktøj, der understøtter en hostet MCP-server ved hjælp af offentligt tilgængelige webadresser.

• Tilpasning: Værktøjer for hver forbindelse kan slås til eller fra, og du kan vælge, om der skal kræves bekræftelse før kørsel, om de skal køre automatisk, eller om du permanent vil tillade alle værktøjer fra en MCP-server.

Hver MCP-forbindelse er unik for en enkelt tilpasset agent og benytter legitimationsoplysningerne fra den person, der godkendte den. Forbindelser deles ikke på tværs af agenter, selvom de opretter forbindelse til den samme tjeneste.

Dette betyder:

• Hvis du opsætter en Figma-forbindelse til en tilpasset agent A, skal tilpasset agent B bruge sin egen separate Figma-forbindelse.

• Du skal logge ind på hver MCP-server for hver tilpasset agent, du konfigurerer.

• Tilbagekaldelse af en forbindelse i én tilpasset agent påvirker ikke andre agenter.

Du kan oprette forbindelse til følgende apps uden yderligere konfiguration:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Merkur

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. Åbn din tilpassede agent Indstillinger.

2. Gå til Værktøjer & Adgang.

3. Klik på Tilføj forbindelse → Tilføj.

4. Vælg en prækonfigureret MCP-server.

5. Følg godkendelsesprompterne for at forbinde din konto.

6. Vælg, hvilke værktøjer fra MCP-serveren du vil have din agent til at bruge. Disse vil variere afhængigt af den MCP-server, du vælger.

7. Klik på Opret forbindelse.

For at oprette forbindelse til en MCP-server, der ikke er på listen over forudkonfigurerede, skal en arbejdsområdeadministrator først slå denne indstilling til. Der er to separate indstillinger: én til at tillade brugerdefinerede MCP-servere og én til at beslutte, om medlemmer kan installere enhver forbindelse eller kun dem, du godkender.

Sådan tillader du brugerdefinerede MCP-servere:

1. Som arbejdsområdeadministrator skal du gå til Indstillinger → Forbindelser.

2. Under fanen Administrer skal du slå til Aktivér brugerdefinerede MCP-servere.

Sådan vælger du, om medlemmer kan installere enhver forbindelse eller kun administrator-godkendte forbindelser:

1. Som arbejdsområdeadministrator skal du gå til Indstillinger → Forbindelser.

2. Under fanen Administrer skal du finde sektionen Administrer tilladelser.

3. Ud for Begræns hvilke forbindelser medlemmer kan installere skal du vælge én:

   • Godkendte og anbefalede: Godkend automatisk alle forbindelser, der anbefales af Notion.

   • Kun godkendte: Vælg manuelt hver forbindelse, som medlemmer kan installere.

4. Vælg Godkendte forbindelser for at gennemse, hvad medlemmer kan installere.

5. Vælg Tilføj godkendt forbindelse, og vælg derefter, hvad du vil tillade:

   • Forbindelser: Søg efter en forbindelse efter navn eller ID, og føj den til listen over godkendte.

   • Brugerdefineret MCP-server: Tilføj en specifik URL til en brugerdefineret MCP-server, som du vil tillade.

6. Klik på Gem.

Når dette er indstillet, kan alle i arbejdsområdet oprette forbindelse til de godkendte muligheder, når de opsætter en tilpasset agent. De logger ind med deres egne legitimationsoplysninger.

Sådan tilføjer du en brugerdefineret MCP-forbindelse til en tilpasset agent:

1. Åbn din tilpassede agent Indstillinger.

2. Gå til Værktøjer & Adgang.

3. Klik på Tilføj forbindelse → Brugerdefineret MCP-server.

4. Du skal indtaste MCP-serverens URL fra det værktøj eller den udbyder, du opretter forbindelse til (for eksempel: din virksomheds interne værktøjsteam).

5. Angiv et vist navn for forbindelsen (valgfrit).

6. Tilføj alle påkrævede godkendelsesoplysninger.

7. Klik på Opret forbindelse.

Brugerdefinerede MCP-servere understøtter muligvis en eller begge af følgende log-ind-metoder:

• OAuth

• Header-baseret godkendelse

  (for eksempel API-nøgler eller bearer-tokens)

Nogle OAuth-servere understøtter ikke dynamisk klientregistrering (DCR). Det betyder, at Notion skal forhåndsregistrere en klientapplikation hos tredjepartstjenesten, før OAuth-log-ind kan fungere. Hvis den server, du vil bruge, ikke understøtter DCR, skal du tjekke dens dokumentation for at se, om du kan bruge en API-nøgle eller et bearer-token i stedet. Hvis ingen af mulighederne er tilgængelige, kan MCP-serveren ikke bruges sammen med Tilpassede agenter.

Du kan bestemme, hvordan en tilpasset agent skal bruge en MCP-forbindelse i din agents Indstillinger under Værktøjer & Adgang. Udvid MCP-forbindelsesposten for at se tilgængelige værktøjer og bestemme, hvordan de kører. Værktøjerne kan aktiveres eller deaktiveres ved hjælp af den tilhørende til-/fra-funktion.

Læse- og skriveværktøjer

• Læseværktøjer (f.eks. søg, hent, list, vis) gør det muligt for Tilpassede agenter at hente eller se oplysninger uden at foretage ændringer i eksterne systemer.

• Skriveværktøjer (f.eks. opret, opdater, slet, send, post) foretager ændringer af data i eksterne systemer. Som standard kræver disse bekræftelsefør agenten udfører handlingen.

Kør automatisk eller spørg altid

• Kør automatisk gør det muligt for værktøjet at udføre uden at kræve bekræftelse fra brugeren. Denne indstilling er bedst til læseværktøjer (søg, hent, list, vis), da de ikke ændrer data.

• Spørg altid kræver, at en bruger godkender eller annullerer en handling, før den udføres. Dette er standardindstillingen for skriveværktøjer (opret, opdater, slet, send) for at forhindre utilsigtede ændringer.

• Tillad altid godkender permanent alle værktøjer fra en server og fjerner fremtidige bekræftelsesanmodninger.

Sådan fjerner du en MCP-forbindelse

1. Åbn din agents Indstillinger.

2. Gå til Værktøjer og adgang.

3. Find MCP-forbindelsen og klik på Afslut forbindelse.

4. Klik på Afslut forbindelse for at bekræfte.

5. Test altid din agent, efter du har foretaget ændringer. Du kan til enhver tid oprette forbindelse igen ved at godkende på ny.

Bemærk: Hvis du fjerner en forbindelse, kan agenten ikke længere få adgang til den tjeneste, og planlagte kørsler, der afhænger af den server, kan fejle. Din agents arbejdsgange kan gå i stykker, så snart du afslutter forbindelsen. Du kan til enhver tid oprette forbindelse igen ved at godkende på ny.

MCP-forbindelser respekterer de brugertilladelsesniveauer, der er indstillet på din tilpassede agent. Her er, hvad hvert tilladelsesniveau kan gøre med MCP-forbundne værktøjer.

Brugere med Fuld adgang og Kan redigere tilladelser til en tilpasset agent kan:

• Tilføj nye MCP-forbindelser til den tilpassede agent.

• Chat med agenten og brug alle forbundne værktøjer, selvom de ikke har adgang til værktøjet uden for agenten.

• Se agentens aktivitetslog og brug af MCP-værktøjer.

• Fjern eksisterende MCP-forbindelser.

• Genopret eller opdater legitimationsoplysningerne til MCP-serveren.

Og for de MCP-forbindelser, du opretter, kan brugere med Fuld adgang og Kan redigere:

• Konfigurer, hvilke værktøjer der er aktiveret eller deaktiveret, og ændr indstillinger for værktøjskørsel (kør automatisk vs. spørg altid)

Bemærk: Når en MCP-forbindelse er etableret, er det kun den person, der godkender MCP-forbindelsen, der kan konfigurere og opdatere værktøjsindstillinger - selvom andre har Fuld adgang eller Kan redigere-tilladelser til den tilpassede agent. Agenten bruger den pågældende persons legitimationsoplysninger og tilladelser, når den tilgår den eksterne tjeneste.

Brugere med tilladelsen Kan se og interagere til Tilpassede agenter kan:

• Chatte med den tilpassede agent og bruge alle forbundne værktøjer, selvom de ikke har adgang til værktøjerne uden for den tilpassede agent.

• Udløser både læse- og skrivehandlinger gennem den tilpassede agent.

• Godkend eller annuller skrivehandlinger, når bekræftelse er påkrævet.

• Se, hvilke MCP-servere der er forbundet (i indstillingerne for den tilpassede agent).

Brugere med tilladelsen 'Kan se og interagere' til en tilpasset agent kan:

• Tilføj eller fjern MCP-forbindelser.

• Ændr, hvilke værktøjer der er aktiveret.

• Ændr indstillinger for værktøjskørsel.

• Se agentens fulde aktivitetslog.

Bemærk: Skrivehandlinger (som at oprette eller opdatere elementer) kræver som standard bekræftelse for at forhindre utilsigtede ændringer. Brugere vil se en meddelelse, der viser præcis, hvilken handling agenten vil udføre, før den udføres.

Hvis værktøjer ikke vises efter oprettelse af forbindelse:

• Opdater agentsiden.

• Kontroller, at MCP-serveren blev godkendt korrekt (kig efter et grønt flueben eller status "Forbundet").

• Bekræft, at serveren er online og returnerer værktøjsmetadata.

• Prøv at genoprette forbindelsen til serveren, eller afslut forbindelsen og tilføj den igen.

Hvis tilpassede agent-kørsler fejler med MCP-fejl:

• Tjek fanen Aktivitet for specifikke fejlmeddelelser.

• Bekræft, at din forbindelse stadig er gyldig (tokens kan være udløbet).

• Sørg for, at forbindelsen stadig er aktiveret i agentens indstillinger.

• Prøv at genoprette forbindelsen til MCP-serveren for at opdatere legitimationsoplysninger.

• Opdater din tilpassede agents instruktioner til at nævne server- eller værktøjsnavnet, som du ønsker at bruge. For eksempel: “Brug Linear MCP til at hente metadata for dette mock.”