Utilisation MCP

Utilisez le mode MCP pour exposer des endpoints MCP locaux a des clients distants. MCP est disponible sur Pro et Business.

Prerequis de l'offre : Le mode MCP necessite une API key connectee sur Pro ou Business.

1. Installer le CLI

$ npm install -g instatunnel

2. Authentification (nouveaux vs existants)

Nouvel utilisateur

$ 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"

Utilisateur existant

$ 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. Utiliser l assistant MCP du dashboard (recommande)

Vous preferez un flux guide ? Ouvrez votre dashboard et utilisez MCP Setup Wizard v2 dans CLI Updates, MCP, and 2026 Best Practices. dashboard.

Verifie l eligibilite MCP de l offre avant configuration.
Genere la commande exacte instatunnel ... --mcp --transport v2 avec votre port et sous-domaine.
Genere un JSON en un clic pour VS Code, Cursor, Claude Desktop, Windsurf, Codex et Gemini Antigravity.

3. Demarrer le tunnel MCP (v1 par defaut)

v1 est le transport par defaut. C est l option la plus compatible pour HTTP et webhooks.

$ instatunnel 8787 --mcp

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

4. Utiliser le transport v2 en streaming si necessaire

Utilisez v2 lorsque vous avez besoin de streaming (MCP Streamable HTTP, reponses longues ou flux type server-push). En cas de doute, commencez par v1 puis passez a v2 pour les clients streaming.

$ instatunnel 8787 --mcp --transport v2

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

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

5. Header token MCP optionnel (deploiement progressif)

InstaTunnel prend en charge un header token MCP pour une defense en profondeur. Dans le deploiement progressif actuel, votre espace peut d abord etre en mode avertissement puis en mode strict.

$ export INSTATUNNEL_MCP_TOKEN="your-shared-secret"

$ instatunnel 8787 --mcp --transport v2

5a. Generer YOUR_MCP_TOKEN

Generez un token fort et utilisez-le comme YOUR_MCP_TOKEN dans les headers Authorization du JSON MCP.

$ 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. Configurer votre client/serveur MCP

Utilisez l URL HTTPS generee dans la configuration de votre client MCP et pointez vers le chemin attendu par votre serveur MCP local.

https://your-subdomain.instatunnel.my

6a. Avez-vous besoin d'en-tetes Authorization ?

Non pour les serveurs MCP locaux en stdio. Les headers n y sont pas utilises.
Non si votre serveur MCP distant ne force pas l authentification.
Oui uniquement lorsque votre serveur MCP attend un bearer token (recommande sur endpoint public).
Cela vaut pour VS Code, Cursor, Claude Desktop, Windsurf, Codex et Gemini Antigravity : le client ne force pas le bearer auth ; la politique serveur decide.

7. Generateur MCP en un clic

Generez et copiez un JSON pret a l emploi pour VS Code, Cursor, Claude Desktop, Windsurf, Codex et 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...

Notes

v1 reste le transport par defaut pour la compatibilite.
En cas de doute, commencez par v1.
Utilisez v2 pour MCP Streamable HTTP et les longues reponses streaming.
--transport v2 necessite CLI 1.1.7+ ; maintenez a jour avec npm install -g instatunnel@latest.
Les tunnels MCP ont des protections plus strictes, y compris des limites de debit specifiques MCP.
Utilisez instatunnel --stats pour l usage du compte et instatunnel --logs pour interroger les logs.
Utilisez l authentification et evitez d exposer publiquement des outils sensibles.

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...

Par ou commencer dans la documentation InstaTunnel ?

Preuves et confiance

Cadence des releases

Controles de securite

Runbooks de fiabilite

Documentation

Utilisation MCP

1. Installer le CLI

2. Authentification (nouveaux vs existants)

2a. Utiliser l assistant MCP du dashboard (recommande)

3. Demarrer le tunnel MCP (v1 par defaut)

4. Utiliser le transport v2 en streaming si necessaire

5. Header token MCP optionnel (deploiement progressif)

5a. Generer YOUR_MCP_TOKEN

6. Configurer votre client/serveur MCP

6a. Avez-vous besoin d'en-tetes Authorization ?

7. Generateur MCP en un clic

One-Click MCP Config Generator

Notes

MCP FAQ (Localhost, Webhooks, IDE Setup)

Besoin d un chemin rapide ?

One-Click MCP Config Generator

MCP FAQ (Localhost, Webhooks, IDE Setup)