MCP-anslutningar för skräddarsydda agenter

MCP-anslutningar (Model Context Protocol) gör att din skräddarsydda agent säkert kan ansluta till externa appar. Med MCP-anslutningar kan din agent läsa information och vidta åtgärder med hjälp av förkonfigurerade anslutningar till appar som Linear, Ramp, Figma med flera – eller ansluta till vilken app som helst genom att ställa in skräddarsydda MCP-anslutningar.

Obs: MCP-anslutningar är endast tillgängliga för Business- och Enterprise-abonnemang.

MCP-anslutningar gör att skräddarsydda agenter kan interagera med externa verktyg och tjänster via Model Context Protocol. MCP-verktyg fungerar med alla utlösartyper, inklusive schemalagda körningar, utlösta körningar baserade på Notion- eller Slack-händelser samt manuella körningar från chatt eller @-omnämnanden.

Huvudfunktioner:

• Förkonfigurerade servrar: Anslut snabbt till populära appar utan ytterligare konfiguration.

• Anpassade servrar: Anslut till alla verktyg som stöder en värdbaserad MCP-server med hjälp av offentligt tillgängliga webbadresser.

• Anpassning: Verktyg för varje anslutning kan aktiveras eller inaktiveras, och du kan välja om bekräftelse ska krävas före körning, om de ska köras automatiskt eller om alla verktyg från en server ska tillåtas permanent.

Varje MCP-anslutning är unik för en enskild skräddarsydd agent och använder inloggningsuppgifterna för den person som autentiserade den. Anslutningar delas inte mellan agenter, även om de ansluter till samma tjänst.

Detta innebär:

• Om du konfigurerar en Figma-anslutning för agent A, kommer agent B att behöva en egen separat Figma-anslutning.

• Du måste logga in på varje MCP-server för varje agent du konfigurerar.

• Att återkalla en anslutning i en agent påverkar inte andra agenter.

Du kan ansluta till följande appar utan ytterligare konfiguration:

• Amplitude

• Attio

• ruta

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. Öppna din skräddarsydda agents Inställningar.

2. Gå till Verktyg och åtkomst.

3. Klicka på Lägg till anslutning → Lägg till.

4. Välj en förkonfigurerad server.

5. Följ autentiseringsanvisningarna för att ansluta ditt konto.

6. Välj vilka verktyg från servern du vill att din agent ska använda. Dessa varierar beroende på vilken server du väljer.

7. Klicka på Anslut.

För att ansluta till en MCP-server som inte finns i den förkonfigurerade listan måste en arbetsyteadministratör först aktivera detta alternativ. Det finns två separata inställningar: en för att tillåta anpassade MCP-servrar och en för att bestämma om medlemmar kan installera vilken anslutning som helst eller bara de som du godkänner.

För att tillåta anpassade MCP-servrar:

1. Som arbetsyteadministratör, gå till Inställningar → Anslutningar.

2. På fliken Hantera, aktivera Aktivera anpassade MCP-servrar.

För att välja om medlemmar kan installera vilken anslutning som helst eller bara administratörsgodkända anslutningar:

1. Som arbetsyteadministratör, gå till Inställningar → Anslutningar.

2. På fliken Hantera, leta upp avsnittet Hantera behörigheter.

3. Bredvid Begränsa vilka anslutningar medlemmar kan installera, välj ett alternativ:

   • Godkända och rekommenderade: Godkänn automatiskt alla anslutningar som rekommenderas av Notion.

   • Endast godkända: Välj manuellt vilka anslutningar medlemmar kan installera.

4. Välj Godkända anslutningar för att granska vad medlemmar kan installera.

5. Välj Lägg till godkänd anslutning och välj sedan vad du vill tillåta:

   • Anslutningar: Sök efter en anslutning via namn eller ID och lägg till den i listan över godkända.

   • Anpassad MCP-server: Lägg till en specifik URL för en anpassad MCP-server som du vill tillåta.

6. Klicka på Spara.

När detta är inställt kan vem som helst i arbetsytan ansluta till de godkända alternativen när de konfigurerar en skräddarsydd agent. De autentiserar sig med sina egna inloggningsuppgifter.

Så här lägger du till en anpassad MCP till en skräddarsydd agent:

1. Öppna din skräddarsydda agents Inställningar.

2. Gå till Verktyg och åtkomst.

3. Klicka på Lägg till anslutning → Anpassad MCP-server.

4. Du behöver ange MCP-serverns URL från verktyget eller leverantören du ansluter till (till exempel: ditt företags interna verktygsteam).

5. Ange ett visningsnamn för anslutningen (valfritt).

6. Lägg till eventuella nödvändiga autentiseringsuppgifter.

7. Klicka på Anslut.

Anpassade MCP-servrar kan ha stöd för en eller båda av följande inloggningsmetoder:

• OAuth

• Rubrikbaserad autentisering

  (till exempel API-nycklar eller bearer-tokens)

Vissa OAuth-servrar har inte stöd för dynamisk klientregistrering (DCR). Det innebär att Notion måste förregistrera en klientapplikation hos tredjepartstjänsten innan OAuth-inloggning kan fungera. Om servern du vill använda inte har stöd för DCR, kontrollera dess dokumentation för att se om du kan använda en API-nyckel eller bearer-token istället. Om inget av alternativen är tillgängligt kan MCP-servern inte användas med anpassade agenter.

