A hands-on walkthrough for reaching an MCP server on your internal network, such as a self-hosted GitLab, through a server tunnel: create the tunnel, list the server’s origin, connect a machine with the one-time command that you never run again (one container, no Docker socket), add the server as Reached through a tunnel, assign it to a gateway, and have each user sign in with their own identity.
By the end of this tutorial, an MCP server on your internal network will be reachable through an MCP Manager gateway, and each person who uses it will sign in as themselves. Nothing on your network is exposed to the internet, and you open no inbound port.This tutorial uses a self-hosted GitLab at https://gitlab.example.internal as the example. Its MCP endpoint is https://gitlab.example.internal/api/v4/mcp.
Following along with your own server? Only two values change. Use your server’s origin (scheme, host and port) in Step 1, and its MCP URL in Step 3. Everything else is the same.
You need four capabilities: Manage tunnels for the tunnel, Basic server management to add the server, Basic gateway management to assign it to a gateway, and View and export logs to see the logs at the end. Server tunnels must also be enabled for your workspace. Without that, or without Manage tunnels, you won’t see the Tunnels section. Ask a workspace administrator. See Who can manage server tunnels.
What you’ll need
An MCP Manager workspace and a role with the capabilities above.
A Linux machine on your internal network that your organization controls and that stays on. It must reach the internal server. The tunnel machine sees every credential sent through it, so don’t use a personal laptop. See What the tunnel machine can see.
Docker Engine on that machine, running as root (the standard install). Rootless Docker and Podman aren’t supported yet. The machine runs no other server tunnel: one per Docker host.
Outbound TCP 443 from that machine to app.mcpmanager.ai, headscale.mcpmanager.ai, derp-a.mcpmanager.ai, derp-b.mcpmanager.ai, and Docker Hub’s registry-1.docker.io, auth.docker.io and production.cloudfront.docker.com. See What the tunnel machine needs.
The internal server’s MCP URL.
For each person who will sign in: a browser that can reach the server’s sign-in page, for example on your office network or VPN.
Step 1: Create a server tunnel
1
Open Tunnels
Open the Tunnels section in MCP Manager.
2
Create the tunnel
Select Create server tunnel. In Tunnel name, name it after the network it reaches, for example Office network. Under Allowed destinations, list the origins it may reach, one per line, for example https://gitlab.example.internal. An origin is the scheme, host and port only, with no path. Select Create tunnel, and the tunnel’s page opens.
Your own server: if it signs users in through a separate host, such as your own identity provider, add that origin too. Every request through the tunnel, including each step of the sign-in, must go to an allowed origin.
Step 2: Connect a machine
1
Open Connect a machine
On the tunnel’s page, select Connect a machine. The window lists the tunnel’s allowed destinations, and MCP Manager makes the command and shows it right away.If the window says that no agent release is available yet, MCP Manager has to publish one before it can give you a command. Try again later.
2
Check the allowed destinations
Make sure https://gitlab.example.internal is on the list. If it isn’t, select Edit, add it, and select Save and generate command. MCP Manager saves the list and makes a new command.
Check the list before you run the command. The command caps where this machine may send requests, in its MCPM_TUNNEL_ALLOWED_ORIGINS value, and MCP Manager fills that value in from this list. To reach an origin you add later, the machine needs a new command. See Limit destinations on the machine itself.
3
Copy the command
Leave Docker (default) selected for Docker Desktop, for Docker inside a VM, and for servers elsewhere on your network. If the machine is a Linux host with Docker Engine and your server runs on that same machine, choose Docker Engine on Linux (host network) under Not working? Try another variation, so the tunnel reaches the server at localhost.Select Copy command. Copy it before you close the window, because MCP Manager shows it once. It can be used once, and it expires after 24 hours. For a fresh one, select re-generate command next to the expiry time.
4
Run it on the machine
Run the command on the machine in your network. MCP Manager fills in every value, so it looks like this with your own:
The command starts one container in the background and returns. The container gets no Docker socket and no folder from your host, and everything it’s allowed to do is in that line. See Every privilege the tunnel gets is in the command.On its first start, the container makes the machine’s key, downloads the current signed release, checks it, and starts the worker that connects to your tunnel.The container is always named mcpm-server-tunnel, so a host runs one server tunnel machine. Running the command again, or replacing a machine on a host that already runs one? Remove the old container first. The window shows this command above the install command:
terminal
docker rm -f mcpm-server-tunnel
Removing the container disconnects that machine from its tunnel. If you’re replacing a machine, also terminate the old one in the tunnel’s Machines list, so MCP Manager stops accepting its key.
5
Wait for the machine to come online
Leave the window open. It checks the tunnel every few seconds for 10 minutes. When the new machine is online, usually within a minute or two, the window closes by itself and a Tunnel is available. message appears. The machine shows on your tunnel, and your workspace gets an alert, A machine joined a server tunnel. To check right away, or after 10 minutes, select Check connection.
If the machine doesn’t come online, Check connection tells you whether it enrolled. To see why, read the container’s log on the machine:
terminal
docker logs mcpm-server-tunnel --tail 200
A message that the command was already used or has expired means you need a new command from Connect a machine. A message that a host cannot be reached means a firewall or proxy is blocking it. See What the tunnel machine needs. For a worker that stays in Joining, see A worker stays in Joining.
You run this command once. The container restarts on its own after a reboot, and the tunnel updates itself with signed releases. You never run the command again to stay current or secure. See Automatic updates with no downtime.
Step 3: Add the internal server
1
Enter the server's URL
Go to MCP Servers, click Add, choose Remote, and enter the URL: https://gitlab.example.internal/api/v4/mcp.Shortcut: Add a server through it, in the Tunnel is available. message, opens this window with Office network already chosen. The message stays until you close it. Add in Servers reached through this tunnel, on the tunnel’s page, does the same.
2
Route it through the tunnel
Before you select Continue, open Reach this server through a tunnel (optional), turn on Reached through a tunnel, and choose Office network. You can’t change this after Continue.The window shows that https://gitlab.example.internal is already in the tunnel’s allowed destinations. For a server whose origin isn’t on the list yet, a switch to add it is on by default. A machine connected before that needs a new command to reach the new origin.
3
Finish adding the server
Select Continue, check the Server name, and select Continue again. MCP Manager connects to the server through the tunnel. If it asks you to sign in, select Authenticate now to sign in as yourself, or Do it later.
From now on, MCP Manager sends this server’s traffic only through Office network. It never calls the URL directly, even when the tunnel is down.
Step 4: Assign the server to a gateway
1
Assign it
Go to Gateways, open the gateway your team uses, and on its Servers tab click Assign a server. Select the GitLab server. Its identity setup opens.
2
Choose per-user identity
Under Identity Scheme, select Each user uses their own identity, so each person signs in to GitLab as themselves. See Identity Controls.
They select Authenticate with GitLab, or Add new identity if they already have identities. GitLab’s sign-in and consent screen opens in their browser, so that browser must reach https://gitlab.example.internal. If it can’t, they connect to the VPN and try again.Everything else in the sign-in, such as the token exchange, goes through the tunnel machine.
3
Call a tool
In the AI client, ask for something that uses GitLab:
List my open merge requests in GitLab.
The request goes from the client to the MCP Manager gateway, through the tunnel to the machine on your network, and on to GitLab, signed in as that person.
4
Find the call in your logs
Go to Logs and open the newest tools/call entry. It shows who made the call, through which gateway, on the GitLab server. GitLab’s own audit log shows the same person.
If a call fails, the error links to what to do. Tunnel unavailable means no machine on the tunnel is online: see Tunnel unavailable. A refused destination means an origin is missing from the list: see Allowed destinations.
An internal server is now behind your gateway. Each person signs in to it as themselves, every call is governed and logged, and your network accepts no inbound connection. MCP Manager keeps the tunnel machine up to date on its own, so you never run the install command again.
Check each machine’s version and update status in the Tunnels section. The status is read-only, and Waiting its turn is normal. See What the Tunnels section shows about updates.
Add more internal servers on the same network to the same tunnel. When you add a server’s origin to the allowed destinations, each machine connected before that needs a new command to reach it. See Limit destinations on the machine itself.
How a server tunnel works, what runs in the container, how updates run, and terminating a machine.
Identity Controls
Per-user and shared identity, and what each looks like for the people who connect.
Connect a workstation MCP server
Connect a server that runs on your own machine instead.
Capabilities reference
The capabilities that gate server tunnels and gateways.
{"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":"tutorials/connect-an-internal-server-through-a-tunnel","slug":"/tutorials/connect-an-internal-server-through-a-tunnel","pageMetadata":{"title":"Connect an internal server through a tunnel","diataxis":"tutorial","sidebarTitle":"Internal server through a tunnel","description":"A hands-on walkthrough for reaching an MCP server on your internal network, such as a self-hosted GitLab, through a server tunnel: create the tunnel, list the server's origin, connect a machine with the one-time command that you never run again (one container, no Docker socket), add the server as Reached through a tunnel, assign it to a gateway, and have each user sign in with their own identity.","icon":"route","keywords":["server tunnel","internal server","self-hosted GitLab","on-premises","private network","VPN","Reached through a tunnel","allowed destinations","install command","enrollment command","docker","mcpmanager/tunnel","mcpm-server-tunnel","per-user identity","OAuth"],"href":"/tutorials/connect-an-internal-server-through-a-tunnel"},"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: \"A hands-on walkthrough for reaching an MCP server on your internal network, such as a self-hosted GitLab, through a server tunnel: create the tunnel, list the server’s origin, connect a machine with the one-time command that you never run again (one container, no Docker socket), add the server as Reached through a tunnel, assign it to a gateway, and have each user sign in with their own identity.\"\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];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,Check,CodeBlock,Heading,Info,Note,Step,Steps,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Check)_missingMdxReference(`Check`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`By the end of this tutorial, an MCP server on your internal network will be reachable through an `,_jsx(_components.strong,{children:`MCP Manager`}),` gateway, and each person who uses it will sign in as themselves. Nothing on your network is exposed to the internet, and you open no inbound port.`]}),`\n`,_jsxs(_components.p,{children:[`This tutorial uses a self-hosted GitLab at `,_jsx(_components.code,{children:`https://gitlab.example.internal`}),` as the example. Its MCP endpoint is `,_jsx(_components.code,{children:`https://gitlab.example.internal/api/v4/mcp`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Following along with your own server?`}),` Only two values change. Use your server’s origin (scheme, host and port) in `,_jsx(_components.a,{href:`#step-1-create-a-server-tunnel`,children:`Step 1`}),`, and its MCP URL in `,_jsx(_components.a,{href:`#step-3-add-the-internal-server`,children:`Step 3`}),`. Everything else is the same.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`You need four capabilities: `,_jsx(_components.strong,{children:`Manage tunnels`}),` for the tunnel, `,_jsx(_components.strong,{children:`Basic server management`}),` to add the server, `,_jsx(_components.strong,{children:`Basic gateway management`}),` to assign it to a gateway, and `,_jsx(_components.strong,{children:`View and export logs`}),` to see the logs at the end. Server tunnels must also be enabled for your workspace. Without that, or without `,_jsx(_components.strong,{children:`Manage tunnels`}),`, you won’t see the `,_jsx(_components.strong,{children:`Tunnels`}),` section. Ask a workspace administrator. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#who-can-manage-server-tunnels`,children:`Who can manage server tunnels`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`what-you’ll-need`,children:`What you’ll need`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`An MCP Manager workspace and a role with the capabilities above.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A Linux machine on your internal network`}),` that your organization controls and that stays on. It must reach the internal server. The tunnel machine sees every credential sent through it, so don’t use a personal laptop. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#what-the-tunnel-machine-can-see`,children:`What the tunnel machine can see`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Docker Engine`}),` on that machine, running as root (the standard install). Rootless Docker and Podman aren’t supported yet. The machine runs no other server tunnel: one per Docker host.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Outbound TCP 443`}),` from that machine to `,_jsx(_components.code,{children:`app.mcpmanager.ai`}),`, `,_jsx(_components.code,{children:`headscale.mcpmanager.ai`}),`, `,_jsx(_components.code,{children:`derp-a.mcpmanager.ai`}),`, `,_jsx(_components.code,{children:`derp-b.mcpmanager.ai`}),`, and Docker Hub’s `,_jsx(_components.code,{children:`registry-1.docker.io`}),`, `,_jsx(_components.code,{children:`auth.docker.io`}),` and `,_jsx(_components.code,{children:`production.cloudfront.docker.com`}),`. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#what-the-tunnel-machine-needs`,children:`What the tunnel machine needs`}),`.`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`The internal server’s MCP URL.`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`For each person who will sign in:`}),` a browser that can reach the server’s sign-in page, for example on your office network or VPN.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`step-1-create-a-server-tunnel`,children:`Step 1: Create a server tunnel`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Tunnels`,children:_jsxs(_components.p,{children:[`Open the `,_jsx(_components.strong,{children:`Tunnels`}),` section in MCP Manager.`]})}),_jsxs(Step,{title:`Create the tunnel`,children:[_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Create server tunnel`}),`. In `,_jsx(_components.strong,{children:`Tunnel name`}),`, name it after the network it reaches, for example `,_jsx(_components.code,{children:`Office network`}),`. Under `,_jsx(_components.strong,{children:`Allowed destinations`}),`, list the origins it may reach, one per line, for example `,_jsx(_components.code,{children:`https://gitlab.example.internal`}),`. An origin is the scheme, host and port only, with no path. Select `,_jsx(_components.strong,{children:`Create tunnel`}),`, and the tunnel’s page opens.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Your own server:`}),` if it signs users in through a separate host, such as your own identity provider, add that origin too. Every request through the tunnel, including each step of the sign-in, must go to an allowed origin.`]})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`step-2-connect-a-machine`,children:`Step 2: Connect a machine`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open Connect a machine`,children:[_jsxs(_components.p,{children:[`On the tunnel’s page, select `,_jsx(_components.strong,{children:`Connect a machine`}),`. The window lists the tunnel’s allowed destinations, and MCP Manager makes the command and shows it right away.`]}),_jsx(_components.p,{children:`If the window says that no agent release is available yet, MCP Manager has to publish one before it can give you a command. Try again later.`})]}),_jsxs(Step,{title:`Check the allowed destinations`,children:[_jsxs(_components.p,{children:[`Make sure `,_jsx(_components.code,{children:`https://gitlab.example.internal`}),` is on the list. If it isn’t, select `,_jsx(_components.strong,{children:`Edit`}),`, add it, and select `,_jsx(_components.strong,{children:`Save and generate command`}),`. MCP Manager saves the list and makes a new command.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Check the list before you run the command. The command caps where this machine may send requests, in its `,_jsx(_components.code,{children:`MCPM_TUNNEL_ALLOWED_ORIGINS`}),` value, and MCP Manager fills that value in from this list. To reach an origin you add later, the machine needs a new command. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#limit-destinations-on-the-machine-itself`,children:`Limit destinations on the machine itself`}),`.`]})})]}),_jsxs(Step,{title:`Copy the command`,children:[_jsxs(_components.p,{children:[`Leave `,_jsx(_components.strong,{children:`Docker (default)`}),` selected for Docker Desktop, for Docker inside a VM, and for servers elsewhere on your network. If the machine is a Linux host with Docker Engine and your server runs on that same machine, choose `,_jsx(_components.strong,{children:`Docker Engine on Linux (host network)`}),` under `,_jsx(_components.strong,{children:`Not working? Try another variation`}),`, so the tunnel reaches the server at `,_jsx(_components.code,{children:`localhost`}),`.`]}),_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Copy command`}),`. Copy it before you close the window, because MCP Manager shows it once. It can be used once, and it expires after 24 hours. For a fresh one, select `,_jsx(_components.strong,{children:`re-generate command`}),` next to the expiry time.`]})]}),_jsxs(Step,{title:`Run it on the machine`,children:[_jsx(_components.p,{children:`Run the command on the machine in your network. MCP Manager fills in every value, so it looks like this with your own:`}),_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`]})})}),_jsxs(_components.p,{children:[`The command starts one container in the background and returns. The container gets no Docker socket and no folder from your host, and everything it’s allowed to do is in that line. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#every-privilege-the-tunnel-gets-is-in-the-command`,children:`Every privilege the tunnel gets is in the command`}),`.`]}),_jsx(_components.p,{children:`On its first start, the container makes the machine’s key, downloads the current signed release, checks it, and starts the worker that connects to your tunnel.`}),_jsxs(_components.p,{children:[`The container is always named `,_jsx(_components.code,{children:`mcpm-server-tunnel`}),`, so a host runs one server tunnel machine. Running the command again, or replacing a machine on a host that already runs one? Remove the old container first. The window shows this command above the install command:`]}),_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:` 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.p,{children:[`Removing the container disconnects that machine from its tunnel. If you’re replacing a machine, also terminate the old one in the tunnel’s `,_jsx(_components.strong,{children:`Machines`}),` list, so MCP Manager stops accepting its key.`]})]}),_jsxs(Step,{title:`Wait for the machine to come online`,children:[_jsxs(_components.p,{children:[`Leave the window open. It checks the tunnel every few seconds for 10 minutes. When the new machine is online, usually within a minute or two, the window closes by itself and a `,_jsx(_components.strong,{children:`Tunnel is available.`}),` message appears. The machine shows on your tunnel, and your workspace gets an alert, `,_jsx(_components.strong,{children:`A machine joined a server tunnel`}),`. To check right away, or after 10 minutes, select `,_jsx(_components.strong,{children:`Check connection`}),`.`]}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`If the machine doesn’t come online, `,_jsx(_components.strong,{children:`Check connection`}),` tells you whether it enrolled. To see why, read the container’s log on the machine:`]}),_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`]})})}),_jsxs(_components.p,{children:[`A message that the command was already used or has expired means you need a new command from `,_jsx(_components.strong,{children:`Connect a machine`}),`. A message that a host cannot be reached means a firewall or proxy is blocking it. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#what-the-tunnel-machine-needs`,children:`What the tunnel machine needs`}),`. For a worker that stays in `,_jsx(_components.strong,{children:`Joining`}),`, see `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#a-worker-stays-in-joining`,children:`A worker stays in Joining`}),`.`]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`You run this command once. The container restarts on its own after a reboot, and the tunnel updates itself with signed releases. You never run the command again to stay current or secure. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#automatic-updates-with-no-downtime`,children:`Automatic updates with no downtime`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`step-3-add-the-internal-server`,children:`Step 3: Add the internal server`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Enter the server's URL`,children:[_jsxs(_components.p,{children:[`Go to `,_jsx(_components.a,{href:`https://app.mcpmanager.ai/settings/servers`,children:`MCP Servers`}),`, click `,_jsx(_components.strong,{children:`Add`}),`, choose `,_jsx(_components.strong,{children:`Remote`}),`, and enter the URL: `,_jsx(_components.code,{children:`https://gitlab.example.internal/api/v4/mcp`}),`.`]}),_jsxs(_components.p,{children:[`Shortcut: `,_jsx(_components.strong,{children:`Add a server through it`}),`, in the `,_jsx(_components.strong,{children:`Tunnel is available.`}),` message, opens this window with `,_jsx(_components.code,{children:`Office network`}),` already chosen. The message stays until you close it. `,_jsx(_components.strong,{children:`Add`}),` in `,_jsx(_components.strong,{children:`Servers reached through this tunnel`}),`, on the tunnel’s page, does the same.`]})]}),_jsxs(Step,{title:`Route it through the tunnel`,children:[_jsxs(_components.p,{children:[`Before you select `,_jsx(_components.strong,{children:`Continue`}),`, open `,_jsx(_components.strong,{children:`Reach this server through a tunnel (optional)`}),`, turn on `,_jsx(_components.strong,{children:`Reached through a tunnel`}),`, and choose `,_jsx(_components.code,{children:`Office network`}),`. You can’t change this after `,_jsx(_components.strong,{children:`Continue`}),`.`]}),_jsxs(_components.p,{children:[`The window shows that `,_jsx(_components.code,{children:`https://gitlab.example.internal`}),` is already in the tunnel’s allowed destinations. For a server whose origin isn’t on the list yet, a switch to add it is on by default. A machine connected before that needs a new command to reach the new origin.`]})]}),_jsx(Step,{title:`Finish adding the server`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Continue`}),`, check the `,_jsx(_components.strong,{children:`Server name`}),`, and select `,_jsx(_components.strong,{children:`Continue`}),` again. MCP Manager connects to the server through the tunnel. If it asks you to sign in, select `,_jsx(_components.strong,{children:`Authenticate now`}),` to sign in as yourself, or `,_jsx(_components.strong,{children:`Do it later`}),`.`]})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`From now on, MCP Manager sends this server’s traffic only through `,_jsx(_components.code,{children:`Office network`}),`. It never calls the URL directly, even when the tunnel is down.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`step-4-assign-the-server-to-a-gateway`,children:`Step 4: Assign the server to a gateway`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Assign it`,children:_jsxs(_components.p,{children:[`Go to `,_jsx(_components.a,{href:`https://app.mcpmanager.ai/settings/gateways`,children:`Gateways`}),`, open the gateway your team uses, and on its `,_jsx(_components.strong,{children:`Servers`}),` tab click `,_jsx(_components.strong,{children:`Assign a server`}),`. Select the GitLab server. Its identity setup opens.`]})}),_jsx(Step,{title:`Choose per-user identity`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Identity Scheme`}),`, select `,_jsx(_components.strong,{children:`Each user uses their own identity`}),`, so each person signs in to GitLab as themselves. See `,_jsx(_components.a,{href:`/features/identity-controls`,children:`Identity Controls`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`step-5-each-person-signs-in-as-themselves`,children:`Step 5: Each person signs in as themselves`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Connect the gateway`,children:_jsxs(_components.p,{children:[`Each person connects the gateway in their AI client, as in `,_jsx(_components.a,{href:`/tutorials/connect-your-ai-client`,children:`Connect your AI client to a gateway`}),`. MCP Manager shows `,_jsx(_components.strong,{children:`Connect to GitLab`}),`.`]})}),_jsxs(Step,{title:`Authorize`,children:[_jsxs(_components.p,{children:[`They select `,_jsx(_components.strong,{children:`Authenticate with GitLab`}),`, or `,_jsx(_components.strong,{children:`Add new identity`}),` if they already have identities. GitLab’s sign-in and consent screen opens in `,_jsx(_components.strong,{children:`their`}),` browser, so that browser must reach `,_jsx(_components.code,{children:`https://gitlab.example.internal`}),`. If it can’t, they connect to the VPN and try again.`]}),_jsx(_components.p,{children:`Everything else in the sign-in, such as the token exchange, goes through the tunnel machine.`})]}),_jsxs(Step,{title:`Call a tool`,children:[_jsx(_components.p,{children:`In the AI client, ask for something that uses GitLab:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`List my open merge requests in GitLab.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`The request goes from the client to the MCP Manager gateway, through the tunnel to the machine on your network, and on to GitLab, signed in as that person.`})]}),_jsx(Step,{title:`Find the call in your logs`,children:_jsxs(_components.p,{children:[`Go to `,_jsx(_components.a,{href:`https://app.mcpmanager.ai/settings/logging/logs`,children:`Logs`}),` and open the newest `,_jsx(_components.code,{children:`tools/call`}),` entry. It shows who made the call, through which gateway, on the GitLab server. GitLab’s own audit log shows the same person.`]})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`If a call fails, the error links to what to do. `,_jsx(_components.strong,{children:`Tunnel unavailable`}),` means no machine on the tunnel is online: see `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#tunnel-unavailable`,children:`Tunnel unavailable`}),`. A refused destination means an origin is missing from the list: see `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#allowed-destinations`,children:`Allowed destinations`}),`.`]})}),`\n`,_jsx(Check,{children:_jsx(_components.p,{children:`An internal server is now behind your gateway. Each person signs in to it as themselves, every call is governed and logged, and your network accepts no inbound connection. MCP Manager keeps the tunnel machine up to date on its own, so you never run the install command again.`})}),`\n`,_jsx(Heading,{level:`2`,id:`what’s-next`,children:`What’s next`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Connect a second machine to the tunnel, so one machine going down doesn’t stop traffic. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#more-than-one-machine-for-failover`,children:`More than one machine for failover`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Check each machine’s version and update status in the `,_jsx(_components.strong,{children:`Tunnels`}),` section. The status is read-only, and `,_jsx(_components.strong,{children:`Waiting its turn`}),` is normal. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#what-the-tunnels-section-shows-about-updates`,children:`What the Tunnels section shows about updates`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Add more internal servers on the same network to the same tunnel. When you add a server’s origin to the allowed destinations, each machine connected before that needs a new command to reach it. See `,_jsx(_components.a,{href:`/mcp-gateway-concepts/mcp-servers/server-tunnels#limit-destinations-on-the-machine-itself`,children:`Limit destinations on the machine itself`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Add a guardrail to the gateway in `,_jsx(_components.a,{href:`/tutorials/first-gateway-rule`,children:`Add your first gateway rule`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`further-reading`,children:`Further reading`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Server Tunnels`,icon:`route`,href:`/mcp-gateway-concepts/mcp-servers/server-tunnels`,children:_jsx(_components.p,{children:`How a server tunnel works, what runs in the container, how updates run, and terminating a machine.`})}),_jsx(Card,{title:`Identity Controls`,icon:`id-badge`,href:`/features/identity-controls`,children:_jsx(_components.p,{children:`Per-user and shared identity, and what each looks like for the people who connect.`})}),_jsx(Card,{title:`Connect a workstation MCP server`,icon:`laptop`,href:`/tutorials/connect-a-workstation-server`,children:_jsx(_components.p,{children:`Connect a server that runs on your own machine instead.`})}),_jsx(Card,{title:`Capabilities reference`,icon:`user-lock`,href:`/deployment/rbac-and-roles/capabilities`,children:_jsx(_components.p,{children:`The capabilities that gate server tunnels and gateways.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{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":"Connect an internal server through a tunnel","diataxis":"tutorial","sidebarTitle":"Internal server through a tunnel","description":"A hands-on walkthrough for reaching an MCP server on your internal network, such as a self-hosted GitLab, through a server tunnel: create the tunnel, list the server's origin, connect a machine with the one-time command that you never run again (one container, no Docker socket), add the server as Reached through a tunnel, assign it to a gateway, and have each user sign in with their own identity.","icon":"route","keywords":["server tunnel","internal server","self-hosted GitLab","on-premises","private network","VPN","Reached through a tunnel","allowed destinations","install command","enrollment command","docker","mcpmanager/tunnel","mcpm-server-tunnel","per-user identity","OAuth"],"href":"/tutorials/connect-an-internal-server-through-a-tunnel"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What you’ll need","slug":"what-you’ll-need","depth":2,"children":[]},{"title":"Step 1: Create a server tunnel","slug":"step-1-create-a-server-tunnel","depth":2,"children":[]},{"title":"Step 2: Connect a machine","slug":"step-2-connect-a-machine","depth":2,"children":[]},{"title":"Step 3: Add the internal server","slug":"step-3-add-the-internal-server","depth":2,"children":[]},{"title":"Step 4: Assign the server to a gateway","slug":"step-4-assign-the-server-to-a-gateway","depth":2,"children":[]},{"title":"Step 5: Each person signs in as themselves","slug":"step-5-each-person-signs-in-as-themselves","depth":2,"children":[]},{"title":"What’s next","slug":"what’s-next","depth":2,"children":[]},{"title":"Further reading","slug":"further-reading","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"mcpmanagerbyusercentrics","siteName":"MCP Manager","title":"Connect an internal server through a tunnel - MCP Manager","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T17:33:03.691Z","originalFileLocation":"tutorials/connect-an-internal-server-through-a-tunnel.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=\"A hands-on walkthrough for reaching an MCP server on your internal network, such as a self-hosted GitLab, through a server tunnel: create the tunnel, list the server\u0026#x27;s origin, connect a machine with the one-time command that you never run again (one container, no Docker socket), add the server as Reached through a tunnel, assign it to a gateway, and have each user sign in with their own identity.\">\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=\"Connect an internal server through a tunnel - MCP Manager\">\u003cmeta data-mint-head property=\"og:description\" content=\"A hands-on walkthrough for reaching an MCP server on your internal network, such as a self-hosted GitLab, through a server tunnel: create the tunnel, list the server\u0026#x27;s origin, connect a machine with the one-time command that you never run again (one container, no Docker socket), add the server as Reached through a tunnel, assign it to a gateway, and have each user sign in with their own identity.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MCP Manager\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mcpmanager.ai/tutorials/connect-an-internal-server-through-a-tunnel\">\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=Tutorials\u0026amp;title=Connect+an+internal+server+through+a+tunnel\u0026amp;description=A+hands-on+walkthrough+for+reaching+an+MCP+server+on+your+internal+network%2C+such+as+a+self-hosted+GitLab%2C+through+a+server+tunnel%3A+create+the+tunnel%2C+list+the+s\u0026amp;theme=ee542cc5624d2073b939b538\u0026amp;signature=5959368a6d354c6f386494454be4a10d22f895d5164bd6097f2c6703d3c21e55\">\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=\"Connect an internal server through a tunnel - MCP Manager\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"A hands-on walkthrough for reaching an MCP server on your internal network, such as a self-hosted GitLab, through a server tunnel: create the tunnel, list the server\u0026#x27;s origin, connect a machine with the one-time command that you never run again (one container, no Docker socket), add the server as Reached through a tunnel, assign it to a gateway, and have each user sign in with their own identity.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mcpmanagerbyusercentrics.mintlify.site/_mintlify/api/og/v2?division=Tutorials\u0026amp;title=Connect+an+internal+server+through+a+tunnel\u0026amp;description=A+hands-on+walkthrough+for+reaching+an+MCP+server+on+your+internal+network%2C+such+as+a+self-hosted+GitLab%2C+through+a+server+tunnel%3A+create+the+tunnel%2C+list+the+s\u0026amp;theme=ee542cc5624d2073b939b538\u0026amp;signature=5959368a6d354c6f386494454be4a10d22f895d5164bd6097f2c6703d3c21e55\">\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/tutorials/connect-an-internal-server-through-a-tunnel\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/tutorials/connect-an-internal-server-through-a-tunnel.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/tutorials/connect-an-internal-server-through-a-tunnel#webpage\",\"url\":\"https://docs.mcpmanager.ai/tutorials/connect-an-internal-server-through-a-tunnel\",\"name\":\"Connect an internal server through a tunnel\",\"description\":\"A hands-on walkthrough for reaching an MCP server on your internal network, such as a self-hosted GitLab, through a server tunnel: create the tunnel, list the server's origin, connect a machine with the one-time command that you never run again (one container, no Docker socket), add the server as Reached through a tunnel, assign it to a gateway, and have each user sign in with their own identity.\",\"dateModified\":\"2026-11-19T17:33:03.691Z\",\"isPartOf\":{\"@id\":\"https://docs.mcpmanager.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mcpmanager.ai/tutorials/connect-an-internal-server-through-a-tunnel#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mcpmanager.ai/tutorials/connect-an-internal-server-through-a-tunnel#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tutorials\",\"item\":\"https://docs.mcpmanager.ai/tutorials/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect an internal server through a tunnel\",\"item\":\"https://docs.mcpmanager.ai/tutorials/connect-an-internal-server-through-a-tunnel\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.mcpmanager.ai/tutorials/connect-an-internal-server-through-a-tunnel#article\",\"headline\":\"Connect an internal server through a tunnel\",\"name\":\"Connect an internal server through a tunnel\",\"description\":\"A hands-on walkthrough for reaching an MCP server on your internal network, such as a self-hosted GitLab, through a server tunnel: create the tunnel, list the server's origin, connect a machine with the one-time command that you never run again (one container, no Docker socket), add the server as Reached through a tunnel, assign it to a gateway, and have each user sign in with their own identity.\",\"url\":\"https://docs.mcpmanager.ai/tutorials/connect-an-internal-server-through-a-tunnel\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mcpmanager.ai/tutorials/connect-an-internal-server-through-a-tunnel#webpage\"},\"dateModified\":\"2026-11-19T17:33:03.691Z\",\"keywords\":\"server tunnel, internal server, self-hosted GitLab, on-premises, private network, VPN, Reached through a tunnel, allowed destinations, install command, enrollment command, docker, mcpmanager/tunnel, mcpm-server-tunnel, per-user identity, OAuth\",\"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":"/tutorials/connect-an-internal-server-through-a-tunnel.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","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","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","description":"A hands-on walkthrough for connecting an MCP server running on your own machine to MCP Manager: create a workstation server, configure a local instance, run the generated commands to start the encrypted tunnel, test the connection, and call a local tool through a governed gateway.","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","description":"A hands-on lesson in MCP Manager's access model: create a team, build a gateway for it, provision a server with a trimmed tool allowlist, invite a teammate, and confirm they see only that 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":"Connect an internal server through a tunnel - MCP Manager","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}