Serveur MCP

MCP  est un standard ouvert que les assistants IA utilisent pour appeler des outils externes. Tout client MCP qui prend en charge le transport Streamable HTTP peut se connecter. L’assistant travaille dans l’application que vous avez ouverte : les projets qu’il modifie et les exécutions qu’il lance apparaissent sur le canevas, et il voit les modifications que vous apportez dans la fenêtre.

Quelques exemples de demandes :

Ouvrez ~/Projects/Acme/Acme.babel, activez le proxy dynamique et la génération du fichier de mappage pour Acme.exe, lancez l’obfuscation et signalez-moi les avertissements éventuels.

Ajoutez Acme.Core.dll au projet et fusionnez-le dans Acme.exe, puis montrez-moi les statistiques de renommage de la prochaine exécution.

Décodez la trace de pile de crash.txt avec Acme.exe.map.xml et dites-moi laquelle de mes méthodes a levé l’exception.

Montrez-moi les licences qui expirent dans les 30 prochains jours et les clients auxquels elles appartiennent.

Passez l’interface au thème Copper Night et faites une capture d’écran du tableau de bord.

À quoi sert le proxy dynamique ? S’il est pertinent pour Acme.exe, activez-le et expliquez pourquoi.

Activer le serveur

Le serveur est désactivé par défaut et n’écoute pas tant que vous ne l’avez pas activé.

Les modifications s’appliquent immédiatement. Décocher Activer le serveur d’automatisation arrête le serveur ; changer le port ou le jeton le redémarre et déconnecte les clients connectés. La palette de commandes propose aussi MCP : démarrer le serveur local (lecture/écriture du projet), MCP : arrêter le serveur local, MCP : afficher l’état et MCP : afficher le fichier de configuration du client.

Connecter un client

La section Configuration du client des paramètres MCP génère une configuration pour le port et le jeton actuels. Cliquez sur Copier la configuration et collez-la dans la configuration MCP de votre client :

{
  "mcpServers": {
    "babel-obfuscator": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp",
      "headers": {
        "X-Babel-Token": "paste-the-token-from-settings-mcp"
      }
    }
  }
}

Si aucun jeton n’est exigé, le bloc headers est omis. Afficher le fichier… montre le fichier de configuration que Babel Desktop écrit pour le serveur en cours d’exécution.

Pour Claude Code, cliquez sur Copier la commande Claude Code et exécutez la commande copiée dans un terminal :

claude mcp add --transport http babel-obfuscator http://127.0.0.1:8765/mcp \
  --header "X-Babel-Token: paste-the-token-from-settings-mcp"

Démarrez d’abord Babel Desktop, puis l’assistant. Pour vérifier la connexion, demandez à l’assistant de faire une capture d’écran de la fenêtre de Babel Desktop.

Ce que l’assistant peut faire

Le serveur expose les fonctionnalités de l’application sous forme d’outils MCP, regroupés comme suit :

Les noms des paramètres sont les noms d’options Babel Obfuscator affichés dans le panneau des propriétés, ce qui permet à l’assistant de s’appuyer sur la référence de la tâche Babel pour choisir les valeurs. Vous n’avez pas besoin de nommer les outils. Décrivez le résultat voulu, et l’assistant les choisit.

Modifications confirmées

Les opérations qui risquent de faire perdre du travail ou d’écraser des fichiers se déroulent en deux temps. L’assistant prépare d’abord l’opération et reçoit en retour une proposition qui décrit ce qui va se passer, par exemple les fichiers de sortie qu’une exécution remplacera ou l’enregistrement qu’une suppression retirera. Il doit vous montrer la proposition et obtenir votre accord avant de confirmer l’opération. Une proposition expire au bout de deux minutes et ne peut servir qu’une seule fois. Elle est refusée si le projet, les fichiers ou l’enregistrement ont changé depuis sa création.

La confirmation en deux temps s’applique aux opérations suivantes :

• la création d’un nouveau projet, le remplacement d’une entrée, le retrait d’une cible, la modification du graphe et des dépendances, et le lancement d’une exécution (obfuscate_start renvoie une proposition) ;
• les commandes de configuration : la fusion dans l’assembly principal, l’obfuscation publique et le niveau de protection d’une cible ;
• l’installation et la désinstallation d’extensions, et la suppression d’un profil de connexion de gestion des licences ;
• la création, la modification, la révocation et la suppression d’enregistrements de gestion des licences (licensing_prepare et licensing_confirm).

La modification des paramètres ou des règles XML exige la révision actuelle du projet, ce qui empêche un assistant d’écraser des modifications qu’il n’a pas vues.

