> 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

> **Odpowiedzialność użytkownika**
>
> Odpowiadasz za bezpieczeństwo, zgodność i działanie każdego zewnętrznego serwera MCP,
> który integrujesz ze swoimi agentami konwersacyjnymi ElevenLabs. ElevenLabs udostępnia platformę
> do integracji, ale nie zarządza zewnętrznymi serwerami MCP, nie rekomenduje ich ani nie zabezpiecza.

## Przegląd

> **Note**
>
> Ten przewodnik dotyczy zapewniania agentom ElevenLabs dostępu do zewnętrznych serwerów MCP. Jeśli chcesz
> zrobić odwrotnie — zarządzać agentami ElevenLabs z Claude lub innego klienta MCP — użyj [hostowanego serwera MCP ](/docs/pl/eleven-agents/operate/hosted-mcp).

[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) to otwarty standard określający, jak aplikacje dostarczają kontekst dużym modelom językowym (LLM). MCP działa jak uniwersalny łącznik, który pozwala modelom AI płynnie korzystać z różnych źródeł danych i narzędzi. Integrując serwery obsługujące MCP, możesz znacznie rozszerzyć możliwości swoich agentów konwersacyjnych ElevenLabs.

> **Warning**
>
> Obsługa MCP nie jest obecnie dostępna dla użytkowników w trybie Zero Retention Mode ani dla osób wymagających
> zgodności z HIPAA.

ElevenLabs pozwala łączyć agentów konwersacyjnych z zewnętrznymi serwerami MCP. Dzięki temu Twoi agenci mogą:

* Uzyskiwać i przetwarzać informacje z różnych źródeł danych przez serwer MCP
* Korzystać ze specjalistycznych narzędzi i funkcji udostępnianych przez serwer MCP
* Tworzyć bardziej dynamiczne, kompetentne i interaktywne doświadczenia konwersacyjne

## Włącz MCP w obszarze roboczym

MCP jest domyślnie wyłączone w każdym obszarze roboczym. Zanim ktokolwiek będzie mógł dodawać lub używać serwerów MCP, jeden z członków obszaru roboczego musi wyrazić zgodę w jego imieniu.

#### Panel

