> 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

> **Responsabilidad del usuario**
>
> Eres responsable de la seguridad, el cumplimiento normativo y el comportamiento de cualquier servidor MCP de terceros que
> integres con tus agentes conversacionales de ElevenLabs. ElevenLabs proporciona la plataforma para la
> integración, pero no gestiona, respalda ni protege servidores MCP externos.

## Descripción general

> **Note**
>
> Esta guía explica cómo dar a tus agentes de ElevenLabs acceso a servidores MCP externos. Si quieres hacer lo
> contrario, gestionar tus agentes de ElevenLabs desde Claude u otro cliente MCP, usa el [servidor MCP alojado](/docs/es/eleven-agents/operate/hosted-mcp).

El [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) es un estándar abierto que define cómo las aplicaciones proporcionan contexto a los modelos de lenguaje grandes (LLM). Considera MCP como un conector universal que permite a los modelos de IA interactuar sin problemas con diversas fuentes de datos y herramientas. Al integrar servidores que implementan MCP, puedes ampliar significativamente las capacidades de tus agentes conversacionales de ElevenLabs.

> **Warning**
>
> La compatibilidad con MCP no está disponible actualmente para usuarios con el modo de retención cero ni para quienes requieren
> cumplimiento de HIPAA.

ElevenLabs te permite conectar tus agentes conversacionales a servidores MCP externos. Esto permite a tus agentes:

* Acceder y procesar información de varias fuentes de datos mediante el servidor MCP
* Utilizar herramientas y funcionalidades especializadas expuestas por el servidor MCP
* Crear experiencias conversacionales más dinámicas, informadas e interactivas

## Activa MCP para tu espacio de trabajo

MCP está desactivado de forma predeterminada en todos los espacios de trabajo. Antes de que alguien pueda añadir o usar servidores MCP, un miembro del espacio de trabajo debe aceptarlo en nombre del espacio de trabajo.

#### Panel

