What a server tunnel is: a machine your organization runs next to internal servers, such as a self-hosted GitLab, through which MCP Manager reaches them while every user signs in as themselves. Covers the one command you run once and what each part of it allows, the container that runs on the machine (a launcher that never changes and workers that update themselves, with no Docker socket and no host folders), signed releases and how updates hand over with no downtime, the independent check that replaces a worker that won’t update, the limits that stop runaway software, allowed destinations and the MCPM_TUNNEL_ALLOWED_ORIGINS cap, terminating a machine or a tunnel, the Manage tunnels capability, and what the tunnel-unavailable, update-failed, misconfigured and tunnel-disabled states mean.
A server tunnel is a machine your organization runs next to its internal servers, such as a self-hosted GitLab or an internal Grafana. MCP Manager reaches those servers through it. The machine dials out to MCP Manager, so you open nothing inbound and expose nothing to the internet. Every user still signs in to the internal server with their own identity, so the server’s own audit log names the person behind each call.You connect a machine by running one command. You never run it again: the tunnel updates itself with signed releases and no downtime. See Automatic updates with no downtime.Ready to set one up? Connect an internal server through a tunnel walks the whole path. This page covers how a server tunnel works and what it means for security.
Server tunnels need the Manage tunnels capability, and they must be enabled for your workspace. Without both you don’t see the Tunnels section, and you can’t mark a server as Reached through a tunnel. Ask a workspace administrator to grant it. See Who can manage server tunnels and the capabilities reference.
What a server tunnel is for
A server tunnel solves one problem: an MCP server that lives on your internal network, used by many people, each of whom must sign in as themselves. A self-hosted GitLab is the typical case. MCP Manager’s gateway runs in the cloud and can’t reach it, and you don’t want to expose it to the internet.A server reached through a tunnel is a remote server with one extra setting: Reached through a tunnel, and the tunnel to use. It keeps everything a remote server has. You assign it to gateways, choose per-user or shared identity, and its calls run through your gateway rules and land in your logs. One tunnel can carry several servers. GitLab and Grafana on the same network are two servers bound to the same tunnel, and you assign each to gateways on its own.
How a server tunnel connects
A server tunnel connects outbound only. The machine dials out to MCP Manager over TCP 443 and joins a private, encrypted network built on WireGuard that MCP Manager coordinates. The gateway sends each request to the machine over that network. The machine then opens its own HTTPS connection to the internal server and sends the response back the same way.The gateway sends an internal server’s traffic only through its tunnel. When the tunnel can’t take a request, the request fails with a clear error. MCP Manager never falls back to calling the server’s URL directly.On the machine, one container does all of this. Inside it, a launcher that never changes runs the worker that carries your traffic, and swaps in a new worker when a new release arrives. Each person’s sign-in page opens in their own browser, which must reach the internal server, for example over your office network or VPN. See What runs inside the tunnel container.
What the tunnel machine needs
The tunnel machine is a host your organization runs, close to the servers it reaches. It needs:
Docker Engine on a Linux machine, running as root (the standard install). MCP Manager publishes releases for linux/amd64 and linux/arm64. Rootless Docker and Podman aren’t supported yet.
One server tunnel per Docker host. A server tunnel’s container is always named mcpm-server-tunnel, so Docker won’t start a second one on the same host. For failover, connect a second host.
To stay on. A tunnel with no machine online carries no traffic. The container runs with --restart unless-stopped, so it comes back on its own after a reboot once Docker starts.
A route to each internal server it will reach, over your own network.
Outbound TCP 443 to the hosts below. Allowlist them by hostname, not IP address, and exempt them from TLS inspection.
Hostname
Why it’s needed
app.mcpmanager.ai
MCP Manager. The worker connects the machine here the first time, then checks in regularly.
headscale.mcpmanager.ai
Coordination server. The worker joins the private network here.
derp-a.mcpmanager.ai
Relay server. Carries the traffic between MCP Manager and the machine.
derp-b.mcpmanager.ai
Relay server, second region. Used for failover and lower latency.
registry-1.docker.io
Docker Hub. Docker pulls the mcpmanager/tunnel image from here when you run the command. After that, the machine downloads every signed release from here.
auth.docker.io
Docker Hub sign-in. Docker Hub hands out the short-lived token for each download here.
production.cloudfront.docker.com
Docker Hub downloads. Docker Hub sends the image layers and release files from here. Docker can change this host, so check Docker’s own list if a download is blocked.
The coordination and relay servers are the same ones a workstation uses. If a corporate proxy blocks them, the symptoms and fixes in Network requirements apply here too.
Private certificates and outbound proxies
An internal server with your own certificate authority. The tunnel checks the HTTPS certificate of every destination except the machine itself (localhost and host.docker.internal). If your internal server’s certificate is signed by your organization’s own CA, give the tunnel that CA as PEM text, not a file path. Add this to the command, before the image name:
terminal
-e MCPM_EXTRA_CA_CERTS="$(cat your-ca.pem)"
Without it, requests to that server fail with Upstream Certificate Rejected, and the message says what to add. HTTPS certificates covers each kind of certificate failure, and applies here too.A machine behind an outbound proxy. Add the standard HTTPS_PROXY (or ALL_PROXY) and NO_PROXY variables to the command the same way. The tunnel uses them to check in, join the private network and download releases. Docker pulls the image itself, so set Docker’s own proxy settings for that.Docker fixes these values when it creates the container. To add one to a machine that’s already running, run a new command on it, as in Limit destinations on the machine itself.
The one-time command that connects a machine
Someone with Manage tunnels selects Connect a machine on the tunnel, which makes a command, and runs it on the machine. MCP Manager fills in every value. It looks like this:
It’s one line. The origins value sits in double quotes, which bash, PowerShell and cmd all pass through as they are, so it pastes the same way into each. The container starts in the background and keeps running.
Every privilege the tunnel gets is in the command
You can read everything the tunnel is allowed to do in that one line. Docker fixes these settings when it creates the container, so nothing MCP Manager ships later can widen them.
Part of the command
What it means
--cap-drop ALL --cap-add SETUID --cap-add SETGID
The container drops every Linux capability except two. The launcher uses those two for one thing only: starting each worker as a separate, weaker user. Workers keep no capability at all.
--security-opt no-new-privileges
Nothing inside the container can gain a privilege later.
--read-only
The container can’t change its own files. It writes only to its volume.
--pids-limit <P> --memory <M> --memory-swap <M>
Hard limits on processes and memory, enforced by the kernel whatever our code does. Setting --memory-swap to the same value as --memory turns swap off.
-v mcpm-tunnel-<id>:/var/lib/mcpm
One named Docker volume, new for each command, so a host you connect again never reuses an earlier machine’s identity. It holds the machine’s identity and the releases it has checked. No folder from your host is mounted.
--add-host host.docker.internal:host-gateway
Lets the container reach servers on the machine itself by that name. When you choose Docker Engine on Linux (host network) in the command’s variation menu, the command has --network host -e MCPM_TUNNEL_NETWORK=host instead, and the tunnel reaches servers on the machine at localhost.
Connects this machine to your tunnel. The token works once.
--name mcpm-server-tunnel
The same name on every host, so a host runs one server tunnel machine. To run a new command on the host, remove this container first with docker rm -f mcpm-server-tunnel.
What the command leaves out matters as much. There’s no Docker socket, so the tunnel can’t start, stop or inspect any other container on the host. There’s no host folder and no privileged mode, and the container shares the host’s network only when you choose that for a Linux machine that runs Docker directly.
The token, the machine key and when you need a new command
The enrollment token in the command has three limits:
It works once. A second machine needs its own command.
It expires 24 hours after it’s generated.
MCP Manager shows it once and stores only a hash of it.
If MCP Manager refuses a command when the machine runs it, see The install command is refused.The first time the container starts, the machine makes its own key and keeps it in the volume. The private key never leaves the container, and only the launcher can read it. From then on, every request the machine sends to MCP Manager is signed with that key. Each new machine raises an alert, A machine joined a server tunnel, naming who issued the command.Run the command once per machine. A machine needs a new command only when it loses its container or volume, or to reach an allowed destination its command didn’t include. A machine that lost its volume (after docker volume rm or docker system prune --volumes) can no longer prove who it is, so terminate it in the Tunnels section and connect the host again with a new command. MCP Manager can replace every key it uses, including its root keys, without you running anything. See Signed releases.The first install trusts the MCP Manager web app. The command, including the image digest, comes from MCP Manager over TLS. The signature checks protect every update after the install, not the install itself.When MCP Manager has no release published for server tunnels, it can’t issue a command. It creates no token and says that no release is available yet.
More than one machine for failover
You can connect several machines to one tunnel. Each machine’s worker checks in with MCP Manager regularly, and a machine that has stopped checking in gets no traffic. MCP Manager sends each request to an online machine. When it can’t reach that machine before any part of the request was sent, it tries the next one. A request that fails after it was sent is reported and never retried, so a tool call never runs twice.Connect each machine on its own Docker host.
What the tunnel machine can see
The tunnel machine sees every credential sent through it. It’s the HTTPS client to your internal server, so each user’s token passes through it in plain text on the way to that server. Run a server tunnel only on infrastructure your organization controls, next to the servers it reaches.
Treat the tunnel machine like the servers behind it. Anyone who controls the machine can read the credentials of every user who calls a server through it. The tunnel container can’t control Docker or read your host’s files, but whoever controls the host can read the container. Use a host you’d trust with those servers’ credentials, and don’t share it with workloads you trust less.
This is the trade a server tunnel makes on purpose. A workstation is safe to run on a laptop because the only credentials it sees are its owner’s. A server tunnel carries everyone’s, so it belongs on your organization’s infrastructure, never on a personal machine.
What runs inside the tunnel container
One container runs on the tunnel machine, and three kinds of program run inside it.
The launcher is the container’s first process. It never changes after you run the command, and it has no network access. It checks every release before anything in it runs, starts each worker as its own user, and keeps the machine key. When a worker needs to send a request to MCP Manager, the launcher signs it, so a worker never holds the key.
Workers carry your traffic. A worker joins the private network, checks in with MCP Manager, sends requests on to your internal servers, and downloads the next release. Up to three run at once: the one serving traffic, a new one being checked, and an old one finishing its requests.
The built-in fetcher ships inside the image. It downloads the current release the first time the machine starts, and again if no stored release will run. It does nothing else.
What a worker can’t do
Workers are the part that updates, so they get the least power:
Read the machine key or the launcher’s records. Only the launcher can.
Change the code it runs. Each release is unpacked read-only after the launcher has checked it.
See or signal another worker. Each worker runs as its own user, with its own folder.
Gain privileges. A worker holds no Linux capability, and no-new-privileges stops it gaining any.
Take more than its share. Each worker has its own process limit, so one bad worker can’t starve the one serving your traffic.
What a server tunnel doesn’t promise
The list of places your requests may go is enforced by the worker’s code. Docker limits the kind of network the container gets, not the hosts it can reach. So if someone stole MCP Manager’s release key and took over MCP Manager’s servers, they could ship a worker that ignores the list and reaches whatever the container’s network reaches.That’s why two root keys can replace a stolen release key, so machines stop accepting it, and why the independent check can retire a worker that misbehaves. If you have strict requirements, also limit the machine’s outbound traffic at your firewall, so the network itself only reaches the servers you meant.
Automatic updates with no downtime
You run the command once. After that, the tunnel updates itself. You never run the command again to keep a machine current or secure.
What MCP Manager staff control and what your organization controls
MCP Manager staff manage updates on a staff-only page, and each change records who made it and why. Org members with Manage tunnels see each machine’s version and update status in the Tunnels section, read-only.
Decision
Who decides
Which release machines move to
MCP Manager staff
Which organizations get a release first, and when everyone else follows
MCP Manager staff
Pausing updates
MCP Manager staff
How many updates run at the same time across all tunnels
MCP Manager staff
Holding updates for one organization or one machine
MCP Manager staff. You can’t pause or hold updates yourself.
Where the machine runs, its network access, a tunnel’s allowed destinations, and the cap in the command
Your organization
Terminating a machine or a tunnel
Your organization, with Manage tunnels
While staff pause updates, existing machines stay on the version they run. A new machine still starts with the current release.
Signed releases: what the launcher checks before anything runs
A release is a signed package of worker code, published to Docker Hub. Every release is signed by a release key. The release key is in turn approved by MCP Manager’s root keys. There are three root keys, and any two must agree. The launcher has the root keys’ public halves built in, and it checks the whole chain on the machine before anything in a release runs.The launcher refuses a release when:
the signatures don’t check out all the way up to the root keys;
it’s older than a release the machine has already run (each release has a counter that only goes up);
it’s signed with an older key than the newest one the machine has accepted;
the download doesn’t match the fingerprint the release lists for it.
MCP Manager’s gateway, the part that talks to your machines, holds no signing key. It can tell a machine that a release exists, but it can’t make one.Every key can be replaced without you. To replace the release key, two root keys approve a new one, and machines stop accepting the old one. To replace a root key, two current root keys sign the new set, and each machine checks that the same way before it trusts it. You never run a new command for either.Updates only move forward. MCP Manager never rolls a machine back to an older release. To undo a bad release, staff publish a newer one.
How an update runs
A new release has to prove it works before the old one stops.
The serving worker learns from MCP Manager that a newer release is out. It downloads the release from Docker Hub and hands it to the launcher.
The launcher checks the release and starts it as a new worker beside the old one. The old worker keeps serving.
The new worker joins the private network and checks in. MCP Manager tests it through its gateway, the way real traffic arrives. The new worker must reach every allowed destination with a verified TLS handshake.
When the checks pass, MCP Manager switches traffic in one step. New requests go to the new worker from the next request on.
The old worker stops taking new requests, finishes the ones in flight, and exits. If it doesn’t finish in time, the launcher stops it anyway, so an old worker can never hold its place.
Once the new worker has proven itself, the launcher remembers it as the release to fall back to, and empties the old worker’s folder.
What “no downtime” means. No new request fails because of an update, and requests in flight finish. A very long-lived stream that’s still open when the old worker’s time runs out is closed, and the client has to reconnect. The stream doesn’t resume where it left off.
When an update goes wrong
A failed update never takes down the worker that’s already serving. If the serving worker itself crashes or goes quiet, requests to that machine fail until the launcher starts a replacement, and the tunnel’s other machines keep serving.
A new worker never becomes healthy. MCP Manager doesn’t switch traffic to it, the launcher drops it, and the serving worker carries on.
A worker keeps crashing. The launcher restarts the same release a few times. Then it falls back to the last release that proved itself on this machine. If none will run, the built-in fetcher downloads the current release. The launcher never runs a release older than the last one that proved itself.
A worker stops responding. Each worker has to signal the launcher regularly. A worker that goes quiet is stopped and replaced, even if its process is still running.
What happened
What MCP Manager does
The update can’t succeed on retry. The launcher refused the release, the release has nothing for this machine’s platform, or the new worker started and then failed MCP Manager’s checks.
Marks the update Update failed with the reason, raises one alert for the tunnel and release, and doesn’t offer that release to the machine again until a newer release comes out. When the cause was an origin the machine can’t reach, changing the tunnel’s allowed destinations offers it again.
The update may succeed on retry. The download failed, or the new worker stopped before it was ready.
Tries again later. It raises one alert for the first failure of that release on the machine, with the reason.
The machine was offline.
Drops the attempt quietly, with no alert, and offers the update again later.
How MCP Manager paces updates
One at a time. MCP Manager updates one machine at a time across all tunnels, unless staff raise that. It releases to a first group of organizations, then to everyone. A tunnel can wait a while for its turn when many machines are queued. The Tunnels section then shows Waiting its turn. That’s normal and needs nothing from you.
Installs and replacements never wait. A machine’s first worker, and a replacement for a worker that stopped, aren’t updates. They don’t wait their turn, and a pause doesn’t hold them back.
The independent check: replacing a worker that stops updating
Normally the serving worker is how a machine hears about new releases. If a worker ever stopped listening, for example a worker built with a stolen release key, it could keep a machine on old code.So the launcher also runs its own check, on its own schedule, with the built-in fetcher. No release can change the fetcher. It reads a minimum release that two root keys have signed. A release key alone can’t sign it. When a worker is below that minimum, the launcher:
stops signing requests for it straight away;
gives it a short time to finish what it’s doing, then stops it;
starts the current release beside it, so traffic moves over without a gap.
This is the safety net. Normal updates stay the fast way to replace a release.
What the Tunnels section shows about updates
Each machine in the Tunnels section shows the version of each worker and one update status:
Status
What it means
Up to date
The machine runs the release MCP Manager wants it to run.
Waiting its turn
A newer release exists and this machine hasn’t got it yet. The reason says why: pacing, a pause by staff, or the tunnel being off.
Updating to a version
The machine is installing that version.
Update failed
The update failed. The status shows the reason and the time, and the machine keeps its current version.
No release available yet
MCP Manager hasn’t published a release yet.
The tunnel’s page shows the target release even while staff have paused updates. You can’t start, pause or change an update from it. See When a machine doesn’t come online or doesn’t update for what to do about each state.
Limits that stop runaway software
A bug in a release can’t take over the tunnel machine, because several limits stack up. Each one still works if the ones above it fail.
The kernel. The --pids-limit and --memory values in the command cap the whole container. Nothing inside can go past them.
The launcher. At most three workers run at once, each with its own process limit. A worker that’s stopped is removed along with every process it started. The launcher also spaces out worker starts, and that spacing survives a restart.
The memory watchdog. When the container nears its memory limit, the launcher stops the newest worker first, so the worker serving your traffic is the last to go.
The worker. Each worker runs one tunnel for its whole life, so it never stacks up copies of itself.
MCP Manager. The gateway caps how many workers a machine may have joined at once, and paces how fast machines join.
Allowed destinations
Allowed destinations is each tunnel’s list of the origins it may send requests to. An origin is a scheme, host and port, such as https://gitlab.example.internal. Enter only that: the editor refuses a path, a query or credentials. A default port (443 for HTTPS, 80 for HTTP) counts the same as no port. Every request through the tunnel must go to an origin on the list. That includes each step of an OAuth sign-in: discovery, client registration, the token exchange, token refresh and user info.You list the first destinations when you create the tunnel; at least one is required. To change the list afterwards, someone with Manage tunnels opens the tunnel and selects Edit under Allowed destinations. The list opens in the Connect a machine window, and saving it makes a new command that carries the new list. Adding a server through the tunnel can also add the server’s origin to the list.A tunnel allows at most 100 origins. Joined with +, the origins can be at most 32,768 bytes in all. That joined value is the one the command carries (see below). The editor shows how many of the 100 origins you’ve used, and it won’t save a list over either limit.Three rules apply:
Only listed origins. MCP Manager compares the canonical origin, so two spellings of one host can’t slip past the list.
HTTPS unless you list http://. A plain-HTTP origin works only when you add it with http:// explicitly.
The list only narrows. An OAuth server’s metadata can never add an origin to it. OAuth endpoints must also pass the same rule a workstation uses: they must be on the authorization server’s issuer origin, an origin its metadata names, or the MCP server’s origin. See Signing in with OAuth.
When a destination isn’t allowed, the request fails with MCPM_TUNNEL_DESTINATION_NOT_ALLOWED (HTTP 403). The message names the URL and the tunnel. MCP Manager sent nothing to that URL. To fix it, add the URL’s origin to the tunnel’s allowed destinations. If the server signs in with OAuth on another host, such as a separate identity provider, add that origin too. Each machine gets the new list at its next check-in, but it reaches the new origin only after you run a new command on it, because its command caps its destinations. See Limit destinations on the machine itself.The same error is returned when the server redirects to another origin. A server tunnel follows a redirect only within the same origin, so a request’s credentials never reach a different server, and adding the origin doesn’t change that. Point the MCP server at the address it redirects to instead. The message names both addresses.Keep the list to origins you use. During every update, the new worker must reach each allowed destination before it takes over. An origin the machine can’t reach makes the update fail with the reason, and the machine stays on its current version. That release isn’t offered to the machine again until the tunnel’s allowed destinations change or a newer release comes out.
Limit destinations on the machine itself
The command also caps destinations on the machine, so the limit holds even if someone changes the list in MCP Manager. That’s the MCPM_TUNNEL_ALLOWED_ORIGINS value in the command: a list of origins joined by +, such as https://gitlab.example.internal+https://grafana.example.internal. MCP Manager fills it in from the tunnel’s allowed destinations when it builds the command, and you can edit it before you run the command. An origin with characters a shell would misread is left out, and the window says so.If a tunnel’s list is already longer than 32,768 bytes, MCP Manager doesn’t issue a command. A machine installed with it would reach none of the destinations. The message says the list is too long and links to the tunnel’s page. There, select Edit under Allowed destinations, shorten the list and save it, and the window makes the command.The machine sends only to origins that are on both lists. Docker fixes the cap when it creates the container, so MCP Manager can’t widen it later. Keep the two lists in step: an origin on the tunnel’s list but outside the cap can’t be reached from that machine.To give a connected machine an origin you added, run a new command on it. In Connect a machine, copy a new command. On the machine, remove the old container with docker rm -f mcpm-server-tunnel, then run the new command. The machine connects again as a new machine, so terminate the old one in the Machines list. Each machine needs its own command, because a command works once. For the next machine, select re-generate command, next to the expiry time.
Terminating a machine or a tunnel
Someone with Manage tunnels can terminate a single machine or a whole tunnel in the Tunnels section. Both take effect from the next request, and requests in flight through a terminated machine fail.
Terminate a machine when it’s retired, lost, or may be compromised. MCP Manager revokes the machine first, so it gets no traffic from the next request on, even if it’s still running. The machine is refused at its next check-in, stops carrying traffic, and goes quiet. Other machines on the tunnel keep serving. Termination is permanent: to use that host again, connect it with a new command.
Terminate the tunnel with Revoke all machines, under Manage this tunnel on the tunnel’s page, to cut off a whole network at once. This terminates every machine on it and cancels the commands nobody has used. It doesn’t change whether the tunnel is on: an enabled tunnel stays enabled and takes new machines, so connect a machine with a new command to use it again. If part of the termination fails, the alert says which part, and you select Revoke all machines again. See The machines of a tunnel were only partly terminated.
Turning a tunnel off is a different action, and it terminates nothing. While a tunnel is disabled or archived, MCP Manager sends no request through it, and every server bound to it fails with Tunnel disabled. Its machines stay connected and keep checking in, and the tunnel takes no new machine and no new command. Its machines start no update while it’s off: the Tunnels section shows them as waiting. Turn it back on and requests flow through the same machines again, with nothing to reinstall.Each termination raises an alert that names who did it. To clean up the host afterwards, remove the container and its volume:
docker volume ls --filter name=mcpm-tunnel lists the volume names.
Who can manage server tunnels
Server tunnels are managed with one capability, Manage tunnels, and they must be enabled for your workspace. The capability can be granted to any role. Someone with Manage roles turns it on for the roles that need it.
Action
Who can do it
Create, rename, turn off or archive a server tunnel, and generate its commands
Manage tunnels
Mark a server as Reached through a tunnel, choose its tunnel, or change its URL
Manage tunnels
Edit a tunnel’s allowed destinations
Manage tunnels
See every tunnel and machine, with each machine’s version and update status, and terminate any of them
Manage tunnels
Publish releases, choose which release machines move to, and pause updates
MCP Manager staff only
Assign a tunneled server to a gateway
Basic gateway management
Sign in to a tunneled server with your own identity
Available to everyone
Manage tunnels doesn’t let its holder read anyone else’s credentials or see more of the logs than their other capabilities allow. A server goes through exactly one tunnel. To switch it, use Move to another tunnel on the server’s page.
Server tunnel or workstation
A server tunnel and a workstation both reach servers MCP Manager can’t reach directly, and both connect outbound only. They differ in who owns the machine and whose sign-in goes through it. Use a server tunnel when many people reach an internal server through one shared machine, each as themselves. Use a workstation for a server that runs on one person’s own machine.
Server tunnel
Workstation
Who owns it
Your organization
One user
What it reaches
Servers on its network, by URL
MCP servers on or near that user’s machine
Whose sign-in
Each user signs in as themselves
The owner’s, or a shared identity the owner makes Global
Credentials it sees
Every user’s, so it must run on your organization’s infrastructure
Its owner’s own
Machines
One or more per tunnel, for failover
One machine at a time per user, serving all of that user’s workstation servers
Updates
Automatic. You run the command once, and the tunnel updates itself.
Run the latest command from the setup window
Set up by
Someone with Manage tunnels
Each user, with the workstation capabilities
When a request through a server tunnel fails
A request through a server tunnel can fail in four ways. The AI client gets a short error that links to its section on this page. The full message, with the URL and the tunnel, is in the request’s log entry and, except for Tunnel disabled, in an alert. A destination that isn’t on the list is covered under Allowed destinations; the other three are below.
Tunnel unavailable
Tunnel unavailable (MCPM_TUNNEL_UNAVAILABLE, HTTP 503) means the server’s tunnel has no machine that can take the request right now. The message names the tunnel. MCP Manager sent nothing to the internal server, and it never calls the server directly instead. The usual causes:
No machine is online. The machine is off, Docker is stopped, or the tunnel container isn’t running.
Its worker stopped. A release kept crashing, or the launcher had to stop the worker for memory. The launcher raises A tunnel machine reports a failure. See What each tunnel alert means.
The machine can’t reach MCP Manager. A firewall or proxy blocks one of the hosts it needs.
Its last machine was terminated.
A brief failure inside MCP Manager. The message then says so, and a retry succeeds.
To fix it:
Open the tunnel in the Tunnels section and check whether any machine is online and when each was last seen.
On the machine, check that the tunnel container is running, and read its log. The log holds the launcher’s events and the worker’s own messages:
Misconfigured (MCPM_TUNNEL_MISCONFIGURED, HTTP 500) means a server is marked as Reached through a tunnel but MCP Manager can’t route it through one. Either it isn’t bound to exactly one active tunnel, or it isn’t a standalone remote server. Usually the server was saved without a tunnel. MCP Manager won’t guess where to send the request, and it never falls back to calling the server’s URL directly.To fix it, someone with Manage tunnels opens the server in MCP Servers and chooses its tunnel again. The next request uses the new binding. Only a standalone remote server can be reached through a tunnel; the error’s details name the server’s type when that’s the cause.
Tunnel disabled
Tunnel disabled (MCPM_TUNNEL_DISABLED, HTTP 503) means an admin disabled or archived the server’s tunnel. It’s a choice, not a fault: MCP Manager sent nothing to the network behind the tunnel, and it never calls the server directly instead. The message names the tunnel and links to its page. The tunnel’s machines aren’t terminated, so nothing needs to be reinstalled.To fix it, someone with Manage tunnels turns on the tunnel’s Enabled switch in the Tunnels list. If the tunnel was archived, switch on Show archived and unarchive it first. The next request goes through the same machines.
When a machine does not come online or does not update
These states show in the Tunnels section, on the machine. Each one says what MCP Manager knows, what it means for traffic, and what to do. Machine states are Online, Offline and Terminated. Worker states are Joining, Being checked (update), Serving traffic and Draining (being replaced).
The install command is refused
When MCP Manager refuses the command, the machine never connects. Its log says why, with a link to the page that fixes it:
terminal
docker logs mcpm-server-tunnel --tail 200
The log says
What it means
What to do
This enrollment command was already used or revoked.
A command connects one machine, once. It was already run, or Revoke all machines cancelled it.
Generate a new command.
This enrollment command has expired.
A command works for 24 hours after it’s made.
Generate a new command.
Tunnel … was disabled (or archived) in MCP Manager and takes no new machines
The tunnel is off.
Enable it in the Tunnels list, unarchiving it first if it’s archived. Then generate a new command.
This machine was terminated in MCP Manager.
The command was run again after its machine was terminated.
Generate a new command.
This enrollment command is not valid.
The token in the command is wrong, often because only part of the command was copied.
Copy the command again with Copy command, not from the shortened line on screen.
To generate a new command, open the tunnel in the Tunnels section and select Connect a machine, or select re-generate command next to the expiry time if the window is still open. Before you run it, remove the refused container with docker rm -f mcpm-server-tunnel, because the new command starts a container with the same name.
A worker stays in Joining
A worker in the Joining state has started but hasn’t registered with MCP Manager yet. The machine carries no traffic through that worker until it registers.The usual causes are a firewall or proxy that blocks headscale.mcpmanager.ai, derp-a.mcpmanager.ai or derp-b.mcpmanager.ai, a release that can’t be downloaded from Docker Hub, and a join key that expired because the machine was asleep. To find the cause, read the container’s log:
A machine shows as Offline when it has no serving worker that checked in recently. It gets no traffic until one does.To fix it, check that the container exists and is running, and start it if it stopped:
terminal
docker ps -a --filter name=mcpm-server-tunneldocker start mcpm-server-tunnel
If the container is gone and its volume is gone too, the machine lost its identity and needs a new command. If only the container is gone, connect the host again with a new command too, because a command works once. Then terminate the old machine in the Machines list.
An update shows Waiting its turn
Waiting its turn means a newer release exists and this machine hasn’t got it yet. The status gives the reason: MCP Manager updates one machine at a time across all tunnels unless staff raise that, staff paused updates, or the tunnel is off. Updates also pause by themselves for everyone when several new releases fail in a short time. The machine keeps running its current version and serves traffic as usual. Unless the tunnel is off, nothing is needed from you.If the status also says the machine hasn’t checked in recently, it can’t start anything until it’s back online. See A machine shows as offline.
An update shows Update failed
Update failed means the update didn’t finish. The status shows the reason and the time. The machine keeps serving on its current version. MCP Manager raised one alert for the tunnel and release, which you find on the Alerts page.The reason says which part failed:
The launcher refused the release. It failed one of the signature or version checks, or it has nothing for this machine’s operating system and CPU type. This won’t succeed on retry, so the machine isn’t offered that release again.
The download failed. Docker Hub couldn’t be reached, or the download was cut short. MCP Manager tries again later.
The new worker failed MCP Manager’s checks. The reason names the check, for example that it can’t reach a specific allowed origin. MCP Manager doesn’t offer that release to the machine again until the tunnel’s allowed destinations change or a newer release comes out, so fixing the network alone doesn’t retry it. Removing an origin the machine can’t reach offers it again. If the tunnel lists more than 100 origins, which only a list saved outside the editor can, the reason says at most 100 can be checked: remove the origins the tunnel no longer needs.
When a release failed on your machine, tell support the tunnel name, the reason and the time shown, so staff can publish a release for the machine to move to.
A machine shows No release available yet
No release available yet means MCP Manager hasn’t published a release yet, so there’s nothing to update to. A machine that has no worker yet gets none until a release is published. Machines that already run a worker are unaffected.
What each tunnel alert means
Tunnel alerts link to this page. Find yours by its title or its code. Each entry says what the alert means, what happens to traffic meanwhile, and what to do. For alerts in general, see Alerts.
Two launchers run as one tunnel machine
warning.tunnel.duplicate_agent. Two launchers check in with the same machine’s key at the same time. That happens when a virtual machine is copied, or when a second container starts with a copy of the machine’s volume. MCP Manager can’t tell their workers apart.Meanwhile: MCP Manager refuses neither copy, and traffic keeps flowing.What to do: remove the copy’s container. It most likely has the same name as the original, which the alert names: mcpm-server-tunnel. If you can’t tell which one is the copy, terminate the machine in the Machines list and connect each host again with its own new command.
A tunnel machine reports a failure
error.tunnel.launcher_failure. The launcher on the machine reports one of these, named in the alert:
crash_loop. A new release died several times in a row before it served steadily. The launcher won’t start it again until another release becomes stable or the launcher restarts. Meanwhile, the machine runs the last release that served steadily. Tell support the tunnel name and the alert’s text.
memory_kill of the worker that carries traffic. The container neared its memory limit, and the launcher had to stop the serving worker. That machine carries no traffic until the launcher starts a worker again. Requests go to the tunnel’s other machines, and with no other machine online they fail with Tunnel unavailable. If it happens again, tell support.
A tunnel machine takes no updates until it repairs its trust record
error.tunnel.launcher_failure with trust_damaged. The launcher found its record of trusted signing keys or its minimum release damaged.Meanwhile: the machine keeps running the release it has and keeps serving traffic. It refuses every new release, fixes included, until it has repaired the record.What to do: usually nothing. The launcher repairs the record by itself, from statements it reads from the release registry or gets from MCP Manager, with no reinstall. If the machine still reports this after several hours, check that it can reach Docker Hub (see What the tunnel machine needs), and look in its log for trust_damaged and then trust_rebuilt.
A tunnel machine reports a problem
warning.tunnel.launcher_warning. The launcher reports a problem it works around. The machine keeps serving traffic. The alert names the problem:
pulse_lost. A worker stopped answering the launcher, so the launcher stopped it.
memory_kill. The container neared its memory limit, and the launcher stopped a worker that wasn’t carrying traffic, such as a new release being checked.
journal_write_failed or journal_problem. The launcher couldn’t write or read its records in the volume. Check that the host’s disk isn’t full.
check_failed. The launcher’s own check of the release registries didn’t finish. It keeps the release it runs and checks again later.
no_process_limit, process_ceiling_below_minimum, memory_watchdog_off or swap_allowed. The container wasn’t started with the --pids-limit, --memory and --memory-swap values from the command, so one of the limits that stop runaway software is missing. Connect the host again with a new command, run as MCP Manager gives it, and terminate the old machine.
Any other code, such as root_set_refused, helper_failed, layout_problem, kind_mismatch or internal_error. The alert’s text gives the reason. If it repeats, tell support the tunnel name and the alert’s text.
Requests claiming to be a tunnel machine were refused
warning.tunnel.machine_refused. MCP Manager refused several requests in a row that claim to be one machine, because their signature doesn’t match the key it holds for that machine.Meanwhile: anyone who knows a machine’s id can send such requests, and they change nothing. If the machine still checks in, nothing needs doing. If the machine itself sent them, it reaches nothing, and its workers keep retrying.What to do: this happens when a machine was restored from an old backup of its volume, or when a key renewal didn’t finish. Terminate the machine and connect the host again with a new command.
A tunnel machine signed a request with a counter that went backwards
warning.tunnel.machine_refused. A launcher numbers its signed requests in order, and this request carried a number far below the highest one MCP Manager has accepted from the machine. Usually the machine was restored from a backup or snapshot of its volume, or an older copy of it runs on another host.Meanwhile: requests from that older state stay refused. Its check-ins fail, and a worker of it that restarts can’t join the tunnel again.What to do: if a copy runs on another host, remove it first. Then terminate the machine and connect the host again with a new command.
The machines of a tunnel were only partly terminated
warning.tunnel.termination_incomplete. Someone selected Revoke all machines, and only part of it finished. The alert says how many machines were terminated and what failed.Meanwhile: a machine that wasn’t terminated keeps carrying traffic, and a command that wasn’t cancelled can still connect a machine.What to do: open the tunnel and select Revoke all machines again.
A tunnel update failed on a machine
warning.tunnel.update_deferred. When MCP Manager will try the release again, the title is A tunnel update hit a problem on a machine instead. A new release didn’t start on the machine, and the alert says at which step and why.Meanwhile: the current version keeps serving.What to do: see An update shows Update failed.
Alerts that are no longer raised
error.tunnel.no_healthy_worker, warning.tunnel.replacement_incomplete and warning.tunnel.trust_state_unsaved came from the earlier tunnel agent, which is gone. MCP Manager no longer raises them, but older alerts can still show them. Nothing needs doing about an old one.
Further reading
Connect an internal server through a tunnel
The hands-on tutorial: create a tunnel, connect a machine, and let each user sign in as themselves.
Workstation MCP Servers
Servers on one person’s own machine, reached through an encrypted tunnel.
Remote MCP Servers
Servers at a URL, and the authentication methods they use.
Architecture & Trust
How the gateway path is secured, and where a server tunnel fits.
External sources
WireGuard
The encrypted-tunnel protocol that server tunnels are built on.
Docker run reference: runtime privilege and Linux capabilities
What --cap-drop, --cap-add and --security-opt do.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MCP Manager","description":"MCP Manager by Usercentrics is the governance and security layer for Model Context Protocol — connect, control, and monitor MCP servers and gateways across your organization.","colors":{"primary":"#0E7490","light":"#22D3EE","dark":"#0E7490"},"logo":{"light":"https://mintcdn.com/mcpmanagerbyusercentrics/6VTit4ttpXMM_zQN/images/mcp-manager-gradient-horizontal.png?fit=max\u0026auto=format\u0026n=6VTit4ttpXMM_zQN\u0026q=85\u0026s=e94ab5f0ba0a199071d9382c369a563e","dark":"https://mintcdn.com/mcpmanagerbyusercentrics/6VTit4ttpXMM_zQN/images/mcp-manager-white-horizontal.png?fit=max\u0026auto=format\u0026n=6VTit4ttpXMM_zQN\u0026q=85\u0026s=03d0f45c0c62b8c1b31002cd74b751c0"},"favicon":{"light":"https://mintcdn.com/mcpmanagerbyusercentrics/gKqTvJPtsRi2bLNx/images/android-chrome-512x512.png?fit=max\u0026auto=format\u0026n=gKqTvJPtsRi2bLNx\u0026q=85\u0026s=4e67940baa41dee1997379b94a6740fb","dark":"https://mintcdn.com/mcpmanagerbyusercentrics/gKqTvJPtsRi2bLNx/images/android-chrome-512x512.png?fit=max\u0026auto=format\u0026n=gKqTvJPtsRi2bLNx\u0026q=85\u0026s=4e67940baa41dee1997379b94a6740fb"},"footer":{"socials":{}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mcpmanagerbyusercentrics","hasAudioNarration":false,"actualSubdomain":"mcpmanagerbyusercentrics","customDomains":["docs.mcpmanager.ai"],"gitSource":{"type":"github","owner":"mcp-manager","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b009a50a93ccdf7d318edcd","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Features","count":19},{"language":"default","tag":"MCP Server Guides","count":14},{"language":"default","tag":"Admin API \u0026 MCP","count":13},{"language":"default","tag":"Enterprise","count":13},{"language":"default","tag":"Deployment","count":12},{"language":"default","tag":"MCP Gateway Concepts","count":12},{"language":"default","tag":"Tutorials","count":11},{"language":"default","tag":"Gateway Rules","count":10},{"language":"default","tag":"Industries","count":10},{"language":"default","tag":"Advanced","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"diagrams.css","content":".dg,.tdg{--tdg-surface: #ffffff;--tdg-surface-2: #eef4f6;--tdg-ink: #0b2236;--tdg-muted: #4c6274;--tdg-line: #d2dee6;--tdg-accent: #0e7490;--tdg-accent-soft: #dcf3f8;--tdg-ok: #0c8a5c;--tdg-ok-soft: #daf4e8;--tdg-warn: #a35a06;--tdg-warn-soft: #fcebd2;--tdg-bad: #c2362b;--tdg-bad-soft: #fde4e1;--tdg-idle: #5b6a77;--tdg-idle-soft: #e5ecf0;--tdg-night: #061826;--tdg-night-2: #0b2537;--tdg-night-ink: #e7f5fb;--tdg-night-muted: #8fb2c6;--tdg-night-line: #1f4058;--tdg-glow: #22d3ee;--tdg-mint: #2fedb4;--tdg-amber: #f5c451;--tdg-risk: #ff7a6e;color:var(--tdg-ink)}html.dark .dg,html.dark .tdg{--tdg-surface: #0e1c28;--tdg-surface-2: #132634;--tdg-ink: #e3eef4;--tdg-muted: #9db3c2;--tdg-line: #24394b;--tdg-accent: #22d3ee;--tdg-accent-soft: #0c3240;--tdg-ok: #3ddc97;--tdg-ok-soft: #0f3326;--tdg-warn: #f5a524;--tdg-warn-soft: #39290c;--tdg-bad: #ff8a7e;--tdg-bad-soft: #3a1714;--tdg-idle: #a2b3bf;--tdg-idle-soft: #1b2a36}.dg{margin:1.5rem 0;container-type:inline-size}.dg-frame{border:1px solid var(--tdg-line);border-radius:16px;background:var(--tdg-surface);overflow:hidden}.dg-bar{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:8px 12px;padding:8px 10px 8px 14px;border-bottom:1px solid var(--tdg-line);background:var(--tdg-surface-2)}.dg-title{font:600 0.68rem/1.3 ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace;letter-spacing:0.08em;text-transform:uppercase;color:var(--tdg-muted);min-width:0}.dg-tabs{display:inline-flex;gap:2px;padding:2px;border-radius:999px;border:1px solid var(--tdg-line);background:var(--tdg-surface);margin-left:auto}.dg-tab{font:600 0.74rem/1 system-ui, -apple-system, 'Segoe UI', sans-serif;padding:6px 11px;border-radius:999px;border:0;background:transparent;color:var(--tdg-muted);cursor:pointer;transition:background-color 0.15s ease,\n color 0.15s ease}.dg-tab:hover{color:var(--tdg-ink)}.dg-tab[aria-selected=\"true\"]{background:var(--tdg-accent-soft);color:var(--tdg-accent)}.dg-tab:focus-visible{outline:2px solid var(--tdg-accent);outline-offset:1px}.dg-panel{padding:12px}.dg-panel[hidden]{display:none}.dg-panel>.tdg{margin:0}.dg-panel-diagram:has(>.tdg>.tdg-night){padding:0}.dg-panel>.tdg>.tdg-night{border:0;border-radius:0}.dg-panel>.tdg>.tdg-card{border:0;padding:0;background:transparent}.dg-panel-mermaid{overflow-x:auto}.dg-panel-mermaid>:first-child{margin-top:0!important}.dg-panel-mermaid>:last-child{margin-bottom:0!important}.dg-panel-text{padding:0}.dg-code-head{display:flex;align-items:center;justify-content:space-between;padding:6px 10px 6px 14px;border-bottom:1px solid var(--tdg-line);font:600 0.66rem/1.2 ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace;letter-spacing:0.08em;text-transform:uppercase;color:var(--tdg-muted)}.dg-copy{font:600 0.72rem/1 system-ui, -apple-system, 'Segoe UI', sans-serif;letter-spacing:0;text-transform:none;padding:5px 10px;border-radius:8px;border:1px solid var(--tdg-line);background:var(--tdg-surface);color:var(--tdg-ink);cursor:pointer}.dg-copy:hover{border-color:var(--tdg-accent);color:var(--tdg-accent)}.dg-copy:focus-visible{outline:2px solid var(--tdg-accent);outline-offset:1px}.dg .dg-code pre{margin:0!important;padding:12px 14px!important;border:0!important;border-radius:0!important;background:var(--tdg-surface-2)!important;overflow-x:auto;font:400 0.78rem/1.6 ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace;color:var(--tdg-ink)}.dg .dg-code code{display:block;padding:0!important;background:none!important;border:0!important;font:inherit;color:inherit;white-space:pre}.dg-code-line{display:block;min-height:1.6em}.dg-hl-comment{color:var(--tdg-muted);opacity:0.75}.dg-hl-keyword{color:#7c3aed;font-weight:600}.dg-hl-string{color:#0c6b4f}.dg-hl-label{color:#a35a06}.dg-hl-arrow{color:var(--tdg-accent);font-weight:600}html.dark .dg-hl-keyword{color:#c4a5ff}html.dark .dg-hl-string{color:#7ee2b8}html.dark .dg-hl-label{color:#f5c451}.dg-steps{border-top:1px solid var(--tdg-line)}.dg-steps>summary{list-style:none;cursor:pointer;display:flex;align-items:center;gap:8px;padding:10px 14px;font:600 0.82rem/1.3 system-ui, -apple-system, 'Segoe UI', sans-serif;color:var(--tdg-ink);background:var(--tdg-surface-2)}.dg-steps>summary::-webkit-details-marker{display:none}.dg-steps>summary::before{content:'';width:7px;height:7px;border-right:2px solid var(--tdg-muted);border-bottom:2px solid var(--tdg-muted);transform:rotate(-45deg);transition:transform 0.15s ease;flex:none}.dg-steps[open]>summary::before{transform:rotate(45deg)}.dg-steps>summary:hover{color:var(--tdg-accent)}.dg-steps>summary:focus-visible{outline:2px solid var(--tdg-accent);outline-offset:-2px}.dg-steps-body{padding:6px 18px 14px;font-size:0.92rem;line-height:1.6;border-top:1px solid var(--tdg-line)}.dg-steps-body>:first-child{margin-top:0.5rem!important}.dg-steps-body>:last-child{margin-bottom:0!important}.dg-steps-body li{margin:0.2rem 0!important}.dg figcaption{margin-top:0.6rem;color:var(--tdg-muted);font-size:0.875rem;line-height:1.5}@media (prefers-reduced-motion: reduce){.dg-tab,.dg-steps>summary::before{transition:none}}"},{"filePath":"tunnel-diagrams.css","content":".tdg{margin:1.5rem 0;container-type:inline-size}.tdg figcaption{margin-top:0.6rem;color:var(--tdg-muted);font-size:0.875rem;line-height:1.5}.tdg-mono{font-family:ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace}.tdg-eyebrow{font:600 0.68rem/1.2 ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace;letter-spacing:0.1em;text-transform:uppercase;color:var(--tdg-accent)}.tdg-night{background:radial-gradient(900px 380px at 72% 10%, var(--tdg-night-2), var(--tdg-night) 62%);border:1px solid var(--tdg-night-line);border-radius:16px;padding:12px;overflow:hidden}.tdg-night svg{display:block;width:100%;height:auto}.tdg-tall{display:none!important}@container (max-width: 520px){.tdg-wide{display:none!important}.tdg-tall{display:block!important;max-width:380px;margin:0 auto}}.tdg-night .n-node{fill:#10212f;stroke:var(--tdg-night-line);stroke-width:1.4}.tdg-night .n-gate{fill:#092b3a;stroke:var(--tdg-glow);stroke-width:1.6}.tdg-night .n-box{fill:#092730;stroke:var(--tdg-mint);stroke-width:2;animation:tdg-breathe 3.2s ease-in-out infinite}.tdg-night .n-frame{fill:none;stroke:var(--tdg-night-line);stroke-width:1.4;stroke-dasharray:7 6}.tdg-night .n-pipe{fill:#092b3a;stroke:var(--tdg-glow);stroke-width:1.6}.tdg-night .n-bar{fill:#0c3443;stroke:var(--tdg-glow);stroke-width:1}.tdg-night .n-ok{stroke:var(--tdg-mint)}.tdg-night .n-bad{fill:none;stroke:var(--tdg-risk);stroke-width:1.4;stroke-dasharray:5 5}.tdg-night .n-flow{fill:none;stroke:var(--tdg-glow);stroke-width:2;stroke-dasharray:2 12;stroke-linecap:round;opacity:0.7;animation:tdg-flow 1.2s linear infinite}.tdg-night .n-link{fill:none;stroke:var(--tdg-mint);stroke-width:1.6;stroke-dasharray:4 6;stroke-linecap:round;opacity:0.85;animation:tdg-flow 1.4s linear infinite}.tdg-night .n-quiet{fill:none;stroke:var(--tdg-night-muted);stroke-width:1.3;stroke-dasharray:3 5;opacity:0.8}.tdg-night .n-t{fill:var(--tdg-night-ink);font:600 13px system-ui, -apple-system, 'Segoe UI', sans-serif}.tdg-night .n-s{fill:var(--tdg-night-muted);font:400 11.5px system-ui, -apple-system, 'Segoe UI', sans-serif}.tdg-night .n-s-ink{fill:var(--tdg-night-ink)}.tdg-night .n-m{fill:var(--tdg-glow);font:600 10.5px ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace;letter-spacing:0.05em}.tdg-night .n-m-ok{fill:var(--tdg-mint)}.tdg-night .n-m-warm{fill:var(--tdg-amber)}.tdg-night .n-m-idle{fill:var(--tdg-night-muted)}.tdg-night .n-m-bad{fill:var(--tdg-risk)}.tdg-night .n-slot{fill:rgba(255, 255, 255, 0.05);stroke:var(--tdg-night-line)}.tdg-night .n-slot-on{fill:rgba(47, 237, 180, 0.16);stroke:var(--tdg-mint)}.tdg-night .n-slot-warm{fill:rgba(245, 196, 81, 0.14);stroke:var(--tdg-amber)}.tdg-night .n-stop{fill:var(--tdg-night);stroke:var(--tdg-risk);stroke-width:1.6}.tdg-night .n-x{stroke:var(--tdg-risk);stroke-width:2.4;stroke-linecap:round}.tdg-night .pk{fill:var(--tdg-glow)}.tdg-night .pk-back{fill:var(--tdg-mint)}.tdg-night .pk-bad{fill:var(--tdg-risk)}.tdg-card{background:var(--tdg-surface);border:1px solid var(--tdg-line);border-radius:16px;padding:16px}.tdg-cd{display:grid;grid-template-columns:minmax(0, 1fr);gap:12px}.tdg-outside{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr));gap:10px}@container (max-width: 420px){.tdg-outside{grid-template-columns:minmax(0, 1fr)}}@container (min-width: 860px){.tdg-cd{grid-template-columns:minmax(0, 1fr) minmax(0, 2.6fr);align-items:stretch}.tdg-outside{grid-template-columns:minmax(0, 1fr);align-content:center}}.tdg-ext{border:1px solid var(--tdg-line);border-radius:12px;padding:10px 12px;display:grid;gap:3px;background:var(--tdg-surface-2);position:relative;overflow:hidden}.tdg-ext b{font-size:0.95rem}.tdg-ext span:last-child{color:var(--tdg-muted);font-size:0.82rem;line-height:1.4}.tdg-ext::after{content:'';position:absolute;left:0;right:0;bottom:0;height:2px;background:linear-gradient(90deg, transparent, var(--tdg-accent), transparent);background-size:200% 100%;animation:tdg-stream 2.6s linear infinite;opacity:0.7}.tdg-box{border:1.6px solid var(--tdg-accent);border-radius:14px;padding:12px;display:grid;gap:10px;background:color-mix(in srgb, var(--tdg-accent-soft) 35%, var(--tdg-surface))}.tdg-box-head{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:8px}.tdg-box-head code{font-size:0.82rem;background:none;padding:0}.tdg-chips{display:flex;flex-wrap:wrap;gap:6px}.tdg-chip{font:600 0.66rem/1 ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace;letter-spacing:0.04em;padding:5px 8px;border-radius:999px;border:1px solid currentColor;white-space:nowrap;color:var(--tdg-accent);background:var(--tdg-accent-soft)}.tdg-chip-ok{color:var(--tdg-ok);background:var(--tdg-ok-soft)}.tdg-chip-warn{color:var(--tdg-warn);background:var(--tdg-warn-soft)}.tdg-chip-idle{color:var(--tdg-idle);background:var(--tdg-idle-soft)}.tdg-launcher{border:1px solid var(--tdg-line);border-radius:12px;padding:10px 12px;background:var(--tdg-surface);display:grid;grid-template-columns:minmax(0, 1fr);gap:4px 14px;align-items:center}@container (min-width: 560px){.tdg-launcher{grid-template-columns:11rem minmax(0, 1fr)}}.tdg-launcher b{font-size:1rem}.tdg .tdg-launcher ul{margin:0!important;padding-left:1.1em!important;color:var(--tdg-muted);font-size:0.85rem;line-height:1.5}.tdg .tdg-launcher li{margin:0!important}.tdg-slots{display:grid;grid-template-columns:repeat(3, minmax(0, 1fr));gap:8px}@container (max-width: 440px){.tdg-slots{grid-template-columns:minmax(0, 1fr)}}.tdg-slot{border:1.5px dashed var(--tdg-line);border-radius:12px;padding:10px;display:grid;gap:4px;align-content:start;color:var(--tdg-idle);position:relative;overflow:hidden;min-width:0}.tdg-slot b{color:var(--tdg-ink);font-size:0.92rem}.tdg-slot span{font-size:0.8rem;line-height:1.4;color:var(--tdg-muted)}.tdg-slot .tdg-user{font:500 0.66rem/1.3 ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace;color:var(--tdg-idle)}.tdg-slot-on{border-style:solid;border-color:var(--tdg-ok);background:var(--tdg-ok-soft);animation:tdg-glow-ok 3.2s ease-in-out infinite}.tdg-slot-warm{border-style:solid;border-color:var(--tdg-warn);background:var(--tdg-warn-soft)}.tdg-slot-warm::after{content:'';position:absolute;inset:0;background:linear-gradient(100deg, transparent 30%, color-mix(in srgb, var(--tdg-warn) 18%, transparent) 50%, transparent 70%);transform:translateX(-100%);animation:tdg-shine 2.8s ease-in-out infinite}.tdg-row{display:grid;grid-template-columns:minmax(0, 1fr);gap:8px}@container (min-width: 760px){.tdg-row{grid-template-columns:minmax(0, 1fr) minmax(0, 2fr)}}.tdg-panel{border:1px solid var(--tdg-line);border-radius:12px;padding:10px 12px;background:var(--tdg-surface);display:grid;gap:6px;align-content:start;min-width:0}.tdg-panel>code{font-size:0.82rem;background:none;padding:0;font-weight:600}.tdg .tdg-panel p,.tdg .tdg-panel [data-as=\"p\"]{display:block;margin:0!important;font-size:0.82rem;line-height:1.45;color:var(--tdg-muted)}.tdg-vol{display:grid;grid-template-columns:repeat(3, minmax(0, 1fr));gap:6px}@container (max-width: 440px){.tdg-vol{grid-template-columns:minmax(0, 1fr)}}.tdg-vol div{border-radius:8px;background:var(--tdg-surface-2);padding:7px 8px;display:grid;gap:2px;min-width:0}.tdg-vol code{font-size:0.78rem;background:none;padding:0;color:var(--tdg-accent)}.tdg-vol span{font-size:0.74rem;line-height:1.35;color:var(--tdg-muted)}.tdg-steps{list-style:none!important;margin:0!important;padding:0!important;display:grid;grid-template-columns:minmax(0, 1fr);gap:10px;counter-reset:tdg-step}@container (min-width: 440px){.tdg-steps{grid-template-columns:repeat(2, minmax(0, 1fr))}}@container (min-width: 900px){.tdg-steps{grid-template-columns:repeat(4, minmax(0, 1fr))}}.tdg-step{margin:0!important;border:1px solid var(--tdg-line);border-radius:14px;padding:12px;display:grid;gap:8px;align-content:start;background:var(--tdg-surface);counter-increment:tdg-step;animation:tdg-spot 10s ease-in-out infinite;min-width:0}.tdg-step:nth-child(2){animation-delay:2.5s}.tdg-step:nth-child(3){animation-delay:5s}.tdg-step:nth-child(4){animation-delay:7.5s}.tdg-step-title{display:flex;gap:8px;align-items:center;font-weight:600;font-size:0.92rem;line-height:1.3}.tdg-step-title::before{content:counter(tdg-step);flex:none;width:22px;height:22px;border-radius:50%;display:grid;place-items:center;font:600 0.72rem/1 ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace;color:var(--tdg-accent);background:var(--tdg-accent-soft)}.tdg .tdg-step p,.tdg .tdg-step [data-as=\"p\"]{display:block;margin:0!important;font-size:0.8rem;line-height:1.45;color:var(--tdg-muted)}.tdg-mini{display:grid;grid-template-columns:repeat(3, minmax(0, 1fr));gap:5px}.tdg-mini span{border:1.4px dashed var(--tdg-line);border-radius:8px;padding:6px 4px;text-align:center;font:600 0.68rem/1.25 ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace;color:var(--tdg-idle);position:relative;min-width:0;overflow-wrap:anywhere}.tdg-mini small{display:block;font:500 0.6rem/1.2 system-ui, -apple-system, 'Segoe UI', sans-serif;letter-spacing:0;opacity:0.85}.tdg-mini .on{border-style:solid;border-color:var(--tdg-ok);background:var(--tdg-ok-soft);color:var(--tdg-ok)}.tdg-mini .on::after{content:'';position:absolute;top:4px;right:4px;width:6px;height:6px;border-radius:50%;background:var(--tdg-ok);animation:tdg-blink 1.6s ease-in-out infinite}.tdg-mini .warm{border-style:solid;border-color:var(--tdg-warn);background:var(--tdg-warn-soft);color:var(--tdg-warn)}.tdg-mini .out{border-style:solid;border-color:var(--tdg-idle);background:var(--tdg-idle-soft);color:var(--tdg-idle)}@keyframes tdg-flow{to{stroke-dashoffset:-14}}@keyframes tdg-breathe{0%,100%{stroke-opacity:1}50%{stroke-opacity:0.45}}@keyframes tdg-stream{from{background-position:100% 0}to{background-position:-100% 0}}@keyframes tdg-shine{0%,45%{transform:translateX(-100%)}100%{transform:translateX(100%)}}@keyframes tdg-glow-ok{0%,100%{box-shadow:0 0 0 0 transparent}50%{box-shadow:0 0 0 3px color-mix(in srgb, var(--tdg-ok) 22%, transparent)}}@keyframes tdg-blink{0%,100%{opacity:1}50%{opacity:0.3}}@keyframes tdg-spot{0%,22%,100%{border-color:var(--tdg-line);box-shadow:none}6%,18%{border-color:var(--tdg-accent);box-shadow:0 10px 26px -18px var(--tdg-accent)}}@media (prefers-reduced-motion: reduce){.tdg *,.tdg *::before,.tdg *::after{animation:none!important}.tdg .tdg-moving{display:none}}"},{"filePath":"diagram-kit.css","href":"/_mintlify/custom/mcpmanagerbyusercentrics/c466f41ae91190a3/diagram-kit.css"}]}
{"page":{"pagePath":"mcp-gateway-concepts/mcp-servers/server-tunnels","slug":"/mcp-gateway-concepts/mcp-servers/server-tunnels","pageMetadata":{"title":"Server Tunnels","diataxis":"explanation","sidebarTitle":"Server tunnels","description":"What a server tunnel is: a machine your organization runs next to internal servers, such as a self-hosted GitLab, through which MCP Manager reaches them while every user signs in as themselves. Covers the one command you run once and what each part of it allows, the container that runs on the machine (a launcher that never changes and workers that update themselves, with no Docker socket and no host folders), signed releases and how updates hand over with no downtime, the independent check that replaces a worker that won't update, the limits that stop runaway software, allowed destinations and the MCPM_TUNNEL_ALLOWED_ORIGINS cap, terminating a machine or a tunnel, the Manage tunnels capability, and what the tunnel-unavailable, update-failed, misconfigured and tunnel-disabled states mean.","icon":"route","keywords":["server tunnel","tunnel","internal server","self-hosted GitLab","Grafana","on-premises","private network","VPN","Reached through a tunnel","allowed destinations","allowed origins","MCPM_TUNNEL_ALLOWED_ORIGINS","MCPM_TUNNEL_UNAVAILABLE","MCPM_TUNNEL_DESTINATION_NOT_ALLOWED","MCPM_TUNNEL_MISCONFIGURED","MCPM_TUNNEL_DISABLED","mcpmanager/tunnel","launcher","worker","no Docker socket","cap-drop","read-only container","pids-limit","install command","Manage tunnels","terminate machine","automatic updates","signed release","root keys","release floor","zero downtime","Waiting its turn","Update failed","WireGuard","per-user identity"],"href":"/mcp-gateway-concepts/mcp-servers/server-tunnels"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"What a server tunnel is: a machine your organization runs next to internal servers, such as a self-hosted GitLab, through which MCP Manager reaches them while every user signs in as themselves. Covers the one command you run once and what each part of it allows, the container that runs on the machine (a launcher that never changes and workers that update themselves, with no Docker socket and no host folders), signed releases and how updates hand over with no downtime, the independent check that replaces a worker that won’t update, the limits that stop runaway software, allowed destinations and the MCPM_TUNNEL_ALLOWED_ORIGINS cap, terminating a machine or a tunnel, the Manage tunnels capability, and what the tunnel-unavailable, update-failed, misconfigured and tunnel-disabled states mean.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const TunnelHandoverDiagram=()=>_jsx(`div`,{className:`tdg`,children:_jsx(`div`,{className:`tdg-card`,children:_jsxs(`ol`,{className:`tdg-steps`,children:[_jsxs(`li`,{className:`tdg-step`,children:[_jsx(`div`,{className:`tdg-step-title`,children:`v8 serves`}),_jsxs(`div`,{className:`tdg-mini`,children:[_jsxs(`span`,{className:`on`,children:[`v8`,_jsx(`small`,{children:`serving`})]}),_jsx(`span`,{children:`free`}),_jsx(`span`,{children:`free`})]}),_jsx(`p`,{children:`The serving worker hears that v9 is out, downloads it, and hands it to the launcher.`})]}),_jsxs(`li`,{className:`tdg-step`,children:[_jsx(`div`,{className:`tdg-step-title`,children:`v9 starts beside it`}),_jsxs(`div`,{className:`tdg-mini`,children:[_jsxs(`span`,{className:`on`,children:[`v8`,_jsx(`small`,{children:`serving`})]}),_jsxs(`span`,{className:`warm`,children:[`v9`,_jsx(`small`,{children:`checked`})]}),_jsx(`span`,{children:`free`})]}),_jsx(`p`,{children:`The launcher checks v9 and starts it. MCP Manager tests it the way real traffic arrives.`})]}),_jsxs(`li`,{className:`tdg-step`,children:[_jsx(`div`,{className:`tdg-step-title`,children:`Traffic moves in one step`}),_jsxs(`div`,{className:`tdg-mini`,children:[_jsxs(`span`,{className:`out`,children:[`v8`,_jsx(`small`,{children:`finishing`})]}),_jsxs(`span`,{className:`on`,children:[`v9`,_jsx(`small`,{children:`serving`})]}),_jsx(`span`,{children:`free`})]}),_jsx(`p`,{children:`New requests go to v9. v8 finishes the requests it already has.`})]}),_jsxs(`li`,{className:`tdg-step`,children:[_jsx(`div`,{className:`tdg-step-title`,children:`v8 leaves`}),_jsxs(`div`,{className:`tdg-mini`,children:[_jsx(`span`,{children:`free`}),_jsxs(`span`,{className:`on`,children:[`v9`,_jsx(`small`,{children:`serving`})]}),_jsx(`span`,{children:`free`})]}),_jsx(`p`,{children:`v8 exits and its folder is emptied. Once v9 proves itself, it becomes the release to fall back to.`})]})]})})});const TunnelContainerDiagram=()=>_jsx(`div`,{className:`tdg`,children:_jsx(`div`,{className:`tdg-card`,children:_jsxs(`div`,{className:`tdg-cd`,children:[_jsxs(`div`,{className:`tdg-outside`,children:[_jsxs(`div`,{className:`tdg-ext`,children:[_jsx(`span`,{className:`tdg-eyebrow`,children:`Release registry`}),_jsx(`b`,{children:`Docker Hub`}),_jsx(`span`,{children:`Signed releases. Workers download them; the launcher checks them.`})]}),_jsxs(`div`,{className:`tdg-ext`,children:[_jsx(`span`,{className:`tdg-eyebrow`,children:`MCP Manager`}),_jsx(`b`,{children:`Gateway`}),_jsx(`span`,{children:`Workers check in here. The launcher signs each check-in with the machine key.`})]})]}),_jsxs(`div`,{className:`tdg-box`,children:[_jsxs(`div`,{className:`tdg-box-head`,children:[_jsx(`code`,{className:`tdg-mono`,children:`mcpm-server-tunnel`}),_jsxs(`div`,{className:`tdg-chips`,children:[_jsx(`span`,{className:`tdg-chip`,children:`read-only`}),_jsx(`span`,{className:`tdg-chip`,children:`no Docker socket`}),_jsx(`span`,{className:`tdg-chip`,children:`no host folders`})]})]}),_jsxs(`div`,{className:`tdg-launcher`,children:[_jsxs(`div`,{children:[_jsx(`div`,{className:`tdg-eyebrow`,children:`Process 1 · no network`}),_jsx(`b`,{children:`Launcher`})]}),_jsxs(`ul`,{children:[_jsx(`li`,{children:`checks every release before it runs`}),_jsx(`li`,{children:`keeps the machine key to itself`}),_jsx(`li`,{children:`starts each worker as its own user`})]})]}),_jsxs(`div`,{className:`tdg-slots`,children:[_jsxs(`div`,{className:`tdg-slot tdg-slot-on`,children:[_jsx(`span`,{className:`tdg-eyebrow`,style:{color:`var(--tdg-ok)`},children:`Serving`}),_jsx(`b`,{children:`Worker v8`}),_jsx(`span`,{children:`Carries your traffic.`}),_jsx(`span`,{className:`tdg-user`,children:`own user · no privileges`})]}),_jsxs(`div`,{className:`tdg-slot tdg-slot-warm`,children:[_jsx(`span`,{className:`tdg-eyebrow`,style:{color:`var(--tdg-warn)`},children:`Being checked`}),_jsx(`b`,{children:`Worker v9`}),_jsx(`span`,{children:`A new release, started beside v8.`}),_jsx(`span`,{className:`tdg-user`,children:`own user · no privileges`})]}),_jsxs(`div`,{className:`tdg-slot`,children:[_jsx(`span`,{className:`tdg-eyebrow`,style:{color:`var(--tdg-idle)`},children:`Free`}),_jsx(`b`,{children:`Third place`}),_jsx(`span`,{children:`Holds a worker while it finishes and leaves.`}),_jsx(`span`,{className:`tdg-user`,children:`own user · no privileges`})]})]}),_jsxs(`div`,{className:`tdg-row`,children:[_jsxs(`div`,{className:`tdg-panel`,children:[_jsx(`span`,{className:`tdg-eyebrow`,children:`Built in`}),_jsx(`b`,{children:`Fetcher`}),_jsx(`p`,{children:`Downloads the current release on the first start, and whenever no stored release will run.`})]}),_jsxs(`div`,{className:`tdg-panel`,children:[_jsx(`span`,{className:`tdg-eyebrow`,children:`Volume`}),_jsx(`code`,{className:`tdg-mono`,children:`mcpm-tunnel-\u003cid>`}),_jsxs(`div`,{className:`tdg-vol`,children:[_jsxs(`div`,{children:[_jsx(`code`,{children:`trust/`}),_jsx(`span`,{children:`Machine key and the launcher's records. Launcher only.`})]}),_jsxs(`div`,{children:[_jsx(`code`,{children:`bundles/`}),_jsx(`span`,{children:`Releases that passed the checks. Read-only.`})]}),_jsxs(`div`,{children:[_jsx(`code`,{children:`work/`}),_jsx(`span`,{children:`A private folder for each worker.`})]})]})]})]})]})]})})});const TunnelPathDiagram=()=>{const packets=(path,className,count,duration,radius)=>Array.from({length:count},(_,index)=>_jsx(`circle`,{className,r:radius,children:_jsx(`animateMotion`,{path,dur:`${duration}s`,begin:`${-duration*index/count}s`,repeatCount:`indefinite`})},`${className}-${index}`));const label=`An AI app calls the MCP Manager gateway, which signs each person in, checks your rules and logs the call. The gateway sends the call through an encrypted tunnel that your machine opened outbound. On your network, one tunnel container passes it to the internal servers on its allowed destinations list, such as a self-hosted GitLab. Anything else is blocked. Each person signs in to GitLab from their own browser.`;return _jsx(`div`,{className:`tdg`,children:_jsxs(`div`,{className:`tdg-night`,children:[_jsxs(`svg`,{className:`tdg-wide`,viewBox:`0 0 640 520`,role:`img`,\"aria-label\":label,children:[_jsx(`path`,{className:`n-flow`,d:`M166 78 L 226 78`}),_jsx(`path`,{className:`n-flow`,d:`M336 138 L 336 158 M336 276 L 336 326`}),_jsx(`path`,{className:`n-link`,d:`M426 360 C 448 360, 448 352, 470 352`}),_jsx(`path`,{className:`n-link`,d:`M426 404 C 448 404, 448 416, 470 416`}),_jsx(`path`,{className:`n-bad`,d:`M426 460 C 448 460, 448 474, 466 474`}),_jsx(`path`,{className:`n-quiet`,d:`M119 326 L 119 310 L 540 310 L 540 326`}),_jsx(`rect`,{className:`n-node`,x:`16`,y:`40`,width:`150`,height:`76`,rx:`14`}),_jsx(`circle`,{cx:`91`,cy:`63`,r:`11`,fill:`none`,stroke:`#8fb2c6`,strokeWidth:`1.6`}),_jsx(`circle`,{cx:`87`,cy:`61`,r:`1.8`,fill:`#8fb2c6`}),_jsx(`circle`,{cx:`95`,cy:`61`,r:`1.8`,fill:`#8fb2c6`}),_jsx(`text`,{x:`91`,y:`99`,className:`n-t`,textAnchor:`middle`,children:`AI app or agent`}),_jsx(`rect`,{className:`n-gate`,x:`226`,y:`18`,width:`220`,height:`120`,rx:`16`}),_jsx(`text`,{x:`336`,y:`44`,className:`n-m`,textAnchor:`middle`,children:`MCP MANAGER`}),_jsx(`text`,{x:`336`,y:`66`,className:`n-t`,textAnchor:`middle`,children:`Gateway`}),_jsx(`text`,{x:`336`,y:`92`,className:`n-s`,textAnchor:`middle`,children:`signs each person in`}),_jsx(`text`,{x:`336`,y:`110`,className:`n-s`,textAnchor:`middle`,children:`checks your rules`}),_jsx(`text`,{x:`336`,y:`128`,className:`n-s`,textAnchor:`middle`,children:`logs every call`}),_jsx(`rect`,{className:`n-pipe`,x:`312`,y:`158`,width:`48`,height:`118`,rx:`24`}),_jsx(`rect`,{x:`329`,y:`213`,width:`14`,height:`11`,rx:`2.5`,fill:`none`,stroke:`#22d3ee`,strokeWidth:`1.6`}),_jsx(`path`,{d:`M332 213 v-3 a4 4 0 0 1 8 0 v3`,fill:`none`,stroke:`#22d3ee`,strokeWidth:`1.6`}),_jsx(`text`,{x:`376`,y:`200`,className:`n-m`,children:`ENCRYPTED TUNNEL`}),_jsx(`text`,{x:`376`,y:`215`,className:`n-m`,children:`WIREGUARD`}),_jsx(`text`,{x:`376`,y:`238`,className:`n-s`,children:`your machine dials out`}),_jsx(`text`,{x:`376`,y:`255`,className:`n-s`,children:`no inbound port`}),_jsx(`rect`,{className:`n-frame`,x:`16`,y:`296`,width:`608`,height:`212`,rx:`18`}),_jsx(`text`,{x:`34`,y:`494`,className:`n-m n-m-idle`,children:`YOUR NETWORK`}),_jsx(`rect`,{className:`n-node`,x:`34`,y:`326`,width:`170`,height:`52`,rx:`10`}),_jsx(`text`,{x:`119`,y:`347`,className:`n-s n-s-ink`,textAnchor:`middle`,children:`Each person's browser`}),_jsx(`text`,{x:`119`,y:`365`,className:`n-s`,textAnchor:`middle`,children:`signs in to GitLab directly`}),_jsx(`text`,{x:`34`,y:`404`,className:`n-s`,children:`Sign-in pages open in each`}),_jsx(`text`,{x:`34`,y:`420`,className:`n-s`,children:`person's own browser, on your`}),_jsx(`text`,{x:`34`,y:`436`,className:`n-s`,children:`network or VPN.`}),_jsx(`rect`,{className:`n-box`,x:`246`,y:`326`,width:`180`,height:`166`,rx:`16`}),_jsx(`text`,{x:`336`,y:`350`,className:`n-t`,textAnchor:`middle`,children:`Tunnel container`}),_jsx(`rect`,{className:`n-bar`,x:`260`,y:`360`,width:`152`,height:`22`,rx:`6`}),_jsx(`text`,{x:`336`,y:`375`,className:`n-m`,textAnchor:`middle`,children:`LAUNCHER`}),_jsx(`rect`,{className:`n-slot n-slot-on`,x:`260`,y:`390`,width:`44`,height:`26`,rx:`6`}),_jsx(`text`,{x:`282`,y:`407`,className:`n-m n-m-ok`,textAnchor:`middle`,children:`v8`}),_jsx(`rect`,{className:`n-slot n-slot-warm`,x:`314`,y:`390`,width:`44`,height:`26`,rx:`6`}),_jsx(`text`,{x:`336`,y:`407`,className:`n-m n-m-warm`,textAnchor:`middle`,children:`v9`}),_jsx(`rect`,{className:`n-slot`,x:`368`,y:`390`,width:`44`,height:`26`,rx:`6`}),_jsx(`text`,{x:`390`,y:`407`,className:`n-m n-m-idle`,textAnchor:`middle`,children:`free`}),_jsx(`text`,{x:`336`,y:`446`,className:`n-s`,textAnchor:`middle`,children:`no Docker socket`}),_jsx(`text`,{x:`336`,y:`464`,className:`n-s`,textAnchor:`middle`,children:`no host folders`}),_jsx(`rect`,{className:`n-node n-ok`,x:`470`,y:`326`,width:`140`,height:`52`,rx:`12`}),_jsx(`text`,{x:`540`,y:`348`,className:`n-t`,textAnchor:`middle`,children:`Self-hosted GitLab`}),_jsx(`text`,{x:`540`,y:`367`,className:`n-m n-m-ok`,textAnchor:`middle`,children:`ALLOWED`}),_jsx(`rect`,{className:`n-node n-ok`,x:`470`,y:`390`,width:`140`,height:`52`,rx:`12`}),_jsx(`text`,{x:`540`,y:`412`,className:`n-t`,textAnchor:`middle`,children:`Internal Grafana`}),_jsx(`text`,{x:`540`,y:`431`,className:`n-m n-m-ok`,textAnchor:`middle`,children:`ALLOWED`}),_jsx(`rect`,{className:`n-bad`,x:`470`,y:`454`,width:`140`,height:`42`,rx:`12`}),_jsx(`text`,{x:`540`,y:`472`,className:`n-t`,textAnchor:`middle`,children:`Anything else`}),_jsx(`text`,{x:`540`,y:`488`,className:`n-m n-m-bad`,textAnchor:`middle`,children:`BLOCKED`}),_jsxs(`g`,{className:`tdg-moving`,children:[packets(`M166 72 L 226 72`,`pk`,2,1.4,4.5),packets(`M226 84 L 166 84`,`pk-back`,2,1.4,3.5),packets(`M330 160 L 330 274`,`pk`,3,2.4,4.5),packets(`M342 274 L 342 160`,`pk-back`,3,2.4,3.5),packets(`M426 360 C 448 360, 448 352, 470 352`,`pk-back`,1,1.8,3.5),_jsxs(`circle`,{className:`pk-bad`,r:`4`,opacity:`0`,children:[_jsx(`animateMotion`,{path:`M426 460 C 448 460, 448 474, 464 474`,dur:`4.5s`,keyPoints:`0;1;1`,keyTimes:`0;0.22;1`,calcMode:`linear`,repeatCount:`indefinite`}),_jsx(`animate`,{attributeName:`opacity`,values:`0;1;1;0;0`,keyTimes:`0;0.04;0.22;0.3;1`,dur:`4.5s`,repeatCount:`indefinite`})]}),_jsxs(`g`,{opacity:`0`,children:[_jsx(`line`,{className:`n-x`,x1:`458`,y1:`469`,x2:`466`,y2:`479`}),_jsx(`line`,{className:`n-x`,x1:`466`,y1:`469`,x2:`458`,y2:`479`}),_jsx(`animate`,{attributeName:`opacity`,values:`0;0;1;0;0`,keyTimes:`0;0.21;0.24;0.45;1`,dur:`4.5s`,repeatCount:`indefinite`})]})]})]}),_jsxs(`svg`,{className:`tdg-tall`,viewBox:`0 0 360 780`,role:`img`,\"aria-label\":label,children:[_jsx(`path`,{className:`n-flow`,d:`M180 68 L 180 440`}),_jsx(`path`,{className:`n-link`,d:`M146 592 C 146 606, 99 606, 99 622`}),_jsx(`path`,{className:`n-link`,d:`M214 592 C 214 606, 261 606, 261 622`}),_jsx(`path`,{className:`n-bad`,d:`M180 592 L 180 692`}),_jsxs(`g`,{className:`tdg-moving`,children:[packets(`M174 68 L 174 440`,`pk`,3,3.4,5),packets(`M186 440 L 186 68`,`pk-back`,3,3.4,4)]}),_jsx(`rect`,{className:`n-node`,x:`105`,y:`12`,width:`150`,height:`56`,rx:`14`}),_jsx(`text`,{x:`180`,y:`45`,className:`n-t`,textAnchor:`middle`,children:`AI app or agent`}),_jsx(`rect`,{className:`n-gate`,x:`60`,y:`96`,width:`240`,height:`112`,rx:`16`}),_jsx(`text`,{x:`180`,y:`120`,className:`n-m`,textAnchor:`middle`,children:`MCP MANAGER`}),_jsx(`text`,{x:`180`,y:`142`,className:`n-t`,textAnchor:`middle`,children:`Gateway`}),_jsx(`text`,{x:`180`,y:`168`,className:`n-s`,textAnchor:`middle`,children:`signs each person in`}),_jsx(`text`,{x:`180`,y:`186`,className:`n-s`,textAnchor:`middle`,children:`checks your rules · logs every call`}),_jsx(`rect`,{className:`n-pipe`,x:`156`,y:`232`,width:`48`,height:`150`,rx:`24`}),_jsx(`rect`,{x:`173`,y:`300`,width:`14`,height:`11`,rx:`2.5`,fill:`none`,stroke:`#22d3ee`,strokeWidth:`1.6`}),_jsx(`path`,{d:`M176 300 v-3 a4 4 0 0 1 8 0 v3`,fill:`none`,stroke:`#22d3ee`,strokeWidth:`1.6`}),_jsx(`text`,{x:`218`,y:`284`,className:`n-m`,children:`ENCRYPTED`}),_jsx(`text`,{x:`218`,y:`299`,className:`n-m`,children:`TUNNEL`}),_jsx(`text`,{x:`218`,y:`322`,className:`n-s`,children:`your machine dials out`}),_jsx(`text`,{x:`218`,y:`339`,className:`n-s`,children:`no inbound port`}),_jsx(`rect`,{className:`n-frame`,x:`12`,y:`410`,width:`336`,height:`356`,rx:`18`}),_jsx(`text`,{x:`30`,y:`434`,className:`n-m n-m-idle`,children:`YOUR NETWORK`}),_jsx(`rect`,{className:`n-box`,x:`98`,y:`448`,width:`164`,height:`144`,rx:`16`}),_jsx(`text`,{x:`180`,y:`472`,className:`n-t`,textAnchor:`middle`,children:`Tunnel container`}),_jsx(`rect`,{className:`n-bar`,x:`110`,y:`482`,width:`140`,height:`20`,rx:`6`}),_jsx(`text`,{x:`180`,y:`496`,className:`n-m`,textAnchor:`middle`,children:`LAUNCHER`}),_jsx(`rect`,{className:`n-slot n-slot-on`,x:`110`,y:`510`,width:`42`,height:`24`,rx:`6`}),_jsx(`text`,{x:`131`,y:`526`,className:`n-m n-m-ok`,textAnchor:`middle`,children:`v8`}),_jsx(`rect`,{className:`n-slot n-slot-warm`,x:`159`,y:`510`,width:`42`,height:`24`,rx:`6`}),_jsx(`text`,{x:`180`,y:`526`,className:`n-m n-m-warm`,textAnchor:`middle`,children:`v9`}),_jsx(`rect`,{className:`n-slot`,x:`208`,y:`510`,width:`42`,height:`24`,rx:`6`}),_jsx(`text`,{x:`229`,y:`526`,className:`n-m n-m-idle`,textAnchor:`middle`,children:`free`}),_jsx(`text`,{x:`180`,y:`558`,className:`n-s`,textAnchor:`middle`,children:`no Docker socket`}),_jsx(`text`,{x:`180`,y:`576`,className:`n-s`,textAnchor:`middle`,children:`no host folders`}),_jsx(`rect`,{className:`n-node n-ok`,x:`24`,y:`622`,width:`150`,height:`54`,rx:`12`}),_jsx(`text`,{x:`99`,y:`645`,className:`n-t`,textAnchor:`middle`,children:`Self-hosted GitLab`}),_jsx(`text`,{x:`99`,y:`664`,className:`n-m n-m-ok`,textAnchor:`middle`,children:`ALLOWED`}),_jsx(`rect`,{className:`n-node n-ok`,x:`186`,y:`622`,width:`150`,height:`54`,rx:`12`}),_jsx(`text`,{x:`261`,y:`645`,className:`n-t`,textAnchor:`middle`,children:`Internal Grafana`}),_jsx(`text`,{x:`261`,y:`664`,className:`n-m n-m-ok`,textAnchor:`middle`,children:`ALLOWED`}),_jsx(`rect`,{className:`n-bad`,x:`105`,y:`692`,width:`150`,height:`54`,rx:`12`}),_jsx(`text`,{x:`180`,y:`715`,className:`n-t`,textAnchor:`middle`,children:`Anything else`}),_jsx(`text`,{x:`180`,y:`734`,className:`n-m n-m-bad`,textAnchor:`middle`,children:`BLOCKED`})]})]})})};const DiagramView=({children})=>_jsx(_Fragment,{children});const DiagramFigure=({title,caption,children})=>{const storageKey=`mcpm-docs-figure-view`;const eventName=`mcpm-docs-figure-view`;const unwrap=node=>{let current=node;while(current\u0026\u0026current.props\u0026\u0026current.props.title===undefined\u0026\u0026current.props.steps===undefined\u0026\u0026current.props.children\u0026\u0026current.props.children.props){current=current.props.children}return current};const findChart=(node,depth)=>{if(!node||depth>8)return null;if(Array.isArray(node)){for(const child of node){const found=findChart(child,depth+1);if(found)return found}return null}if(node.props\u0026\u0026typeof node.props.chart===`string`)return node.props.chart;return node.props?findChart(node.props.children,depth+1):null};const parts=React.Children.toArray(children).map(unwrap).filter(child=>child\u0026\u0026child.props);const steps=parts.find(child=>child.props.steps);const views=parts.filter(child=>child.props.title\u0026\u0026!child.props.steps).map(child=>({name:child.props.title,content:child.props.children}));const mermaidView=views.find(view=>view.name===`Mermaid`);const source=mermaidView?findChart(mermaidView.content,0):null;if(source)views.push({name:`Text`,content:null,source:source.trim()});const names=views.map(view=>view.name);const fallbackId=React.useRef(`dg-${Math.random().toString(36).slice(2,9)}`).current;const figureId=(React.useId?React.useId():fallbackId).replace(/[^a-zA-Z0-9_-]/g,``);const[active,setActive]=React.useState(names[0]);const[opened,setOpened]=React.useState(()=>new Set([names[0]]));const[copied,setCopied]=React.useState(false);const show=name=>{if(!names.includes(name))return;setActive(name);setOpened(previous=>previous.has(name)?previous:new Set([...previous,name]))};React.useEffect(()=>{try{const saved=window.localStorage.getItem(storageKey);if(saved)show(saved)}catch(error){}const onChoice=event=>show(event.detail);window.addEventListener(eventName,onChoice);return()=>window.removeEventListener(eventName,onChoice)},[]);const choose=name=>{show(name);try{window.localStorage.setItem(storageKey,name)}catch(error){}window.dispatchEvent(new CustomEvent(eventName,{detail:name}))};const onKeyDown=event=>{const index=names.indexOf(active);let next=-1;if(event.key===`ArrowRight`)next=(index+1)%names.length;if(event.key===`ArrowLeft`)next=(index-1+names.length)%names.length;if(event.key===`Home`)next=0;if(event.key===`End`)next=names.length-1;if(next\u003c0)return;event.preventDefault();choose(names[next]);const tab=document.getElementById(`${figureId}-tab-${next}`);if(tab)tab.focus()};const copy=text=>{try{navigator.clipboard.writeText(text).then(()=>{setCopied(true);setTimeout(()=>setCopied(false),1600)},()=>{})}catch(error){}};const highlight=text=>{const arrow=/^(\u003c-->|-\\.->|-\\.-x|-\\.-|-->>|->>|-->|---|--x|==>|~~~|-x|-\\))$/;const keyword=/^(flowchart|graph|sequenceDiagram|subgraph|end|direction|classDef|class|style|linkStyle|participant|actor|as|Note|over|loop|alt|else|opt|par|and|rect|activate|deactivate|autonumber|TB|TD|BT|LR|RL)$/;const token=/(\"[^\"]*\"|\\|[^|]*\\||\u003c-->|-\\.->|-\\.-x|-\\.-|-->>|->>|-->|---|--x|==>|~~~|-x|-\\)|[A-Za-z_][\\w-]*|\\s+|.)/g;return text.split(`\n`).map((line,lineIndex)=>{if(line.trim().startsWith(`%%`)){return _jsx(`span`,{className:`dg-code-line dg-hl-comment`,children:line},lineIndex)}return _jsx(`span`,{className:`dg-code-line`,children:(line.match(token)||[]).map((part,partIndex)=>{let className=``;if(part.startsWith(`\"`))className=`dg-hl-string`;else if(part.startsWith(`|`))className=`dg-hl-label`;else if(arrow.test(part))className=`dg-hl-arrow`;else if(keyword.test(part))className=`dg-hl-keyword`;return className?_jsx(`span`,{className,children:part},partIndex):part})},lineIndex)})};return _jsxs(`figure`,{className:`dg`,children:[_jsxs(`div`,{className:`dg-frame`,children:[_jsxs(`div`,{className:`dg-bar`,children:[title?_jsx(`span`,{className:`dg-title`,children:title}):_jsx(`span`,{}),_jsx(`div`,{className:`dg-tabs`,role:`tablist`,\"aria-label\":title?`${title}: choose a view`:`Choose a view`,onKeyDown,children:names.map((name,index)=>_jsx(`button`,{id:`${figureId}-tab-${index}`,type:`button`,role:`tab`,className:`dg-tab`,\"aria-selected\":active===name,\"aria-controls\":`${figureId}-panel-${index}`,tabIndex:active===name?0:-1,onClick:()=>choose(name),children:name},name))})]}),views.map((view,index)=>_jsx(`div`,{id:`${figureId}-panel-${index}`,role:`tabpanel`,\"aria-labelledby\":`${figureId}-tab-${index}`,className:`dg-panel dg-panel-${view.name.toLowerCase()}`,hidden:active!==view.name,children:view.source!==undefined?_jsxs(`div`,{className:`dg-code`,children:[_jsxs(`div`,{className:`dg-code-head`,children:[_jsx(`span`,{children:`Mermaid source`}),_jsx(`button`,{type:`button`,className:`dg-copy`,onClick:()=>copy(view.source),children:copied?`Copied`:`Copy`})]}),_jsx(`pre`,{children:_jsx(`code`,{children:highlight(view.source)})})]}):opened.has(view.name)?view.content:null},view.name)),steps?_jsxs(`details`,{className:`dg-steps`,children:[_jsx(`summary`,{children:`Step by step description`}),_jsx(`div`,{className:`dg-steps-body`,children:steps.props.children})]}):null]}),caption?_jsx(`figcaption`,{children:caption}):null]})};function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Mermaid,Note,Table,Warning,_MdxComponentBoundary}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`server tunnel`}),` is a machine your organization runs next to its internal servers, such as a self-hosted GitLab or an internal Grafana. `,_jsx(_components.strong,{children:`MCP Manager`}),` reaches those servers through it. The machine dials out to MCP Manager, so you open nothing inbound and expose nothing to the internet. Every user still signs in to the internal server with their `,_jsx(_components.strong,{children:`own`}),` identity, so the server’s own audit log names the person behind each call.`]}),`\n`,_jsxs(_components.p,{children:[`You connect a machine by running `,_jsx(_components.strong,{children:`one`}),` command. You never run it again: the tunnel updates itself with signed releases and no downtime. See `,_jsx(_components.a,{href:`#automatic-updates-with-no-downtime`,children:`Automatic updates with no downtime`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Ready to set one up? `,_jsx(_components.a,{href:`/tutorials/connect-an-internal-server-through-a-tunnel`,children:`Connect an internal server through a tunnel`}),` walks the whole path. This page covers how a server tunnel works and what it means for security.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Server tunnels need the `,_jsx(_components.strong,{children:`Manage tunnels`}),` capability, and they must be enabled for your workspace. Without both you don’t see the `,_jsx(_components.strong,{children:`Tunnels`}),` section, and you can’t mark a server as `,_jsx(_components.strong,{children:`Reached through a tunnel`}),`. Ask a workspace administrator to grant it. See `,_jsx(_components.a,{href:`#who-can-manage-server-tunnels`,children:`Who can manage server tunnels`}),` and the `,_jsx(_components.a,{href:`/deployment/rbac-and-roles/capabilities`,children:`capabilities reference`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`what-a-server-tunnel-is-for`,children:`What a server tunnel is for`}),`\n`,_jsx(_components.p,{children:`A server tunnel solves one problem: an MCP server that lives on your internal network, used by many people, each of whom must sign in as themselves. A self-hosted GitLab is the typical case. MCP Manager’s gateway runs in the cloud and can’t reach it, and you don’t want to expose it to the internet.`}),`\n`,_jsxs(_components.p,{children:[`A server reached through a tunnel is a `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/remote`,children:`remote server`}),` with one extra setting: `,_jsx(_components.strong,{children:`Reached through a tunnel`}),`, and the tunnel to use. It keeps everything a remote server has. You assign it to gateways, choose per-user or shared identity, and its calls run through your gateway rules and land in your logs. One tunnel can carry several servers. GitLab and Grafana on the same network are two servers bound to the same tunnel, and you assign each to gateways on its own.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-a-server-tunnel-connects`,children:`How a server tunnel connects`}),`\n`,_jsxs(_components.p,{children:[`A server tunnel connects outbound only. The machine dials out to MCP Manager over TCP 443 and joins a private, encrypted network built on `,_jsx(_components.a,{href:`https://www.wireguard.com/`,children:`WireGuard`}),` that MCP Manager coordinates. The gateway sends each request to the machine over that network. The machine then opens its own HTTPS connection to the internal server and sends the response back the same way.`]}),`\n`,_jsx(_MdxComponentBoundary,{name:`DiagramFigure`,children:_jsxs(DiagramFigure,{title:`How a request reaches an internal server`,caption:`The gateway reaches your internal servers only through a tunnel your machine opens outbound. On the machine, one container with no Docker socket sends each request on to an allowed destination and nowhere else.`,children:[_jsx(_MdxComponentBoundary,{name:`DiagramView`,children:_jsx(DiagramView,{title:`Diagram`,children:_jsx(_MdxComponentBoundary,{name:`TunnelPathDiagram`,children:_jsx(TunnelPathDiagram,{})})})}),_jsx(_MdxComponentBoundary,{name:`DiagramView`,children:_jsx(DiagramView,{title:`Mermaid`,children:_jsx(Mermaid,{chart:`%%{init: {'theme':'base','themeVariables':{'fontFamily':'Lato, sans-serif','lineColor':'#6a6b76','primaryColor':'#e0e2e8','primaryTextColor':'#12141d','primaryBorderColor':'#6a6b76','edgeLabelBackground':'#ffffff','textColor':'#12141d'}}}%%\nflowchart TB\n App[\"🤖 AI app or agent\"] --> GW[\"🛡️ MCP Manager gateway\u003cbr/>signs each person in · checks your rules · logs every call\"]\n GW -->|\"encrypted WireGuard tunnel\u003cbr/>your machine dials out · no inbound port\"| TC\n subgraph NET[\"Your network\"]\n TC[\"Tunnel container\u003cbr/>no Docker socket · no host folders\"]\n TC --> GL[\"🖥️ GitLab\u003cbr/>allowed\"]\n TC --> GF[\"🖥️ Grafana\u003cbr/>allowed\"]\n TC -.-x X[\"🚫 Anything else\u003cbr/>blocked\"]\n GL \u003c-.->|\"each person signs in\u003cbr/>from their own browser\"| BR[\"👤 Browser\"]\n end\n classDef gateway fill:#0086ff,color:#ffffff,stroke:#062b4c,stroke-width:2px;\n classDef client fill:#80cbc4,color:#062b4c,stroke:#00796b,stroke-width:1.5px;\n classDef server fill:#aed8ff,color:#062b4c,stroke:#0b4880,stroke-width:1.5px;\n classDef trust fill:#2fedb4,color:#062b4c,stroke:#059669,stroke-width:1.5px;\n classDef blocked fill:#ec9c9d,color:#12141d,stroke:#eb5757,stroke-width:2px;\n classDef user fill:#c3c9d4,color:#12141d,stroke:#2c2c37,stroke-width:1.5px;\n class GW gateway;\n class App client;\n class GL,GF server;\n class TC trust;\n class X blocked;\n class BR user;\n style NET fill:transparent,stroke:#9ca1ab,stroke-dasharray:4 3,color:#6a6b76;`})})}),_jsx(_MdxComponentBoundary,{name:`DiagramView`,children:_jsx(DiagramView,{steps:true,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`An AI app or agent calls the `,_jsx(_components.strong,{children:`MCP Manager gateway`}),`. The gateway signs each person in, checks your rules and logs the call.`]}),`\n`,_jsxs(_components.li,{children:[`The gateway sends the call through an `,_jsx(_components.strong,{children:`encrypted WireGuard tunnel`}),`. Your machine opened the tunnel outbound, so it needs no inbound port.`]}),`\n`,_jsxs(_components.li,{children:[`On your network, one `,_jsx(_components.strong,{children:`tunnel container`}),` receives the call. It has no Docker socket and no folders from the host.`]}),`\n`,_jsxs(_components.li,{children:[`The container sends the call on only to a destination on its `,_jsx(_components.strong,{children:`allowed destinations`}),` list, such as a self-hosted GitLab or an internal Grafana. Anything else is blocked.`]}),`\n`,_jsxs(_components.li,{children:[`Each person signs in to the internal server from `,_jsx(_components.strong,{children:`their own browser`}),`, which must reach that server, for example over your office network or VPN.`]}),`\n`]})})})]})}),`\n`,_jsxs(_components.p,{children:[`The gateway sends an internal server’s traffic `,_jsx(_components.strong,{children:`only`}),` through its tunnel. When the tunnel can’t take a request, the request fails with a clear error. MCP Manager never falls back to calling the server’s URL directly.`]}),`\n`,_jsxs(_components.p,{children:[`On the machine, one container does all of this. Inside it, a `,_jsx(_components.strong,{children:`launcher`}),` that never changes runs the `,_jsx(_components.strong,{children:`worker`}),` that carries your traffic, and swaps in a new worker when a new release arrives. Each person’s sign-in page opens in their own browser, which must reach the internal server, for example over your office network or VPN. See `,_jsx(_components.a,{href:`#what-runs-inside-the-tunnel-container`,children:`What runs inside the tunnel container`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`what-the-tunnel-machine-needs`,children:`What the tunnel machine needs`}),`\n`,_jsx(_components.p,{children:`The tunnel machine is a host your organization runs, close to the servers it reaches. It needs:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Docker Engine on a Linux machine, running as root`}),` (the standard install). MCP Manager publishes releases for `,_jsx(_components.code,{children:`linux/amd64`}),` and `,_jsx(_components.code,{children:`linux/arm64`}),`. Rootless Docker and Podman aren’t supported yet.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`One server tunnel per Docker host.`}),` A server tunnel’s container is always named `,_jsx(_components.code,{children:`mcpm-server-tunnel`}),`, so Docker won’t start a second one on the same host. For failover, connect a second host.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`To stay on.`}),` A tunnel with no machine online carries no traffic. The container runs with `,_jsx(_components.code,{children:`--restart unless-stopped`}),`, so it comes back on its own after a reboot once Docker starts.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A route to each internal server`}),` it will reach, over your own network.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Outbound TCP 443`}),` to the hosts below. Allowlist them by hostname, not IP address, and exempt them from TLS inspection.`]}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Hostname`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Why it’s needed`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`app.mcpmanager.ai`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`MCP Manager.`}),` The worker connects the machine here the first time, then checks in regularly.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`headscale.mcpmanager.ai`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`Coordination server.`}),` The worker joins the private network here.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`derp-a.mcpmanager.ai`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`Relay server.`}),` Carries the traffic between MCP Manager and the machine.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`derp-b.mcpmanager.ai`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`Relay server, second region.`}),` Used for failover and lower latency.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`registry-1.docker.io`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`Docker Hub.`}),` Docker pulls the `,_jsx(_components.code,{children:`mcpmanager/tunnel`}),` image from here when you run the command. After that, the machine downloads every signed release from here.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`auth.docker.io`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`Docker Hub sign-in.`}),` Docker Hub hands out the short-lived token for each download here.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`production.cloudfront.docker.com`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`Docker Hub downloads.`}),` Docker Hub sends the image layers and release files from here. Docker can change this host, so check `,_jsx(_components.a,{href:`https://docs.docker.com/desktop/setup/allow-list/`,children:`Docker’s own list`}),` if a download is blocked.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`The coordination and relay servers are the same ones a workstation uses. If a corporate proxy blocks them, the symptoms and fixes in `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/workstation#network-requirements`,children:`Network requirements`}),` apply here too.`]}),`\n`,_jsx(Heading,{level:`3`,id:`private-certificates-and-outbound-proxies`,children:`Private certificates and outbound proxies`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`An internal server with your own certificate authority.`}),` The tunnel checks the HTTPS certificate of every destination except the machine itself (`,_jsx(_components.code,{children:`localhost`}),` and `,_jsx(_components.code,{children:`host.docker.internal`}),`). If your internal server’s certificate is signed by your organization’s own CA, give the tunnel that CA as PEM text, not a file path. Add this to the command, before the image name:`]}),`\n`,_jsx(CodeBlock,{filename:`terminal`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`-e`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` MCPM_EXTRA_CA_CERTS=\"$(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cat`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` your-ca.pem)\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Without it, requests to that server fail with `,_jsx(_components.strong,{children:`Upstream Certificate Rejected`}),`, and the message says what to add. `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/workstation#https-certificates`,children:`HTTPS certificates`}),` covers each kind of certificate failure, and applies here too.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`A machine behind an outbound proxy.`}),` Add the standard `,_jsx(_components.code,{children:`HTTPS_PROXY`}),` (or `,_jsx(_components.code,{children:`ALL_PROXY`}),`) and `,_jsx(_components.code,{children:`NO_PROXY`}),` variables to the command the same way. The tunnel uses them to check in, join the private network and download releases. Docker pulls the image itself, so set Docker’s own proxy settings for that.`]}),`\n`,_jsxs(_components.p,{children:[`Docker fixes these values when it creates the container. To add one to a machine that’s already running, run a new command on it, as in `,_jsx(_components.a,{href:`#limit-destinations-on-the-machine-itself`,children:`Limit destinations on the machine itself`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`the-one-time-command-that-connects-a-machine`,children:`The one-time command that connects a machine`}),`\n`,_jsxs(_components.p,{children:[`Someone with `,_jsx(_components.strong,{children:`Manage tunnels`}),` selects `,_jsx(_components.strong,{children:`Connect a machine`}),` on the tunnel, which makes a command, and runs it on the machine. MCP Manager fills in every value. It looks like this:`]}),`\n`,_jsx(CodeBlock,{filename:`terminal`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` run`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --name`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcpm-server-tunnel`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --restart`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` unless-stopped`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --cap-drop`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ALL`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --cap-add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` SETUID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --cap-add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` SETGID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --security-opt`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` no-new-privileges`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --read-only`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --pids-limit`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`P`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --memory`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`M`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --memory-swap`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`M`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -v`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcpm-tunnel-`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`:/var/lib/mcpm`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --add-host`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` host.docker.internal:host-gateway`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -e`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"MCPM_TUNNEL_ALLOWED_ORIGINS=\u003corigins>\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcpmanager/tunnel@sha256:`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`diges`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`t`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` enroll`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` server_tunnel`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`toke`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`n`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`It’s one line. The origins value sits in double quotes, which bash, PowerShell and cmd all pass through as they are, so it pastes the same way into each. The container starts in the background and keeps running.`}),`\n`,_jsx(Heading,{level:`3`,id:`every-privilege-the-tunnel-gets-is-in-the-command`,children:`Every privilege the tunnel gets is in the command`}),`\n`,_jsx(_components.p,{children:`You can read everything the tunnel is allowed to do in that one line. Docker fixes these settings when it creates the container, so nothing MCP Manager ships later can widen them.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Part of the command`}),_jsx(_components.th,{style:{textAlign:`left`},children:`What it means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`--cap-drop ALL --cap-add SETUID --cap-add SETGID`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The container drops every Linux capability except two. The launcher uses those two for one thing only: starting each worker as a separate, weaker user. Workers keep no capability at all.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`--security-opt no-new-privileges`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Nothing inside the container can gain a privilege later.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`--read-only`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The container can’t change its own files. It writes only to its volume.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`--pids-limit \u003cP> --memory \u003cM> --memory-swap \u003cM>`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Hard limits on processes and memory, enforced by the kernel whatever our code does. Setting `,_jsx(_components.code,{children:`--memory-swap`}),` to the same value as `,_jsx(_components.code,{children:`--memory`}),` turns swap off.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`-v mcpm-tunnel-\u003cid>:/var/lib/mcpm`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`One named Docker volume, new for each command, so a host you connect again never reuses an earlier machine’s identity. It holds the machine’s identity and the releases it has checked. No folder from your host is mounted.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`--add-host host.docker.internal:host-gateway`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Lets the container reach servers on the machine itself by that name. When you choose `,_jsx(_components.strong,{children:`Docker Engine on Linux (host network)`}),` in the command’s variation menu, the command has `,_jsx(_components.code,{children:`--network host -e MCPM_TUNNEL_NETWORK=host`}),` instead, and the tunnel reaches servers on the machine at `,_jsx(_components.code,{children:`localhost`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`-e \"MCPM_TUNNEL_ALLOWED_ORIGINS=\u003corigins>\"`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`The most this machine may ever reach. See `,_jsx(_components.a,{href:`#limit-destinations-on-the-machine-itself`,children:`Limit destinations on the machine itself`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`mcpmanager/tunnel@sha256:\u003cdigest>`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The exact image, pinned by its digest.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`enroll server_tunnel \u003ctoken>`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Connects this machine to your tunnel. The token works once.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`--name mcpm-server-tunnel`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`The same name on every host, so a host runs one server tunnel machine. To run a new command on the host, remove this container first with `,_jsx(_components.code,{children:`docker rm -f mcpm-server-tunnel`}),`.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`What the command leaves out matters as much. There’s `,_jsx(_components.strong,{children:`no Docker socket`}),`, so the tunnel can’t start, stop or inspect any other container on the host. There’s `,_jsx(_components.strong,{children:`no host folder`}),` and no privileged mode, and the container shares the host’s network only when you choose that for a Linux machine that runs Docker directly.`]}),`\n`,_jsx(Heading,{level:`3`,id:`the-token-the-machine-key-and-when-you-need-a-new-command`,children:`The token, the machine key and when you need a new command`}),`\n`,_jsx(_components.p,{children:`The enrollment token in the command has three limits:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`It works once.`}),` A second machine needs its own command.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`It expires 24 hours`}),` after it’s generated.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`MCP Manager shows it once`}),` and stores only a hash of it.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If MCP Manager refuses a command when the machine runs it, see `,_jsx(_components.a,{href:`#the-install-command-is-refused`,children:`The install command is refused`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`The first time the container starts, the machine makes its own key and keeps it in the volume. The private key never leaves the container, and only the launcher can read it. From then on, every request the machine sends to MCP Manager is signed with that key. Each new machine raises an alert, `,_jsx(_components.strong,{children:`A machine joined a server tunnel`}),`, naming who issued the command.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Run the command once per machine.`}),` A machine needs a new command only when it loses its container or volume, or to reach an allowed destination its command didn’t include. A machine that lost its volume (after `,_jsx(_components.code,{children:`docker volume rm`}),` or `,_jsx(_components.code,{children:`docker system prune --volumes`}),`) can no longer prove who it is, so terminate it in the `,_jsx(_components.strong,{children:`Tunnels`}),` section and connect the host again with a new command. MCP Manager can replace every key it uses, including its root keys, without you running anything. See `,_jsx(_components.a,{href:`#signed-releases-what-the-launcher-checks-before-anything-runs`,children:`Signed releases`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`The first install trusts the MCP Manager web app.`}),` The command, including the image digest, comes from MCP Manager over TLS. The signature checks protect every update after the install, not the install itself.`]}),`\n`,_jsx(_components.p,{children:`When MCP Manager has no release published for server tunnels, it can’t issue a command. It creates no token and says that no release is available yet.`}),`\n`,_jsx(Heading,{level:`3`,id:`more-than-one-machine-for-failover`,children:`More than one machine for failover`}),`\n`,_jsx(_components.p,{children:`You can connect several machines to one tunnel. Each machine’s worker checks in with MCP Manager regularly, and a machine that has stopped checking in gets no traffic. MCP Manager sends each request to an online machine. When it can’t reach that machine before any part of the request was sent, it tries the next one. A request that fails after it was sent is reported and never retried, so a tool call never runs twice.`}),`\n`,_jsx(_components.p,{children:`Connect each machine on its own Docker host.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-the-tunnel-machine-can-see`,children:`What the tunnel machine can see`}),`\n`,_jsx(_components.p,{children:`The tunnel machine sees every credential sent through it. It’s the HTTPS client to your internal server, so each user’s token passes through it in plain text on the way to that server. Run a server tunnel only on infrastructure your organization controls, next to the servers it reaches.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Treat the tunnel machine like the servers behind it.`}),` Anyone who controls the machine can read the credentials of every user who calls a server through it. The tunnel container can’t control Docker or read your host’s files, but whoever controls the host can read the container. Use a host you’d trust with those servers’ credentials, and don’t share it with workloads you trust less.`]})}),`\n`,_jsx(_components.p,{children:`This is the trade a server tunnel makes on purpose. A workstation is safe to run on a laptop because the only credentials it sees are its owner’s. A server tunnel carries everyone’s, so it belongs on your organization’s infrastructure, never on a personal machine.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-runs-inside-the-tunnel-container`,children:`What runs inside the tunnel container`}),`\n`,_jsx(_components.p,{children:`One container runs on the tunnel machine, and three kinds of program run inside it.`}),`\n`,_jsx(_MdxComponentBoundary,{name:`DiagramFigure`,children:_jsxs(DiagramFigure,{title:`What runs inside the tunnel container`,caption:`One container runs on the machine. The launcher never changes and has no network. Workers carry the traffic and update themselves, each as its own user with no privileges.`,children:[_jsx(_MdxComponentBoundary,{name:`DiagramView`,children:_jsx(DiagramView,{title:`Diagram`,children:_jsx(_MdxComponentBoundary,{name:`TunnelContainerDiagram`,children:_jsx(TunnelContainerDiagram,{})})})}),_jsx(_MdxComponentBoundary,{name:`DiagramView`,children:_jsx(DiagramView,{title:`Mermaid`,children:_jsx(Mermaid,{chart:`%%{init: {'theme':'base','themeVariables':{'fontFamily':'Lato, sans-serif','lineColor':'#6a6b76','primaryColor':'#e0e2e8','primaryTextColor':'#12141d','primaryBorderColor':'#6a6b76','edgeLabelBackground':'#ffffff','textColor':'#12141d'}}}%%\nflowchart TB\n subgraph C[\"Container mcpm-server-tunnel\"]\n direction TB\n FE[\"Fetcher · built in\u003cbr/>downloads the release\u003cbr/>on the first start\"] --> L\n V[(\"Volume\u003cbr/>trust/ · bundles/\u003cbr/>work/\")] --- L\n L[\"Launcher · process 1 · no network\u003cbr/>checks every release · keeps the machine key\u003cbr/>container: read-only, no Docker socket, no host folders\"]\n L -->|starts as its own user| W8[\"Worker v8\u003cbr/>serving\"]\n L --> W9[\"Worker v9\u003cbr/>being checked\"]\n L --> W3[\"Third place\u003cbr/>free\"]\n end\n W8 -->|downloads releases| Hub[\"📦 Docker Hub\u003cbr/>signed releases\"]\n W8 -->|\"checks in\u003cbr/>signed by the launcher\"| GW[\"🛡️ MCP Manager gateway\"]\n classDef gateway fill:#0086ff,color:#ffffff,stroke:#062b4c,stroke-width:2px;\n classDef server fill:#aed8ff,color:#062b4c,stroke:#0b4880,stroke-width:1.5px;\n classDef trust fill:#2fedb4,color:#062b4c,stroke:#059669,stroke-width:1.5px;\n classDef warn fill:#ffd863,color:#12141d,stroke:#ffa535,stroke-width:1.5px;\n classDef user fill:#c3c9d4,color:#12141d,stroke:#2c2c37,stroke-width:1.5px;\n classDef datastore fill:#062b4c,color:#ffffff,stroke:#0086ff,stroke-width:1.5px;\n class GW gateway;\n class L trust;\n class W8 server;\n class W9 warn;\n class W3,FE user;\n class V,Hub datastore;\n style C fill:transparent,stroke:#0e7490,stroke-width:1.5px,color:#6a6b76;`})})}),_jsx(_MdxComponentBoundary,{name:`DiagramView`,children:_jsxs(DiagramView,{steps:true,children:[_jsxs(_components.p,{children:[`The container `,_jsx(_components.code,{children:`mcpm-server-tunnel`}),` is read-only and gets no Docker socket and no host folders. Inside it:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The launcher`}),` is process 1 and has no network. It checks every release before it runs, keeps the machine key to itself, and starts each worker as its own user.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Three worker places.`}),` One worker serves your traffic (v8). A new release starts beside it and is checked (v9). The third place holds a worker while it finishes and leaves. Each worker runs as its own user with no privileges.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The fetcher`}),` is built in. It downloads the current release on the first start, and whenever no stored release will run.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The volume`}),` `,_jsx(_components.code,{children:`mcpm-tunnel-\u003cid>`}),` holds the machine’s state. `,_jsx(_components.code,{children:`trust/`}),` holds the machine key and the launcher’s records, and only the launcher reads it. `,_jsx(_components.code,{children:`bundles/`}),` holds releases that passed the checks, read-only. Each worker gets a private `,_jsx(_components.code,{children:`work/`}),` folder and an `,_jsx(_components.code,{children:`incoming/`}),` folder for the releases it downloads.`]}),`\n`]}),_jsxs(_components.p,{children:[`Outside the container, workers download signed releases from `,_jsx(_components.strong,{children:`Docker Hub`}),` and check in with the `,_jsx(_components.strong,{children:`MCP Manager gateway`}),`. The launcher signs each check-in with the machine key.`]})]})})]})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The launcher`}),` is the container’s first process. It never changes after you run the command, and it has no network access. It checks every release before anything in it runs, starts each worker as its own user, and keeps the machine key. When a worker needs to send a request to MCP Manager, the launcher signs it, so a worker never holds the key.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Workers`}),` carry your traffic. A worker joins the private network, checks in with MCP Manager, sends requests on to your internal servers, and downloads the next release. Up to three run at once: the one serving traffic, a new one being checked, and an old one finishing its requests.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The built-in fetcher`}),` ships inside the image. It downloads the current release the first time the machine starts, and again if no stored release will run. It does nothing else.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`what-a-worker-can’t-do`,children:`What a worker can’t do`}),`\n`,_jsx(_components.p,{children:`Workers are the part that updates, so they get the least power:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Read the machine key or the launcher’s records.`}),` Only the launcher can.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Change the code it runs.`}),` Each release is unpacked read-only after the launcher has checked it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`See or signal another worker.`}),` Each worker runs as its own user, with its own folder.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Gain privileges.`}),` A worker holds no Linux capability, and `,_jsx(_components.code,{children:`no-new-privileges`}),` stops it gaining any.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Take more than its share.`}),` Each worker has its own process limit, so one bad worker can’t starve the one serving your traffic.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`what-a-server-tunnel-doesn’t-promise`,children:`What a server tunnel doesn’t promise`}),`\n`,_jsxs(_components.p,{children:[`The list of places your requests may go is enforced by the worker’s code. Docker limits the kind of network the container gets, not the hosts it can reach. So if someone stole MCP Manager’s release key `,_jsx(_components.strong,{children:`and`}),` took over MCP Manager’s servers, they could ship a worker that ignores the list and reaches whatever the container’s network reaches.`]}),`\n`,_jsxs(_components.p,{children:[`That’s why two root keys can replace a stolen release key, so machines stop accepting it, and why the `,_jsx(_components.a,{href:`#the-independent-check-replacing-a-worker-that-stops-updating`,children:`independent check`}),` can retire a worker that misbehaves. If you have strict requirements, also limit the machine’s outbound traffic at your firewall, so the network itself only reaches the servers you meant.`]}),`\n`,_jsx(Heading,{level:`2`,id:`automatic-updates-with-no-downtime`,children:`Automatic updates with no downtime`}),`\n`,_jsx(_components.p,{children:`You run the command once. After that, the tunnel updates itself. You never run the command again to keep a machine current or secure.`}),`\n`,_jsx(Heading,{level:`3`,id:`what-mcp-manager-staff-control-and-what-your-organization-controls`,children:`What MCP Manager staff control and what your organization controls`}),`\n`,_jsxs(_components.p,{children:[`MCP Manager staff manage updates on a staff-only page, and each change records who made it and why. Org members with `,_jsx(_components.strong,{children:`Manage tunnels`}),` see each machine’s version and update status in the `,_jsx(_components.strong,{children:`Tunnels`}),` section, read-only.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Decision`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Who decides`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Which release machines move to`}),_jsx(_components.td,{style:{textAlign:`left`},children:`MCP Manager staff`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Which organizations get a release first, and when everyone else follows`}),_jsx(_components.td,{style:{textAlign:`left`},children:`MCP Manager staff`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Pausing updates`}),_jsx(_components.td,{style:{textAlign:`left`},children:`MCP Manager staff`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`How many updates run at the same time across all tunnels`}),_jsx(_components.td,{style:{textAlign:`left`},children:`MCP Manager staff`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Holding updates for one organization or one machine`}),_jsx(_components.td,{style:{textAlign:`left`},children:`MCP Manager staff. You can’t pause or hold updates yourself.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Where the machine runs, its network access, a tunnel’s allowed destinations, and the cap in the command`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Your organization`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Terminating a machine or a tunnel`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Your organization, with `,_jsx(_components.strong,{children:`Manage tunnels`})]})]})]})]}),`\n`,_jsx(_components.p,{children:`While staff pause updates, existing machines stay on the version they run. A new machine still starts with the current release.`}),`\n`,_jsx(Heading,{level:`3`,id:`signed-releases-what-the-launcher-checks-before-anything-runs`,children:`Signed releases: what the launcher checks before anything runs`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`release`}),` is a signed package of worker code, published to Docker Hub. Every release is signed by a `,_jsx(_components.strong,{children:`release key`}),`. The release key is in turn approved by MCP Manager’s `,_jsx(_components.strong,{children:`root keys`}),`. There are three root keys, and any two must agree. The launcher has the root keys’ public halves built in, and it checks the whole chain on the machine before anything in a release runs.`]}),`\n`,_jsx(_components.p,{children:`The launcher refuses a release when:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`the signatures don’t check out all the way up to the root keys;`}),`\n`,_jsx(_components.li,{children:`it’s older than a release the machine has already run (each release has a counter that only goes up);`}),`\n`,_jsx(_components.li,{children:`it’s signed with an older key than the newest one the machine has accepted;`}),`\n`,_jsx(_components.li,{children:`the download doesn’t match the fingerprint the release lists for it.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`MCP Manager’s gateway, the part that talks to your machines, holds no signing key. It can tell a machine that a release exists, but it can’t make one.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Every key can be replaced without you.`}),` To replace the release key, two root keys approve a new one, and machines stop accepting the old one. To replace a root key, two current root keys sign the new set, and each machine checks that the same way before it trusts it. You never run a new command for either.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Updates only move forward.`}),` MCP Manager never rolls a machine back to an older release. To undo a bad release, staff publish a newer one.`]}),`\n`,_jsx(Heading,{level:`3`,id:`how-an-update-runs`,children:`How an update runs`}),`\n`,_jsx(_components.p,{children:`A new release has to prove it works before the old one stops.`}),`\n`,_jsx(_MdxComponentBoundary,{name:`DiagramFigure`,children:_jsxs(DiagramFigure,{title:`How an update hands over`,caption:`A new release has to prove it works before the old one stops. If it never does, it's dropped and the serving worker carries on.`,children:[_jsx(_MdxComponentBoundary,{name:`DiagramView`,children:_jsx(DiagramView,{title:`Diagram`,children:_jsx(_MdxComponentBoundary,{name:`TunnelHandoverDiagram`,children:_jsx(TunnelHandoverDiagram,{})})})}),_jsx(_MdxComponentBoundary,{name:`DiagramView`,children:_jsx(DiagramView,{title:`Mermaid`,children:_jsx(Mermaid,{chart:`%%{init: {'theme':'base','themeVariables':{'fontFamily':'Lato, sans-serif','lineColor':'#6a6b76','primaryColor':'#e0e2e8','primaryTextColor':'#12141d','primaryBorderColor':'#6a6b76','edgeLabelBackground':'#ffffff','textColor':'#12141d'}}}%%\nflowchart TB\n S1[\"1 · v8 serves\u003cbr/>it hears v9 is out, downloads it\u003cbr/>and hands it to the launcher\"] --> S2[\"2 · v9 starts beside v8\u003cbr/>the launcher checks v9 and starts it\u003cbr/>MCP Manager tests it like real traffic\"]\n S2 -->|v9 passes| S3[\"3 · traffic moves in one step\u003cbr/>new requests go to v9\u003cbr/>v8 finishes the requests it has\"]\n S2 -.->|v9 never proves itself| D[\"v9 is dropped\u003cbr/>v8 carries on serving\"]\n S3 --> S4[\"4 · v8 leaves\u003cbr/>its folder is emptied\u003cbr/>once v9 proves itself, it becomes the release to fall back to\"]\n classDef server fill:#aed8ff,color:#062b4c,stroke:#0b4880,stroke-width:1.5px;\n classDef trust fill:#2fedb4,color:#062b4c,stroke:#059669,stroke-width:1.5px;\n classDef warn fill:#ffd863,color:#12141d,stroke:#ffa535,stroke-width:1.5px;\n classDef blocked fill:#ec9c9d,color:#12141d,stroke:#eb5757,stroke-width:2px;\n class S1,S4 server;\n class S2 warn;\n class S3 trust;\n class D blocked;`})})}),_jsx(_MdxComponentBoundary,{name:`DiagramView`,children:_jsxs(DiagramView,{steps:true,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`v8 serves.`}),` The serving worker hears that v9 is out, downloads it, and hands it to the launcher.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`v9 starts beside it.`}),` The launcher checks v9 and starts it. MCP Manager tests it the way real traffic arrives.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Traffic moves in one step.`}),` New requests go to v9. v8 finishes the requests it already has.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`v8 leaves.`}),` v8 exits and its folder is emptied. Once v9 proves itself, it becomes the release to fall back to.`]}),`\n`]}),_jsx(_components.p,{children:`If v9 never proves itself, it’s dropped and v8 carries on serving.`})]})})]})}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`The serving worker learns from MCP Manager that a newer release is out. It downloads the release from Docker Hub and hands it to the launcher.`}),`\n`,_jsxs(_components.li,{children:[`The launcher checks the release and starts it as a new worker `,_jsx(_components.strong,{children:`beside`}),` the old one. The old worker keeps serving.`]}),`\n`,_jsxs(_components.li,{children:[`The new worker joins the private network and checks in. MCP Manager tests it through its gateway, the way real traffic arrives. The new worker must reach `,_jsx(_components.strong,{children:`every`}),` allowed destination with a verified TLS handshake.`]}),`\n`,_jsx(_components.li,{children:`When the checks pass, MCP Manager switches traffic in one step. New requests go to the new worker from the next request on.`}),`\n`,_jsx(_components.li,{children:`The old worker stops taking new requests, finishes the ones in flight, and exits. If it doesn’t finish in time, the launcher stops it anyway, so an old worker can never hold its place.`}),`\n`,_jsx(_components.li,{children:`Once the new worker has proven itself, the launcher remembers it as the release to fall back to, and empties the old worker’s folder.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What “no downtime” means.`}),` No new request fails because of an update, and requests in flight finish. A very long-lived stream that’s still open when the old worker’s time runs out is closed, and the client has to reconnect. The stream doesn’t resume where it left off.`]}),`\n`,_jsx(Heading,{level:`3`,id:`when-an-update-goes-wrong`,children:`When an update goes wrong`}),`\n`,_jsx(_components.p,{children:`A failed update never takes down the worker that’s already serving. If the serving worker itself crashes or goes quiet, requests to that machine fail until the launcher starts a replacement, and the tunnel’s other machines keep serving.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A new worker never becomes healthy.`}),` MCP Manager doesn’t switch traffic to it, the launcher drops it, and the serving worker carries on.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A worker keeps crashing.`}),` The launcher restarts the same release a few times. Then it falls back to the last release that proved itself on this machine. If none will run, the built-in fetcher downloads the current release. The launcher never runs a release older than the last one that proved itself.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A worker stops responding.`}),` Each worker has to signal the launcher regularly. A worker that goes quiet is stopped and replaced, even if its process is still running.`]}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`What happened`}),_jsx(_components.th,{style:{textAlign:`left`},children:`What MCP Manager does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`The update can’t succeed on retry.`}),` The launcher refused the release, the release has nothing for this machine’s platform, or the new worker started and then failed MCP Manager’s checks.`]}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Marks the update `,_jsx(_components.strong,{children:`Update failed`}),` with the reason, raises one alert for the tunnel and release, and doesn’t offer that release to the machine again until a newer release comes out. When the cause was an origin the machine can’t reach, changing the tunnel’s allowed destinations offers it again.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`The update may succeed on retry.`}),` The download failed, or the new worker stopped before it was ready.`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Tries again later. It raises one alert for the first failure of that release on the machine, with the reason.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`The machine was offline.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Drops the attempt quietly, with no alert, and offers the update again later.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`how-mcp-manager-paces-updates`,children:`How MCP Manager paces updates`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`One at a time.`}),` MCP Manager updates one machine at a time across all tunnels, unless staff raise that. It releases to a first group of organizations, then to everyone. A tunnel can wait a while for its turn when many machines are queued. The `,_jsx(_components.strong,{children:`Tunnels`}),` section then shows `,_jsx(_components.strong,{children:`Waiting its turn`}),`. That’s normal and needs nothing from you.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Installs and replacements never wait.`}),` A machine’s first worker, and a replacement for a worker that stopped, aren’t updates. They don’t wait their turn, and a pause doesn’t hold them back.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`the-independent-check-replacing-a-worker-that-stops-updating`,children:`The independent check: replacing a worker that stops updating`}),`\n`,_jsx(_components.p,{children:`Normally the serving worker is how a machine hears about new releases. If a worker ever stopped listening, for example a worker built with a stolen release key, it could keep a machine on old code.`}),`\n`,_jsxs(_components.p,{children:[`So the launcher also runs its own check, on its own schedule, with the built-in fetcher. No release can change the fetcher. It reads a `,_jsx(_components.strong,{children:`minimum release`}),` that two root keys have signed. A release key alone can’t sign it. When a worker is below that minimum, the launcher:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`stops signing requests for it straight away;`}),`\n`,_jsx(_components.li,{children:`gives it a short time to finish what it’s doing, then stops it;`}),`\n`,_jsx(_components.li,{children:`starts the current release beside it, so traffic moves over without a gap.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`This is the safety net. Normal updates stay the fast way to replace a release.`}),`\n`,_jsx(Heading,{level:`3`,id:`what-the-tunnels-section-shows-about-updates`,children:`What the Tunnels section shows about updates`}),`\n`,_jsxs(_components.p,{children:[`Each machine in the `,_jsx(_components.strong,{children:`Tunnels`}),` section shows the version of each worker and one update status:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Status`}),_jsx(_components.th,{style:{textAlign:`left`},children:`What it means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Up to date`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The machine runs the release MCP Manager wants it to run.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Waiting its turn`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`A newer release exists and this machine hasn’t got it yet. The reason says why: pacing, a pause by staff, or the tunnel being off.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`Updating to`}),` a version`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`The machine is installing that version.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Update failed`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The update failed. The status shows the reason and the time, and the machine keeps its current version.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`No release available yet`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`MCP Manager hasn’t published a release yet.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`The tunnel’s page shows the target release even while staff have paused updates. You can’t start, pause or change an update from it. See `,_jsx(_components.a,{href:`#when-a-machine-does-not-come-online-or-does-not-update`,children:`When a machine doesn’t come online or doesn’t update`}),` for what to do about each state.`]}),`\n`,_jsx(Heading,{level:`2`,id:`limits-that-stop-runaway-software`,children:`Limits that stop runaway software`}),`\n`,_jsx(_components.p,{children:`A bug in a release can’t take over the tunnel machine, because several limits stack up. Each one still works if the ones above it fail.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The kernel.`}),` The `,_jsx(_components.code,{children:`--pids-limit`}),` and `,_jsx(_components.code,{children:`--memory`}),` values in the command cap the whole container. Nothing inside can go past them.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The launcher.`}),` At most three workers run at once, each with its own process limit. A worker that’s stopped is removed along with every process it started. The launcher also spaces out worker starts, and that spacing survives a restart.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The memory watchdog.`}),` When the container nears its memory limit, the launcher stops the newest worker first, so the worker serving your traffic is the last to go.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The worker.`}),` Each worker runs one tunnel for its whole life, so it never stacks up copies of itself.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`MCP Manager.`}),` The gateway caps how many workers a machine may have joined at once, and paces how fast machines join.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`allowed-destinations`,children:`Allowed destinations`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Allowed destinations`}),` is each tunnel’s list of the origins it may send requests to. An origin is a scheme, host and port, such as `,_jsx(_components.code,{children:`https://gitlab.example.internal`}),`. Enter only that: the editor refuses a path, a query or credentials. A default port (443 for HTTPS, 80 for HTTP) counts the same as no port. Every request through the tunnel must go to an origin on the list. That includes each step of an OAuth sign-in: discovery, client registration, the token exchange, token refresh and user info.`]}),`\n`,_jsxs(_components.p,{children:[`You list the first destinations when you create the tunnel; at least one is required. To change the list afterwards, someone with `,_jsx(_components.strong,{children:`Manage tunnels`}),` opens the tunnel and selects `,_jsx(_components.strong,{children:`Edit`}),` under `,_jsx(_components.strong,{children:`Allowed destinations`}),`. The list opens in the `,_jsx(_components.strong,{children:`Connect a machine`}),` window, and saving it makes a new command that carries the new list. Adding a server through the tunnel can also add the server’s origin to the list.`]}),`\n`,_jsxs(_components.p,{children:[`A tunnel allows at most 100 origins. Joined with `,_jsx(_components.code,{children:`+`}),`, the origins can be at most 32,768 bytes in all. That joined value is the one the command carries (`,_jsx(_components.a,{href:`#limit-destinations-on-the-machine-itself`,children:`see below`}),`). The editor shows how many of the 100 origins you’ve used, and it won’t save a list over either limit.`]}),`\n`,_jsx(_components.p,{children:`Three rules apply:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Only listed origins.`}),` MCP Manager compares the canonical origin, so two spellings of one host can’t slip past the list.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`HTTPS unless you list `,_jsx(_components.code,{children:`http://`}),`.`]}),` A plain-HTTP origin works only when you add it with `,_jsx(_components.code,{children:`http://`}),` explicitly.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The list only narrows.`}),` An OAuth server’s metadata can never add an origin to it. OAuth endpoints must also pass the same rule a workstation uses: they must be on the authorization server’s issuer origin, an origin its metadata names, or the MCP server’s origin. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/workstation#signing-in-with-oauth`,children:`Signing in with OAuth`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`When a destination isn’t allowed,`}),` the request fails with `,_jsx(_components.code,{children:`MCPM_TUNNEL_DESTINATION_NOT_ALLOWED`}),` (HTTP 403). The message names the URL and the tunnel. MCP Manager sent nothing to that URL. To fix it, add the URL’s origin to the tunnel’s allowed destinations. If the server signs in with OAuth on another host, such as a separate identity provider, add that origin too. Each machine gets the new list at its next check-in, but it reaches the new origin only after you run a new command on it, because its command caps its destinations. See `,_jsx(_components.a,{href:`#limit-destinations-on-the-machine-itself`,children:`Limit destinations on the machine itself`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`The same error is returned when the server `,_jsx(_components.strong,{children:`redirects to another origin`}),`. A server tunnel follows a redirect only within the same origin, so a request’s credentials never reach a different server, and adding the origin doesn’t change that. Point the MCP server at the address it redirects to instead. The message names both addresses.`]}),`\n`,_jsxs(_components.p,{children:[`Keep the list to origins you use. During every `,_jsx(_components.a,{href:`#how-an-update-runs`,children:`update`}),`, the new worker must reach `,_jsx(_components.strong,{children:`each`}),` allowed destination before it takes over. An origin the machine can’t reach makes the update fail with the reason, and the machine stays on its current version. That release isn’t offered to the machine again until the tunnel’s allowed destinations change or a newer release comes out.`]}),`\n`,_jsx(Heading,{level:`3`,id:`limit-destinations-on-the-machine-itself`,children:`Limit destinations on the machine itself`}),`\n`,_jsxs(_components.p,{children:[`The command also caps destinations on the machine, so the limit holds even if someone changes the list in MCP Manager. That’s the `,_jsx(_components.code,{children:`MCPM_TUNNEL_ALLOWED_ORIGINS`}),` value in the command: a list of origins joined by `,_jsx(_components.code,{children:`+`}),`, such as `,_jsx(_components.code,{children:`https://gitlab.example.internal+https://grafana.example.internal`}),`. MCP Manager fills it in from the tunnel’s allowed destinations when it builds the command, and you can edit it before you run the command. An origin with characters a shell would misread is left out, and the window says so.`]}),`\n`,_jsxs(_components.p,{children:[`If a tunnel’s list is already longer than 32,768 bytes, MCP Manager doesn’t issue a command. A machine installed with it would reach none of the destinations. The message says the list is too long and links to the tunnel’s page. There, select `,_jsx(_components.strong,{children:`Edit`}),` under `,_jsx(_components.strong,{children:`Allowed destinations`}),`, shorten the list and save it, and the window makes the command.`]}),`\n`,_jsxs(_components.p,{children:[`The machine sends only to origins that are on `,_jsx(_components.strong,{children:`both`}),` lists. Docker fixes the cap when it creates the container, so MCP Manager can’t widen it later. Keep the two lists in step: an origin on the tunnel’s list but outside the cap can’t be reached from that machine.`]}),`\n`,_jsxs(_components.p,{children:[`To give a connected machine an origin you added, run a new command on it. In `,_jsx(_components.strong,{children:`Connect a machine`}),`, copy a new command. On the machine, remove the old container with `,_jsx(_components.code,{children:`docker rm -f mcpm-server-tunnel`}),`, then run the new command. The machine connects again as a new machine, so terminate the old one in the `,_jsx(_components.strong,{children:`Machines`}),` list. Each machine needs its own command, because a command works once. For the next machine, select `,_jsx(_components.strong,{children:`re-generate command`}),`, next to the expiry time.`]}),`\n`,_jsx(Heading,{level:`2`,id:`terminating-a-machine-or-a-tunnel`,children:`Terminating a machine or a tunnel`}),`\n`,_jsxs(_components.p,{children:[`Someone with `,_jsx(_components.strong,{children:`Manage tunnels`}),` can terminate a single machine or a whole tunnel in the `,_jsx(_components.strong,{children:`Tunnels`}),` section. Both take effect from the next request, and requests in flight through a terminated machine fail.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Terminate a machine`}),` when it’s retired, lost, or may be compromised. MCP Manager revokes the machine first, so it gets no traffic from the next request on, even if it’s still running. The machine is refused at its next check-in, stops carrying traffic, and goes quiet. Other machines on the tunnel keep serving. Termination is permanent: to use that host again, connect it with a new command.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Terminate the tunnel`}),` with `,_jsx(_components.strong,{children:`Revoke all machines`}),`, under `,_jsx(_components.strong,{children:`Manage this tunnel`}),` on the tunnel’s page, to cut off a whole network at once. This terminates every machine on it and cancels the commands nobody has used. It doesn’t change whether the tunnel is on: an enabled tunnel stays enabled and takes new machines, so connect a machine with a new command to use it again. If part of the termination fails, the alert says which part, and you select `,_jsx(_components.strong,{children:`Revoke all machines`}),` again. See `,_jsx(_components.a,{href:`#the-machines-of-a-tunnel-were-only-partly-terminated`,children:`The machines of a tunnel were only partly terminated`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Turning a tunnel off is a different action, and it terminates nothing. While a tunnel is disabled or archived, MCP Manager sends no request through it, and every server bound to it fails with `,_jsx(_components.a,{href:`#tunnel-disabled`,children:`Tunnel disabled`}),`. Its machines stay connected and keep checking in, and the tunnel takes no new machine and no new command. Its machines start no update while it’s off: the `,_jsx(_components.strong,{children:`Tunnels`}),` section shows them as waiting. Turn it back on and requests flow through the same machines again, with nothing to reinstall.`]}),`\n`,_jsx(_components.p,{children:`Each termination raises an alert that names who did it. To clean up the host afterwards, remove the container and its volume:`}),`\n`,_jsx(CodeBlock,{filename:`terminal`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` rm`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcpm-server-tunnel`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` volume`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` rm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcpm-tunnel-`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`docker volume ls --filter name=mcpm-tunnel`}),` lists the volume names.`]}),`\n`,_jsx(Heading,{level:`2`,id:`who-can-manage-server-tunnels`,children:`Who can manage server tunnels`}),`\n`,_jsxs(_components.p,{children:[`Server tunnels are managed with one capability, `,_jsx(_components.strong,{children:`Manage tunnels`}),`, and they must be enabled for your workspace. The capability can be granted to any role. Someone with `,_jsx(_components.strong,{children:`Manage roles`}),` turns it on for the roles that need it.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Action`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Who can do it`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Create, rename, turn off or archive a server tunnel, and generate its commands`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Manage tunnels`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[`Mark a server as `,_jsx(_components.strong,{children:`Reached through a tunnel`}),`, choose its tunnel, or change its URL`]}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Manage tunnels`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Edit a tunnel’s allowed destinations`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Manage tunnels`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`See every tunnel and machine, with each machine’s version and update status, and terminate any of them`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Manage tunnels`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Publish releases, choose which release machines move to, and pause updates`}),_jsx(_components.td,{style:{textAlign:`left`},children:`MCP Manager staff only`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Assign a tunneled server to a gateway`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Basic gateway management`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Sign in to a tunneled server with your own identity`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Available to everyone`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Manage tunnels`}),` doesn’t let its holder read anyone else’s credentials or see more of the logs than their other capabilities allow. A server goes through exactly one tunnel. To switch it, use `,_jsx(_components.strong,{children:`Move to another tunnel`}),` on the server’s page.`]}),`\n`,_jsx(Heading,{level:`2`,id:`server-tunnel-or-workstation`,children:`Server tunnel or workstation`}),`\n`,_jsxs(_components.p,{children:[`A server tunnel and a `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/workstation`,children:`workstation`}),` both reach servers MCP Manager can’t reach directly, and both connect outbound only. They differ in who owns the machine and whose sign-in goes through it. Use a server tunnel when many people reach an internal server through one shared machine, each as themselves. Use a workstation for a server that runs on one person’s own machine.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`}}),_jsx(_components.th,{style:{textAlign:`left`},children:`Server tunnel`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Workstation`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Who owns it`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Your organization`}),_jsx(_components.td,{style:{textAlign:`left`},children:`One user`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`What it reaches`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Servers on its network, by URL`}),_jsx(_components.td,{style:{textAlign:`left`},children:`MCP servers on or near that user’s machine`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Whose sign-in`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Each user signs in as themselves`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The owner’s, or a shared identity the owner makes Global`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Credentials it sees`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Every user’s, so it must run on your organization’s infrastructure`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Its owner’s own`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Machines`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`One or more per tunnel, for failover`}),_jsx(_components.td,{style:{textAlign:`left`},children:`One machine at a time per user, serving all of that user’s workstation servers`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Updates`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Automatic. You run the command once, and the tunnel updates itself.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Run the latest command from the setup window`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Set up by`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Someone with `,_jsx(_components.strong,{children:`Manage tunnels`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Each user, with the workstation capabilities`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`when-a-request-through-a-server-tunnel-fails`,children:`When a request through a server tunnel fails`}),`\n`,_jsxs(_components.p,{children:[`A request through a server tunnel can fail in four ways. The AI client gets a short error that links to its section on this page. The full message, with the URL and the tunnel, is in the request’s log entry and, except for Tunnel disabled, in an alert. A destination that isn’t on the list is covered under `,_jsx(_components.a,{href:`#allowed-destinations`,children:`Allowed destinations`}),`; the other three are below.`]}),`\n`,_jsx(Heading,{level:`3`,id:`tunnel-unavailable`,children:`Tunnel unavailable`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Tunnel unavailable`}),` (`,_jsx(_components.code,{children:`MCPM_TUNNEL_UNAVAILABLE`}),`, HTTP 503) means the server’s tunnel has no machine that can take the request right now. The message names the tunnel. MCP Manager sent nothing to the internal server, and it never calls the server directly instead. The usual causes:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No machine is online.`}),` The machine is off, Docker is stopped, or the tunnel container isn’t running.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Its worker stopped.`}),` A release kept crashing, or the launcher had to stop the worker for memory. The launcher raises `,_jsx(_components.strong,{children:`A tunnel machine reports a failure`}),`. See `,_jsx(_components.a,{href:`#what-each-tunnel-alert-means`,children:`What each tunnel alert means`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The machine can’t reach MCP Manager.`}),` A firewall or proxy blocks one of the `,_jsx(_components.a,{href:`#what-the-tunnel-machine-needs`,children:`hosts it needs`}),`.`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Its last machine was terminated.`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A brief failure inside MCP Manager.`}),` The message then says so, and a retry succeeds.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`To fix it:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Open the tunnel in the `,_jsx(_components.strong,{children:`Tunnels`}),` section and check whether any machine is online and when each was last seen.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`On the machine, check that the tunnel container is running, and read its log. The log holds the launcher’s events and the worker’s own messages:`}),`\n`,_jsx(CodeBlock,{filename:`terminal`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ps`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --filter`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` name=mcpm-server-tunnel`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` logs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcpm-server-tunnel`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --tail`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 200`})]}),`\n`]})})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`If the log shows it can’t reach a host, have your network team allow it. See `,_jsx(_components.a,{href:`#what-the-tunnel-machine-needs`,children:`What the tunnel machine needs`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`If its machines were terminated, connect a machine with a new command.`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`To keep one machine from being a single point of failure, connect a second one. See `,_jsx(_components.a,{href:`#more-than-one-machine-for-failover`,children:`More than one machine for failover`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`misconfigured`,children:`Misconfigured`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Misconfigured`}),` (`,_jsx(_components.code,{children:`MCPM_TUNNEL_MISCONFIGURED`}),`, HTTP 500) means a server is marked as `,_jsx(_components.strong,{children:`Reached through a tunnel`}),` but MCP Manager can’t route it through one. Either it isn’t bound to exactly one active tunnel, or it isn’t a standalone remote server. Usually the server was saved without a tunnel. MCP Manager won’t guess where to send the request, and it never falls back to calling the server’s URL directly.`]}),`\n`,_jsxs(_components.p,{children:[`To fix it, someone with `,_jsx(_components.strong,{children:`Manage tunnels`}),` opens the server in `,_jsx(_components.a,{href:`https://app.mcpmanager.ai/settings/servers`,children:`MCP Servers`}),` and chooses its tunnel again. The next request uses the new binding. Only a standalone remote server can be reached through a tunnel; the error’s details name the server’s type when that’s the cause.`]}),`\n`,_jsx(Heading,{level:`3`,id:`tunnel-disabled`,children:`Tunnel disabled`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Tunnel disabled`}),` (`,_jsx(_components.code,{children:`MCPM_TUNNEL_DISABLED`}),`, HTTP 503) means an admin disabled or archived the server’s tunnel. It’s a choice, not a fault: MCP Manager sent nothing to the network behind the tunnel, and it never calls the server directly instead. The message names the tunnel and links to its page. The tunnel’s machines aren’t terminated, so nothing needs to be reinstalled.`]}),`\n`,_jsxs(_components.p,{children:[`To fix it, someone with `,_jsx(_components.strong,{children:`Manage tunnels`}),` turns on the tunnel’s `,_jsx(_components.strong,{children:`Enabled`}),` switch in the `,_jsx(_components.strong,{children:`Tunnels`}),` list. If the tunnel was archived, switch on `,_jsx(_components.strong,{children:`Show archived`}),` and unarchive it first. The next request goes through the same machines.`]}),`\n`,_jsx(Heading,{level:`2`,id:`when-a-machine-does-not-come-online-or-does-not-update`,children:`When a machine does not come online or does not update`}),`\n`,_jsxs(_components.p,{children:[`These states show in the `,_jsx(_components.strong,{children:`Tunnels`}),` section, on the machine. Each one says what MCP Manager knows, what it means for traffic, and what to do. Machine states are `,_jsx(_components.strong,{children:`Online`}),`, `,_jsx(_components.strong,{children:`Offline`}),` and `,_jsx(_components.strong,{children:`Terminated`}),`. Worker states are `,_jsx(_components.strong,{children:`Joining`}),`, `,_jsx(_components.strong,{children:`Being checked (update)`}),`, `,_jsx(_components.strong,{children:`Serving traffic`}),` and `,_jsx(_components.strong,{children:`Draining (being replaced)`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`the-install-command-is-refused`,children:`The install command is refused`}),`\n`,_jsx(_components.p,{children:`When MCP Manager refuses the command, the machine never connects. Its log says why, with a link to the page that fixes it:`}),`\n`,_jsx(CodeBlock,{filename:`terminal`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` logs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcpm-server-tunnel`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --tail`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 200`})]}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`The log says`}),_jsx(_components.th,{style:{textAlign:`left`},children:`What it means`}),_jsx(_components.th,{style:{textAlign:`left`},children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`This enrollment command was already used or revoked.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`A command connects one machine, once. It was already run, or `,_jsx(_components.strong,{children:`Revoke all machines`}),` cancelled it.`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Generate a new command.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`This enrollment command has expired.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`A command works for 24 hours after it’s made.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Generate a new command.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Tunnel … was disabled (or archived) in MCP Manager and takes no new machines`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The tunnel is off.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Enable it in the `,_jsx(_components.strong,{children:`Tunnels`}),` list, unarchiving it first if it’s archived. Then generate a new command.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`This machine was terminated in MCP Manager.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The command was run again after its machine was terminated.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Generate a new command.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`This enrollment command is not valid.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The token in the command is wrong, often because only part of the command was copied.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Copy the command again with `,_jsx(_components.strong,{children:`Copy command`}),`, not from the shortened line on screen.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`To generate a new command, open the tunnel in the `,_jsx(_components.strong,{children:`Tunnels`}),` section and select `,_jsx(_components.strong,{children:`Connect a machine`}),`, or select `,_jsx(_components.strong,{children:`re-generate command`}),` next to the expiry time if the window is still open. Before you run it, remove the refused container with `,_jsx(_components.code,{children:`docker rm -f mcpm-server-tunnel`}),`, because the new command starts a container with the same name.`]}),`\n`,_jsx(Heading,{level:`3`,id:`a-worker-stays-in-joining`,children:`A worker stays in Joining`}),`\n`,_jsxs(_components.p,{children:[`A worker in the `,_jsx(_components.strong,{children:`Joining`}),` state has started but hasn’t registered with MCP Manager yet. The machine carries no traffic through that worker until it registers.`]}),`\n`,_jsxs(_components.p,{children:[`The usual causes are a firewall or proxy that blocks `,_jsx(_components.code,{children:`headscale.mcpmanager.ai`}),`, `,_jsx(_components.code,{children:`derp-a.mcpmanager.ai`}),` or `,_jsx(_components.code,{children:`derp-b.mcpmanager.ai`}),`, a release that can’t be downloaded from Docker Hub, and a join key that expired because the machine was asleep. To find the cause, read the container’s log:`]}),`\n`,_jsx(CodeBlock,{filename:`terminal`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` logs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcpm-server-tunnel`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --tail`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 200`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`#what-the-tunnel-machine-needs`,children:`What the tunnel machine needs`}),` for the hosts to allow.`]}),`\n`,_jsx(Heading,{level:`3`,id:`a-machine-shows-as-offline`,children:`A machine shows as offline`}),`\n`,_jsxs(_components.p,{children:[`A machine shows as `,_jsx(_components.strong,{children:`Offline`}),` when it has no serving worker that checked in recently. It gets no traffic until one does.`]}),`\n`,_jsx(_components.p,{children:`To fix it, check that the container exists and is running, and start it if it stopped:`}),`\n`,_jsx(CodeBlock,{filename:`terminal`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ps`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -a`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --filter`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` name=mcpm-server-tunnel`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` start`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mcpm-server-tunnel`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`If the container is gone and its volume is gone too, the machine lost its identity and needs a new command. If only the container is gone, connect the host again with a new command too, because a command works once. Then terminate the old machine in the `,_jsx(_components.strong,{children:`Machines`}),` list.`]}),`\n`,_jsx(Heading,{level:`3`,id:`an-update-shows-waiting-its-turn`,children:`An update shows Waiting its turn`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Waiting its turn`}),` means a newer release exists and this machine hasn’t got it yet. The status gives the reason: MCP Manager updates one machine at a time across all tunnels unless staff raise that, staff paused updates, or the tunnel is off. Updates also pause by themselves for everyone when several new releases fail in a short time. The machine keeps running its current version and serves traffic as usual. Unless the tunnel is off, nothing is needed from you.`]}),`\n`,_jsxs(_components.p,{children:[`If the status also says the machine hasn’t checked in recently, it can’t start anything until it’s back online. See `,_jsx(_components.a,{href:`#a-machine-shows-as-offline`,children:`A machine shows as offline`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`an-update-shows-update-failed`,children:`An update shows Update failed`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Update failed`}),` means the update didn’t finish. The status shows the reason and the time. The machine keeps serving on its current version. MCP Manager raised one alert for the tunnel and release, which you find on the `,_jsx(_components.a,{href:`/features/alerts`,children:`Alerts`}),` page.`]}),`\n`,_jsx(_components.p,{children:`The reason says which part failed:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The launcher refused the release.`}),` It failed one of the `,_jsx(_components.a,{href:`#signed-releases-what-the-launcher-checks-before-anything-runs`,children:`signature or version checks`}),`, or it has nothing for this machine’s operating system and CPU type. This won’t succeed on retry, so the machine isn’t offered that release again.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The download failed.`}),` Docker Hub couldn’t be reached, or the download was cut short. MCP Manager tries again later.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The new worker failed MCP Manager’s checks.`}),` The reason names the check, for example that it can’t reach a specific allowed origin. MCP Manager doesn’t offer that release to the machine again until the tunnel’s allowed destinations change or a newer release comes out, so fixing the network alone doesn’t retry it. Removing an origin the machine can’t reach offers it again. If the tunnel lists more than 100 origins, which only a list saved outside the editor can, the reason says `,_jsx(_components.code,{children:`at most 100 can be checked`}),`: remove the origins the tunnel no longer needs.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`When a release failed on your machine, tell support the tunnel name, the reason and the time shown, so staff can publish a release for the machine to move to.`}),`\n`,_jsx(Heading,{level:`3`,id:`a-machine-shows-no-release-available-yet`,children:`A machine shows No release available yet`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`No release available yet`}),` means MCP Manager hasn’t published a release yet, so there’s nothing to update to. A machine that has no worker yet gets none until a release is published. Machines that already run a worker are unaffected.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-each-tunnel-alert-means`,children:`What each tunnel alert means`}),`\n`,_jsxs(_components.p,{children:[`Tunnel alerts link to this page. Find yours by its title or its code. Each entry says what the alert means, what happens to traffic meanwhile, and what to do. For alerts in general, see `,_jsx(_components.a,{href:`/features/alerts`,children:`Alerts`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`two-launchers-run-as-one-tunnel-machine`,children:`Two launchers run as one tunnel machine`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`warning.tunnel.duplicate_agent`}),`. Two launchers check in with the same machine’s key at the same time. That happens when a virtual machine is copied, or when a second container starts with a copy of the machine’s volume. MCP Manager can’t tell their workers apart.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Meanwhile:`}),` MCP Manager refuses neither copy, and traffic keeps flowing.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What to do:`}),` remove the copy’s container. It most likely has the same name as the original, which the alert names: `,_jsx(_components.code,{children:`mcpm-server-tunnel`}),`. If you can’t tell which one is the copy, terminate the machine in the `,_jsx(_components.strong,{children:`Machines`}),` list and connect each host again with its own new command.`]}),`\n`,_jsx(Heading,{level:`3`,id:`a-tunnel-machine-reports-a-failure`,children:`A tunnel machine reports a failure`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`error.tunnel.launcher_failure`}),`. The launcher on the machine reports one of these, named in the alert:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`crash_loop`}),`.`]}),` A new release died several times in a row before it served steadily. The launcher won’t start it again until another release becomes stable or the launcher restarts. Meanwhile, the machine runs the last release that served steadily. Tell support the tunnel name and the alert’s text.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`memory_kill`}),` of the worker that carries traffic.`]}),` The container neared its memory limit, and the launcher had to stop the serving worker. That machine carries no traffic until the launcher starts a worker again. Requests go to the tunnel’s other machines, and with no other machine online they fail with `,_jsx(_components.a,{href:`#tunnel-unavailable`,children:`Tunnel unavailable`}),`. If it happens again, tell support.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`a-tunnel-machine-takes-no-updates-until-it-repairs-its-trust-record`,children:`A tunnel machine takes no updates until it repairs its trust record`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`error.tunnel.launcher_failure`}),` with `,_jsx(_components.code,{children:`trust_damaged`}),`. The launcher found its record of trusted signing keys or its minimum release damaged.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Meanwhile:`}),` the machine keeps running the release it has and keeps serving traffic. It refuses every new release, fixes included, until it has repaired the record.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What to do:`}),` usually nothing. The launcher repairs the record by itself, from statements it reads from the release registry or gets from MCP Manager, with no reinstall. If the machine still reports this after several hours, check that it can reach Docker Hub (see `,_jsx(_components.a,{href:`#what-the-tunnel-machine-needs`,children:`What the tunnel machine needs`}),`), and look in its log for `,_jsx(_components.code,{children:`trust_damaged`}),` and then `,_jsx(_components.code,{children:`trust_rebuilt`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`a-tunnel-machine-reports-a-problem`,children:`A tunnel machine reports a problem`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`warning.tunnel.launcher_warning`}),`. The launcher reports a problem it works around. The machine keeps serving traffic. The alert names the problem:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`pulse_lost`}),`.`]}),` A worker stopped answering the launcher, so the launcher stopped it.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`memory_kill`}),`.`]}),` The container neared its memory limit, and the launcher stopped a worker that wasn’t carrying traffic, such as a new release being checked.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`journal_write_failed`}),` or `,_jsx(_components.code,{children:`journal_problem`}),`.`]}),` The launcher couldn’t write or read its records in the volume. Check that the host’s disk isn’t full.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`check_failed`}),`.`]}),` The launcher’s own check of the release registries didn’t finish. It keeps the release it runs and checks again later.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`no_process_limit`}),`, `,_jsx(_components.code,{children:`process_ceiling_below_minimum`}),`, `,_jsx(_components.code,{children:`memory_watchdog_off`}),` or `,_jsx(_components.code,{children:`swap_allowed`}),`.`]}),` The container wasn’t started with the `,_jsx(_components.code,{children:`--pids-limit`}),`, `,_jsx(_components.code,{children:`--memory`}),` and `,_jsx(_components.code,{children:`--memory-swap`}),` values from the command, so one of the `,_jsx(_components.a,{href:`#limits-that-stop-runaway-software`,children:`limits that stop runaway software`}),` is missing. Connect the host again with a new command, run as MCP Manager gives it, and terminate the old machine.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Any other code`}),`, such as `,_jsx(_components.code,{children:`root_set_refused`}),`, `,_jsx(_components.code,{children:`helper_failed`}),`, `,_jsx(_components.code,{children:`layout_problem`}),`, `,_jsx(_components.code,{children:`kind_mismatch`}),` or `,_jsx(_components.code,{children:`internal_error`}),`. The alert’s text gives the reason. If it repeats, tell support the tunnel name and the alert’s text.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`requests-claiming-to-be-a-tunnel-machine-were-refused`,children:`Requests claiming to be a tunnel machine were refused`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`warning.tunnel.machine_refused`}),`. MCP Manager refused several requests in a row that claim to be one machine, because their signature doesn’t match the key it holds for that machine.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Meanwhile:`}),` anyone who knows a machine’s id can send such requests, and they change nothing. If the machine still checks in, nothing needs doing. If the machine itself sent them, it reaches nothing, and its workers keep retrying.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What to do:`}),` this happens when a machine was restored from an old backup of its volume, or when a key renewal didn’t finish. Terminate the machine and connect the host again with a new command.`]}),`\n`,_jsx(Heading,{level:`3`,id:`a-tunnel-machine-signed-a-request-with-a-counter-that-went-backwards`,children:`A tunnel machine signed a request with a counter that went backwards`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`warning.tunnel.machine_refused`}),`. A launcher numbers its signed requests in order, and this request carried a number far below the highest one MCP Manager has accepted from the machine. Usually the machine was restored from a backup or snapshot of its volume, or an older copy of it runs on another host.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Meanwhile:`}),` requests from that older state stay refused. Its check-ins fail, and a worker of it that restarts can’t join the tunnel again.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What to do:`}),` if a copy runs on another host, remove it first. Then terminate the machine and connect the host again with a new command.`]}),`\n`,_jsx(Heading,{level:`3`,id:`the-machines-of-a-tunnel-were-only-partly-terminated`,children:`The machines of a tunnel were only partly terminated`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`warning.tunnel.termination_incomplete`}),`. Someone selected `,_jsx(_components.strong,{children:`Revoke all machines`}),`, and only part of it finished. The alert says how many machines were terminated and what failed.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Meanwhile:`}),` a machine that wasn’t terminated keeps carrying traffic, and a command that wasn’t cancelled can still connect a machine.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What to do:`}),` open the tunnel and select `,_jsx(_components.strong,{children:`Revoke all machines`}),` again.`]}),`\n`,_jsx(Heading,{level:`3`,id:`a-tunnel-update-failed-on-a-machine`,children:`A tunnel update failed on a machine`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`warning.tunnel.update_deferred`}),`. When MCP Manager will try the release again, the title is `,_jsx(_components.strong,{children:`A tunnel update hit a problem on a machine`}),` instead. A new release didn’t start on the machine, and the alert says at which step and why.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Meanwhile:`}),` the current version keeps serving.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What to do:`}),` see `,_jsx(_components.a,{href:`#an-update-shows-update-failed`,children:`An update shows Update failed`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`alerts-that-are-no-longer-raised`,children:`Alerts that are no longer raised`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`error.tunnel.no_healthy_worker`}),`, `,_jsx(_components.code,{children:`warning.tunnel.replacement_incomplete`}),` and `,_jsx(_components.code,{children:`warning.tunnel.trust_state_unsaved`}),` came from the earlier tunnel agent, which is gone. MCP Manager no longer raises them, but older alerts can still show them. Nothing needs doing about an old one.`]}),`\n`,_jsx(Heading,{level:`2`,id:`further-reading`,children:`Further reading`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Connect an internal server through a tunnel`,icon:`route`,href:`/tutorials/connect-an-internal-server-through-a-tunnel`,children:_jsx(_components.p,{children:`The hands-on tutorial: create a tunnel, connect a machine, and let each user sign in as themselves.`})}),_jsx(Card,{title:`Workstation MCP Servers`,icon:`laptop`,href:`/mcp-gateway-concepts/mcp-servers/workstation`,children:_jsx(_components.p,{children:`Servers on one person’s own machine, reached through an encrypted tunnel.`})}),_jsx(Card,{title:`Remote MCP Servers`,icon:`cloud`,href:`/mcp-gateway-concepts/mcp-servers/remote`,children:_jsx(_components.p,{children:`Servers at a URL, and the authentication methods they use.`})}),_jsx(Card,{title:`Architecture \u0026 Trust`,icon:`building-shield`,href:`/mcp-gateway-concepts/architecture-and-trust`,children:_jsx(_components.p,{children:`How the gateway path is secured, and where a server tunnel fits.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`external-sources`,children:`External sources`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`WireGuard`,icon:`shield-halved`,href:`https://www.wireguard.com/`,children:_jsx(_components.p,{children:`The encrypted-tunnel protocol that server tunnels are built on.`})}),_jsx(Card,{title:`Docker run reference: runtime privilege and Linux capabilities`,icon:`docker`,href:`https://docs.docker.com/engine/containers/run/#runtime-privilege-and-linux-capabilities`,children:_jsxs(_components.p,{children:[`What `,_jsx(_components.code,{children:`--cap-drop`}),`, `,_jsx(_components.code,{children:`--cap-add`}),` and `,_jsx(_components.code,{children:`--security-opt`}),` do.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{TunnelHandoverDiagram,TunnelContainerDiagram,TunnelPathDiagram,DiagramView,DiagramFigure,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Server Tunnels","diataxis":"explanation","sidebarTitle":"Server tunnels","description":"What a server tunnel is: a machine your organization runs next to internal servers, such as a self-hosted GitLab, through which MCP Manager reaches them while every user signs in as themselves. Covers the one command you run once and what each part of it allows, the container that runs on the machine (a launcher that never changes and workers that update themselves, with no Docker socket and no host folders), signed releases and how updates hand over with no downtime, the independent check that replaces a worker that won't update, the limits that stop runaway software, allowed destinations and the MCPM_TUNNEL_ALLOWED_ORIGINS cap, terminating a machine or a tunnel, the Manage tunnels capability, and what the tunnel-unavailable, update-failed, misconfigured and tunnel-disabled states mean.","icon":"route","keywords":["server tunnel","tunnel","internal server","self-hosted GitLab","Grafana","on-premises","private network","VPN","Reached through a tunnel","allowed destinations","allowed origins","MCPM_TUNNEL_ALLOWED_ORIGINS","MCPM_TUNNEL_UNAVAILABLE","MCPM_TUNNEL_DESTINATION_NOT_ALLOWED","MCPM_TUNNEL_MISCONFIGURED","MCPM_TUNNEL_DISABLED","mcpmanager/tunnel","launcher","worker","no Docker socket","cap-drop","read-only container","pids-limit","install command","Manage tunnels","terminate machine","automatic updates","signed release","root keys","release floor","zero downtime","Waiting its turn","Update failed","WireGuard","per-user identity"],"href":"/mcp-gateway-concepts/mcp-servers/server-tunnels"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[140,140,"ContainerDiagram=()=>null;const TunnelPathDiagram=()=>null;const DiagramFigure=()=>null;const Tunnel"],[2054,15553,""],[15606,20705,""],[127584,127606,""],[127648,127666,"Figure,TunnelHandoverDiagram,DiagramView"]]},"mdxExtracts":{"tableOfContents":[{"title":"What a server tunnel is for","slug":"what-a-server-tunnel-is-for","depth":2,"children":[]},{"title":"How a server tunnel connects","slug":"how-a-server-tunnel-connects","depth":2,"children":[{"title":"What the tunnel machine needs","slug":"what-the-tunnel-machine-needs","depth":3,"children":[]},{"title":"Private certificates and outbound proxies","slug":"private-certificates-and-outbound-proxies","depth":3,"children":[]},{"title":"The one-time command that connects a machine","slug":"the-one-time-command-that-connects-a-machine","depth":3,"children":[]},{"title":"Every privilege the tunnel gets is in the command","slug":"every-privilege-the-tunnel-gets-is-in-the-command","depth":3,"children":[]},{"title":"The token, the machine key and when you need a new command","slug":"the-token-the-machine-key-and-when-you-need-a-new-command","depth":3,"children":[]},{"title":"More than one machine for failover","slug":"more-than-one-machine-for-failover","depth":3,"children":[]}]},{"title":"What the tunnel machine can see","slug":"what-the-tunnel-machine-can-see","depth":2,"children":[]},{"title":"What runs inside the tunnel container","slug":"what-runs-inside-the-tunnel-container","depth":2,"children":[{"title":"What a worker can’t do","slug":"what-a-worker-can’t-do","depth":3,"children":[]},{"title":"What a server tunnel doesn’t promise","slug":"what-a-server-tunnel-doesn’t-promise","depth":3,"children":[]}]},{"title":"Automatic updates with no downtime","slug":"automatic-updates-with-no-downtime","depth":2,"children":[{"title":"What MCP Manager staff control and what your organization controls","slug":"what-mcp-manager-staff-control-and-what-your-organization-controls","depth":3,"children":[]},{"title":"Signed releases: what the launcher checks before anything runs","slug":"signed-releases-what-the-launcher-checks-before-anything-runs","depth":3,"children":[]},{"title":"How an update runs","slug":"how-an-update-runs","depth":3,"children":[]},{"title":"When an update goes wrong","slug":"when-an-update-goes-wrong","depth":3,"children":[]},{"title":"How MCP Manager paces updates","slug":"how-mcp-manager-paces-updates","depth":3,"children":[]},{"title":"The independent check: replacing a worker that stops updating","slug":"the-independent-check-replacing-a-worker-that-stops-updating","depth":3,"children":[]},{"title":"What the Tunnels section shows about updates","slug":"what-the-tunnels-section-shows-about-updates","depth":3,"children":[]}]},{"title":"Limits that stop runaway software","slug":"limits-that-stop-runaway-software","depth":2,"children":[]},{"title":"Allowed destinations","slug":"allowed-destinations","depth":2,"children":[{"title":"Limit destinations on the machine itself","slug":"limit-destinations-on-the-machine-itself","depth":3,"children":[]}]},{"title":"Terminating a machine or a tunnel","slug":"terminating-a-machine-or-a-tunnel","depth":2,"children":[]},{"title":"Who can manage server tunnels","slug":"who-can-manage-server-tunnels","depth":2,"children":[]},{"title":"Server tunnel or workstation","slug":"server-tunnel-or-workstation","depth":2,"children":[]},{"title":"When a request through a server tunnel fails","slug":"when-a-request-through-a-server-tunnel-fails","depth":2,"children":[{"title":"Tunnel unavailable","slug":"tunnel-unavailable","depth":3,"children":[]},{"title":"Misconfigured","slug":"misconfigured","depth":3,"children":[]},{"title":"Tunnel disabled","slug":"tunnel-disabled","depth":3,"children":[]}]},{"title":"When a machine does not come online or does not update","slug":"when-a-machine-does-not-come-online-or-does-not-update","depth":2,"children":[{"title":"The install command is refused","slug":"the-install-command-is-refused","depth":3,"children":[]},{"title":"A worker stays in Joining","slug":"a-worker-stays-in-joining","depth":3,"children":[]},{"title":"A machine shows as offline","slug":"a-machine-shows-as-offline","depth":3,"children":[]},{"title":"An update shows Waiting its turn","slug":"an-update-shows-waiting-its-turn","depth":3,"children":[]},{"title":"An update shows Update failed","slug":"an-update-shows-update-failed","depth":3,"children":[]},{"title":"A machine shows No release available yet","slug":"a-machine-shows-no-release-available-yet","depth":3,"children":[]}]},{"title":"What each tunnel alert means","slug":"what-each-tunnel-alert-means","depth":2,"children":[{"title":"Two launchers run as one tunnel machine","slug":"two-launchers-run-as-one-tunnel-machine","depth":3,"children":[]},{"title":"A tunnel machine reports a failure","slug":"a-tunnel-machine-reports-a-failure","depth":3,"children":[]},{"title":"A tunnel machine takes no updates until it repairs its trust record","slug":"a-tunnel-machine-takes-no-updates-until-it-repairs-its-trust-record","depth":3,"children":[]},{"title":"A tunnel machine reports a problem","slug":"a-tunnel-machine-reports-a-problem","depth":3,"children":[]},{"title":"Requests claiming to be a tunnel machine were refused","slug":"requests-claiming-to-be-a-tunnel-machine-were-refused","depth":3,"children":[]},{"title":"A tunnel machine signed a request with a counter that went backwards","slug":"a-tunnel-machine-signed-a-request-with-a-counter-that-went-backwards","depth":3,"children":[]},{"title":"The machines of a tunnel were only partly terminated","slug":"the-machines-of-a-tunnel-were-only-partly-terminated","depth":3,"children":[]},{"title":"A tunnel update failed on a machine","slug":"a-tunnel-update-failed-on-a-machine","depth":3,"children":[]},{"title":"Alerts that are no longer raised","slug":"alerts-that-are-no-longer-raised","depth":3,"children":[]}]},{"title":"Further reading","slug":"further-reading","depth":2,"children":[]},{"title":"External sources","slug":"external-sources","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"mcpmanagerbyusercentrics","siteName":"MCP Manager","title":"Server Tunnels - MCP Manager","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T17:33:03.691Z","originalFileLocation":"mcp-gateway-concepts/mcp-servers/server-tunnels.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"What a server tunnel is: a machine your organization runs next to internal servers, such as a self-hosted GitLab, through which MCP Manager reaches them while every user signs in as themselves. Covers the one command you run once and what each part of it allows, the container that runs on the machine (a launcher that never changes and workers that update themselves, with no Docker socket and no host folders), signed releases and how updates hand over with no downtime, the independent check that replaces a worker that won\u0026#x27;t update, the limits that stop runaway software, allowed destinations and the MCPM_TUNNEL_ALLOWED_ORIGINS cap, terminating a machine or a tunnel, the Manage tunnels capability, and what the tunnel-unavailable, update-failed, misconfigured and tunnel-disabled states mean.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MCP Manager\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mcpmanagerbyusercentrics/VOFxFtXGpF8ZdNYo/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/mcpmanagerbyusercentrics/VOFxFtXGpF8ZdNYo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mcpmanagerbyusercentrics/VOFxFtXGpF8ZdNYo/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mcpmanagerbyusercentrics/VOFxFtXGpF8ZdNYo/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mcpmanagerbyusercentrics/VOFxFtXGpF8ZdNYo/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mcpmanagerbyusercentrics/VOFxFtXGpF8ZdNYo/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mcpmanagerbyusercentrics/VOFxFtXGpF8ZdNYo/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mcpmanagerbyusercentrics/VOFxFtXGpF8ZdNYo/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mcpmanagerbyusercentrics/VOFxFtXGpF8ZdNYo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Server Tunnels - MCP Manager\">\u003cmeta data-mint-head property=\"og:description\" content=\"What a server tunnel is: a machine your organization runs next to internal servers, such as a self-hosted GitLab, through which MCP Manager reaches them while every user signs in as themselves. Covers the one command you run once and what each part of it allows, the container that runs on the machine (a launcher that never changes and workers that update themselves, with no Docker socket and no host folders), signed releases and how updates hand over with no downtime, the independent check that replaces a worker that won\u0026#x27;t update, the limits that stop runaway software, allowed destinations and the MCPM_TUNNEL_ALLOWED_ORIGINS cap, terminating a machine or a tunnel, the Manage tunnels capability, and what the tunnel-unavailable, update-failed, misconfigured and tunnel-disabled states mean.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MCP Manager\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/server-tunnels\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mcpmanagerbyusercentrics.mintlify.site/_mintlify/api/og/v2?division=MCP+Servers\u0026amp;title=Server+Tunnels\u0026amp;description=What+a+server+tunnel+is%3A+a+machine+your+organization+runs+next+to+internal+servers%2C+such+as+a+self-hosted+GitLab%2C+through+which+MCP+Manager+reaches+them+while+e\u0026amp;theme=ee542cc5624d2073b939b538\u0026amp;signature=833e5a54d2bc043d76202c52ebf9aacbc98e16a25d3787fb8d086606db873e0d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Server Tunnels - MCP Manager\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What a server tunnel is: a machine your organization runs next to internal servers, such as a self-hosted GitLab, through which MCP Manager reaches them while every user signs in as themselves. Covers the one command you run once and what each part of it allows, the container that runs on the machine (a launcher that never changes and workers that update themselves, with no Docker socket and no host folders), signed releases and how updates hand over with no downtime, the independent check that replaces a worker that won\u0026#x27;t update, the limits that stop runaway software, allowed destinations and the MCPM_TUNNEL_ALLOWED_ORIGINS cap, terminating a machine or a tunnel, the Manage tunnels capability, and what the tunnel-unavailable, update-failed, misconfigured and tunnel-disabled states mean.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mcpmanagerbyusercentrics.mintlify.site/_mintlify/api/og/v2?division=MCP+Servers\u0026amp;title=Server+Tunnels\u0026amp;description=What+a+server+tunnel+is%3A+a+machine+your+organization+runs+next+to+internal+servers%2C+such+as+a+self-hosted+GitLab%2C+through+which+MCP+Manager+reaches+them+while+e\u0026amp;theme=ee542cc5624d2073b939b538\u0026amp;signature=833e5a54d2bc043d76202c52ebf9aacbc98e16a25d3787fb8d086606db873e0d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/mcpmanagerbyusercentrics/VOFxFtXGpF8ZdNYo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MCP Manager\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0E7490\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/server-tunnels\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/mcp-gateway-concepts/mcp-servers/server-tunnels.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mcpmanager.ai/#organization\",\"name\":\"MCP Manager\",\"url\":\"https://docs.mcpmanager.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mcpmanagerbyusercentrics/6VTit4ttpXMM_zQN/images/mcp-manager-gradient-horizontal.png?fit=max\u0026auto=format\u0026n=6VTit4ttpXMM_zQN\u0026q=85\u0026s=e94ab5f0ba0a199071d9382c369a563e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mcpmanager.ai#website\",\"name\":\"MCP Manager\",\"url\":\"https://docs.mcpmanager.ai\",\"publisher\":{\"@id\":\"https://docs.mcpmanager.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/server-tunnels#webpage\",\"url\":\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/server-tunnels\",\"name\":\"Server Tunnels\",\"description\":\"What a server tunnel is: a machine your organization runs next to internal servers, such as a self-hosted GitLab, through which MCP Manager reaches them while every user signs in as themselves. Covers the one command you run once and what each part of it allows, the container that runs on the machine (a launcher that never changes and workers that update themselves, with no Docker socket and no host folders), signed releases and how updates hand over with no downtime, the independent check that replaces a worker that won't update, the limits that stop runaway software, allowed destinations and the MCPM_TUNNEL_ALLOWED_ORIGINS cap, terminating a machine or a tunnel, the Manage tunnels capability, and what the tunnel-unavailable, update-failed, misconfigured and tunnel-disabled states mean.\",\"dateModified\":\"2026-11-19T17:33:03.691Z\",\"isPartOf\":{\"@id\":\"https://docs.mcpmanager.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/server-tunnels#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/server-tunnels#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"MCP Gateway Concepts\",\"item\":\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MCP Servers\",\"item\":\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Server Tunnels\",\"item\":\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/server-tunnels\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/server-tunnels#article\",\"headline\":\"Server Tunnels\",\"name\":\"Server Tunnels\",\"description\":\"What a server tunnel is: a machine your organization runs next to internal servers, such as a self-hosted GitLab, through which MCP Manager reaches them while every user signs in as themselves. Covers the one command you run once and what each part of it allows, the container that runs on the machine (a launcher that never changes and workers that update themselves, with no Docker socket and no host folders), signed releases and how updates hand over with no downtime, the independent check that replaces a worker that won't update, the limits that stop runaway software, allowed destinations and the MCPM_TUNNEL_ALLOWED_ORIGINS cap, terminating a machine or a tunnel, the Manage tunnels capability, and what the tunnel-unavailable, update-failed, misconfigured and tunnel-disabled states mean.\",\"url\":\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/server-tunnels\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mcpmanager.ai/mcp-gateway-concepts/mcp-servers/server-tunnels#webpage\"},\"dateModified\":\"2026-11-19T17:33:03.691Z\",\"keywords\":\"server tunnel, tunnel, internal server, self-hosted GitLab, Grafana, on-premises, private network, VPN, Reached through a tunnel, allowed destinations, allowed origins, MCPM_TUNNEL_ALLOWED_ORIGINS, MCPM_TUNNEL_UNAVAILABLE, MCPM_TUNNEL_DESTINATION_NOT_ALLOWED, MCPM_TUNNEL_MISCONFIGURED, MCPM_TUNNEL_DISABLED, mcpmanager/tunnel, launcher, worker, no Docker socket, cap-drop, read-only container, pids-limit, install command, Manage tunnels, terminate machine, automatic updates, signed release, root keys, release floor, zero downtime, Waiting its turn, Update failed, WireGuard, per-user identity\",\"publisher\":{\"@id\":\"https://docs.mcpmanager.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mcpmanager.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MCP Manager\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"MCP Manager\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/mcp-gateway-concepts/mcp-servers/server-tunnels.md","siteName":"MCP Manager","nav":{"global":null,"groups":[{"group":"Get Started","icon":"rocket","pages":[{"title":"Introduction","sidebarTitle":"Introduction","icon":"house","href":"/get-started/introduction"},{"title":"Use these docs with your AI agent","sidebarTitle":"Docs for AI agents","icon":"wand-magic-sparkles","href":"/get-started/use-docs-with-ai"}]},{"group":"MCP Gateway Concepts","icon":"diagram-project","pages":[{"group":"MCP Servers","icon":"server","pages":[{"title":"MCP Servers Overview","sidebarTitle":"Overview","icon":"server","href":"/mcp-gateway-concepts/mcp-servers/overview"},{"title":"Remote MCP Servers","sidebarTitle":"Remote","icon":"cloud","href":"/mcp-gateway-concepts/mcp-servers/remote"},{"title":"Choosing a Remote Server's Authentication Method","sidebarTitle":"Choosing remote auth","icon":"list-check","href":"/mcp-gateway-concepts/mcp-servers/choosing-remote-auth"},{"title":"Managed MCP Servers","sidebarTitle":"Managed","icon":"cubes","href":"/mcp-gateway-concepts/mcp-servers/managed"},{"title":"Self-Hosted MCP Servers","sidebarTitle":"Self-hosted","icon":"rocket","href":"/mcp-gateway-concepts/mcp-servers/self-hosted"},{"title":"Workstation MCP Servers","sidebarTitle":"Workstation","icon":"laptop","href":"/mcp-gateway-concepts/mcp-servers/workstation"},{"title":"Troubleshoot a workstation connection","sidebarTitle":"Troubleshooting","description":"How to diagnose a workstation server that will not connect: read the proxy container's logs, query its live connection state as JSON, and look up the diagnostic code it reports. Written so you — or an AI assistant reading these docs — can go from a stuck setup screen to the exact hostname your network team needs to allow.","icon":"stethoscope","href":"/mcp-gateway-concepts/mcp-servers/workstation-troubleshooting"},{"title":"Server Tunnels","sidebarTitle":"Server tunnels","icon":"route","href":"/mcp-gateway-concepts/mcp-servers/server-tunnels"},{"title":"Troubleshoot a remote server connection","sidebarTitle":"Troubleshooting connections","description":"What to do when MCP Manager cannot connect to a remote MCP server: a firewall or bot protection blocking MCP Manager, a server that cannot be reached, a server that does not answer the first MCP request, or authentication that cannot be detected. Each section names the cause, how to confirm it, and what to change.","icon":"stethoscope","href":"/mcp-gateway-concepts/mcp-servers/troubleshooting-connections"}]},{"title":"MCP Gateways","sidebarTitle":"MCP Gateways","icon":"network-wired","href":"/mcp-gateway-concepts/mcp-gateways"},{"title":"Apps \u0026 Agents","sidebarTitle":"Apps \u0026 Agents","icon":"robot","href":"/mcp-gateway-concepts/apps-and-agents"},{"title":"Architecture \u0026 Trust","sidebarTitle":"Architecture \u0026 Trust","icon":"building-shield","href":"/mcp-gateway-concepts/architecture-and-trust"}]},{"group":"Features","icon":"shapes","pages":[{"title":"Features","sidebarTitle":"Overview","icon":"grid-2","href":"/features/overview"},{"title":"Connection Experience","sidebarTitle":"Connection Experience","icon":"plug-circle-check","href":"/features/connection-experience"},{"title":"Feature Provisioning","sidebarTitle":"Feature Provisioning","icon":"filter","href":"/features/feature-provisioning"},{"title":"API Tokens \u0026 Headless Agents","sidebarTitle":"API Tokens \u0026 Agents","icon":"key","href":"/features/api-tokens-and-headless-agents"},{"title":"Reporting","sidebarTitle":"Reporting","icon":"chart-pie","href":"/features/reporting"},{"title":"Viewing Logs","sidebarTitle":"Viewing Logs","icon":"rectangle-list","href":"/features/viewing-logs"},{"title":"PII Filtering","sidebarTitle":"PII Filtering","icon":"user-secret","href":"/features/pii-filtering"},{"group":"Gateway Rules","icon":"shield-halved","pages":[{"title":"Gateway Rules Overview","sidebarTitle":"Overview","icon":"shield-halved","href":"/features/gateway-rules/overview"},{"title":"Regex","sidebarTitle":"Regex","icon":"asterisk","href":"/features/gateway-rules/regex"},{"title":"Microsoft Presidio","sidebarTitle":"Microsoft Presidio","icon":"user-shield","href":"/features/gateway-rules/presidio"},{"title":"Amazon Bedrock","sidebarTitle":"Amazon Bedrock","icon":{"style":"brands","name":"aws","library":"fontawesome"},"href":"/features/amazon-bedrock"},{"title":"Google Model Armor","sidebarTitle":"Google Model Armor","icon":{"style":"brands","name":"google","library":"fontawesome"},"href":"/features/google-model-armor"},{"title":"Azure Prompt Shields","sidebarTitle":"Azure Prompt Shields","icon":{"style":"brands","name":"microsoft","library":"fontawesome"},"href":"/features/azure-prompt-shields"},{"title":"Azure AI Content Safety","sidebarTitle":"Azure AI Content Safety","icon":{"style":"brands","name":"microsoft","library":"fontawesome"},"href":"/features/azure-ai-content-safety"},{"title":"Lakera Guard","sidebarTitle":"Lakera Guard","icon":"shield-check","href":"/features/lakera-guard"},{"title":"Google Drive Folder Blocker","sidebarTitle":"Drive Folder Blocker","icon":"folder-tree","href":"/features/gateway-rules/google-drive-folder-blocker"},{"title":"Custom Rule Engines","sidebarTitle":"Custom Rule Engines","icon":"plug","href":"/features/gateway-rules/custom-rules-engines"}]},{"title":"Identity Controls","sidebarTitle":"Identity Controls","icon":"id-card","href":"/features/identity-controls"},{"title":"Alerts","sidebarTitle":"Alerts","icon":"bell","href":"/features/alerts"}]},{"group":"Industries","icon":"industry","pages":[{"title":"Industries","sidebarTitle":"Overview","icon":"industry","href":"/industries/overview"},{"title":"Financial Services \u0026 Banking","sidebarTitle":"Financial Services","icon":"building-columns","href":"/industries/financial-services-and-banking"},{"title":"Investment Management","sidebarTitle":"Investment Management","icon":"chart-line","href":"/industries/investment-management"},{"title":"Healthcare \u0026 Life Sciences","sidebarTitle":"Healthcare","icon":"heart-pulse","href":"/industries/healthcare-and-life-sciences"},{"title":"Pharmaceutical \u0026 Biotechnology","sidebarTitle":"Pharma \u0026 Biotech","icon":"flask-vial","href":"/industries/pharmaceutical-and-biotechnology"},{"title":"Insurance","sidebarTitle":"Insurance","icon":"umbrella","href":"/industries/insurance"},{"title":"Cybersecurity \u0026 Threat Intelligence","sidebarTitle":"Cybersecurity","icon":"user-secret","href":"/industries/cybersecurity-and-threat-intelligence"},{"title":"Energy \u0026 Utilities","sidebarTitle":"Energy \u0026 Utilities","icon":"bolt","href":"/industries/energy-and-utilities"},{"title":"Government \u0026 Public Sector","sidebarTitle":"Government","icon":"landmark","href":"/industries/government-and-public-sector"},{"title":"Retail \u0026 E-commerce","sidebarTitle":"Retail \u0026 E-commerce","icon":"cart-shopping","href":"/industries/retail-and-ecommerce"}]},{"group":"Tutorials","icon":"graduation-cap","pages":[{"title":"Tutorials","sidebarTitle":"Overview","icon":"graduation-cap","href":"/tutorials/overview"},{"title":"Quickstart: Your first governed tool call","sidebarTitle":"First tool call","icon":"rocket","href":"/tutorials/first-tool-call"},{"title":"Connect your AI client to a gateway","sidebarTitle":"Connect your AI client","icon":"plug","href":"/tutorials/connect-your-ai-client"},{"title":"Connect a workstation MCP server","sidebarTitle":"Workstation server","icon":"laptop","href":"/tutorials/connect-a-workstation-server"},{"title":"Connect an internal server through a tunnel","sidebarTitle":"Internal server through a tunnel","icon":"route","href":"/tutorials/connect-an-internal-server-through-a-tunnel"},{"title":"Build a team gateway and invite a teammate","sidebarTitle":"Build a team gateway","icon":"users","href":"/tutorials/team-gateway"},{"title":"Add your first gateway rule","sidebarTitle":"Add a gateway rule","icon":"shield-halved","href":"/tutorials/first-gateway-rule"},{"title":"Redact PII from tool responses with Presidio","sidebarTitle":"Redact PII with Presidio","icon":"user-shield","href":"/tutorials/pii-filtering"},{"title":"Trace a tool call in your logs","sidebarTitle":"Trace a call in logs","icon":"magnifying-glass","href":"/tutorials/trace-in-logs"},{"title":"Run a headless agent with an API token","sidebarTitle":"Run a headless agent","icon":"robot","href":"/tutorials/headless-agent"},{"title":"Build and connect your first custom rule engine","sidebarTitle":"Build a custom rule engine","icon":"plug","href":"/tutorials/custom-rule-engine"}]},{"group":"MCP Server Guides","icon":"compass","pages":[{"title":"Find \u0026 Connect MCP Servers","sidebarTitle":"Overview","icon":"compass","href":"/mcp-server-guides/overview"},{"title":"Connect Asana","sidebarTitle":"Asana","icon":"https://mintlify.s3.us-west-1.amazonaws.com/mcpmanagerbyusercentrics/icons/asana.svg","href":"/mcp-server-guides/asana"},{"title":"Connect Atlassian Rovo","sidebarTitle":"Atlassian Rovo","icon":"atlassian","href":"/mcp-server-guides/atlassian"},{"title":"Connect AWS","sidebarTitle":"AWS","icon":"aws","href":"/mcp-server-guides/aws"},{"title":"Connect Bitbucket","sidebarTitle":"Bitbucket","icon":"bitbucket","href":"/mcp-server-guides/bitbucket"},{"title":"Connect Chargebee","sidebarTitle":"Chargebee","icon":"file-invoice-dollar","href":"/mcp-server-guides/chargebee"},{"title":"Connect Datadog","sidebarTitle":"Datadog","icon":"dog","href":"/mcp-server-guides/datadog"},{"title":"Connect Figma","sidebarTitle":"Figma","icon":"figma","href":"/mcp-server-guides/figma"},{"title":"Connect GitHub","sidebarTitle":"GitHub","icon":"github","href":"/mcp-server-guides/github"},{"title":"Connect HubSpot","sidebarTitle":"HubSpot","icon":"hubspot","href":"/mcp-server-guides/hubspot"},{"title":"Connect Metabase","sidebarTitle":"Metabase","icon":"chart-bar","href":"/mcp-server-guides/metabase"},{"title":"Connect Notion","sidebarTitle":"Notion","icon":"notion","href":"/mcp-server-guides/notion"},{"title":"Connect Salesforce","sidebarTitle":"Salesforce","icon":"salesforce","href":"/mcp-server-guides/salesforce"},{"title":"Connect Slack","sidebarTitle":"Slack","icon":"slack","href":"/mcp-server-guides/slack"}]},{"group":"Security","icon":"lock","pages":[{"title":"Security Overview","sidebarTitle":"Overview","icon":"shield","href":"/security/overview"},{"title":"Authentication \u0026 Identity","sidebarTitle":"Authentication \u0026 Identity","icon":"fingerprint","href":"/security/authentication-and-identity"},{"title":"MCP Authorization Support","sidebarTitle":"MCP Authorization Support","icon":"id-card","href":"/security/mcp-authorization-support"},{"title":"Feature Governance","sidebarTitle":"Feature Governance","icon":"list-check","href":"/security/feature-governance"},{"title":"Audit \u0026 Observability","sidebarTitle":"Audit \u0026 Observability","icon":"magnifying-glass-chart","href":"/security/audit-and-observability"},{"title":"Runtime Protections","sidebarTitle":"Runtime Protections","icon":"shield-halved","href":"/security/runtime-protections"}]},{"group":"Deployment","icon":"boxes-stacked","pages":[{"group":"Access Control","icon":"user-lock","pages":[{"title":"Access Control","sidebarTitle":"Overview","icon":"user-lock","href":"/deployment/access-control"},{"title":"Roles","sidebarTitle":"Roles","icon":"user-shield","href":"/deployment/rbac-and-roles/overview"},{"title":"Teams","sidebarTitle":"Teams","icon":"users","href":"/deployment/teams"},{"title":"Capabilities","sidebarTitle":"Capabilities","icon":"key","href":"/deployment/rbac-and-roles/capabilities"},{"title":"Restore a Deactivated Member","sidebarTitle":"Restore a deactivated member","icon":"user-check","href":"/deployment/restore-a-deactivated-member"}]},{"title":"Gateway Deployment Strategies","sidebarTitle":"Gateway Deployment Strategies","icon":"sitemap","href":"/deployment/gateway-deployment-strategies"},{"title":"Safe Rollout Sequence","sidebarTitle":"Safe Rollout Sequence","icon":"shield-check","href":"/deployment/safe-rollout-sequence"},{"title":"Hosting \u0026 Data Residency","sidebarTitle":"Hosting \u0026 Data Residency","icon":"cloud","href":"/deployment/hosting-and-data-residency"},{"title":"Product Support","sidebarTitle":"Product Support","icon":"life-ring","href":"/deployment/product-support"},{"title":"Uptime \u0026 Maintenance Plan","sidebarTitle":"Uptime \u0026 Maintenance Plan","icon":"calendar-check","href":"/deployment/uptime-and-maintenance-plan"},{"title":"Enterprise Strategy \u0026 Lockdown","sidebarTitle":"Enterprise \u0026 Lockdown","icon":"building-lock","href":"/deployment/enterprise-strategy-and-lockdown"},{"title":"MCP Enterprise Lockdown Checklist","sidebarTitle":"Lockdown Checklist","icon":"list-check","href":"/deployment/lockdown-checklist"}]},{"group":"Enterprise","icon":"building","pages":[{"title":"Security \u0026 Compliance","sidebarTitle":"Security \u0026 Compliance","icon":"file-shield","href":"/enterprise/security-and-compliance"},{"title":"Single Sign-On (SSO)","sidebarTitle":"SSO","icon":"right-to-bracket","href":"/enterprise/sso"},{"title":"Add an MCP Manager tile to your IdP dashboard","sidebarTitle":"IdP dashboard tile","icon":"grip","href":"/enterprise/idp-dashboard-tile"},{"title":"SCIM Provisioning","sidebarTitle":"SCIM","icon":"arrows-rotate","href":"/enterprise/scim"},{"title":"Supported Identity Providers","sidebarTitle":"Identity Providers","icon":"address-book","href":"/enterprise/supported-identity-providers"},{"title":"Programmatic Access","sidebarTitle":"Programmatic Access","icon":"code","href":"/enterprise/programmatic-access"},{"group":"Export to SIEM","icon":"tower-broadcast","pages":[{"title":"Export to SIEM","sidebarTitle":"Overview","icon":"tower-broadcast","href":"/enterprise/export-to-siem"},{"title":"New Relic","sidebarTitle":"New Relic","icon":"chart-line","href":"/enterprise/export-to-siem/new-relic"},{"title":"Grafana Cloud","sidebarTitle":"Grafana Cloud","icon":"lines-leaning","href":"/enterprise/export-to-siem/grafana-cloud"},{"title":"Datadog","sidebarTitle":"Datadog","icon":"dog","href":"/enterprise/export-to-siem/datadog"},{"title":"Honeycomb","sidebarTitle":"Honeycomb","icon":"table-cells-large","href":"/enterprise/export-to-siem/honeycomb"},{"title":"Splunk","sidebarTitle":"Splunk","icon":"database","href":"/enterprise/export-to-siem/splunk-observability-cloud"},{"title":"Self-hosted OpenTelemetry Collector","sidebarTitle":"Self-hosted Collector","icon":"server","href":"/enterprise/export-to-siem/self-hosted-collector"}]}]},{"group":"Admin API \u0026 MCP","icon":"terminal","tag":"Beta","pages":[{"title":"Admin API \u0026 MCP Server","sidebarTitle":"Overview","icon":"terminal","tag":"Beta","href":"/admin-api/overview"},{"title":"Connect an agent to the Admin MCP server","sidebarTitle":"Connect an agent","icon":"plug","tag":"Beta","href":"/admin-api/connect"},{"title":"Authentication \u0026 access","sidebarTitle":"Authentication \u0026 access","icon":"shield-halved","tag":"Beta","href":"/admin-api/authentication"},{"title":"Plan limits","sidebarTitle":"Plan limits","icon":"gauge","tag":"Beta","href":"/admin-api/plan-limits"},{"group":"Tool \u0026 endpoint reference","icon":"book","pages":[{"title":"Tool \u0026 endpoint reference","sidebarTitle":"Overview","icon":"book","tag":"Beta","href":"/admin-api/reference/overview"},{"title":"Account \u0026 Access Tokens","sidebarTitle":"Account \u0026 Access Tokens","icon":"key","tag":"Beta","href":"/admin-api/reference/account"},{"title":"Servers","sidebarTitle":"Servers","icon":"server","tag":"Beta","href":"/admin-api/reference/servers"},{"title":"Identities","sidebarTitle":"Identities","icon":"fingerprint","tag":"Beta","href":"/admin-api/reference/identities"},{"title":"Gateways","sidebarTitle":"Gateways","icon":"network-wired","tag":"Beta","href":"/admin-api/reference/gateways"},{"title":"People, Teams \u0026 Roles","sidebarTitle":"People, teams \u0026 roles","icon":"users","tag":"Beta","href":"/admin-api/reference/people"},{"title":"Hosts","sidebarTitle":"Hosts","icon":"robot","tag":"Beta","href":"/admin-api/reference/hosts"},{"title":"Logging","sidebarTitle":"Logging","icon":"file-lines","tag":"Beta","href":"/admin-api/reference/logging"}]},{"title":"What's coming","sidebarTitle":"What's coming","icon":"road","tag":"Beta","href":"/admin-api/roadmap"}]},{"group":"Build Your Own MCP Server","icon":"hammer","pages":[{"title":"Building Your Own MCP Server","sidebarTitle":"Overview","icon":"hammer","href":"/build-your-own-mcp-server/overview"},{"title":"Add a Connect Button to Your Site","sidebarTitle":"Connect Button","icon":"link","href":"/build-your-own-mcp-server/connect-button"},{"title":"Build with FastMCP (Python)","sidebarTitle":"FastMCP (Python)","icon":"python","href":"/build-your-own-mcp-server/fastmcp"},{"title":"Build with the TypeScript SDK","sidebarTitle":"TypeScript SDK","icon":"js","href":"/build-your-own-mcp-server/typescript"},{"title":"Build on Cloudflare Workers","sidebarTitle":"Cloudflare Workers","icon":"cloudflare","href":"/build-your-own-mcp-server/cloudflare"},{"title":"Build with Spring AI (Java)","sidebarTitle":"Spring AI (Java)","icon":"java","href":"/build-your-own-mcp-server/java-spring"},{"title":"Build with Go","sidebarTitle":"Go (SDK + mcp-go)","icon":"golang","href":"/build-your-own-mcp-server/go"},{"title":"Debugging Your Self-Hosted Server's OAuth","sidebarTitle":"Debug Self-Hosted OAuth","icon":"bug","href":"/build-your-own-mcp-server/debugging-self-hosted-oauth"}]},{"group":"Advanced","icon":"screwdriver-wrench","pages":[{"title":"Validate MCP Servers with Open Tools","sidebarTitle":"Validate Servers","icon":"plug-circle-check","href":"/advanced/validate-mcp-servers"},{"title":"Gateway Resiliency","sidebarTitle":"Gateway Resiliency","icon":"heart-pulse","href":"/advanced/gateway-resiliency"},{"title":"Fix a Broken or Stale MCP Connection","sidebarTitle":"Fix a Broken Connection","icon":"plug-circle-xmark","href":"/advanced/fixing-broken-connections"},{"title":"Agents that Pass Identities to MCP Manager","sidebarTitle":"Agents Passing Identities","icon":"id-badge","href":"/advanced/agents-passing-identities"},{"title":"Getting fresh data from Claude","sidebarTitle":"Stale data in Claude","icon":"arrows-rotate","href":"/advanced/getting-fresh-data-from-claude"},{"title":"Building a Custom Rule Engine","sidebarTitle":"Building an Engine","icon":"code","href":"/advanced/building-a-custom-rule-engine"},{"title":"Custom Rule Engine Examples","sidebarTitle":"Custom Rule Engine Examples","icon":"wand-magic-sparkles","href":"/advanced/custom-rule-engine-examples"},{"title":"Building vs. Buying an MCP Gateway","sidebarTitle":"Building vs. Buying","icon":"scale-balanced","href":"/advanced/building-vs-buying"},{"title":"Frequently Asked Questions","sidebarTitle":"FAQ","icon":"circle-question","href":"/advanced/faq"}]}]},"basePath":"","title":"Server Tunnels - MCP Manager","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}