Exécutions d’obfuscation

Une exécution lancée par l’assistant ne diffère en rien d’une exécution que vous lancez dans la fenêtre. Elle écrit la sortie aux mêmes emplacements, indique sa progression dans le panneau Activité et peut être annulée d’un côté comme de l’autre. L’assistant interroge obfuscate_status jusqu’à la fin de l’exécution, puis lit les statistiques avec results_read et results_table. Tant qu’une exécution est en cours, le projet ne peut pas être modifié.

Gestion des licences

Les outils de gestion des licences agissent sur les profils de connexion de gestion des licences, avec les rôles et les autorisations de la clé API du profil. Les enregistrements ne peuvent être créés, modifiés et supprimés que par un profil Test local dont le mode d’accès est Gestion locale ; les profils distants et les profils en lecture seule refusent toute modification. Les réponses omettent les secrets tels que les clés de licence, les clés API, les jetons et les adresses IP. Les outils du tableau de bord ne renvoient que des données agrégées.

Ce qui reste dans la fenêtre

L’assistant ne peut pas effectuer les opérations suivantes ; elles vous reviennent, dans la fenêtre :

• la saisie d’identifiants : se connecter avec une clé API et générer le jeton MCP ;
• la réponse aux demandes de mot de passe pendant une exécution, et le décodage de traces de pile avec des fichiers de mappage protégés par mot de passe ;
• le démarrage et l’arrêt du serveur MCP lui-même.

Outils de documentation Babel

Le serveur met aussi à la disposition de l’assistant la documentation que vous êtes en train de lire. Lorsque vous demandez comment une fonction marche ou comment réaliser une opération, l’assistant cherche dans la documentation, lit la section pertinente et répond avec des liens vers les pages utilisées, avant de modifier le moindre paramètre. Le serveur indique aux clients connectés de procéder ainsi, et vous n’avez pas besoin de nommer les outils.

Les outils de documentation ne font que lire, et ne se connectent qu’à https://docs.babelfor.net. La recherche s’exécute sur votre machine : votre question n’est pas envoyée au site de documentation. Les outils téléchargent l’index de recherche et les pages qu’ils lisent, c’est-à-dire les mêmes fichiers publics que ceux décrits dans Utiliser la documentation avec l’IA.

Quelques exemples de demandes :

Comment exclure un type du renommage avec les règles XML ? Modifiez les règles de ce projet en conséquence.

Cherchez dans la documentation de Babel Licensing comment mon application doit libérer une licence flottante à sa fermeture.

Lisez la page Décodeur de pile et expliquez-moi de quel fichier de mappage j’ai besoin pour un build de release.

Utilisation hors ligne et mises à jour

Babel Desktop conserve l’index et les pages téléchargés dans un dossier docs-cache de votre profil utilisateur.

• Les changements de l’index sont vérifiés au plus une fois toutes les 24 heures. Une page n’est téléchargée de nouveau que si elle a changé sur le site.
• Pour obtenir plus tôt la dernière version, demandez à l’assistant d’actualiser la documentation. Les outils acceptent refresh: true à cet effet.
• Sans connexion réseau, les outils répondent à partir de la copie en cache et signalent que le résultat est périmé, avec la date de la copie.
• Après un échec de connexion ou une erreur du site, les outils utilisent le cache pendant 10 minutes avant d’interroger de nouveau le site.

Sécurité

• Le serveur est désactivé par défaut et n’écoute qu’une fois que vous l’avez activé.
• Il est lié à 127.0.0.1, de sorte que les autres machines ne peuvent pas l’atteindre.
• Lorsque Exiger un jeton d’accès est activé, toute requête dépourvue de l’en-tête X-Babel-Token correct est rejetée.
• La taille des requêtes, les sessions, les connexions et les délais d’attente sont limités, et l’hôte et l’origine de chaque requête sont validés.
• Aucun outil n’exécute de commandes, de requêtes SQL ou d’URL arbitraires.
• Les outils de documentation ne se connectent qu’à https://docs.babelfor.net, sans suivre les redirections, et ne font que lire.

L’assistant a le même accès à vos projets et à vos fichiers que vous dans Babel Desktop. Il peut modifier les paramètres d’un projet, lancer des obfuscations et, après confirmation, remplacer des fichiers de sortie. Si vous laissez un assistant explorer librement, donnez-lui une copie du projet, et désactivez le serveur lorsque vous ne vous en servez pas.

Dépannage

Le Babel Licensing Service possède son propre serveur MCP, qui fonctionne à distance avec l’API du service ; voir Intégration de l’IA pour une comparaison.