Configuration des outils externes avec des serveurs MCP

Ajoutez, gérez et configurez les serveurs MCP pour Delegate, y compris les serveurs personnalisés, settings_v2.json, et Applications MCP.

MCP est un protocole ouvert pour la connexion des assistants d'IA à des sources de données et des outils externes. Contrairement aux connecteurs Integration Service, les serveurs MCP peuvent être distants (hébergés ailleurs, accessibles via HTTP) ou locaux (un programme s'exécutant sur votre machine).

La plupart des serveurs MCP n'ont pas besoin d'une configuration manuelle ; consultez la référence des serveurs MCP pour le catalogue soutenu par Orchestrator et la marketplace tierce, qui ajoutent tous deux un serveur en un clic.

Ajout d’un serveur MCP personnalisé

Pour un serveur qui ne figure pas dans le catalogue ou le marketplace, ajoutez-le manuellement à partir de Modules complémentaires et intégrations → Serveurs MCP.

Serveurs MCP distants

Les serveurs MCP distants sont hébergés ailleurs et accessibles via HTTP :

1. Sélectionnez Ajouter un serveur MCP → Distant.
2. Entrez les détails du serveur:
   • URL : l’adresse du point de terminaison (par exemple, https://api.example.com/mcp)
   • Titre : un nom convivial (par exemple, « API de l'entreprise »)
   • En-têtes (facultatif) : en-têtes d'authentification, si requis
3. Sélectionnez Enregistrer.
4. Activez /Désactivez pour activer.

Exemple de configuration :

{
  "type": "remote",
  "url": "https://internal-api.company.com/mcp",
  "enabled": true,
  "title": "Company Data API",
  "headers": {
    "Authorization": "<your-access-token>"
  }
}

Serveurs MCP locaux

Les serveurs MCP locaux s’exécutent en tant que processus sur votre machine:

1. Sélectionnez Ajouter un serveur MCP → Local.
2. Entrez les détails du serveur:
   • Titre : un nom convivial
   • Commande : l’exécutable à exécuter (par exemple, node, python, /path/to/server)
   • Arguments : arguments de ligne de commande
   • Répertoire de travail : où la commande s'exécute
   • Variables d'environnement : paires clé-valeur pour le processus
3. Sélectionnez Enregistrer.
4. Activez /Désactivez pour activer.

Exemples de configurations

Serveur MCP du système de fichiers :

{
  "type": "local",
  "enabled": true,
  "serverId": "filesystem-mcp",
  "title": "Local Filesystem Access",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
    "env": {},
    "cwd": "/Users/username"
  }
}

Serveur MCP GitHub :

{
  "type": "local",
  "enabled": true,
  "serverId": "github-mcp",
  "title": "GitHub Integration",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "<your-github-token>"
    },
    "cwd": "/Users/username"
  }
}

Gestion des serveurs MCP

À partir de Modules complémentaires et intégrations → Serveurs MCP, vous pouvez activer ou désactiver un serveur configuré, modifier sa configuration ou le supprimer. La désactivation d’un serveur empêche l’agent d’utiliser ses outils, mais n’arrête pas un processus de serveur local qui est déjà en cours d’exécution ; vous devrez peut-être arrêter vous-même ce processus.

Comment l’agent découvre les outils MCP

Lorsqu'un serveur MCP est activé, l'agent s'y connecte, le serveur signale ses outils disponibles et ces outils deviennent disponibles dans la conversation ; aucun enregistrement manuel n'est nécessaire. Vous pouvez les référencer en langage naturel, par exemple : « Utiliser l’outil de système de fichiers pour répertorier mon dossier Documents. »

MCP Apps : interfaces interactives en ligne

MCP Apps est une extension du protocole de contexte du modèle qui permet à un outil de renvoyer une interface interactive - un formulaire, un tableau de bord, un graphique, une table de données - au lieu de texte uniquement. Lorsque l’outil d’un serveur MCP connecté le prend en charge, Delegate affiche cette interface en ligne dans la conversation, dans un cadre isolé : l’interface peut appeler les outils propres au serveur et recevoir des mises à jour, mais ne peut accéder à quoi que ce soit en dehors de son propre cadre. Les formulaires arrivent pré-remplis de valeurs raisonnables, vous ne modifiez donc que ce qui compte au lieu de décrire chaque champ dans le chat.

La disponibilité de cette fonction sur un serveur MCP donné dépend de ce serveur ; tous les serveurs n'implémentent pas l'extension.

Les administrateurs peuvent gouverner les serveurs MCP au niveau de la politique - voir Serveurs MCP dans la gouvernance avec Automation Ops.

Avancé: gestion de la connexion via settings_v2.json

Les utilisateurs avancés peuvent gérer les connexions de serveur MCP directement dans settings_v2.json - la même liste mcpServers que celle que l'IU lit et écrit :

{
  "mcpServers": [
    {
      "type": "remote",
      "url": "https://api.example.com/mcp",
      "enabled": true,
      "title": "Example API",
      "headers": {
        "Authorization": "<your-access-token>"
      }
    },
    {
      "type": "local",
      "enabled": true,
      "serverId": "my-local-server",
      "title": "Local Tools",
      "config": {
        "command": "python",
        "args": ["/path/to/server.py"],
        "env": { "API_KEY": "<your-api-key>" },
        "cwd": "/path/to/working/dir"
      }
    }
  ]
}

Modifiez settings_v2.json uniquement si vous êtes à l'aise avec JSON - une syntaxe non valide empêche le chargement de l'application. Sauvegardez toujours avant d'effectuer des modifications. Consultez la section Emplacements des fichiers de paramètres.

Pour des considérations de sécurité et des informations sur le flux de données pour les connexions, consultez la section Configuration de la sécurité locale.

Prochaines étapes

• Référence des serveurs MCP - Le catalogue Orchestrator et la marketplace tierce
• Connexion à des applications métier populaires - Pour les intégrations SaaS gérées
• Répétition du travail avec des routines - Enregistrer les workflows qui utilisent vos outils connectés
• Partage des compétences avec votre équipe - Trouver des compétences préconstruites pour vos services connectés