Aller au contenu
Localtonet Localtonet Tableau de bord

Exposer des outils MCP avec un tunnel Passerelle MCP

Desktop v7.8+ Mobile v10.1+

Aide pour cette page
Sur cette page 8 sections
  1. De quoi s'agit-il
  2. Avant de commencer
  3. Créer la passerelle
  4. Ouvrir la page Passerelle MCP
  5. Remplir le formulaire
  6. Démarrer le tunnel
  7. Types d'URL
  8. Jeton de la passerelle
  9. Connecter un client MCP
  10. Ouvrir le tableau de bord de la passerelle
  11. Enregistrer vos serveurs MCP
  12. Créer un jeton client
  13. Pointer le client MCP vers la passerelle
  14. Paramètres
  15. Dépannage
  16. Pages associées

Un tunnel Passerelle MCP connecte des clients MCP et des assistants IA à des outils qui s'exécutent sur votre appareil, via une passerelle publique. Le client Localtonet exécute la passerelle à votre place, et le tunnel lui donne une adresse HTTPS publique.

De quoi s'agit-il #

Le Model Context Protocol (MCP) permet à un assistant IA d'appeler des outils. Une passerelle MCP se place devant les serveurs MCP que vous exécutez et propose tous leurs outils via un seul point d'accès.

Lorsque vous démarrez un tunnel Passerelle MCP, le client Localtonet lance une passerelle sur votre appareil et Localtonet la publie à l'adresse du tunnel. Vous ne saisissez ni IP locale ni port. La passerelle comprend :

  • un tableau de bord web à l'adresse https://<ADDRESS>/dashboard, où vous enregistrez des serveurs MCP et créez des jetons client ;
  • le point d'accès MCP à l'adresse https://<ADDRESS>/mcp, auquel se connectent vos clients MCP.

À ne pas confondre avec le serveur MCP de Localtonet. Cette page traite de la publication de vos propres outils. Pour permettre à un assistant IA de gérer votre compte Localtonet (tunnels, jetons, etc.), consultez Serveur MCP.

Avant de commencer #

  • Le client Localtonet s'exécute sur l'appareil et est connecté avec un AuthToken. Voir Démarrage rapide.
  • Le client est suffisamment récent. Versions minimales de l'application Localtonet requises pour utiliser cette fonctionnalité : Desktop v7.8, Mobile v10.1.

Créer la passerelle #

  1. Ouvrir la page Passerelle MCP #

    Ouvrez Mes tunnels › Passerelle MCP et développez Créer un tunnel Passerelle MCP.

  2. Remplir le formulaire #

    ChampCe qu'il faut saisir
    Type d'URLSous-domaine aléatoire, Sous-domaine personnalisé ou Domaine personnalisé. Voir le tableau ci-dessous.
    Jeton d'appareilLe jeton de l'appareil qui exécute vos outils.
    Région du serveurLe serveur auquel se connectent vos clients MCP.
    Sous-domaineAffiché pour Sous-domaine personnalisé : le nom souhaité.
    DomaineLe domaine de l'adresse.

    Sélectionnez Créer le tunnel.

  3. Démarrer le tunnel #

    La passerelle apparaît sous Vos tunnels. Sélectionnez Démarrer. La colonne URL affiche l'adresse publique.

Types d'URL #

Type d'URLAdresse obtenueRemarques
Sous-domaine aléatoireUn nom généré sous le domaine que vous sélectionnez.Idéal pour un premier test.
Sous-domaine personnaliséLe Sous-domaine que vous saisissez sous le Domaine que vous sélectionnez.Solde requis.
Domaine personnaliséL'un de vos propres domaines.Solde requis. La liste Domaine affiche vos domaines ; si elle est vide, créez d'abord un domaine depuis Gestionnaire DNS. Voir Domaines personnalisés.

Jeton de la passerelle #

Chaque tunnel Passerelle MCP reçoit son propre jeton de la passerelle à sa création. C'est le jeton d'administration de la passerelle : le tableau de bord de la passerelle et son API de gestion n'acceptent des modifications qu'avec lui.

  1. Sélectionnez l'icône Paramètres du tunnel.
  2. À côté de Jeton de la passerelle, sélectionnez Gérer. La fenêtre Jeton de la passerelle affiche le jeton dont le milieu est masqué.
  3. Sélectionnez le bouton de copie à côté du jeton. Il copie toujours le jeton complet. Le bouton d'affichage voisin révèle le jeton à l'écran.

Gardez le jeton de la passerelle confidentiel. Il donne le contrôle total de la passerelle : ses serveurs, ses outils et ses jetons client. Ne le saisissez pas dans un client MCP ; les clients utilisent leur propre jeton.

