Frequently asked questions

Before you install

TunnelTend tends the local work around your MCP tunnels. These answers explain where it helps, what it owns, and what to expect from the Windows release. Looking for your first connection? Start with Get started. Looking for a command? Use the CLI reference.

Fit and relationships

What does TunnelTend actually do?

It remembers the MCP services you registered and looks after their local lifecycle: starting them at sign-in, keeping the official OpenAI tunnel connected, checking health, recovering within limits, restarting on source changes if you want that, and updating OpenAI’s tunnel client through verified releases.

You bring a working tool with an MCP server and the required OpenAI access. TunnelTend supplies the routine. How it works draws the whole chain.

Is this an OpenAI product?

No. TunnelTend is an independent Wolfsblvt Works project. It is not affiliated with, endorsed by or supported by OpenAI.

It uses OpenAI’s official tunnel-client as a separate program. OpenAI owns that client, the tunnel protocol, the hosted side and the access rules; TunnelTend owns the local care around it. See what you need from OpenAI.

I just want ChatGPT to use a tool on my PC. Is this for me?

If the tool has a working MCP server, you use Windows 11, and you have the required OpenAI tunnel access, TunnelTend can take care of the local startup and recovery. Your computer must still be awake, online and signed in.

You still need the OpenAI side: a tunnel in your organization, a runtime key and a connector in ChatGPT. Get started walks through all of it in order, and explains the words along the way.

Can I use it if I’m not a developer?

You do not need Git or a source checkout. The released installer and setup guide explain which PowerShell app to open, what to paste, what to replace and how to check the result. A local coding agent can also follow the same route with you.

You still need a working MCP server for your tool and OpenAI tunnel access. If you only know the app’s name, start with Find your MCP service. It explains what to look for in the app’s instructions and what to ask its maintainer or an agent. An app without MCP support needs a separate integration.

Why not just use the official tunnel client?

You can. The official client already connects MCP services, runs detached and lets you inspect and control the runtime. If that is enough, TunnelTend is optional.

TunnelTend adds remembered intent, Windows sign-in automation, a bounded watchdog, source watching and verified client maintenance. The difference is ongoing care, not access. Read the official client’s guide.

Is TunnelTend a hosting service?

No. It runs on your computer and manages locally launched services or connects the official client to an HTTP endpoint you run. There is no TunnelTend cloud, account, dashboard or control plane.

If you need availability independent of your desktop, use an always-on machine. A sleeping or powered-off PC serves nothing, and TunnelTend will not pretend otherwise.

Does it work on macOS or Linux?

The supported setup is Windows 11 with PowerShell 7.4 or newer. Installation, process handling and unattended automation are Windows-first, and this release offers no supported macOS or Linux installation. The official client’s own platform support is a separate matter. Check the prerequisites.

Is it ready for unattended use?

The first stable release targets current-user Windows 11 operation. Sign-in startup, sleep/resume recovery, bounded recovery, client rollback and a real remote tool call were exercised during its qualification. Read the release notes for the exact limits, then confirm your own service and consumer.

This is desktop automation, not an uptime promise.

Access and trust

Which OpenAI products and accounts can use it?

TunnelTend uses OpenAI’s Secure MCP Tunnel route. OpenAI documents consumers including ChatGPT, Codex, the Responses API and AgentKit; availability, organization or workspace scope and permissions are controlled by OpenAI and may depend on your plan. OpenAI’s current guide is the authority; installing TunnelTend grants no access.

Do I have to open a port on my router?

No. The official client makes one outbound connection to OpenAI, and ChatGPT talks to your service through it. TunnelTend never asks for port forwarding. Your network still has to let the client connect outward, and a tunnel does not change how an HTTP service you already run listens or authenticates. OpenAI’s guidance owns those requirements.

What stays on my computer, and where do keys go?

Service definitions, policy, observations, logs and client backups stay on your PC. There is no TunnelTend telemetry. Your MCP requests and responses travel through the official client and OpenAI’s infrastructure, as they would without TunnelTend.

Credentials are stored as references, such as env:CONTROL_PLANE_API_KEY or file:C:\secure\runtime-key.txt, never as raw keys. The secret stays in your environment or file and is resolved when needed. Read privacy and data.

Can my local coding agent set it up and run it for me?

Yes, if it can run commands on your Windows computer. Hand it the agent guide and name the service you want registered. It uses the same installer and CLI as you would, works with credential references, and reports what it actually observed. A cloud-only chat without access to your computer cannot do the local part.

It does not stop at installation. TunnelTend's commands read or change exactly what their names say and answer in one JSON envelope, so you can keep saying things like “stop my photo-tagger until I sign in again” and let the agent run them. See what you can say.

Automation and control

What happens when I close the terminal, sign out or sleep?

Closing the terminal is fine: TunnelTend uses current-user Scheduled Tasks and detached runtimes. Eligible services start when you sign in, not before anyone logs in.

Do not rely on availability while signed out, asleep, disconnected or powered off. A new sign-in starts a new session. Sleep/resume recovery was observed during qualification; check your own service after waking. Read the automation model.

Will it rebuild my project or pull new code?

No build or pull is ever inferred. Project registration enables source watching by default, which restarts the service after stable local file changes; --no-source-watch turns that off. Application updates are a separate, explicit opt-in command you define. Read the rules.

What gets updated automatically?

Only OpenAI’s official tunnel client, and only through stable releases whose published digest verifies. TunnelTend stages and checks the new client before replacing the old one and keeps a backup for rollback. It does not update itself or your project’s dependencies. Automatic client updates can be disabled. Read the update and rollback behavior.

What if a service keeps failing?

The watchdog limits attempts within a rolling window and backs off between them. Exhaustion is visible in doctor, and attempts become eligible again as old ones leave the window. One failing service never blocks the rest. --force never authorizes killing an unrelated process or skipping credential, scope or download checks. Follow the failure route.

Can I keep my existing aliases or supervisor?

You can deliberately import an existing official alias; it then becomes part of TunnelTend’s registry. Do not run two supervisors against the same runtime: choose one owner, review an alias before importing it, and stop a hand-managed runtime before starting a competing one. See alias import.

Cost and leaving

Can I remove it without losing my projects?

Yes. Normal uninstall stops the registered services, removes TunnelTend’s tasks, program files and PATH entry, and keeps your registrations and logs. Your project source and your OpenAI tunnel objects are never touched. You can leave runtimes running or purge the state on purpose. Use the uninstall guide.