Du kan bestämma hur en skräddarsydd agent ska använda en MCP-anslutning i agentens Inställningar under Verktyg och åtkomst. Expandera MCP-anslutningsposten för att se tillgängliga verktyg och avgöra hur de körs. Verktyg kan aktiveras eller inaktiveras med hjälp av den intilliggande växlingsknappen.

Läs- och skrivverktyg

• Läsverktyg (t.ex. sök, hämta, lista, visa) gör att den anpassade agenten kan hämta eller visa information utan att göra ändringar i externa system.

• Skrivverktyg (t.ex. skapa, uppdatera, ta bort, skicka, posta) gör ändringar i data i externa system. Som standard kräver dessa bekräftelseinnan agenten utför åtgärden.

Kör automatiskt eller fråga alltid

• Kör automatiskt gör att verktyget kan köras utan att kräva bekräftelse från användaren. Den här inställningen är bäst för läsverktyg (sök, hämta, lista, visa) eftersom de inte ändrar data.

• Fråga alltid kräver att en användare godkänner eller avbryter en åtgärd innan den körs. Detta är standardinställningen för skrivverktyg (skapa, uppdatera, ta bort, skicka) för att förhindra oavsiktliga ändringar.

• Tillåt alltid godkänner permanent alla verktyg från en server och tar bort framtida bekräftelseförfrågningar.

För att ta bort en MCP-anslutning

1. Öppna agentens Inställningar.

2. Gå till Verktyg och åtkomst.

3. Hitta MCP-anslutningen och klicka på frånkoppla.

4. Klicka på frånkoppla för att bekräfta.

5. Testa alltid din agent efter att du har gjort ändringar. Du kan återansluta när som helst genom att autentisera igen.

Obs: Om du tar bort en anslutning kan agenten inte längre komma åt den tjänsten och schemalagda körningar som är beroende av den servern kan misslyckas. Agentens arbetsflöden kan sluta fungera så fort du frånkopplar. Du kan återansluta när som helst genom att autentisera igen.

MCP-anslutningar respekterar de användarbehörighetsnivåer som ställts in för din skräddarsydda agent. Här är vad varje behörighetsnivå kan göra med MCP-anslutna verktyg.

Användare med Full åtkomst och Kan redigera-behörigheter till en skräddarsydd agent kan:

• Lägg till nya MCP-anslutningar till den skräddarsydda agenten.

• Chatta med agenten och använd alla anslutna verktyg, även om de inte har åtkomst till verktyget utanför agenten.

• Visa agentens aktivitetslogg och användning av MCP-verktyg.

• Ta bort befintliga MCP-anslutningar.

• Återanslut eller uppdatera autentiseringsuppgifterna för MCP-servern.

Och för MCP-anslutningar som de har konfigurerat, kan användare med Full åtkomst och Kan redigera-behörigheter:

• Konfigurera vilka verktyg som är aktiverade eller inaktiverade och ändra inställningar för verktygskörning (kör automatiskt kontra fråga alltid)

Obs: När en MCP-anslutning väl har upprättats kan endast den person som autentiserar MCP-anslutningen konfigurera och uppdatera verktygsinställningar – även om andra har Full åtkomst eller Kan redigera-behörigheter till den skräddarsydda agenten. Agenten använder den personens autentiseringsuppgifter och behörigheter vid åtkomst till den externa tjänsten.

Användare med Kan visa och interagera-behörigheter till en skräddarsydd agent kan:

• Chatta med den skräddarsydda agenten och använd alla anslutna verktyg, även om de inte har åtkomst till verktygen utanför den skräddarsydda agenten.

• Utlös både läs- och skrivåtgärder via agenten.

• Godkänn eller avbryt skrivåtgärder när bekräftelse krävs.

• Se vilka MCP-servrar som är anslutna (i inställningarna för den skräddarsydda agenten).

Användare med Kan visa och interagera-behörigheter till en skräddarsydd agent kan inte:

• Lägg till eller ta bort MCP-anslutningar.

• Ändra vilka verktyg som är aktiverade.

• Ändra inställningar för verktygskörning.

• Visa agentens fullständiga aktivitetslogg.

Obs: Skrivåtgärder (som att skapa eller uppdatera objekt) kräver som standard bekräftelse för att förhindra oavsiktliga ändringar. Användare kommer att se en uppmaning som visar exakt vilken åtgärd agenten kommer att utföra innan den körs.

Om verktyg inte visas efter anslutning:

• Uppdatera sidan för agentinställningar.

• Kontrollera att MCP-servern har autentiserats korrekt (leta efter en grön bock eller statusen ”Ansluten”).

• Verifiera att servern är online och returnerar verktygsmetadata.

• Prova att återansluta servern, eller frånkoppla och lägg till den igen.

Om körningar av skräddarsydda agenter misslyckas med MCP-fel:

• Kontrollera fliken Aktivitet för specifika felmeddelanden.

• Verifiera att din anslutning fortfarande är giltig (tokens kan ha gått ut).

• Se till att anslutningen fortfarande är aktiverad i inställningarna för den skräddarsydda agenten.

• Prova att återansluta MCP-servern för att uppdatera autentiseringsuppgifter.

• Uppdatera din skräddarsydda agents instruktioner för att nämna servern eller verktygsnamnet du vill använda. Till exempel: ”Använd Linear MCP för att hämta metadata för denna mock.”