Aller au contenu
Localtonet Localtonet Tableau de bord

Serveur MCP de Localtonet

Aide pour cette page
Sur cette page 9 sections
  1. Ce que c'est, et ce que ce n'est pas
  2. Détails de connexion
  3. Avant de commencer
  4. Connecter votre client MCP
  5. Ajouter le serveur au client
  6. Vérifier la connexion
  7. Créer un tunnel
  8. Outils
  9. Tunnels
  10. Configuration du tunnel
  11. AuthTokens et groupes de jetons
  12. Serveurs et fournisseurs SSO
  13. Accès VPN sur les tunnels proxy
  14. Appareils
  15. Limites
  16. Sécurité
  17. Dépannage
  18. Pages associées

Le serveur MCP de Localtonet permet à un assistant IA compatible avec le Model Context Protocol, tel que Claude ou Cursor, de gérer votre compte en langage naturel : lister, créer, démarrer, arrêter et configurer des tunnels, et gérer les AuthTokens, les groupes de jetons, les serveurs et les fournisseurs SSO.

Ce que c'est, et ce que ce n'est pas #

  • Le serveur MCP de cette page est exploité par Localtonet à l'adresse https://localtonet.com/mcp. Ses outils agissent sur votre compte Localtonet, de la même manière que l'API REST.
  • La Passerelle MCP est un type de tunnel. Elle donne une adresse publique à un serveur MCP qui s'exécute sur votre propre appareil. Utilisez-la pour publier vos propres outils, et non pour gérer Localtonet.

Détails de connexion #

ParamètreValeur
Point de terminaisonhttps://localtonet.com/mcp
TransportStreamable HTTP
AuthentificationVotre clé API comme jeton Bearer : Authorization: Bearer <YOUR_API_KEY>
Informations sur le serveurlocaltonet.com/mcp-info (JSON) et la carte du serveur à l'adresse https://localtonet.com/.well-known/mcp-server-card

Avant de commencer #

  • Un client MCP capable de se connecter à un serveur distant via Streamable HTTP et d'envoyer un en-tête Authorization personnalisé.
  • Votre clé API. Ouvrez le Tableau de bord et utilisez Copier dans la carte Clé API. Consultez Compte et sécurité.
  • Pour travailler sur les tunnels : un appareil dont le client Localtonet est connecté, afin que l'assistant dispose d'un AuthToken sur lequel créer des tunnels.

Connecter votre client MCP #

  1. Ajouter le serveur au client #

    La plupart des clients MCP acceptent un serveur distant sous la forme d'une URL accompagnée d'en-têtes. La forme habituelle est :

    Configuration du client MCP
    {
      "mcpServers": {
        "localtonet": {
          "type": "http",
          "url": "https://localtonet.com/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_API_KEY>"
          }
        }
      }
    }

    Le nom du fichier et les noms exacts des clés diffèrent d'un client à l'autre. Consultez la documentation de votre client pour savoir où les serveurs MCP distants sont configurés, et utilisez l'URL et l'en-tête ci-dessus.

  2. Vérifier la connexion #

    Rechargez le client. Les outils Localtonet devraient apparaître dans sa liste d'outils. Posez d'abord une question anodine, par exemple :

    Invite
    List my Localtonet tunnels and tell me which ones are running.
  3. Créer un tunnel #

    Décrivez ce que vous voulez. Par exemple :

    Invite
    Create an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.

    L'assistant suit le flux de travail prescrit par le serveur : il recherche l'AuthToken de l'appareil, choisit un serveur, appelle l'outil de création correspondant, puis démarre le tunnel, car un tunnel nouvellement créé n'est pas en cours d'exécution.

Outils #

Les noms d'outils ci-dessous sont ceux que votre client affiche. Un outil qui échoue renvoie un message qui commence par Error:.

Tunnels #

FonctionOutils
ConsulterGetTunnels, GetTunnel, GetTunnelRequestLogs
CréerCreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel
ExécuterStartTunnel, StopTunnel, DeleteTunnel
ModifierUpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType
En masseBulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType

Configuration du tunnel #

ParamètreOutils
Restrictions IPGetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions
Contrôles d'accèsGetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls
En-têtes et authentificationGetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication
Expiration et limitesGetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage
Serveur et portGetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer
Arguments et noteGetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote
Clients de proxy rotatif et groupes de jetonsGetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups
Paramètres avancésGetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless

Le rôle des paramètres est décrit dans la Référence des paramètres.

AuthTokens et groupes de jetons #

FonctionOutils
AuthTokensGetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken
Mode avion et changement d'IPGetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink
Groupes de jetonsGetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup

Serveurs et fournisseurs SSO #

FonctionOutils
ServeursGetAvailableServers
Fournisseurs SSOGetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel

Accès VPN sur les tunnels proxy #

GetVpnAccessDevices, CreateVpnAccessDevice, GetVpnAccessDeviceConfig, GetVpnAccessDeviceCredentials, RegenerateVpnAccessDevice, DeleteVpnAccessDevice. Ces outils gèrent les appareils WireGuard et OpenVPN d'un tunnel proxy. Chaque appareil reçoit sa propre configuration, et tout son trafic sort par le proxy.

Appareils #

OutilFonction
ListDevicesListe les ordinateurs associés à votre compte sous Mes appareils, en indiquant si chacun est en ligne ainsi que son utilisation du processeur, de la mémoire et du disque.
GetDeviceMetricsRenvoie les dernières valeurs de processeur, de mémoire, de disque et de durée de fonctionnement d'un appareil.
RunDeviceCommandExécute une commande shell sur un appareil et renvoie sa sortie et son code de sortie. Il attend jusqu'au délai que vous indiquez, de 1 à 120 secondes, 30 par défaut.

RunDeviceCommand nécessite plus que la clé API : il exige une clé d'accès d'appareil (elle commence par ltd_) que vous créez pour cet appareil sous Mes appareils. Consultez Terminal d'appareil. Une exécution apparaît dans l'historique des connexions de l'appareil avec son heure et son adresse IP ; la commande n'est pas enregistrée.

Limites #

  • Les requêtes vers le serveur MCP sont soumises à une limitation de débit, avec les requêtes API de votre clé API. Une réponse 429 signifie : patientez, puis réessayez.
  • Les outils en masse acceptent une liste de 100 éléments au maximum.

Sécurité #

L'assistant agit avec votre clé API. Ses outils peuvent créer, arrêter et supprimer des tunnels, supprimer des AuthTokens et des groupes de jetons, et modifier des règles d'accès, sans étape de confirmation du côté de Localtonet.

  • Activez la confirmation des appels d'outils dans votre client MCP, au moins pour les outils dont le nom commence par Delete, BulkDelete, Stop et Set.
  • Ne donnez la clé d'accès d'appareil pour RunDeviceCommand qu'à un assistant auquel vous donneriez aussi un terminal sur cet ordinateur. Une commande est exécutée par le shell par défaut de l'appareil.
  • Traitez le fichier de configuration du client comme un secret : il contient votre clé API. Ne le validez pas (commit) dans un dépôt.
  • Si la clé a pu fuiter, sélectionnez Modifier dans la carte Clé API du tableau de bord. Cela crée une nouvelle clé et invalide l'ancienne ; mettez ensuite à jour votre client MCP.
  • Avec une clé API copiée depuis un tableau de bord d'équipe, l'assistant ne liste que vos AuthTokens et vos tunnels dans cette équipe. Consultez Gestion d'équipe.

Dépannage #

Le client signale 401, ou « API key is required. Provide Authorization: Bearer <apikey> »

La requête n'a pas d'en-tête Authorization valide. Vérifiez que le client envoie des en-têtes personnalisés pour ce serveur, que la valeur est Bearer, un espace, puis la clé, et que la clé n'a pas été modifiée dans le tableau de bord depuis que vous l'avez copiée.

L'assistant indique qu'un outil a renvoyé « Error: … »

C'est la réponse de Localtonet, pas un problème de connexion. Le texte après Error: indique ce qui a été refusé, par exemple un AuthToken manquant ou une limite de l'offre. Corrigez cette cause au lieu de laisser l'assistant réessayer.

Le tunnel a été créé mais ne répond pas

Demandez à l'assistant de le démarrer. Un nouveau tunnel reste arrêté tant que StartTunnel n'est pas appelé, et le client Localtonet de l'appareil doit être connecté.

Il manque des outils dans mon client

Certains clients limitent le nombre d'outils ou vous demandent de les activer un par un. Activez les outils Localtonet dont vous avez besoin dans les paramètres du client.

Support