---
title: MCPトンネルのクイックスタート
url: https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/quickstart
description: ローカルのDocker Composeデプロイメントを使用して、Claudeをプライベートな MCP サーバーに接続します。
---

<Note>
  MCPトンネルはリサーチプレビュー段階です。お試しいただくには、[アクセスをリクエスト](https://claude.com/form/mcp-tunnels)してください。
</Note>

このクイックスタートでは、トンネルの作成から、Claudeがそのトンネルを介してプライベートなMCPサーバーを呼び出すまでの手順を説明します。ここでは[手動](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/concepts#credential-provisioning)での認証情報プロビジョニングを伴うDocker Composeを使用します。これはローカルテストのための最短の方法です。本番環境へのデプロイメントについては、[Helmでデプロイする](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/deploy-helm)または[Docker Composeでデプロイする](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/deploy-compose)を参照してください。

## 構築するもの

2つのコンテナからなる[トンネルスタック](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/concepts#components)（[プロキシ](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/concepts#components)と[cloudflared](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/concepts#components)）と、それと並行して動作するサンプルのMCPサーバーです。すべてが稼働すると、パブリックポートで何もリッスンしていないにもかかわらず、サンプルサーバーにClaudeから`https://echo.<your-tunnel-domain>/mcp`でアクセスできるようになります。

## 必要なもの

* アウトバウンドのインターネットアクセスが可能なマシン上の[DockerとDocker Compose](https://docs.docker.com/get-docker/)。
* MCPトンネルを管理できる[Claude Console](https://platform.claude.com/)のロール。[Consoleガイドの前提条件](https://platform.claude.com/docs/ja/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トンネル](https://platform.claude.com/settings/workspaces/default/mcp-tunnels)ページ（`platform.claude.com/settings/workspaces/default/mcp-tunnels`）に移動します。各トンネルは1つのワークスペースに属します。サイドバーのワークスペースピッカーで目的のワークスペースを選択します。**New tunnel**をクリックして名前を付けます。**Set up programmatic access**はオフのままにしてください。このクイックスタートでは手動での認証情報プロビジョニングを使用します。

    作成後、トンネルを開きます。**Connection**セクションから2つの値をコピーします。

    * **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とサーバー証明書を生成する">
    プロキシは、あなたが管理するCAによって署名された証明書を使用して[内部TLS](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/concepts#components)を終端します。両方を生成します。

    <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:d243d30642d39857a0579e465cb3b9bf3ae7c1141e83143bb6856777a31467a5
            volumes:
              - ./config/mcp-proxy.yaml:/etc/mcp-gateway/config.yaml:ro
              - ./data:/data:ro
            restart: unless-stopped

          cloudflared:
            image: cloudflare/cloudflared@sha256:0e56c13c7058fcef9c4f0e7d83372f82330548dbf8f8b366f3d8b506526d93b2
            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:d243d30642d39857a0579e465cb3b9bf3ae7c1141e83143bb6856777a31467a5
            volumes:
              - ./config/mcp-proxy.yaml:/etc/mcp-gateway/config.yaml:ro
              - ./data:/data:ro
            restart: unless-stopped

          cloudflared:
            image: cloudflare/cloudflared@sha256:0e56c13c7058fcef9c4f0e7d83372f82330548dbf8f8b366f3d8b506526d93b2
            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>

    `echo`に対する`route configured`の行が1つと、`Registered tunnel connection`の行が4つ表示されるはずです。コンテナの起動には数秒かかります。ログコマンドの結果が空の場合は、再実行してください。
  </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/ja/agents-and-tools/mcp-tunnels/deploy-compose">
    プログラムによるアクセスの有無にかかわらず利用できる、強化された単一ホストデプロイメント。
  </Card>

  <Card title="Helmでデプロイする" icon="stack" href="https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/deploy-helm">
    自動認証情報管理を備えたKubernetesデプロイメント。
  </Card>
</CardGroup>