Connecter un client MCP #

  1. Ouvrir le tableau de bord de la passerelle #

    Le tunnel étant démarré, ouvrez https://<ADDRESS>/dashboard dans un navigateur. Collez le jeton de la passerelle dans le champ Admin token en bas du menu latéral.

  2. Enregistrer vos serveurs MCP #

    Ouvrez Servers et sélectionnez Add Server. Un serveur peut être un serveur MCP joint par URL (Streamable HTTP ou SSE), une commande locale (stdio) ou un service OpenAPI. Catalog liste des serveurs MCP prêts à installer, et Tools affiche les outils que la passerelle a collectés auprès de tous les serveurs.

  3. Créer un jeton client #

    Ouvrez Clients et sélectionnez New Client. Saisissez un Name et sélectionnez Create Client. La passerelle affiche le Client Token une seule fois : copiez-le maintenant, il ne sera plus affiché. Dans la liste des clients, Allowed Servers et Allowed Groups indiquent les serveurs et les groupes d'outils qu'un client peut utiliser.

  4. Pointer le client MCP vers la passerelle #

    Dans votre client MCP ou votre assistant IA, ajoutez un serveur MCP distant avec ces deux valeurs :

    Paramètres du client MCP
    URL:     https://<ADDRESS>/mcp
    Header:  Authorization: Bearer <CLIENT_TOKEN>

    L'endroit où vous les saisissez dépend du client ; suivez sa propre documentation pour les serveurs MCP distants (HTTP).

Le Audit Log du tableau de bord affiche les requêtes récentes de la passerelle, et Settings contient la configuration de la passerelle avec sauvegarde et restauration.

La passerelle conserve ses serveurs, ses groupes, ses clients et son journal d'audit sur votre appareil, dans un dossier nommé mcp-data-<TUNNEL_ID> dans le répertoire de travail du client Localtonet (sous Android, dans le stockage propre à l'application). <TUNNEL_ID> est le nombre figurant dans la colonne ID ; chaque tunnel Passerelle MCP a donc son propre dossier.

Paramètres #

Sélectionnez l'icône Paramètres du tunnel pour ouvrir Paramètres du tunnel.

ParamètreFonctionPlus d'infos
Répartition de chargeRépartissez le trafic entre plusieurs appareils ou utilisez une cible de secours lorsqu'une cible est indisponible.Équilibrage de charge
HTTPS uniquement ?Utilise uniquement HTTPS pour le point d'accès public du tunnel.Référence des paramètres
Authentification basique ?Exige un nom d'utilisateur et un mot de passe pour accéder à ce tunnel.Contrôle d'accès
HTTP/3 actif ?Autorise les clients à se connecter au point d'accès public en HTTP/3.Référence des paramètres
Connexion héritée ?Essayez ce réglage si le tunnel ne parvient pas à se connecter avec la méthode de connexion normale.Référence des paramètres
Jeton de la passerelleGérez le jeton d'accès de cette Passerelle MCP.Voir ci-dessus
Délai d'expiration HTTPLe temps pendant lequel le serveur attend une réponse de votre application locale avant d'abandonner la requête, de 1 à 600 secondes. Laissez le champ vide pour utiliser la valeur par défaut du serveur.Référence des paramètres
Note du tunnelEnregistrez une note privée pour vous aider à identifier ou documenter ce tunnel.Référence des paramètres
Restriction IPContrôlez quelles adresses IP clientes peuvent accéder à ce tunnel.Contrôle d'accès
Date d'expiration, Limites de vitesse, Limite de bande passante, Utilisation de la bande passanteDate d'expiration, limites de vitesse en envoi et en téléchargement, limite de transfert de données, et Effacer pour réinitialiser la consommation enregistrée.Limites et expiration
Port sortantChoisissez un port sortant fixe pour la connexion de l'application Localtonet au serveur.Ports
Trafic de bande passante, Journal des requêtes, Journal d'activité, Santé du tunnelLe trafic dans le temps, les requêtes enregistrées, les démarrages, les arrêts et les modifications de paramètres, ainsi que les résultats récents des contrôles de santé.Journaux et inspection

Dans la liste des tunnels, la colonne Webhooks contient un bouton Voir les journaux de requêtes et réponses qui ouvre l'inspecteur de requêtes d'un tunnel démarré. Voir Journaux et inspection.

Dépannage #

La passerelle ne démarre pas ou l'adresse ne répond pas

Vérifiez la version de l'application Localtonet sur l'appareil : la Passerelle MCP nécessite au minimum Desktop v7.8 ou Mobile v10.1. Vérifiez ensuite que le tunnel est démarré et que la colonne Connexion indique que l'appareil est connecté.

Le tableau de bord de la passerelle ne charge pas ses données

Les requêtes de gestion du tableau de bord nécessitent le jeton d'administration. Le champ Admin token est vide ou incorrect. Copiez de nouveau le jeton de la passerelle depuis les Paramètres du tunnel et collez-le dans le champ.

Le client MCP est rejeté

Le point d'accès MCP exige un jeton client dans l'en-tête Authorization: Bearer. Créez-en un sous Clients dans le tableau de bord de la passerelle et utilisez-le ici, et non le jeton de la passerelle.

« Veuillez d'abord démarrer votre tunnel. »

L'inspecteur de requêtes n'est disponible que lorsque le tunnel est démarré.

« Vous devez créer un domaine depuis le Gestionnaire DNS ! » ou « ATTENTION ! Vous n'avez aucun domaine ! »

Domaine personnalisé nécessite l'un de vos propres domaines. Ajoutez-le dans Gestionnaire DNS, ou choisissez un autre type d'URL.

« Vous devez acheter du solde pour utiliser cette fonctionnalité. »

Sous-domaine personnalisé et Domaine personnalisé nécessitent du solde. Utilisez Sous-domaine aléatoire ou ajoutez du solde. Voir Offres et solde.

Support