Connect a DSW instance to an Agent through MCP - Platform For AI

Une fois le service MCP activé sur une instance DSW, connectez cette instance à un client Agent. L'Agent peut alors exécuter des commandes, lire et écrire des fichiers, ainsi que lancer du code directement dans l'instance, ce qui vous permet de déléguer vos tâches de développement cloud à l'IA.

Prérequis

Un VPC et un groupe de sécurité sont configurés pour l'instance DSW ou pour le quota de ressources auquel elle appartient.

Cas d'utilisation

La connexion d'une instance DSW à un Agent offre à ce dernier une machine de développement cloud prête à l'emploi. Il peut lire et modifier du code, exécuter des commandes et lancer des expériences directement dans l'instance, vous libérant ainsi des opérations répétitives liées à l'environnement. Voici quelques scénarios typiques :

Développement et débogage de code à distance : Demandez à l'Agent de créer et de modifier du code dans l'instance, de l'exécuter, d'identifier les erreurs, de les corriger et de relancer l'exécution pour boucler entièrement le cycle de développement.
Préparation de l'environnement et gestion des dépendances : Chargez l'Agent d'installer les dépendances Python ou système manquantes, de vérifier les versions de CUDA et des frameworks, et de valider l'environnement d'exécution, ce qui vous évite de saisir les commandes une par une.
Hébergement d'entraînements et d'expériences : L'Agent lance les scripts d'entraînement en mode asynchrone, surveille les journaux et les sorties, puis résume automatiquement les résultats dès la fin de l'entraînement.
Traitement des données et organisation de la documentation : Recherchez et nettoyez par lots les fichiers de données dans l'instance, ou convertissez des pages web, des PDF et des documents Office au format Markdown pour une analyse ultérieure.

Connecter une instance DSW à un Agent via MCP

Étape 1 : Créer une instance DSW et activer le service MCP

Activez le service MCP en trois étapes : activez l'interrupteur du service, générez les identifiants d'accès et ouvrez le port dans le groupe de sécurité. Une fois ces actions effectuées, l'Agent peut accéder à l'instance via le protocole MCP.

Activez l'interrupteur du service MCP. L'exemple suivant illustre la création d'une instance à l'aide de ressources publiques. Configurez les paramètres clés comme décrit dans cette section. Vous pouvez ajuster les autres paramètres selon vos besoins.

Pour une instance existante, accédez à la liste des instances, cliquez sur Change Configuration dans la colonne Actions , puis reconfigurez l'instance DSW.
- Resource Type : Sélectionnez les ressources publiques.
- VPC Settings : Sélectionnez un VPC situé dans la même région. Un VPC est requis pour activer le service MCP.
- Security Group : Sélectionnez le groupe de sécurité créé.
- VSwitch : Sélectionnez le vSwitch créé.
- Enable MCP Service : Activez l'interrupteur. Lorsque l'interrupteur est activé, un service nommé MCP apparaît et écoute par défaut sur le port 9806 de l'instance.
Si vous souhaitez accéder à l'instance DSW depuis Internet (par exemple, via un client Agent local), configurez les paramètres suivants :
- Service Access and Port Configuration :
  - Access over Internet : Cochez la case.
  - Internet Access Port : Indiquez un port, par exemple 1078.
- Public Network Access : Sélectionnez DNAT + EIP
  - NAT Gateway : Sélectionnez la passerelle NAT créée dans la même région.
  - EIP : Sélectionnez l'EIP associé à la passerelle NAT.
    
    Important
    Important : Pour permettre à l'instance DSW d'accéder à Internet, configurez une entrée SNAT pour la passerelle NAT. Pour plus d'informations, consultez Améliorer la vitesse d'accès public via une passerelle dédiée.
Une fois la configuration terminée, cliquez sur OK pour créer l'instance.
Générez les identifiants d'accès. Après la création de l'instance DSW, cliquez sur le nom de l'instance pour accéder à sa page de détails. Dans la section Access Configuration , cliquez sur Generate Access Credentials. Ces identifiants servent à authentifier l'Agent lorsqu'il appelle le service MCP. Transmettez-les sous forme de Bearer Token dans l'en-tête de la requête.

Vous disposez désormais du point d'accès MCP et des identifiants d'accès.

