MCP-verbindingen voor aangepaste agenten

MCP-verbindingen laten je aangepaste agent veilig verbinding maken met externe apps. Met MCP-verbindingen kan je agent informatie lezen en Actie uitvoeren met behulp van vooraf geconfigureerde verbindingen met apps zoals Linear, Ramp, Figma en meer—of verbinding maken met elke app door aangepaste MCP-verbindingen in te stellen.

Opmerking: MCP-verbindingen zijn alleen beschikbaar op Business- en Enterprise-abonnementen.

MCP-verbindingen laten aangepaste agenten communiceren met externe tools en services via het Model Context Protocol. MCP-tools werken met alle triggertypen, inclusief geplande uitvoeringen, uitvoeringen die worden geactiveerd op basis van Notion- of Slack-gebeurtenissen, en handmatige uitvoering vanuit chat of @-vermelding.

Belangrijkste functies:

• Vooraf geconfigureerde servers: Maak snel verbinding met populaire apps zonder extra configuratie.

• Aangepaste servers: Maak verbinding met elke tool die een gehoste MCP-server ondersteunt met behulp van openbaar beschikbare URL's.

• Aanpassing: Tools voor elke verbinding kunnen worden in- of uitgeschakeld, en je kunt kiezen of je bevestiging wilt vereisen voordat ze worden uitgevoerd, ze automatisch wilt uitvoeren of alle tools van een server permanent wilt toestaan.

Elke MCP-verbinding is uniek voor één aangepaste agent en gebruikt de inloggegevens van de persoon die deze heeft geauthenticeerd. Verbindingen worden niet gedeeld tussen agenten, zelfs niet als ze verbinding maken met dezelfde service.

Dit betekent:

• Als je een Figma-verbinding instelt voor agent A, heeft agent B een eigen afzonderlijke Figma-verbinding nodig.

• Je moet inloggen op elke MCP-server voor elke agent die je configureert.

• Het intrekken van een verbinding in de ene agent heeft geen invloed op andere agenten.

Je kunt zonder extra configuratie verbinding maken met de volgende apps:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. Open de Instellingen van je aangepaste agent.

2. Ga naar Tools & Toegang.

3. Klik op Koppeling toevoegen → Toevoegen.

4. Kies een vooraf geconfigureerde server.

5. Volg de authenticatieprompts om je account te koppelen.

6. Selecteer welke tools van de server je wilt dat je agent gebruikt. Deze variëren op basis van de server die je kiest.

7. Klik op Verbinden.

Om een verbinding te maken met een MCP-server die niet in de vooraf geconfigureerde lijst staat, moet een werkruimtebeheerder deze optie eerst inschakelen. Er zijn twee afzonderlijke instellingen: één om aangepaste MCP-servers toe te staan en één om te bepalen of leden elke verbinding kunnen installeren of alleen verbindingen die jij goedkeurt.

Aangepaste MCP-servers toestaan:

1. Ga als werkruimtebeheerder naar Instellingen → Verbindingen.

2. Schakel in het tabblad Beheren de optie Aangepaste MCP-servers inschakelen in.

Kiezen of leden elke verbinding kunnen installeren of alleen door de beheerder goedgekeurde verbindingen:

1. Ga als werkruimtebeheerder naar Instellingen → Verbindingen.

2. Zoek in het tabblad Beheren naar de sectie Machtigingen beheren.

3. Kies naast Beperken welke verbindingen leden kunnen installeren een optie:

   • Goedgekeurd & aanbevolen: Automatisch alle verbindingen goedkeuren die door Notion worden aanbevolen.

   • Alleen goedgekeurd: Handmatig elke verbinding selecteren die leden kunnen installeren.

4. Selecteer Goedgekeurde verbindingen om te bekijken wat leden kunnen installeren.

