Gologin MCP Server

Serveur MCP GoLogin pour agents IA

Gérez les profils de navigateur GoLogin, les proxys, les empreintes numériques, les dossiers et les sessions de navigateur cloud via des conversations avec l'IA. Ce serveur Model Context Protocol (MCP) connecte votre client IA à l'API GoLogin.

Démarrage rapide

Vous avez besoin de Node.js 22 ou plus récent, d'un compte GoLogin actif et d'un jeton API GoLogin. Node.js 22 et 24 LTS ont été testés sur macOS Apple Silicon.

1. Connectez-vous à votre compte GoLogin, ouvrez API & MCP, et générez un jeton dans l'onglet API.
2. Ajoutez cette configuration à votre client MCP, en remplaçant l'espace réservé du jeton. Fusionnez-la dans toute configuration mcpServers existante.

{
  "mcpServers": {
    "gologin-mcp": {
      "command": "npx",
      "args": ["-y", "gologin-mcp"],
      "env": {
        "API_TOKEN": "your-gologin-api-token-here"
      }
    }
  }
}

3. Redémarrez ou rechargez la connexion MCP de votre client, puis demandez : « Affichez-moi mes profils GoLogin. »

Le client démarre le serveur automatiquement. -y permet à npm d'installer le package sans confirmation interactive. Ce serveur lit API_TOKEN ; la variable GOLOGIN_TOKEN utilisée par d'autres CLI GoLogin n'est pas un alias ici.

Pour une vérification de démarrage en terminal, avec API_TOKEN déjà défini dans votre environnement :

npx -y gologin-mcp

Le serveur communique via l'entrée/sortie standard (stdio) et attend un client MCP. Il n'ouvre pas de navigateur et ne fournit pas d'invite de commande interactive par lui-même.

Ce que vous pouvez faire

• Créer, lire, mettre à jour, supprimer et organiser des profils de navigateur.
• Configurer les proxys des profils et actualiser les empreintes numériques du navigateur.
• Gérer les dossiers et leur appartenance aux profils.
• Lire les informations du compte.
• Démarrer et arrêter des profils de navigateur dans le cloud GoLogin.

Le démarrage cloud renvoie une URL de connexion. Ce serveur n'expose pas de navigation de page, de clic, de remplissage de formulaire ou d'outils de lancement Orbita local. Pour l'automatisation de pages, utilisez un client d'automatisation de navigateur séparé ou le CLI GoLogin Agent Browser.

Le processus MCP s'exécute localement ; les requêtes API GoLogin et les sessions de navigateur cloud nécessitent un accès réseau. La disponibilité du cloud et les opérations API dépendent des autorisations et du plan de votre compte.

Outils

Les noms des outils sont générés à partir de la méthode HTTP et du chemin dans la spécification OpenAPI GoLogin, que le serveur charge au démarrage. Ce qui suit est une sélection d'outils disponibles, et non une liste fixe d'alias. Interrogez tools/list dans votre client MCP pour connaître les noms et schémas d'entrée actuels.

Outil	Description
get_profile_v2	Lister et rechercher des profils, avec pagination et filtres de dossiers
post_profile_custom	Créer un profil avec des paramètres partiels tels que le nom, le système d'exploitation et le proxy
get_profile_id	Lire un profil par ID
put_profile_id_custom	Mettre à jour les paramètres sélectionnés d'un profil
delete_profile	Supprimer les profils listés dans profilesToDelete
patch_profile_proxy_many_v2	Configurer des proxys pour un ou plusieurs profils
patch_profile_fingerprints	Actualiser les empreintes numériques pour les profils listés dans browsersIds
get_proxy_v2	Lister les proxys
get_folders	Lister les dossiers
post_folders_folder	Créer un dossier par nom
patch_folders_folder	Ajouter ou retirer des profils d'un dossier
delete_folders_folder	Supprimer un dossier par nom
post_profile_id_web	Démarrer un profil dans le cloud et renvoyer une URL de connexion
delete_profile_id_web	Arrêter un profil cloud
get_user	Lire les informations du compte

Par exemple, un client MCP peut envoyer cette requête tools/call pour lire un profil :

