---
title: Быстрый старт с туннелями MCP
url: https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/quickstart
description: Подключите Claude к приватному серверу MCP с помощью локального развёртывания Docker Compose.
---

<Note>
  «MCP tunnels» (туннели MCP) находятся на этапе «research preview» (исследовательская предварительная версия). [Запросите доступ](https://claude.com/form/mcp-tunnels), чтобы опробовать их.
</Note>

Этот быстрый старт проведёт вас с нуля до момента, когда Claude вызывает приватный сервер MCP через туннель. В нём используется Docker Compose с [ручной](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/concepts#credential-provisioning) выдачей учётных данных (credential provisioning) — это самый короткий путь для локального тестирования. Для производственных развёртываний см. [Развёртывание с помощью Helm](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/deploy-helm) или [Развёртывание с помощью Docker Compose](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/deploy-compose).

## Что вы создадите

[Стек туннеля](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/concepts#components) (tunnel stack) из двух контейнеров ([прокси](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/concepts#components) и [cloudflared](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/concepts#components)), а также пример сервера MCP, работающий рядом с ним. Когда всё запущено, пример сервера доступен из Claude по адресу `https://echo.<your-tunnel-domain>/mcp`, хотя ничто не прослушивает публичный порт.

## Что вам понадобится

* [Docker и Docker Compose](https://docs.docker.com/get-docker/) на машине с исходящим доступом в интернет.
* Роль в [Claude Console](https://platform.claude.com), позволяющая управлять туннелями MCP. См. [предварительные требования в руководстве по Console](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/console#prerequisites).
* [OpenSSL](https://openssl-library.org/source/) версии 1.1.1 или новее. Предустановлен в macOS и большинстве дистрибутивов Linux; в Windows установите его отдельно (исполняемый файл `openssl` должен находиться в вашем `PATH`).

<Steps>
  <Step title="Создайте туннель">
    В Claude Console перейдите на страницу [MCP tunnels](https://platform.claude.com/settings/workspaces/default/mcp-tunnels) (`platform.claude.com/settings/workspaces/default/mcp-tunnels`). Каждый туннель принадлежит одному рабочему пространству. Выберите нужное рабочее пространство в селекторе рабочих пространств на боковой панели. Нажмите **New tunnel** и задайте ему имя. Оставьте параметр **Set up programmatic access** выключенным; в этом быстром старте используется ручная выдача учётных данных.

    После создания откройте туннель. Скопируйте два значения из раздела **Connection**:

    * **Domain** (выглядит как `abcd1234.tunnel.anthropic.com`)
    * **Token** (нажмите на значок глаза, затем скопируйте)
  </Step>

  <Step title="Подготовьте каталог развёртывания">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash
        mkdir -p mcp-tunnel/{config,data}
        cd mcp-tunnel
        export TUNNEL_DOMAIN=YOUR_TUNNEL_DOMAIN_HERE   # from step 1
        export TUNNEL_TOKEN='eyJ...'            # from step 1
        ```
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell
        New-Item -ItemType Directory -Force -Path mcp-tunnel/config, mcp-tunnel/data | Out-Null
        Set-Location mcp-tunnel
        $env:TUNNEL_DOMAIN = "YOUR_TUNNEL_DOMAIN_HERE"   # from step 1
        $env:TUNNEL_TOKEN  = "eyJ..."             # from step 1
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Сгенерируйте CA и серверный сертификат">
    Прокси завершает [внутренний TLS](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/concepts#components) (inner TLS), используя сертификат, подписанный центром сертификации (CA), который вы контролируете. Сгенерируйте оба:

    <Tabs>
      <Tab title="macOS / Linux">
        ```bash
        openssl req -x509 -newkey rsa:2048 -nodes \
          -keyout data/ca.key -out data/ca.crt \
          -days 3650 -subj "/CN=mcp-tunnel-ca" \
          -addext "basicConstraints=critical,CA:TRUE" \
          -addext "keyUsage=critical,keyCertSign,cRLSign" \
          -addext "subjectKeyIdentifier=hash"

        cat > data/tls.ext <<EOF
        subjectAltName = DNS:${TUNNEL_DOMAIN},DNS:*.${TUNNEL_DOMAIN}
        authorityKeyIdentifier = keyid,issuer
        extendedKeyUsage = serverAuth
        EOF

        openssl req -newkey rsa:2048 -nodes \
          -keyout data/tls.key -out /tmp/server.csr \
          -subj "/CN=${TUNNEL_DOMAIN}"
        openssl x509 -req -in /tmp/server.csr \
          -CA data/ca.crt -CAkey data/ca.key -CAcreateserial \
          -out data/tls.crt -days 90 -extfile data/tls.ext

        chmod 644 data/tls.key
        ```
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell
        openssl req -x509 -newkey rsa:2048 -nodes `
          -keyout data/ca.key -out data/ca.crt `
          -days 3650 -subj "/CN=mcp-tunnel-ca" `
          -addext "basicConstraints=critical,CA:TRUE" `
          -addext "keyUsage=critical,keyCertSign,cRLSign" `
          -addext "subjectKeyIdentifier=hash"

        @"
        subjectAltName = DNS:$env:TUNNEL_DOMAIN,DNS:*.$env:TUNNEL_DOMAIN
        authorityKeyIdentifier = keyid,issuer
        extendedKeyUsage = serverAuth
        "@ | Set-Content -NoNewline -Encoding ascii -Path data/tls.ext

        openssl req -newkey rsa:2048 -nodes `
          -keyout data/tls.key -out data/server.csr `
          -subj "/CN=$env:TUNNEL_DOMAIN"
        openssl x509 -req -in data/server.csr `
          -CA data/ca.crt -CAkey data/ca.key -CAcreateserial `
          -out data/tls.crt -days 90 -extfile data/tls.ext
        ```
      </Tab>
    </Tabs>

    Вернувшись в Console, на странице сведений о туннеле нажмите **Add certificate** и загрузите `data/ca.crt` (или вставьте его содержимое). Значок **Needs certificate** рядом с именем туннеля исчезнет.
  </Step>

  <Step title="Напишите пример сервера MCP">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash
        cat > hello_server.py <<'EOF'
        from mcp.server.fastmcp import FastMCP

        mcp = FastMCP("hello-server", host="0.0.0.0", port=9000)


        @mcp.tool()
        def hello(name: str = "world") -> str:
            """Say hello to someone."""
            return f"Hello, {name}!"


        if __name__ == "__main__":
            mcp.run(transport="streamable-http")
        EOF
        ```
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell
        @'
        from mcp.server.fastmcp import FastMCP

        mcp = FastMCP("hello-server", host="0.0.0.0", port=9000)


        @mcp.tool()
        def hello(name: str = "world") -> str:
            """Say hello to someone."""
            return f"Hello, {name}!"


        if __name__ == "__main__":
            mcp.run(transport="streamable-http")
        '@ | Set-Content -NoNewline -Encoding ascii -Path hello_server.py
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Напишите конфигурацию прокси и файл compose">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash
        cat > config/mcp-proxy.yaml <<EOF
        listen_addr: ":8080"
        tunnel_domain: ${TUNNEL_DOMAIN}
        tls:
          cert_file: /data/tls.crt
          key_file: /data/tls.key
        routes:
          echo: http://hello-mcp:9000
        EOF

        cat > docker-compose.yaml <<'EOF'
        services:
          mcp-proxy:
            image: us-docker.pkg.dev/anthropic-public-registry/images/mcp-proxy@sha256:efb27b299d627e4134815663cb8896641eeaee025d734c0f695582b4df38f013
            volumes:
              - ./config/mcp-proxy.yaml:/etc/mcp-gateway/config.yaml:ro
              - ./data:/data:ro
            restart: unless-stopped

          cloudflared:
            image: cloudflare/cloudflared@sha256:6b599ca3e974349ead3286d178da61d291961182ec3fe9c505e1dd02c8ac31b0
            command: tunnel --no-autoupdate run --url http://localhost:8080
            environment:
              - TUNNEL_TOKEN
            network_mode: "service:mcp-proxy"
            restart: unless-stopped

          hello-mcp:
            image: python:3.13-slim
            working_dir: /app
            volumes:
              - ./hello_server.py:/app/hello_server.py:ro
            command: sh -c "pip install --quiet mcp && python hello_server.py"
            restart: unless-stopped
        EOF
        ```
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell
        @"
        listen_addr: ":8080"
        tunnel_domain: $env:TUNNEL_DOMAIN
        tls:
          cert_file: /data/tls.crt
          key_file: /data/tls.key
        routes:
          echo: http://hello-mcp:9000
        "@ | Set-Content -NoNewline -Encoding ascii -Path config/mcp-proxy.yaml

        @'
        services:
          mcp-proxy:
            image: us-docker.pkg.dev/anthropic-public-registry/images/mcp-proxy@sha256:efb27b299d627e4134815663cb8896641eeaee025d734c0f695582b4df38f013
            volumes:
              - ./config/mcp-proxy.yaml:/etc/mcp-gateway/config.yaml:ro
              - ./data:/data:ro
            restart: unless-stopped

          cloudflared:
            image: cloudflare/cloudflared@sha256:6b599ca3e974349ead3286d178da61d291961182ec3fe9c505e1dd02c8ac31b0
            command: tunnel --no-autoupdate run --url http://localhost:8080
            environment:
              - TUNNEL_TOKEN
            network_mode: "service:mcp-proxy"
            restart: unless-stopped

          hello-mcp:
            image: python:3.13-slim
            working_dir: /app
            volumes:
              - ./hello_server.py:/app/hello_server.py:ro
            command: sh -c "pip install --quiet mcp && python hello_server.py"
            restart: unless-stopped
        '@ | Set-Content -NoNewline -Encoding ascii -Path docker-compose.yaml
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Запустите">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash
        docker compose up -d
        docker compose logs mcp-proxy | grep "route configured"
        docker compose logs cloudflared | grep "Registered tunnel connection"
        ```
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell
        docker compose up -d
        docker compose logs mcp-proxy | Select-String "route configured"
        docker compose logs cloudflared | Select-String "Registered tunnel connection"
        ```
      </Tab>
    </Tabs>

    Вы должны увидеть одну строку `route configured` для `echo` и четыре строки `Registered tunnel connection`. Запуск контейнеров занимает несколько секунд; повторно выполните команды просмотра логов, если они вернули пустой результат.
  </Step>

  <Step title="Вызовите его из Claude">
    В Console перейдите на страницу [Sessions](https://platform.claude.com/sessions) (`platform.claude.com/sessions`) и создайте сессию. В окне выбора агента выберите **Create new agent**, задайте агенту имя и оставьте предварительно заполненную модель. Нажмите **+ MCP Server**, выберите свой туннель, установите для **Subdomain** значение `echo`, а для **Path** — `mcp`. Затем спросите:

    > Use the hello tool to greet tunnel.

    Вы должны увидеть вызов инструмента, а затем его результат.
  </Step>
</Steps>

## Следующие шаги

Туннель проверен от начала до конца. Чтобы подключить собственный сервер MCP, добавьте его в `docker-compose.yaml` (или запустите его в той же сети Docker), добавьте для него маршрут в `config/mcp-proxy.yaml`, затем перезапустите прокси (`docker compose restart mcp-proxy`).

Для производственных развёртываний:

<CardGroup cols={2}>
  <Card title="Развёртывание с помощью Docker Compose" icon="cube" href="https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/deploy-compose">
    Защищённое развёртывание на одном хосте, с программным доступом или без него.
  </Card>

  <Card title="Развёртывание с помощью Helm" icon="stack" href="https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/deploy-helm">
    Развёртывание в Kubernetes с автоматическим управлением учётными данными.
  </Card>
</CardGroup>