MCP Servers
Verbind externe tools en diensten met AI SmartTalk via het Model Context Protocol (MCP). MCP is een open standaard die uw AI-assistent in staat stelt om te communiceren met externe systemen via een uniforme interface.
Overzicht
De MCP Server-integratie stelt u in staat om:
- Meerdere MCP-servers gelijktijdig te verbinden
- Externe tools bloot te stellen zodat uw AI deze kan aanroepen tijdens gesprekken
- Authenticatie uit te voeren met aangepaste HTTP-headers (API-sleutels, tokens, enz.)
- Verbindingen te testen voordat u live gaat
- 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. Leer meer op modelcontextprotocol.io.
Vereisten
Voordat u begint, zorg ervoor dat u:
- Een actief AI SmartTalk-account heeft
- Toegang heeft tot een of meer MCP-compatibele servers
- De server-URL voor elke MCP-server heeft
- Alle vereiste authenticatiegegevens (API-sleutels, tokens)
Hoe MCP Werkt
- De gebruiker stelt een vraag die externe gegevens vereist
- AI SmartTalk herkent dat het een MCP-tool nodig heeft
- De juiste MCP-server wordt aangeroepen met de juiste tool
- Antwoord wordt teruggegeven en de AI formuleert een antwoord in natuurlijke taal
AI SmartTalk ondersteunt meerdere MCP-servers tegelijk. Tools van verschillende servers worden automatisch genamespaceerd om conflicten te voorkomen.
Stapsgewijze Setup
Stap 1: Toegang tot MCP-integratie
- Log in op uw AI SmartTalk-account
- Navigeer naar Administratie → Mijn Assistenten → [Uw Assistent Naam]
- Klik op Connectors in de linkerzijbalk
- Zoek MCP Servers en klik erop
Stap 2: Voeg een MCP-server toe
Klik op Server Toevoegen om het serverconfiguratieformulier te openen. Vul de volgende velden in:
| Veld | Vereist | Beschrijving |
|---|---|---|
| Servernaam | Ja | Een vriendelijke naam om deze server te identificeren (bijv. "Bedrijf CRM", "Interne Wiki") |
| Server URL | Ja | De MCP server endpoint URL (bijv. https://mcp.example.com) |
| HTTP Headers | Nee | Aangepaste headers voor authenticatie of andere vereisten |
AI SmartTalk voegt automatisch /mcp toe aan uw URL als deze daar niet al mee eindigt. Bijvoorbeeld, https://example.com wordt https://example.com/mcp. Als uw server een ander endpoint-pad gebruikt, neem dit dan op in de URL (bijv. https://example.com/api/mcp).
Stap 3: Voeg Authenticatieheaders toe (Optioneel)
Als uw MCP-server authenticatie vereist, klik dan op Headers Toevoegen om aangepaste HTTP-headers te configureren:
| Veelvoorkomende Header | Gebruik |
|---|---|
Authorization | Bearer-tokens (bijv. Bearer sk-xxx...) |
X-API-Key | API-sleutel authenticatie |
X-Auth-Token | Aangepaste token-authenticatie |
Voor elke header, geef:
- Sleutel: De headernaam (selecteer uit veelvoorkomende headers of typ een aangepaste)
- Waarde: De headerwaarde (gevoelige waarden worden automatisch gemaskeerd in de UI)
U kunt meerdere headers per server toevoegen. Headers die "secret", "password", "token" of "auth" in de sleutelnaam bevatten, worden automatisch verborgen voor de veiligheid.
Stap 4: Test de Verbinding
Voordat u opslaat, klik op Test Verbinding om te verifiëren of uw server bereikbaar is:
- AI SmartTalk stuurt een JSON-RPC-initialisatieverzoek naar uw server
- De test controleert meerdere endpoints in volgorde:
/mcp,/health, en vervolgens de basis-URL - Resultaten tonen de verbindingsstatus, responstijd en serverinformatie
| Testresultaat | Betekenis |
|---|---|
| Verbonden | Server heeft succesvol gereageerd met MCP-protocol |
| Authenticatie mislukt | Controleer uw API-sleutel of token in headers |
| Server niet gevonden | Verifieer of de URL correct is |
| Verbinding geweigerd | Server kan down zijn of firewall blokkeert toegang |
| Timeout | Server heeft te lang geduurd om te reageren (10s limiet) |
| SSL-fout | Controleer of de server een geldig SSL-certificaat heeft |
Stap 5: Sla de Configuratie op
- Klik op Toevoegen om de server aan uw lijst toe te voegen
- Herhaal Stappen 2-4 om meer MCP-servers toe te voegen indien nodig
- Klik op Opslaan Integratie om alle geconfigureerde servers te activeren
Multi-Server Ondersteuning
AI SmartTalk ondersteunt het verbinden van meerdere MCP-servers tegelijkertijd. Dit stelt u in staat om tools van verschillende bronnen te combineren:
Tool Namespacing
Tools van elke server worden automatisch voorafgegaan door de servernaam om naamconflicten te voorkomen. Bijvoorbeeld:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Dit betekent dat u veilig servers kunt verbinden die tools met dezelfde naam blootstellen.
Beheer van Meerdere Servers
Het integratiedashboard toont alle geconfigureerde servers met:
- Servernaam en URL voor gemakkelijke identificatie
- Headers tellen badge als aangepaste headers zijn geconfigureerd
- Statusindicator (Geconfigureerd / Incompleet)
- Actieknoppen: Test verbinding, Bewerken of Verwijderen van individuele servers
Tool Ontdekking
Zodra uw MCP-servers zijn verbonden, ontdekt AI SmartTalk automatisch alle beschikbare tools die door elke server worden blootgesteld. Deze tools worden onmiddellijk beschikbaar voor uw AI-assistent.
De AI-assistent zal:
- De lijst van alle beschikbare tools van alle verbonden servers zien
- Automatisch de juiste tool selecteren op basis van gebruikersvragen
- De tool aanroepen met de juiste parameters
- De respons verwerken en een antwoord in natuurlijke taal geven
U hoeft individuele tools niet handmatig te configureren of in te schakelen. Alle tools die door een verbonden MCP-server worden blootgesteld, zijn automatisch beschikbaar voor uw AI-assistent.
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 bedrijfssystemen:
- "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?"
- "Haal de laatste aandelenprijs voor AAPL op"
- "Controleer de vluchtstatus voor UA123"
Ontwikkeling Tools
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 |
| Google Drive | Bestandsbeheer | Gemeenschapsserver |
| Brave Search | Web zoeken | Gemeenschapsserver |
Vind meer: Bezoek de MCP Server Registry voor een groeiende lijst van gemeenschaps-MCP-servers.
Zelf-Hosted MCP Servers
Je kunt aangepaste MCP-servers creëren voor:
- Proprietaire interne systemen
- Aangepaste bedrijfslogica
- Veilige of privégegevens toegang
Gebruik een van de MCP SDK's (TypeScript, Python) om je eigen server te bouwen.
Beveiligingsoverwegingen
Authenticatie
Configureer authenticatie via HTTP Headers in de serverconfiguratie:
| Methode | Voorbeeld Header |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Custom Token | X-Auth-Token: your-token |
Gegevensprivacy
- MCP-verzoeken kunnen gebruikersgespreksgegevens bevatten
- Zorg ervoor dat je MCP-server gegevens verwerkt volgens je privacybeleid
- Overweeg vereisten voor gegevensresidentie
- AI SmartTalk maskeert gevoelige headerwaarden in de UI
Netwerkbeveiliging
- Gebruik HTTPS voor alle MCP-verbindingen
- Beperk de toegang tot de MCP-server tot vertrouwde IP's
- Implementeer rate limiting op je MCP-server
- Zorg ervoor dat geldige SSL-certificaten aanwezig zijn
Probleemoplossing
Verbinding Problemen
| Probleem | Oplossing |
|---|---|
| "Verbinding geweigerd" | Controleer de server-URL en poort. Zorg ervoor dat de server draait |
| "Authenticatie mislukt" (401) | Verifieer je API-sleutel of token in de headerconfiguratie |
| "Verboden" (403) | Controleer of je inloggegevens de vereiste machtigingen hebben |
| "Server niet gevonden" (404) | Verifieer de URL. AI SmartTalk voegt automatisch /mcp toe |
| "Timeout" | Controleer de netwerkverbinding en firewallregels. De test heeft een timeout van 10 seconden |
| "SSL-fout" | Zorg ervoor dat je MCP-server een geldig SSL-certificaat heeft |
| "Rate limited" (429) | Te veel verzoeken. Wacht en probeer het opnieuw, of verhoog de serverlimieten |
Hulpmiddelen Problemen
| Probleem | Oplossing |
|---|---|
| Hulpmiddelen verschijnen niet | Verifieer of de MCP-server hulpmiddelen correct blootstelt. Probeer te verversen |
| Verkeerde hulpmiddelen aangeroepen | Controleer of de servernamen beschrijvend zijn om de AI te helpen correct te kiezen |
| Hulpmiddeloproep mislukt | Controleer de serverlogs op fouten. Zorg ervoor dat het hulpmiddel het verwachte formaat retourneert |
Veelvoorkomende Fouten
- Vergeten
/mcp: AI SmartTalk voegt het automatisch toe, maar als je eindpunt anders is, voeg dan het volledige pad toe - Verkeerd headerformaat: Zorg ervoor dat de authenticatieheaders overeenkomen met wat je server verwacht
- Dubbele servernamen: Elke server moet een unieke naam hebben
Beheren van MCP Servers
| Actie | Hoe |
|---|---|
| Server toevoegen | Klik op "Server Toevoegen", vul de details in, test en sla op |
| Server bewerken | Klik op het bewerkingspictogram op de serverkaart |
| Verbinding testen | Klik op het testpictogram op de serverkaart |
| Server verwijderen | Klik op het verwijderpictogram op de serverkaart |
| Wijzigingen opslaan | Klik op "Opslaan Integratie" om alle wijzigingen vast te leggen |
Best Practices
- Gebruik beschrijvende servernamen: Helpt de AI te begrijpen welke server moet worden geraadpleegd (bijv. "Bedrijf CRM" in plaats van "Server 1")
- Test voordat je opslaat: Test altijd verbindingen om configuratieproblemen vroegtijdig op te sporen
- Begin met één server: Raak vertrouwd met één integratie voordat je er meer toevoegt
- Beveilig je inloggegevens: Gebruik speciale API-sleutels voor AI SmartTalk, geen persoonlijke tokens
- Monitor je servers: Volg welke hulpmiddelen worden aangeroepen en hun prestaties
- Houd servers up-to-date: Zorg ervoor dat je MCP-servers de laatste protocolspecificatie volgen