La aceptación se produce automáticamente la primera vez que alguien intenta añadir un servidor MCP desde el [panel de integraciones de servidores MCP](https://elevenlabs.io/app/agents/integrations). Un cuadro de diálogo le pide revisar y aceptar los Términos del servidor Model Context Protocol; al aceptarlos se activa MCP para todo el espacio de trabajo, de modo que cualquier miembro con acceso a ElevenAgents puede añadir servidores MCP y vincularlos a agentes.

#### API

Puedes activar o desactivar MCP para el espacio de trabajo directamente actualizando la configuración de espacio de trabajo `can_use_mcp_servers`:

```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 });
```

Volver a establecer `can_use_mcp_servers` en `false` desactiva MCP para el espacio de trabajo. Se conservan las integraciones de servidores MCP existentes, pero los agentes ya no pueden usarlas hasta que vuelvas a activar la configuración.

> **Note**
>
> Activar MCP es una configuración para todo el espacio de trabajo, no para cada agente. Cualquier miembro, o cualquier clave de API
> con el permiso `convai_write`, puede activarlo o desactivarlo; no está limitado a los administradores del espacio de trabajo.

Una vez activado MCP para el espacio de trabajo, cada servidor MCP que añadas es un recurso independiente: el miembro que lo crea puede compartirlo individualmente con otros miembros del espacio de trabajo, como ocurre al compartir un agente o un documento de la base de conocimiento.

> **Warning**
>
> Activar esta configuración no anula la restricción anterior del modo de retención cero y HIPAA.
> Los espacios de trabajo con el modo de retención cero o el cumplimiento de HIPAA activados no pueden usar servidores MCP, independientemente
> de la configuración de `can_use_mcp_servers`.

## Primeros pasos

> **Note**
>
> ElevenLabs admite servidores MCP con transporte SSE (Server-Sent Events) y HTTP con transmisión.

En este ejemplo, usaremos [Zapier MCP](https://zapier.com/mcp), que te permite conectar ElevenAgents con cientos de herramientas y servicios.

> **Note**
>
> Los servidores MCP todavía no se pueden gestionar mediante la CLI de ElevenLabs; usa el panel o el SDK.

#### Añadir desde el panel

#### Abre las integraciones MCP

Ve al [panel de integraciones de servidores MCP](https://elevenlabs.io/app/agents/integrations) y haz clic en **Añadir servidor MCP personalizado**.

![Creación de tu primer servidor MCP](/docs/_fern-img/335d1d8fced3cd82eed4ed43ba0058d3a8dbc431f81cdb387bf3d5964e5ead80.webp)

#### Configura el servidor MCP

Introduce los siguientes datos:

* **Nombre**: El nombre del servidor MCP (p. ej., "Servidor MCP de Zapier")
* **Descripción**: Una descripción de lo que puede hacer el servidor MCP
* **URL del servidor**: La URL del servidor MCP. Si contiene una clave secreta, trátala como una contraseña y guárdala como secreto del espacio de trabajo.
* **Token secreto** (opcional): Valor de la cabecera de autorización
* **Cabeceras HTTP** (opcional): Cualquier cabecera adicional que requiera el servidor

#### Guarda y prueba la conexión

Haz clic en **Añadir integración** para guardar la integración y probar la conexión para enumerar las herramientas disponibles.

![Herramientas de ejemplo de Zapier](/docs/_fern-img/7c9d83baedd0e2dc74014d4a690159333bbef0eec37c36fa9ee0fd6cd455df0e.webp)

#### Vincula el servidor a un agente

El servidor MCP ya está disponible para añadirlo a tus agentes. La compatibilidad con MCP está disponible tanto para agentes públicos como privados.

![Añadir el servidor MCP a un agente](/docs/_fern-img/b18756710b4466a5fa462080d6f3b237d84f76f898d5c94d4583f31d2fa0395b.webp)

#### Añadir mediante la 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] } },
  },
});
```

## Modos de aprobación de herramientas

ElevenLabs ofrece controles de aprobación flexibles para gestionar cómo los agentes solicitan permiso para usar herramientas de servidores MCP. Puedes configurar los ajustes de aprobación tanto en el nivel del servidor MCP como en el de cada herramienta para lograr el máximo control de seguridad.

![Configuración del modo de aprobación de herramientas](/docs/_fern-img/9f4c208459131622478de5010e2234d3af8a03dc9bc5b7ec2fcab48a7be3bde3.webp)

### Modos de aprobación disponibles

* **Preguntar siempre (recomendado)**: Máxima seguridad. El agente solicitará tu permiso antes de cada uso de herramienta.
* **Aprobación detallada de herramientas**: Desactiva y preselecciona las herramientas que pueden ejecutarse automáticamente y las que requieren aprobación.
* **Sin aprobación**: El asistente puede usar cualquier herramienta sin aprobación.

### Control detallado de herramientas

El modo de aprobación detallada de herramientas te permite configurar herramientas individuales con distintos requisitos de aprobación, lo que te proporciona un control preciso sobre qué herramientas pueden ejecutarse automáticamente y cuáles requieren permiso explícito.

![Configuración de aprobación
detallada de herramientas](/docs/_fern-img/041cad753319ed92189ee8d4f70a9d3ed07177303bf71777ce36a90270a5dd24.webp)

Para cada herramienta, puedes establecer:

* **Aprobada automáticamente**: La herramienta se ejecuta automáticamente sin requerir permiso
* **Requiere aprobación**: La herramienta requiere permiso explícito antes de ejecutarse
* **Desactivada**: La herramienta queda completamente desactivada y no se puede utilizar

> **Tip**
>
> Usa la aprobación detallada de herramientas para permitir que las herramientas de solo lectura y bajo riesgo se ejecuten automáticamente,
> mientras exiges aprobación para las herramientas que modifican datos o realizan operaciones sensibles.

## Aspectos clave de la integración con ElevenLabs

* **Servidores externos**: Eres responsable de seleccionar los servidores MCP externos que deseas integrar. ElevenLabs proporciona los medios para conectarte a ellos.
* **Funciones compatibles**: ElevenLabs admite servidores MCP que se comunican mediante transportes SSE (Server-Sent Events) y HTTP con transmisión para interacciones en tiempo real.
* **Herramientas dinámicas**: Las herramientas y capacidades disponibles en un servidor MCP integrado las define ese servidor externo y pueden cambiar si se actualiza la configuración del servidor.

## Seguridad y exención de responsabilidad

La integración de servidores MCP externos puede exponer tus agentes y datos a servicios de terceros. Es fundamental comprender las implicaciones de seguridad.

> **Exención de responsabilidad importante**
>
> Al activar las integraciones de servidores MCP, reconoces que esto puede implicar compartir datos con
> servicios de terceros no controlados por ElevenLabs. Esto podría conllevar riesgos de seguridad adicionales.
> Asegúrate de comprender plenamente las implicaciones, evaluar la seguridad de cualquier servidor MCP que
> integres y revisar nuestras [Directrices de seguridad para la integración con MCP ](/docs/es/eleven-agents/customization/tools/mcp/security) antes de continuar.

Consulta nuestras [Directrices de seguridad para la integración con MCP](/docs/es/eleven-agents/customization/tools/mcp/security) para conocer buenas prácticas detalladas.

## Buscar o crear servidores MCP

* Utiliza servidores MCP disponibles públicamente de proveedores de confianza
* Desarrolla tu propio servidor MCP para exponer tus datos o herramientas propios
* Explora la comunidad y los recursos de Model Context Protocol para ver ejemplos e implementaciones de servidores

### Recursos

* [Ejemplos de servidores MCP de Anthropic](https://docs.anthropic.com/en/docs/agents-and-tools/remote-mcp-servers#remote-mcp-server-examples) - Una lista de servidores de ejemplo de Anthropic
* [Awesome Remote MCP Servers](https://github.com/jaw9c/awesome-remote-mcp-servers) - Una lista seleccionada y de código abierto de servidores MCP remotos
* [Directorio de servidores MCP remotos](https://remote-mcp.com/) - Una lista consultable de servidores MCP remotos