Serveur MCP de Localtonet
Sur cette page 9 sections
- Ce que c'est, et ce que ce n'est pas
- Détails de connexion
- Avant de commencer
- Connecter votre client MCP
- Ajouter le serveur au client
- Vérifier la connexion
- Créer un tunnel
- Outils
- Tunnels
- Configuration du tunnel
- AuthTokens et groupes de jetons
- Serveurs et fournisseurs SSO
- Accès VPN sur les tunnels proxy
- Appareils
- Limites
- Sécurité
- Dépannage
- 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ètre | Valeur |
|---|---|
| Point de terminaison | https://localtonet.com/mcp |
| Transport | Streamable HTTP |
| Authentification | Votre clé API comme jeton Bearer : Authorization: Bearer <YOUR_API_KEY> |
| Informations sur le serveur | localtonet.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
Authorizationpersonnalisé. - 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 #
-
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.
-
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 :
InviteList my Localtonet tunnels and tell me which ones are running. -
Créer un tunnel #
Décrivez ce que vous voulez. Par exemple :
InviteCreate 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 #
| Fonction | Outils |
|---|---|
| Consulter | GetTunnels, GetTunnel, GetTunnelRequestLogs |
| Créer | CreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel |
| Exécuter | StartTunnel, StopTunnel, DeleteTunnel |
| Modifier | UpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType |
| En masse | BulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType |
Configuration du tunnel #
| Paramètre | Outils |
|---|---|
| Restrictions IP | GetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions |
| Contrôles d'accès | GetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls |
| En-têtes et authentification | GetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication |
| Expiration et limites | GetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage |
| Serveur et port | GetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer |
| Arguments et note | GetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote |
| Clients de proxy rotatif et groupes de jetons | GetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups |
| Paramètres avancés | GetAdvancedTunnelSettings, 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 #
| Fonction | Outils |
|---|---|
| AuthTokens | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| Mode avion et changement d'IP | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| Groupes de jetons | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
Serveurs et fournisseurs SSO #
| Fonction | Outils |
|---|---|
| Serveurs | GetAvailableServers |
| Fournisseurs SSO | GetSsoProviders, 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 #
| Outil | Fonction |
|---|---|
ListDevices | Liste 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. |
GetDeviceMetrics | Renvoie les dernières valeurs de processeur, de mémoire, de disque et de durée de fonctionnement d'un appareil. |
RunDeviceCommand | Exé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
429signifie : 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,StopetSet. - Ne donnez la clé d'accès d'appareil pour
RunDeviceCommandqu'à 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.