Configuration des outils externes avec des serveurs MCP

Add, manage, and configure MCP servers for Delegate, including custom servers, settings_v2.json, and MCP Apps.

MCP est un protocole ouvert pour connecter 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 section Référence des serveurs MCP pour le catalogue basé sur Orchestrator et le Marketplace tiers, les deux ajoutant un serveur en un clic.

Ajouter un serveur MCP personnalisé

Pour un serveur qui ne se trouve pas dans le catalogue ou le Marketplace, ajoutez-le manuellement depuis 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

Depuis 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 déjà en cours d'exécution. Il est possible que vous ayez besoin d'arrêter ce processus vous-même.

Comment l'agent découvrez 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 sans enregistrement manuel nécessaire. Vous pouvez les référencer en langage naturel, par exemple: "Utiliser l'outil système de fichiers pour lister mon dossier Documents.".

MCP Apps: interfaces interactives en ligne

Les MCP Apps sont 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 d'un texte uniquement. Lorsque l'outil d'un serveur MCP connecté le prend en charge, Delegate rend cette interface en ligne dans la conversation, dans un cadre sandboxed: l'interface peut appeler les propres outils du serveur et recevoir des mises à jour, mais ne peut pas accéder à quoi que ce soit en dehors de son cadre. Les formulaires arrivent préremplis avec des valeurs sensibles, vous ne modifiez donc que ce qui compte au lieu de décrire chaque champ dans le chat.

Si un serveur MCP donné offre cela 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 expérimentés peuvent gérer les connexions au serveur MCP directement dans settings_v2.json — la même mcpServers liste les lectures et écritures de l'interface utilisateur:

{
  "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 — syntaxe non valide empêche le chargement de l'application. Sauvegardez toujours avant la modification. Voir Paramètres des emplacements des fichiers.

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 - Catalogue Orchestrator et Marketplace tiers
• Connexion aux applications métier populaires — Pour les intégrations SaaS gérées
• Répéter le travail avec des routines - Enregistrez les workflows qui utilisent vos outils connectés
• Partage des compétences avec votre équipe — Trouvez des compétences prédéfinies pour vos services connectés