> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Model Context Protocol

> **Verantwoordelijkheid van de gebruiker**
>
> Je bent verantwoordelijk voor de beveiliging, compliance en het gedrag van elke MCP-server van
> derden die je met je conversationele ElevenLabs-agents integreert. ElevenLabs biedt het platform
> voor integratie, maar beheert, onderschrijft of beveiligt geen externe MCP-servers.

## Overzicht

> **Note**
>
> Deze gids behandelt het geven van toegang tot externe MCP-servers aan je ElevenLabs-agents. Wil je
> het omgekeerde, namelijk je ElevenLabs-agents beheren vanuit Claude of een andere MCP-client,
> gebruik dan de [gehoste MCP-server](/docs/nl/eleven-agents/operate/hosted-mcp).

Het [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is een open standaard die bepaalt hoe applicaties context aan Large Language Models (LLM's) leveren. Zie MCP als een universele connector waarmee AI-modellen naadloos kunnen samenwerken met uiteenlopende gegevensbronnen en tools. Door servers te integreren die MCP implementeren, kun je de mogelijkheden van je conversationele ElevenLabs-agents aanzienlijk uitbreiden.

> **Warning**
>
> MCP-ondersteuning is momenteel niet beschikbaar voor gebruikers met Zero Retention Mode of voor
> gebruikers die HIPAA-compliance vereisen.

Met ElevenLabs kun je je conversationele agents verbinden met externe MCP-servers. Hiermee kunnen je agents:

* Informatie uit verschillende gegevensbronnen via de MCP-server openen en verwerken
* Gespecialiseerde tools en functionaliteiten gebruiken die de MCP-server beschikbaar stelt
* Dynamischere, beter geïnformeerde en interactievere gesprekservaringen creëren

## MCP inschakelen voor je workspace

MCP is standaard uitgeschakeld voor elke workspace. Voordat iemand MCP-servers kan toevoegen of gebruiken, moet één lid namens de workspace toestemming geven.

#### Dashboard

De toestemming wordt automatisch gegeven wanneer iemand voor het eerst probeert een MCP-server toe te voegen vanuit het [dashboard voor MCP-serverintegraties](https://elevenlabs.io/app/agents/integrations). In een dialoogvenster wordt gevraagd de voorwaarden voor Model Context Protocol Server te bekijken en te accepteren — acceptatie schakelt MCP in voor de hele workspace, zodat elk lid met toegang tot ElevenAgents vervolgens MCP-servers kan toevoegen en aan agents kan koppelen.

#### API

Je kunt MCP rechtstreeks voor de workspace in- of uitschakelen door de workspace-instelling `can_use_mcp_servers` bij te werken:

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.settings.update(can_use_mcp_servers=True)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.settings.update({ canUseMcpServers: true });
```

Als je `can_use_mcp_servers` weer op `false` zet, wordt MCP uitgeschakeld voor de workspace. Bestaande MCP-serverintegraties blijven behouden, maar agents kunnen ze niet meer gebruiken totdat de instelling opnieuw wordt ingeschakeld.

> **Note**
>
> MCP inschakelen is een instelling voor de hele workspace, niet per agent. Elk lid, of elke API-sleutel
> met de machtiging `convai_write`, kan dit in- of uitschakelen — dit is niet beperkt tot
> workspacebeheerders.

Zodra MCP is ingeschakeld voor de workspace, is elke MCP-server die je toevoegt een eigen resource: het lid dat deze maakt, kan deze afzonderlijk met andere workspaceleden delen, net als het delen van een agent of kennisbankdocument.

> **Warning**
>
> Het inschakelen van deze instelling heft de bovenstaande beperking voor Zero Retention Mode en HIPAA niet op.
> Workspaces met Zero Retention Mode of HIPAA-compliance ingeschakeld kunnen geen MCP-servers gebruiken,
> ongeacht de instelling `can_use_mcp_servers`.

## Aan de slag

> **Note**
>
> ElevenLabs ondersteunt MCP-servers met zowel SSE-transport (Server-Sent Events) als streamable HTTP-transport.

In dit voorbeeld gebruiken we [Zapier MCP](https://zapier.com/mcp), waarmee je ElevenAgents kunt verbinden met honderden tools en services.

> **Note**
>
> MCP-servers kunnen nog niet via de ElevenLabs CLI worden beheerd — gebruik het dashboard of de SDK.

#### Toevoegen via het dashboard

#### MCP-integraties openen

Ga naar het [dashboard voor MCP-serverintegraties](https://elevenlabs.io/app/agents/integrations) en klik op **Add Custom MCP Server**.

![Je eerste MCP-server maken](/docs/_fern-img/335d1d8fced3cd82eed4ed43ba0058d3a8dbc431f81cdb387bf3d5964e5ead80.webp)

#### De MCP-server configureren

Vul de volgende gegevens in:

* **Naam**: De naam van de MCP-server (bijv. "Zapier MCP Server")
* **Beschrijving**: Een beschrijving van wat de MCP-server kan doen
* **Server-URL**: De URL van de MCP-server. Als deze een geheime sleutel bevat, behandel die dan als een wachtwoord en sla deze op als workspacegeheim.
* **Secret Token** (optioneel): Waarde voor de autorisatieheader
* **HTTP Headers** (optioneel): Eventuele extra headers die de server vereist

#### De verbinding opslaan en testen

Klik op **Add Integration** om de integratie op te slaan en de verbinding te testen om beschikbare tools weer te geven.

![Voorbeeldtools van Zapier](/docs/_fern-img/7c9d83baedd0e2dc74014d4a690159333bbef0eec37c36fa9ee0fd6cd455df0e.webp)

#### De server aan een agent koppelen

De MCP-server kan nu aan je agents worden toegevoegd. MCP-ondersteuning is beschikbaar voor zowel openbare als privéagents.

![De MCP-server aan een agent toevoegen](/docs/_fern-img/b18756710b4466a5fa462080d6f3b237d84f76f898d5c94d4583f31d2fa0395b.webp)

#### Toevoegen via de API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

server = elevenlabs.conversational_ai.mcp_servers.create(
    config={
        "url": "https://mcp.zapier.com/api/mcp/...",
        "name": "Zapier MCP Server",
        "description": "An MCP server with access to Zapier's tools and services",
        "approval_policy": "always_ask",
        "transport": "SSE",
    },
)

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "agent": {"prompt": {"mcp_server_ids": [server.id]}},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

const server = await elevenlabs.conversationalAi.mcpServers.create({
  config: {
    url: "https://mcp.zapier.com/api/mcp/...",
    name: "Zapier MCP Server",
    description: "An MCP server with access to Zapier's tools and services",
    approvalPolicy: "always_ask",
    transport: "SSE",
  },
});

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    agent: { prompt: { mcpServerIds: [server.id] } },
  },
});
```

## Modi voor toolgoedkeuring

ElevenLabs biedt flexibele goedkeuringsinstellingen om te beheren hoe agents toestemming vragen om tools van MCP-servers te gebruiken. Voor maximale controle over de beveiliging kun je goedkeuringsinstellingen configureren op zowel MCP-serverniveau als individueel toolniveau.

![Instellingen voor de toolgoedkeuringsmodus](/docs/_fern-img/9f4c208459131622478de5010e2234d3af8a03dc9bc5b7ec2fcab48a7be3bde3.webp)

### Beschikbare goedkeuringsmodi

* **Always Ask (aanbevolen)**: Maximale beveiliging. De agent vraagt je toestemming vóór elk gebruik van een tool.
* **Fine-Grained Tool Approval**: Schakel tools uit en selecteer vooraf welke automatisch kunnen worden uitgevoerd en welke goedkeuring vereisen.
* **No Approval**: De assistent kan elke tool zonder goedkeuring gebruiken.

### Gedetailleerde toolcontrole

Met de modus Fine-Grained Tool Approval kun je individuele tools met verschillende goedkeuringsvereisten configureren. Zo heb je nauwkeurige controle over welke tools automatisch kunnen worden uitgevoerd en welke expliciete toestemming vereisen.

![Instellingen voor gedetailleerde toolgoedkeuring
](/docs/_fern-img/041cad753319ed92189ee8d4f70a9d3ed07177303bf71777ce36a90270a5dd24.webp)

Voor elke tool kun je instellen:

* **Automatisch goedgekeurd**: De tool wordt automatisch uitgevoerd zonder toestemming te vereisen
* **Goedkeuring vereist**: De tool vereist expliciete toestemming vóór uitvoering
* **Uitgeschakeld**: De tool is volledig uitgeschakeld en kan niet worden gebruikt

> **Tip**
>
> Gebruik Fine-Grained Tool Approval om tools met alleen-lezen en een laag risico automatisch uit te
> voeren, terwijl je goedkeuring vereist voor tools die gegevens wijzigen of gevoelige bewerkingen uitvoeren.

## Belangrijke aandachtspunten voor ElevenLabs-integratie

* **Externe servers**: Je bent verantwoordelijk voor het selecteren van de externe MCP-servers die je wilt integreren. ElevenLabs biedt de middelen om ermee te verbinden.
* **Ondersteunde functies**: ElevenLabs ondersteunt MCP-servers die via SSE-transport (Server-Sent Events) en streamable HTTP-transport communiceren voor realtime-interacties.
* **Dynamische tools**: De tools en mogelijkheden van een geïntegreerde MCP-server worden bepaald door die externe server en kunnen veranderen als de serverconfiguratie wordt bijgewerkt.

## Beveiliging en disclaimer

Het integreren van externe MCP-servers kan je agents en gegevens blootstellen aan diensten van derden. Het is cruciaal de gevolgen voor beveiliging te begrijpen.

> **Belangrijke disclaimer**
>
> Door MCP-serverintegraties in te schakelen, erken je dat hierbij gegevens kunnen worden gedeeld met
> diensten van derden die niet door ElevenLabs worden beheerd. Dit kan extra beveiligingsrisico's met
> zich meebrengen. Zorg dat je de gevolgen volledig begrijpt, controleer de beveiliging van elke
> MCP-server die je integreert en lees onze [Beveiligingsrichtlijnen voor MCP-integratie ](/docs/nl/eleven-agents/customization/tools/mcp/security) voordat je doorgaat.

Raadpleeg onze [Beveiligingsrichtlijnen voor MCP-integratie](/docs/nl/eleven-agents/customization/tools/mcp/security) voor gedetailleerde best practices.

## MCP-servers vinden of bouwen

* Gebruik openbaar beschikbare MCP-servers van vertrouwde aanbieders
* Ontwikkel je eigen MCP-server om je eigen gegevens of tools beschikbaar te stellen
* Verken de community en resources van Model Context Protocol voor voorbeelden en serverimplementaties

### Resources

* [MCP-servervoorbeelden van Anthropic](https://docs.anthropic.com/en/docs/agents-and-tools/remote-mcp-servers#remote-mcp-server-examples) - Een lijst met voorbeeldservers van Anthropic
* [Awesome Remote MCP Servers](https://github.com/jaw9c/awesome-remote-mcp-servers) - Een samengestelde opensourcelijst met externe MCP-servers
* [Remote MCP Server Directory](https://remote-mcp.com/) - Een doorzoekbare lijst met externe MCP-servers