MCP Nutzung

Nutze den MCP-Modus, um lokale MCP-Endpunkte fur entfernte Clients freizugeben. MCP ist in Pro und Business verfugbar.

Plan-Anforderung: MCP erfordert einen angemeldeten API-Key in Pro oder Business.

1. CLI installieren

$ npm install -g instatunnel

2. Authentifizieren (neue vs bestehende Nutzer)

Neuer Nutzer

$ instatunnel auth login -e you@example.com

# Verify email from inbox and copy API key from verification page

$ instatunnel auth set-key "it_your_api_key"

Bestehender Nutzer

$ instatunnel auth show-key --reveal --copy

# If key is not saved locally:

$ instatunnel auth login -e you@example.com

# Use recovery email, then save the new/current key:

$ instatunnel auth set-key "it_your_api_key"

$ Set-Clipboard "it_your_api_key" # Windows PowerShell helper

$ instatunnel auth set-key "$(Get-Clipboard)"

$ pbpaste | xargs -I {} instatunnel auth set-key "{}" # macOS

$ xclip -o -selection clipboard | xargs -I {} instatunnel auth set-key "{}" # Linux

2a. MCP-Setup-Assistent im Dashboard nutzen (empfohlen)

Mochtest du einen gefuhrten Ablauf? Offne dein Dashboard und nutze den MCP Setup Wizard v2 im Bereich CLI Updates, MCP, and 2026 Best Practices. dashboard.

Prueft die MCP-Planberechtigung vor der Einrichtung.
Erstellt den exakten Befehl instatunnel ... --mcp --transport v2 mit Port und Subdomain.
Erzeugt One-Click-JSON fur VS Code, Cursor, Claude Desktop, Windsurf, Codex und Gemini Antigravity.

3. MCP-Tunnel starten (v1 Standard)

v1 ist der Standard-Transport. Am kompatibelsten fur klassisches HTTP-Forwarding und Webhook-Traffic.

$ instatunnel 8787 --mcp

$ instatunnel 8787 --mcp --subdomain my-mcp

4. Streaming-Transport v2 verwenden, wenn notig

Nutze v2 fur Streaming-Verhalten (MCP Streamable HTTP, langlebige Tool-Antworten oder server-push-artige Flows). Wenn du unsicher bist, starte mit v1 und wechsle nur fur Streaming-Clients zu v2.

$ instatunnel 8787 --mcp --transport v2

$ instatunnel 8787 --mcp --transport v2 --subdomain my-mcp

Kompatibilitat: --transport v2 requires newer InstaTunnel CLI versions (1.1.7+). Recommended update: npm install -g instatunnel@latest.

5. Optionaler MCP-Token-Header (stufenweiser Rollout)

InstaTunnel unterstutzt einen MCP-Token-Header fur Defense-in-Depth. Im aktuellen stufenweisen Rollout kann dein Workspace zuerst im Warnmodus und spater im Enforce-Modus laufen.

$ export INSTATUNNEL_MCP_TOKEN="your-shared-secret"

$ instatunnel 8787 --mcp --transport v2

5a. YOUR_MCP_TOKEN erzeugen

Erzeuge ein starkes Token und nutze es als YOUR_MCP_TOKEN in MCP-JSON-Authorization-Headern.

$ node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

$ node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" | Set-Clipboard # Windows

$ node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" | pbcopy # macOS

$ node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" | xclip -selection clipboard # Linux

6. MCP-Client/Server konfigurieren

Verwende die generierte HTTPS-URL in der MCP-Client-Konfiguration und setze den Pfad auf den von deinem lokalen MCP-Server erwarteten Endpoint.

https://your-subdomain.instatunnel.my

6a. Benotigst du Authorization-Header?

Nein fur lokale stdio-MCP-Server. Dort werden keine Header verwendet.
Nein, wenn dein entfernter MCP-Server keine Authentifizierung erzwingt.
Ja, nur wenn dein MCP-Server ein Bearer-Token erwartet (empfohlen fur offentliche Endpunkte).
Gilt fur VS Code, Cursor, Claude Desktop, Windsurf, Codex und Gemini Antigravity: Der Client erzwingt kein Bearer-Auth; die Server-Policy entscheidet.

7. One-Click MCP-Konfigurationsgenerator

Generiere und kopiere sofort nutzbares JSON fur VS Code, Cursor, Claude Desktop, Windsurf, Codex und Gemini Antigravity.

One-Click MCP Config Generator

Generate IDE-ready JSON for VS Code, Cursor, Claude Desktop, Windsurf, Codex, and Gemini Antigravity with endpoint and token header.