{
  "name": "get_profile_id",
  "arguments": {
    "id": "your-profile-id"
  }
}

Les arguments suivent le schéma d'entrée de chaque outil. Les paramètres de chemin et de requête, ainsi que les champs du corps de la requête, sont passés comme arguments de premier niveau.

Exemples d'invites

• « Affichez-moi mes profils GoLogin. »
• « Créez un profil Linux nommé 'Research'. »
• « Renommez le profil PROFILE_ID en 'Research US'. »
• « Mettez à jour le profil PROFILE_ID pour utiliser ces paramètres de proxy. »
• « Actualisez l'empreinte numérique du profil PROFILE_ID. »
• « Créez un dossier nommé 'Research' et ajoutez-y le profil PROFILE_ID. »
• « Démarrez le profil PROFILE_ID dans le cloud et donnez-moi l'URL de connexion. »
• « Arrêtez la session cloud du profil PROFILE_ID. »
• « Affichez les informations de mon compte GoLogin. »

Configuration pour les clients MCP

Claude Desktop

Ouvrez Paramètres > Développeur > Modifier la configuration et ajoutez la configuration de démarrage rapide à claude_desktop_config.json. Quittez complètement et redémarrez Claude Desktop, puis vérifiez que gologin-mcp et ses outils sont disponibles.

Consultez le guide officiel de configuration MCP locale pour les chemins de configuration et le dépannage.

Cursor

Ajoutez la configuration de démarrage rapide à ~/.cursor/mcp.json pour votre compte utilisateur, ou .cursor/mcp.json pour un projet. Rechargez la connexion MCP et activez les outils du serveur. Gardez les configurations contenant des jetons API hors du contrôle de version.

Consultez la documentation MCP de Cursor pour les paramètres clients actuels.

Autres clients MCP

Utilisez un client prenant en charge les serveurs MCP stdio locaux. Configurez npx comme commande, -y et gologin-mcp comme arguments, et API_TOKEN dans l'environnement du serveur. Le format et l'emplacement de la configuration dépendent du client.

Dépannage

• Le serveur ne se connecte pas : vérifiez que Node.js et npx sont disponibles pour le client, puis redémarrez sa connexion MCP. Le serveur a également besoin d'accéder à docs-download.gologin.com pour charger ses définitions d'outils.
• L'API renvoie 401 Unauthorized : vérifiez le API_TOKEN passé au serveur et la validité du jeton dans GoLogin. Redémarrez la connexion après l'avoir modifié.
• Nom d'outil introuvable : actualisez la liste des outils et utilisez les noms renvoyés par tools/list ; des noms tels que list_profiles et start_browser ne sont pas des alias intégrés.
• Le démarrage cloud échoue : vérifiez la réponse de l'API et l'accès cloud de votre compte. Le démarrage MCP local ne lance pas lui-même Orbita sur votre ordinateur.

Développement

git clone https://github.com/gologinapp/gologin-mcp.git
cd gologin-mcp
npm ci
npm run build

Pour exécuter votre build local avec API_TOKEN déjà configuré :

node dist/index.js

Avant de publier, exécutez :

npm run release:check

Le package inclut uniquement le serveur compilé, les métadonnées du package, le README et la licence. La vérification de publication valide cette liste blanche afin que l'état local, les bases de données, les identifiants et les fichiers de développement ne puissent pas être inclus comme fichiers supplémentaires. npm publish exécute la même vérification automatiquement.

Publications du registre MCP

server.json décrit ce serveur pour le registre MCP officiel sous io.github.gologinapp/gologin-mcp. Le package npm déclare le même identifiant dans mcpName.

Maintenez les versions dans package.json, package-lock.json et server.json alignées. Publiez d'abord le package npm vérifié, puis exécutez Publier sur le registre MCP depuis l'onglet Actions du dépôt sur main. Le workflow vérifie que la version npm contient l'identifiant correct du registre et s'authentifie via GitHub OIDC, sans jeton de registre séparé. Il ne publie pas sur npm.

Liens

• GoLogin
• Documentation de l'API GoLogin
• Package npm
• Annuaire Glama

Licence

MIT, copyright GoLogin.