5. Selecteer Goedgekeurde verbinding toevoegen en kies vervolgens wat je wilt toestaan:

   • Verbindingen: Zoek naar een verbinding op naam of ID en voeg deze toe aan de lijst met goedgekeurde verbindingen.

   • Aangepaste MCP-server: Voeg een specifieke URL van een aangepaste MCP-server toe die je wilt toestaan.

6. Klik op Opslaan.

Zodra dit is ingesteld, kan iedereen in de werkruimte een verbinding maken met de goedgekeurde opties wanneer ze een Custom Agent instellen. Ze authenticeren met hun eigen inloggegevens.

Een aangepaste MCP-verbinding toevoegen aan een Custom Agent:

1. Open de Instellingen van je aangepaste agent.

2. Ga naar Tools & Toegang.

3. Klik op Verbinding toevoegen → Aangepaste MCP-server.

4. Je moet de URL van de MCP-server invoeren van de tool of provider waarmee je verbinding maakt (bijvoorbeeld: het interne toolteam van je bedrijf).

5. Geef een weergavenaam op voor de verbinding (optioneel).

6. Voeg alle vereiste authenticatiegegevens toe.

7. Klik op Verbinden.

Aangepaste MCP-servers ondersteunen mogelijk een of beide van de volgende inlogmethoden:

• OAuth

• Authenticatie op basis van headers

  (bijvoorbeeld API-sleutels of bearer-tokens)

Sommige OAuth-servers ondersteunen geen dynamic client registration (DCR). Dit betekent dat Notion een clientapplicatie vooraf moet registreren bij de externe service voordat OAuth-aanmelding kan werken. Als de server die je wilt gebruiken geen DCR ondersteunt, controleer dan de documentatie om te zien of je in plaats daarvan een API-sleutel of bearer-token kunt gebruiken. Als geen van beide opties beschikbaar is, kan de MCP-server niet worden gebruikt met aangepaste agenten.

Je kunt in de Instellingen van je aangepaste agent onder Tools & Toegang bepalen hoe een MCP-verbinding gebruikt moet worden. Vouw de MCP-verbinding uit om de beschikbare tools te zien en te bepalen hoe ze werken. Tools kunnen worden in- of uitgeschakeld met de bijbehorende schakelaar.

Leestools en schrijftools

• Leestools (bijv. zoeken, ophalen, weergeven, bekijken) stellen de aangepaste agent in staat om informatie op te halen of te bekijken zonder wijzigingen aan te brengen in externe systemen.

• Schrijftools (bijv. maken, bijwerken, verwijderen, verzenden, plaatsen) brengen wijzigingen aan in gegevens in externe systemen. Standaard vereisen deze bevestigingvoordat de agent de Actie uitvoert.

Automatisch uitvoeren of altijd vragen

• Automatisch uitvoeren staat toe dat de tool wordt uitgevoerd zonder dat bevestiging van de gebruiker vereist is. Deze instelling is het meest geschikt voor leestools (zoeken, ophalen, weergeven, bekijken), aangezien deze geen gegevens wijzigen.

• Altijd vragen vereist dat een gebruiker een Actie goedkeurt of annuleert voordat deze wordt uitgevoerd. Dit is de standaardinstelling voor schrijftools (maken, bijwerken, verwijderen, verzenden) om onbedoelde wijzigingen te voorkomen.

• Altijd toestaan keurt permanent alle tools van een server goed en verwijdert toekomstige bevestigingsvragen.

Een MCP-verbinding verwijderen

1. Open de Instellingen van je agent.

2. Ga naar Tools & Toegang.

3. Zoek de MCP-verbinding en klik op Verbinding verbreken.

4. Klik op Verbinding verbreken om te bevestigen.

5. Test je agent altijd nadat je wijzigingen hebt aangebracht. Je kunt op elk gewenst moment opnieuw verbinding maken door opnieuw te verifiëren.