Tunnel subdomainMCP token

MCP Endpoint

https://your-subdomain.instatunnel.my/mcp

Target: .vscode/mcp.json (workspace)

{
  "mcpServers": {
    "instatunnel-remote": {
      "type": "streamable-http",
      "url": "https://your-subdomain.instatunnel.my/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

headers.Authorization is not required by MCP clients by default. Add it only when your MCP server expects bearer-token auth. For local stdio MCP servers, headers are not used.

Token helper

Generate a strong token, paste it into YOUR_MCP_TOKEN, and use the same value in your local MCP server auth.

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" | Set-Clipboard

Loading MCP setup...

Hinweise

v1 bleibt aus Kompatibilitatsgrunden der Standard-Transport.
Wenn du unsicher bist, starte mit v1.
Nutze v2 fur MCP Streamable HTTP und lange Streaming-Antworten.
--transport v2 erfordert CLI 1.1.7+; halte es aktuell mit npm install -g instatunnel@latest.
MCP-Tunnel haben strengere Schutzmechanismen, einschliesslich MCP-spezifischer Rate-Limits.
Nutze instatunnel --stats fur Konto-Nutzung und instatunnel --logs fur Request-Log-Polling.
Verwende Authentifizierung und vermeide es, sensible Tools offentlich freizugeben.

MCP FAQ (Localhost, Webhooks, IDE Setup)

Common setup and troubleshooting questions for VS Code, Cursor, Claude Desktop, Windsurf, Codex, and Gemini Antigravity.

Do VS Code, Cursor, Claude Desktop, Windsurf, Codex, or Gemini Antigravity require Authorization headers by default?

No. The client usually does not force bearer headers. Add "Authorization": "Bearer YOUR_MCP_TOKEN" only if your remote MCP server enforces token auth. For local stdio MCP servers, headers are not used.

Which endpoint should I use with InstaTunnel?

Use: https://YOUR-SUBDOMAIN.instatunnel.my/mcp. Start your local MCP server first, then run: instatunnel 8787 --mcp --transport v2 --subdomain YOUR-SUBDOMAIN.

What is the difference between local stdio MCP and remote HTTP MCP?

Local stdio is process-to-process on your machine, with no public URL. Remote HTTP MCP is reachable via URL and is required when an IDE or agent needs to access your MCP server from another network context.

Why do I get "failed to reach local server localhost:8787"?

InstaTunnel can reach the public tunnel, but your local app is not listening on the forwarded port. Start your MCP server locally on the same port (for example 8787) and retry.

Can I use this for localhost sharing and webhook testing?

Yes. For generic webhook testing, use normal HTTP tunnels (for example instatunnel 3000 --subdomain webhook-demo). For MCP tools, use MCP mode with --mcp --transport v2 and the /mcp endpoint.

Which transport should I use: v1 or v2?

v1 is default and most compatible, so start there if you are unsure. Use v2 when you need Streamable HTTP behavior (long-lived streaming/tool responses). Recommended: instatunnel 8787 --mcp --transport v2. Note: --transport v2 requires newer CLI versions (1.1.7+). Update with npm install -g instatunnel@latest.

Why do I get "MCP mode is available on Pro and Business plans"?

MCP mode is gated by plan. Upgrade to Pro/Business, then rerun your command with the same saved API key.

Where do I configure MCP clients?

Use each client's MCP settings area. The JSON shape from the generator works for common MCP clients. For Codex, you can also register MCP servers via codex mcp add.

Official references

Loading MCP FAQ...

Wo sollte ich in der InstaTunnel-Dokumentation starten?

Evidenz und Vertrauen

Release-Kadenz

Sicherheitskontrollen

Zuverlassigkeits-Runbooks

Dokumentation

MCP Nutzung

1. CLI installieren

2. Authentifizieren (neue vs bestehende Nutzer)

2a. MCP-Setup-Assistent im Dashboard nutzen (empfohlen)

3. MCP-Tunnel starten (v1 Standard)

4. Streaming-Transport v2 verwenden, wenn notig

5. Optionaler MCP-Token-Header (stufenweiser Rollout)

5a. YOUR_MCP_TOKEN erzeugen

6. MCP-Client/Server konfigurieren

6a. Benotigst du Authorization-Header?

7. One-Click MCP-Konfigurationsgenerator

One-Click MCP Config Generator

Hinweise

MCP FAQ (Localhost, Webhooks, IDE Setup)

Schneller Pfad gesucht?

One-Click MCP Config Generator

MCP FAQ (Localhost, Webhooks, IDE Setup)