Zgoda jest udzielana automatycznie, gdy ktoś po raz pierwszy próbuje dodać serwer MCP z [panelu integracji serwerów MCP](https://elevenlabs.io/app/agents/integrations). Okno dialogowe prosi o zapoznanie się z Warunkami korzystania z serwera Model Context Protocol i ich zaakceptowanie — akceptacja włącza MCP dla całego obszaru roboczego, więc każdy członek mający dostęp do ElevenAgents może potem dodawać serwery MCP i przypisywać je do agentów.

#### API

Możesz włączyć lub wyłączyć MCP dla obszaru roboczego bezpośrednio, aktualizując ustawienie `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 });
```

Ustawienie `can_use_mcp_servers` z powrotem na `false` wyłącza MCP dla obszaru roboczego. Istniejące integracje serwerów MCP zostają zachowane, ale agenci nie mogą z nich korzystać, dopóki ustawienie nie zostanie ponownie włączone.

> **Note**
>
> Włączenie MCP jest ustawieniem dla całego obszaru roboczego, a nie dla pojedynczego agenta. Każdy członek lub dowolny klucz API
> z uprawnieniem `convai_write` może je włączyć lub wyłączyć — nie jest to ograniczone do administratorów
> obszaru roboczego.

Gdy MCP jest włączone dla obszaru roboczego, każdy dodany serwer MCP jest osobnym zasobem: członek, który go tworzy, może udostępniać go indywidualnie innym członkom obszaru roboczego, podobnie jak agenta lub dokument bazy wiedzy.

> **Warning**
>
> Włączenie tego ustawienia nie znosi powyższych ograniczeń Zero Retention Mode i HIPAA.
> Obszary robocze z włączonym Zero Retention Mode lub zgodnością z HIPAA nie mogą korzystać z serwerów MCP, niezależnie
> od ustawienia `can_use_mcp_servers`.

## Pierwsze kroki

> **Note**
>
> ElevenLabs obsługuje serwery MCP z transportem SSE (Server-Sent Events) i strumieniowym HTTP.

W tym przykładzie użyjemy [Zapier MCP](https://zapier.com/mcp), który pozwala połączyć ElevenAgents z setkami narzędzi i usług.

> **Note**
>
> Serwerami MCP nie można jeszcze zarządzać przez CLI ElevenLabs — użyj panelu lub SDK.

#### Dodaj przez panel

#### Otwórz integracje MCP

Przejdź do [panelu integracji serwerów MCP](https://elevenlabs.io/app/agents/integrations) i kliknij **Add Custom MCP Server**.

![Tworzenie pierwszego serwera MCP](/docs/_fern-img/335d1d8fced3cd82eed4ed43ba0058d3a8dbc431f81cdb387bf3d5964e5ead80.webp)

#### Skonfiguruj serwer MCP

Wprowadź następujące dane:

* **Nazwa**: Nazwa serwera MCP (np. „Zapier MCP Server”)
* **Opis**: Opis możliwości serwera MCP
* **URL serwera**: URL serwera MCP. Jeśli zawiera tajny klucz, traktuj go jak hasło i zapisz jako sekret obszaru roboczego.
* **Tajny token** (opcjonalnie): Wartość nagłówka autoryzacji
* **Nagłówki HTTP** (opcjonalnie): Wszelkie dodatkowe nagłówki wymagane przez serwer

#### Zapisz i przetestuj połączenie

Kliknij **Add Integration**, aby zapisać integrację i przetestować połączenie w celu wyświetlenia dostępnych narzędzi.

![Przykładowe narzędzia Zapier](/docs/_fern-img/7c9d83baedd0e2dc74014d4a690159333bbef0eec37c36fa9ee0fd6cd455df0e.webp)

#### Przypisz serwer do agenta

Serwer MCP można teraz dodać do agentów. Obsługa MCP jest dostępna zarówno dla agentów publicznych, jak i prywatnych.

![Dodawanie serwera MCP do agenta](/docs/_fern-img/b18756710b4466a5fa462080d6f3b237d84f76f898d5c94d4583f31d2fa0395b.webp)

#### Dodaj przez 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] } },
  },
});
```

## Tryby zatwierdzania narzędzi

ElevenLabs zapewnia elastyczne ustawienia zatwierdzania, które określają, jak agenci proszą o zgodę na użycie narzędzi z serwerów MCP. Dla maksymalnej kontroli bezpieczeństwa możesz konfigurować ustawienia zatwierdzania zarówno na poziomie serwera MCP, jak i pojedynczego narzędzia.

![Ustawienia trybu zatwierdzania narzędzi](/docs/_fern-img/9f4c208459131622478de5010e2234d3af8a03dc9bc5b7ec2fcab48a7be3bde3.webp)

### Dostępne tryby zatwierdzania

* **Zawsze pytaj (zalecane)**: Maksymalne bezpieczeństwo. Agent poprosi o zgodę przed każdym użyciem narzędzia.
* **Szczegółowe zatwierdzanie narzędzi**: Wyłącz i wstępnie wybierz narzędzia, które mogą działać automatycznie, oraz te wymagające zatwierdzenia.
* **Bez zatwierdzania**: Asystent może używać dowolnego narzędzia bez zatwierdzenia.

### Szczegółowa kontrola narzędzi

Tryb szczegółowego zatwierdzania narzędzi pozwala konfigurować pojedyncze narzędzia z różnymi wymaganiami zatwierdzania, dając precyzyjną kontrolę nad tym, które narzędzia mogą działać automatycznie, a które wymagają wyraźnej zgody.

![Ustawienia szczegółowego zatwierdzania narzędzi
](/docs/_fern-img/041cad753319ed92189ee8d4f70a9d3ed07177303bf71777ce36a90270a5dd24.webp)

Dla każdego narzędzia możesz ustawić:

* **Automatycznie zatwierdzane**: Narzędzie działa automatycznie bez wymaganej zgody
* **Wymaga zatwierdzenia**: Narzędzie wymaga wyraźnej zgody przed wykonaniem
* **Wyłączone**: Narzędzie jest całkowicie wyłączone i nie można go używać

> **Tip**
>
> Użyj szczegółowego zatwierdzania narzędzi, aby narzędzia niskiego ryzyka, służące tylko do odczytu, działały automatycznie,
> a narzędzia modyfikujące dane lub wykonujące wrażliwe operacje wymagały zatwierdzenia.

## Kluczowe kwestie integracji z ElevenLabs

* **Zewnętrzne serwery**: To Ty wybierasz zewnętrzne serwery MCP, które chcesz zintegrować. ElevenLabs zapewnia sposób połączenia z nimi.
* **Obsługiwane funkcje**: ElevenLabs obsługuje serwery MCP komunikujące się przez SSE (Server-Sent Events) i strumieniowy HTTP do interakcji w czasie rzeczywistym.
* **Dynamiczne narzędzia**: Narzędzia i możliwości dostępne z zintegrowanego serwera MCP są definiowane przez ten zewnętrzny serwer i mogą się zmienić po aktualizacji jego konfiguracji.

## Bezpieczeństwo i zastrzeżenie

Integracja zewnętrznych serwerów MCP może udostępnić Twoich agentów i dane usługom innych firm. Kluczowe jest zrozumienie konsekwencji dla bezpieczeństwa.

> **Ważne zastrzeżenie**
>
> Włączając integracje serwerów MCP, potwierdzasz, że może to wiązać się z udostępnianiem danych
> usługom innych firm, nad którymi ElevenLabs nie ma kontroli. Może to powodować dodatkowe zagrożenia bezpieczeństwa.
> Upewnij się, że w pełni rozumiesz konsekwencje, zweryfikuj bezpieczeństwo każdego integrowanego serwera MCP
> i przed kontynuowaniem zapoznaj się z naszymi [wytycznymi bezpieczeństwa integracji MCP ](/docs/pl/eleven-agents/customization/tools/mcp/security).

Szczegółowe dobre praktyki znajdziesz w naszych [wytycznych bezpieczeństwa integracji MCP](/docs/pl/eleven-agents/customization/tools/mcp/security).

## Znajdowanie lub tworzenie serwerów MCP

* Korzystaj z publicznie dostępnych serwerów MCP od zaufanych dostawców
* Twórz własny serwer MCP, by udostępniać swoje dane lub narzędzia
* Przeglądaj społeczność i zasoby Model Context Protocol, aby znaleźć przykłady i implementacje serwerów

### Zasoby

* [Przykłady serwerów MCP od Anthropic](https://docs.anthropic.com/en/docs/agents-and-tools/remote-mcp-servers#remote-mcp-server-examples) - Lista przykładowych serwerów od Anthropic
* [Awesome Remote MCP Servers](https://github.com/jaw9c/awesome-remote-mcp-servers) - Wyselekcjonowana lista zdalnych serwerów MCP open source
* [Remote MCP Server Directory](https://remote-mcp.com/) - Przeszukiwalna lista zdalnych serwerów MCP