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 te communiceren met externe systemen via een uniforme interface.

---

Overzicht

De MCP Server-integratie stelt je in staat om:

• Verbinding te maken met elke MCP-compatibele server
• Tools bloot te stellen voor je AI om aan te roepen tijdens gesprekken
• Toegang te krijgen tot externe gegevens via gestandaardiseerde protocollen
• Mogelijkheden 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 je begint, zorg ervoor dat je:

• Een actief AI SmartTalk-account hebt
• Toegang hebt tot een MCP-server (zelf-gehost of van derden)
• MCP-server-URL en authenticatiegegevens hebt
• Begrip hebt 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 het een MCP-tool nodig heeft
3. De MCP-server wordt aangeroepen met de juiste tool
4. Het antwoord 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 Tools

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

Tool	Beschrijving	Parameters
search_crm	Zoek klantgegevens	query, limit
create_ticket	Maak een supportticket aan	title, description
get_weather	Haal weergegevens op	location

Stap 5: Schakel Tools in voor Uw AI

1. Bekijk de ontdekte tools
2. Schakel in tools die u wilt dat uw AI gebruikt
3. Configureer eventuele tool-specifieke instellingen
4. Sla uw configuratie op

---

SmartFlow-integratie

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

MCP-tools gebruiken in Stromen

1. Zoek in SmartFlow naar MCP in de actiebibliotheek
2. Sleep de MCP-actie in uw stroom
3. Selecteer de MCP-server en Tool
4. Koppel invoerparameters vanuit uw stroomcontext
5. Gebruik de toolrespons in volgende acties

Voorbeeld: Klantlookup-stroom

Trigger: Chat Service (wanneer gebruiker vraagt naar account)
Acties:
  1. MCP Tool Aanroep:
       Server: Bedrijf CRM
       Tool: search_crm
       Parameters:
         query: {{user_email}}
  2. AI Respons:
       Context: CRM lookup resultaat
       Prompt: Beantwoord de vraag van de gebruiker over het account

---

Gebruikscases

Klantrelatiebeheer

Verbind uw CRM via MCP:

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

Interne Tools

Toegang tot bedrijfsystemen:

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

Externe Gegevensbronnen

Haal live gegevens op:

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

Ontwikkelingstools

Voor technische teams:

• "Wat is de status van de laatste build?"
• "Zoek 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-Hosted MCP Servers

U kunt aangepaste MCP servers maken voor:

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

---

Beveiligingsoverwegingen

Authenticatie

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

Gegevensprivacy

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

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 Problemen

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

Tool Ontdekkingsproblemen

Probleem	Oplossing
"Geen tools gevonden"	Controleer 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
"Tool-aanroep 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 beschikbaar)
Tools vernieuwen	Klik op Vernieuwen om tools opnieuw te ontdekken

---

Best Practices

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 versiebeheer voor stabiliteit

---

Bronnen

MCP Documentatie

• MCP Specificatie
• MCP GitHub
• MCP Servers Bouwen

AI SmartTalk Bronnen

• SmartFlow Acties
• API Integratie

---

Gerelateerde Documentatie

• Integraties Overzicht
• SmartFlow Introductie
• API Documentatie