Opmerking: Als je een verbinding verwijdert, heeft de agent geen toegang meer tot die service en kunnen geplande uitvoeringen die afhankelijk zijn van die server mislukken. De workflows van je agent kunnen direct na het verbreken van de verbinding stoppen met werken. Je kunt op elk gewenst moment opnieuw verbinding maken door opnieuw te verifiëren.

MCP-verbindingen respecteren de gebruikersmachtigingsniveaus die zijn ingesteld voor je Aangepaste agent. Hier zie je wat elk machtigingsniveau kan doen met MCP-verbonden tools.

Gebruikers met machtigingen voor Volledige toegang en Kan bewerken voor een aangepaste agent kunnen:

• Nieuwe MCP-verbindingen toevoegen aan de aangepaste agent.

• Chatten met de agent en alle verbonden tools gebruiken, zelfs als ze buiten de agent geen toegang hebben tot de tool.

• Het activiteitenlogboek en het gebruik van MCP-tools van de agent bekijken.

• Verwijder bestaande MCP-verbindingen.

• Verbind de MCP-server opnieuw of werk de inloggegevens bij.

En voor MCP-verbindingen die je opzet, kunnen gebruikers met de machtigingen 'Volledige toegang' en 'Kan bewerken':

• Configureren welke tools zijn in- of uitgeschakeld en instellingen voor tooluitvoering wijzigen (automatisch uitvoeren versus altijd vragen)

Opmerking: Zodra een MCP-verbinding tot stand is gebracht, kan alleen de persoon die de MCP-verbinding authenticeert de toolinstellingen configureren en bijwerken - zelfs als anderen 'Volledige toegang' of 'Kan bewerken'-machtigingen hebben voor de Aangepaste agent. De agent gebruikt de inloggegevens en machtigingen van die persoon bij het verkrijgen van toegang tot de externe service.

Gebruikers met de machtigingen 'Kan bekijken & interacteren' voor een Aangepaste agent kunnen:

• Chat met de Aangepaste agent en gebruik alle verbonden tools, zelfs als deze geen toegang hebben tot de tools buiten de Aangepaste agent.

• Activeer zowel lees- als schrijfacties via de agent.

• Schrijfacties goedkeuren of annuleren wanneer bevestiging vereist is.

• Bekijk welke MCP-servers zijn verbonden (in de instellingen van de Aangepaste agent).

Gebruikers met de machtigingen 'Kan bekijken & interacteren' kunnen niet:

• MCP-verbindingen toevoegen of verwijderen.

• Wijzig welke tools zijn ingeschakeld.

• Wijzig de instellingen voor tooluitvoering.

• Bekijk het volledige activiteitenlogboek van de agent.

Opmerking: Schrijfacties (zoals het maken of bijwerken van items) vereisen standaard bevestiging om onbedoelde wijzigingen te voorkomen. Je ziet een prompt die precies laat zien welke actie de agent zal ondernemen voordat deze wordt uitgevoerd.

Als tools niet verschijnen na het koppelen:

• Vernieuw de pagina met instellingen van de Aangepaste agent.

• Controleer of de MCP-server succesvol is geauthenticeerd (zoek naar een groen vinkje of de status “Verbonden”).

• Controleer of de server online is en tool-metadata retourneert.

• Probeer de server opnieuw te koppelen, of de koppeling te verbreken en opnieuw toe te voegen.

Als uitvoeringen van de Aangepaste agent mislukken met MCP-fouten:

• Controleer het tabblad Activiteit voor specifieke foutmeldingen.

• Controleer of je verbinding nog geldig is (tokens kunnen zijn verlopen).

• Zorg ervoor dat de verbinding nog is ingeschakeld in de instellingen van je agent.

• Probeer de MCP-server opnieuw te koppelen om de inloggegevens te vernieuwen.

• Werk de instructies van je Aangepaste agent bij om de server- of toolnaam te vermelden die je wilt gebruiken. Bijvoorbeeld: “Gebruik Linear MCP om metadata voor deze mock op te halen.”