Remarque
Les identifiants sont valides pendant 7 jours par défaut. À leur expiration, régénérez-les au même emplacement. Après régénération, mettez à jour les identifiants dans la configuration de l'Agent.

Étape 2 : Ouvrir le port et l'adresse IP dans le groupe de sécurité

Sur la page de détails de l'instance DSW, dans la section Network Information , cliquez sur le nom du groupe de sécurité pour accéder à sa page de détails. Sous l'onglet Inbound , cliquez sur Add Rule . Configurez les paramètres suivants. Vous pouvez conserver les valeurs par défaut pour les autres paramètres.

Source : Saisissez l'adresse IP du lieu de déploiement de l'Agent (par exemple, l'adresse IP publique de l'ordinateur local exécutant l'Agent).
Destination (this instance) : Indiquez le port 9806.

Étape 3 : Connecter l'Agent à l'instance DSW

Le service MCP de DSW utilise le protocole standard Streamable HTTP et est compatible avec les principaux clients Agent. Ouvrez le client Agent (tel que Open Code ou Qoder CLI) et envoyez l'invite suivante à l'Agent, en remplaçant <MCP access endpoint> et <access credentials> par les valeurs réelles. L'Agent établira automatiquement la connexion MCP.

Si vous utilisez un client Agent local pour vous connecter à une instance DSW, utilisez le point d'accès public.

Add an MCP server named dsw-mcp with the Streamable HTTP protocol, endpoint http://<MCP access endpoint>, and request header Authorization: Bearer <access credentials>. Complete the setup automatically using your MCP configuration method.

Une fois la connexion établie, saisissez la commande suivante dans le client Agent pour tester la connectivité.

Create a hello_world Python file in the /mnt/workspace directory on the DSW instance.

Après l'exécution de la commande, ouvrez l'instance DSW. Le fichier hello_world.py apparaît dans l'espace de travail.

Outils pris en charge

Le service MCP de DSW expose un ensemble d'outils via le protocole standard Streamable HTTP. L'Agent charge automatiquement la liste des outils après la connexion. Ces outils sont répartis en cinq catégories : Shell, File, System, Format conversion et Code, soit 16 outils au total.

Outils Shell

Exécutez des commandes à l'intérieur de l'instance. Les commandes consécutives partagent le répertoire de travail, ce qui s'avère utile pour lancer des scripts, installer des dépendances et démarrer des jobs d'entraînement.

Outil

Fonction

Paramètres clés

shell_exec

Exécuter une commande shell

cmd (obligatoire), cwd, new_session, timeout

shell_view

Afficher la sortie cumulée et l'état d'une session

session_id, limit

shell_wait

Attendre la fin d'une commande asynchrone

session_id, seconds

shell_write

Envoyer une entrée à un processus en cours d'exécution

session_id, input, press_enter

shell_kill

Arrêter et nettoyer une session

session_id

Outils File

Lisez, écrivez, recherchez et modifiez des fichiers à l'intérieur de l'instance.

Outil

Fonction

Paramètres clés

file_read

Lire le contenu d'un fichier (par plage de lignes)

path (obligatoire), start_line, end_line, sudo

file_write

Écrire ou ajouter du contenu à un fichier ; prend en charge le binaire base64

path, content, encoding, append

file_str_replace

Remplacer des chaînes de caractères globalement dans un fichier

path, old_str, new_str

file_search

Rechercher du contenu de fichier par expression régulière

path, regex

file_find

Trouver des fichiers selon un motif glob

path, pattern

file_list

Lister les répertoires (récursif, filtrage par type)

path, recursive, file_types

file_edit

Éditeur avec fonction d'annulation

command (view/create/str_replace/insert/undo_edit), path, etc.

Outils System

Interrogez l'environnement de l'instance et les dépendances installées.

Outil

Fonction

Paramètres clés

system_info

Interroger l'environnement de l'instance (OS, Python, Node, outils disponibles)

Aucun

system_packages

Lister les packages Python ou Node.js installés

language

Outils de conversion de format

Outil

Fonction

Paramètres clés

util_to_markdown

Convertir des pages web, des PDF, des fichiers Office, des images, etc., au format Markdown

uri

Outils Code

Outil

Fonction

Paramètres clés

code_run

Exécuter du code (prend actuellement en charge Python)

code, language, timeout

Une fois le service MCP activé, les outils sont immédiatement disponibles. Aucune configuration supplémentaire n'est requise.