Plugin Official

MCP Tunnels

Walks you through connecting Claude to a private MCP server via an Anthropic MCP tunnel using Docker Compose.

Author
Anthropic
Works with
Claude Code
License
Apache-2.0
Documented
Oct 2, 2026

What MCP Tunnels is

Provides /create-docker-mcp-tunnel, which drives the MCP tunnels quickstart: certificates, proxy config and cloudflared. No inbound ports are opened. It is a research preview.

What it does

How MCP Tunnels plugs in: which agents run it and what it addsRUNS INYour agentClaude Codeone host documentedPLUGIN · OFFICIALMCP TunnelsBundles of skills, commands, hook…5 install steps2 permission noteslicense: Apache-2.0WHAT IT ADDSWhat it doesPreflight checks Docker, Compose,…Generates a CA and server certifi…Scaffolds a FastMCP sample or wir…Writes mcp-proxy.yaml and a diges…agent → extension → new capability · from the official repository or docs
Where MCP Tunnels runs and what it adds, from its documentation
  • Preflight checks Docker, Compose, OpenSSL and connectivity
  • Generates a CA and server certificate with OpenSSL
  • Scaffolds a FastMCP sample or wires an existing server
  • Writes mcp-proxy.yaml and a digest-pinned docker-compose.yaml
  • Starts the stack and checks logs
  • Includes a troubleshooting matrix and rotation basics

When to use it

Good fit

  • Local testing of a private MCP server behind a tunnel
  • Exposing an internal MCP server with no inbound ports

Not for

  • Hardened, Kubernetes or Workload Identity deployments; see the official guides

How to install MCP Tunnels

You need: Docker and Docker Compose; OpenSSL 1.1.1+; Console role able to manage MCP tunnels; Outbound access to api.anthropic.com:443 and tunnel edge 7844 TCP/UDP

  1. Run Claude Code
  2. Run /plugin install mcp-tunnels@claude-plugins-official
  3. Run /create-docker-mcp-tunnel [deployment-dir]
  4. Create the tunnel in the Claude Console and upload ca.crt when asked
  5. Start the stack and verify logs

Permissions and security

What it can access

  • Runs Docker containers and OpenSSL locally
  • Token stored in a locked-down gitignored .env

Security notes from the maintainers

  • Research preview, as-is, no uptime or support commitment
  • Depends on Cloudflare transport
  • Never copy ca.key or tls.key off the host

Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.

Limitations

  • Targets manual-credentials, single-host, local testing

Tools it extends

Frequently asked questions

What does /create-docker-mcp-tunnel do?

It sets up an MCP tunnel end to end with Docker Compose, certificates and proxy config. source

Does mcp-tunnels open inbound ports?

No; traffic uses an outbound-only connection. source

Is mcp-tunnels production ready?

It is a research preview and targets local testing. source

Related guides

Sources and gaps

Not stated by the maintainers: Release date and version history are not shown in the plugin README.

More extensions to look at