> 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. # Gehoste MCP-server ## Overzicht De door ElevenLabs gehoste MCP-server is een externe server voor [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) die tools voor agentbeheer beschikbaar stelt aan AI-assistenten. Na verbinding kan een assistent zoals Claude agents in je workspace maken, configureren en beheren via natuurlijke taal, zonder dat je lokaal iets hoeft te installeren of uit te voeren. De server is beschikbaar op: ``` https://api.elevenlabs.io/v1/mcp ``` Authenticatie gebruikt OAuth. Wanneer je verbinding maakt, log je in met je ElevenLabs-account en geef je de assistent beperkte toegang tot je workspace. Er worden geen API-sleutels naar de client gekopieerd. > **Note** > > Wil je je ElevenLabs-agent in plaats daarvan toegang geven tot externe MCP-servers? Bekijk de [handleiding voor MCP- integratie](/docs/nl/eleven-agents/customization/tools/mcp). ## Verbinden vanuit Claude Desktop De gehoste MCP-server is gepubliceerd in de directory van Claude Desktop. #### Open de directory Ga in Claude Desktop naar **Settings** > **Connectors** en blader door de directory. #### Voeg de ElevenLabs-connector toe Zoek naar **ElevenLabs** en selecteer **Connect**. #### Log in Voltooi de OAuth-flow met je ElevenLabs-account. Claude kan vervolgens namens jou agents in je workspace weergeven, maken en bijwerken. ## Regio's voor dataresidentie De connector in de Claude-directory en de standaardserver-URL maken verbinding met de globale omgeving. Bevindt je workspace zich in een geïsoleerde omgeving voor [dataresidentie](/docs/nl/overview/administration/data-residency), voeg dan een aangepaste connector toe die naar de URL van je regio verwijst: | Regio | MCP-server-URL | | --------- | ----------------------------------------------- | | EU | `https://api.eu.residency.elevenlabs.io/v1/mcp` | | India | `https://api.in.residency.elevenlabs.io/v1/mcp` | | Singapore | `https://api.sg.residency.elevenlabs.io/v1/mcp` | > **Warning** > > Geïsoleerde omgevingen zijn afzonderlijke workspaces met afzonderlijke accounts. Wanneer de OAuth-flow start, > log je in met je account voor die omgeving, niet met je elevenlabs.io-account. ### Een aangepaste connector toevoegen in Claude #### Open het connectormenu Selecteer in een nieuwe chat de knop **+** en vervolgens **Add connector** > **Add custom connector**. Je kunt ook connectors toevoegen via **Settings** > **Connectors**. ![Het Claude-chatinvoermenu met Add connector en Add custom connector gemarkeerd](/docs/_fern-img/1c3f441dcc1e77404715e95da3f290f61f913b65b8e3636e404b71b1f4da3797.webp) #### Voer een naam en de URL van je regio in Geef de connector een naam die de regio duidelijk maakt, bijvoorbeeld "ElevenLabs EU", en voer de URL van de MCP-server van je regio in. Selecteer **Continue**. ![Het dialoogvenster Add custom connector met de naam ElevenLabs EU en de EU-server-URL ingevuld](/docs/_fern-img/a1f5f6c459eafc68ce220f1e4d6dd1402e5e78f0d7abb87a41d1800ba6e4c355.webp) #### Behoud de gedetecteerde instellingen Claude detecteert de instellingen van de server automatisch: authenticatie is ingesteld op **Always required** en de OAuth-client gebruikt \*\*Anthropic's hosted client metadata \*\*. Laat beide zoals gedetecteerd en selecteer **Add**. ![De authenticatie-instellingen van de connector met Always required en hosted client metadata gedetecteerd](/docs/_fern-img/5f5b5941ec2d311769570cb194bbd70dc347db5bde46c812f94bae7da1c25c47.webp) #### Log in en autoriseer Voltooi de OAuth-flow met je account voor die omgeving. Kies de workspace, controleer de gevraagde machtigingen en selecteer **Authorize**. ![Het toestemmingsscherm van ElevenLabs met de workspacekiezer en gevraagde machtigingen](/docs/_fern-img/550401ee663f8b123ad61feffcc8cd6767f3f8f665419bf0a0b5cf999a6688ec.webp) > **Note** > > Andere MCP-clients werken op dezelfde manier: wijs de client naar de server-URL van je regio en voltooi de > OAuth-flow. Er is geen clientregistratie nodig voor clients die hosted client metadata > (CIMD) ondersteunen. ## Wat je kunt doen Na verbinding kan je assistent: * Nieuwe agents maken door te beschrijven wat je wilt * Elke agentinstelling bijwerken, inclusief de systeemprompt, stem, taal en eerste bericht * Je agents weergeven en hun configuraties inspecteren of vergelijken * Recente gesprekken van een agent bekijken, volledige transcripten lezen en daarin zoeken * De onderwerpen verkennen die in de gesprekken van je agents aan bod komen * Procedures, tools, MCP-servers en kennisbankdocumenten beheren * Tests maken, uitvoeren en beoordelen * Werken met branches, concepten, verkeersimplementaties en mergevoorstellen * Triage-tickets lezen en bijwerken * Agents dupliceren en verwijderen * Het verwachte LLM-gebruik en de kosten van een agent inschatten voordat je wijzigingen aanbrengt * De widgetconfiguratie en deelbare link van een agent ophalen * Spraakaudio uit tekst genereren, geleverd als een downloadlink die kort geldig is > **Warning** > > Als je een agent via de MCP-server bijwerkt, wordt de wijziging direct gepubliceerd op de branch waarop de > assistent zich richt, of standaard op `main`. De wijziging wordt niet als concept klaargezet zoals wijzigingen uit de > in-app [ElevenAgents Architect](/docs/nl/eleven-agents/operate/architect/external-assistants). ## Voorbeeldprompts Probeer na verbinding bijvoorbeeld deze prompts: * "Maak een supportagent voor mijn documentatiesite. Deze moet vriendelijk en beknopt zijn en vragen over facturering escaleren." * "Wat kost mijn checkoutagent per gesprek met Gemini 2.5 Flash in plaats van GPT-4o?" * "Dupliceer mijn productieagent, wijzig vervolgens de stem en stel het eerste bericht in op Spaans." * "Geef mijn agents weer en vertel me welke nog steeds het standaard eerste bericht gebruiken." * "Genereer een voorbeeld van de stem van mijn agent die onze nieuwe begroeting uitspreekt." ## Machtigingen Twee lagen bepalen wat een verbonden assistent kan doen: de machtigingen die je aan ElevenLabs verleent wanneer je verbinding maakt, en de toolinstellingen in je MCP-client. ### Machtigingen van ElevenLabs Wanneer je verbinding maakt, toont het OAuth-toestemmingsscherm de machtigingen die de assistent aanvraagt, zoals het lezen en schrijven van agents. De assistent kan alleen acties uitvoeren die vallen onder de machtigingen die je goedkeurt, en de toegang is beperkt tot de workspace waarmee je inlogt. Je kunt de verbinding op elk moment intrekken via je MCP-client of de instellingen van je ElevenLabs-account. ### Toolinstellingen in je MCP-client Met MCP-clients zoals Claude kun je kiezen welke tools van de connector de assistent mag gebruiken en voor welke je vóór elke aanroep goedkeuring moet geven. Open in Claude de instellingen van de ElevenLabs-connector om afzonderlijke tools in of uit te schakelen en in te stellen of een tool automatisch wordt uitgevoerd of eerst om bevestiging vraagt. Deze instellingen werken op twee niveaus. Workspacebeheerders kunnen de connector en de tools ervan voor iedereen in hun organisatie configureren, en individuele gebruikers kunnen voor zichzelf strengere instellingen toepassen. Een tool die door een beheerder is uitgeschakeld, kan niet opnieuw door een individuele gebruiker worden ingeschakeld. ## Beveiliging * Toegang wordt beperkt via OAuth-machtigingen voor lees- en schrijfbewerkingen in ElevenAgents en Text to Speech. * Het verwijderen van een agent is onomkeerbaar. Controleer toolaanroepen in je MCP-client voordat je ze goedkeurt en beperk schrijftoegang tot workspaceleden die deze nodig hebben. ## Gerelateerde bronnen #### [ElevenLabs CLI](/docs/nl/eleven-agents/operate/cli) Beheer agents als code met versiebeheer en CI/CD. #### [Agents-skill](https://github.com/elevenlabs/skills/tree/main/agents) Geef codeagents uitgebreidere ElevenLabs-workflows via de skillsrepository. #### [API-referentie](/docs/nl/api-reference/introduction) Volledige REST API voor programmatische controle van het platform.