MCP Servers

Verbind externe tools en diensten met AI SmartTalk via het Model Context Protocol (MCP). MCP is een open standaard die AI-assistenten in staat stelt om via een uniforme interface met externe systemen te communiceren.

---

Overzicht

De MCP Server-integratie stelt u in staat om:

• Verbinding te maken met elke MCP-compatibele server
• Tools bloot te stellen voor uw AI om aan te roepen tijdens gesprekken
• Toegang te krijgen tot externe gegevens via gestandaardiseerde protocollen
• Functionaliteiten uit te breiden zonder maatwerkontwikkeling

Wat is MCP? Model Context Protocol is een open standaard (ontwikkeld door Anthropic) die AI-systemen in staat stelt om veilig verbinding te maken met externe gegevensbronnen en tools.

---

Vereisten

Voordat u begint, zorg ervoor dat u:

• Een actief AI SmartTalk-account heeft
• Toegang heeft tot een MCP-server (zelf gehost of van derden)
• MCP-server-URL en authenticatiegegevens heeft
• Begrip heeft van welke tools de MCP-server blootstelt

---

Hoe MCP Werkt

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   User Query    │────▶│  AI SmartTalk   │────▶│   MCP Server    │
│                 │     │   (AI Agent)    │     │                 │
│ "Check my CRM"  │     │                 │     │  - CRM tools    │
│                 │◀────│ Processes query │◀────│  - DB queries   │
│   Response      │     │ Calls MCP tools │     │  - File access  │
└─────────────────┘     └─────────────────┘     └─────────────────┘

1. De gebruiker stelt een vraag die externe gegevens vereist
2. AI SmartTalk herkent dat er een MCP-tool nodig is
3. De MCP-server wordt aangeroepen met de juiste tool
4. De respons wordt teruggegeven en de AI formuleert een antwoord

---

Stapsgewijze Setup

Stap 1: Toegang tot MCP-integratie

1. Log in op uw AI SmartTalk-account
2. Navigeer naar Instellingen → Integraties
3. Zoek MCP-servers en klik op Server toevoegen

Stap 2: Configureer de MCP-server

Voer uw MCP-servergegevens in:

Veld	Beschrijving
Servernaam	Vriendelijke naam voor deze verbinding
Server-URL	MCP-server-eindpunt (bijv. https://mcp.example.com)
Transport	SSE (Server-Sent Events) of WebSocket
Authenticatie	API-sleutel, OAuth of geen

Stap 3: Test de Verbinding

1. Klik op Test Verbinding
2. AI SmartTalk zal de MCP-server pingen
3. Controleer of de status Verbonden aangeeft

Stap 4: Ontdek Beschikbare Hulpmiddelen

Zodra u bent verbonden, haalt AI SmartTalk de lijst met beschikbare hulpmiddelen op:

Hulpmiddel	Beschrijving	Parameters
search_crm	Zoek klantgegevens	query, limit
create_ticket	Maak een supportticket aan	titel, beschrijving
get_weather	Haal weergegevens op	locatie

Stap 5: Schakel Hulpmiddelen in voor Uw AI

1. Bekijk de ontdekte hulpmiddelen
2. Schakel in de hulpmiddelen die u wilt dat uw AI gebruikt
3. Configureer eventuele specifieke instellingen voor het hulpmiddel
4. Sla uw configuratie op

---

SmartFlow-integratie

MCP-hulpmiddelen kunnen ook worden gebruikt in SmartFlow-workflows:

MCP-hulpmiddelen gebruiken in Stromen

1. Zoek in SmartFlow naar MCP in de actiebibliotheek
2. Sleep de MCP-actie naar uw stroom
3. Selecteer de MCP-server en Hulpmiddel
4. Koppel invoerparameters vanuit uw stroomcontext
5. Gebruik de respons van het hulpmiddel in daaropvolgende acties

Voorbeeld: Klantlookup-stroom

Trigger: Chat Service (wanneer gebruiker vraagt naar account)
Acties:
  1. MCP-hulpmiddeloproep:
       Server: Bedrijf CRM
       Hulpmiddel: search_crm
       Parameters:
         query: {{user_email}}
  2. AI-respons:
       Context: CRM-lookupresultaat
       Prompt: Beantwoord de vraag van de gebruiker over het account

---

Toepassingsgevallen

Klantrelatiebeheer

Verbind uw CRM via MCP:

• "Zoek klant John Smith op"
• "Wat is de status van account #12345?"
• "Hoeveel open supporttickets hebben we?"

Interne Hulpmiddelen

Toegang tot bedrijfssystemen:

• "Controleer de voorraad voor product SKU-123"
• "Wat staat er op de agenda voor morgen?"
• "Zoek in onze interne wiki naar onboardingdocumenten"

Externe Gegevensbronnen

Haal live gegevens op:

• "Wat is het huidige weer in Parijs?"
• "Krijg de laatste aandelenprijs voor AAPL"
• "Controleer de vluchtstatus voor UA123"

Ontwikkelingshulpmiddelen

Voor technische teams:

• "Wat is de status van de laatste build?"
• "Zoek in onze GitHub-issues naar authenticatiefouten"
• "Controleer de gezondheid van productie-servers"

---

MCP Server Voorbeelden

Populaire MCP Servers

Server	Doel	Link
Filesystem	Lees/schrijf lokale bestanden	Ingebouwde referentieserver
PostgreSQL	Query databases	Gemeenschapsserver
GitHub	Repo-beheer	Gemeenschapsserver
Slack	Messaging-integratie	Gemeenschapsserver

Vind meer: Bezoek de MCP Server Registry voor gemeenschapsservers.

Zelf-gehoste MCP Servers

U kunt aangepaste MCP servers maken voor:

• Proprietaire interne systemen
• Aangepaste bedrijfslogica
• Veilige/private gegevens toegang

---

Beveiligingsoverwegingen

Authenticatie

Methode	Gebruiksscenario
API Key	Eenvoudige server-naar-server authenticatie
OAuth 2.0	Door gebruiker gedelegeerde toegang
mTLS	Omgevingen met hoge beveiliging

Gegevensprivacy

• MCP-aanvragen kunnen gebruikersgegevens bevatten
• Zorg ervoor dat uw MCP server gegevens op de juiste manier verwerkt
• Overweeg vereisten voor gegevensresidentie
• Log en controleer MCP-toolaanroepen

Netwerkbeveiliging

• Gebruik HTTPS voor alle MCP-verbindingen
• Beperk de toegang tot de MCP server tot AI SmartTalk IP's
• Implementeer rate limiting op uw MCP server

---

Probleemoplossing

Verbinding Issues

Probleem	Oplossing
"Verbinden geweigerd"	Controleer server-URL en poort
"Authenticatie mislukt"	Verifieer inloggegevens/API-sleutel
"Timeout"	Controleer netwerkconnectiviteit, firewallregels
"SSL-fout"	Zorg voor een geldig SSL-certificaat

Tool Ontdekkingsproblemen

Probleem	Oplossing
"Geen tools gevonden"	Verifieer of de MCP server tools correct blootstelt
"Tool niet beschikbaar"	Controleer of de tool is ingeschakeld aan de serverzijde
"Schema mismatch"	Update AI SmartTalk om tool-schema's te vernieuwen

Runtime Problemen

Probleem	Oplossing
"Toolaanroep mislukt"	Controleer serverlogs op fouten
"Onverwachte reactie"	Verifieer of de tool het verwachte formaat retourneert
"Rate limited"	Implementeer backoff of verhoog limieten

---

Beheren van MCP Servers

Actie	Hoe
Server toevoegen	Instellingen → Integraties → MCP → Server toevoegen
Server bewerken	Klik op de servernaam om te wijzigen
Server uitschakelen	Schakel uit zonder te verwijderen
Server verwijderen	Verwijderknop (tools worden niet meer beschikbaar)
Tools vernieuwen	Klik op Vernieuwen om tools opnieuw te ontdekken

---

Beste Praktijken

1. Begin eenvoudig: Verbind één server, test grondig, breid vervolgens uit
2. Documenteer tools: Houd interne documentatie bij over wat elke tool doet
3. Monitor gebruik: Volg welke tools worden aangeroepen en de prestaties
4. Verwerk fouten elegant: AI moet toolfouten elegant afhandelen
5. Beveilig inloggegevens: Gebruik omgevingsvariabelen, geen hardcoded sleutels
6. Versie uw servers: MCP servers moeten worden geversioneerd voor stabiliteit

---

Bronnen

MCP Documentatie

• MCP Specificatie
• MCP GitHub
• MCP Servers Bouwen

AI SmartTalk Bronnen

• SmartFlow Acties
• API Integratie

---

Gerelateerde Documentatie

• Integraties Overzicht
• SmartFlow Inleiding
• API Documentatie