IaGenify SDK 0.3.0 : connecter les agents aux serveurs MCP de votre choix.

De nombreux outils utiles parlent déjà le protocole MCP. Pour les exploiter depuis un SDK, il fallait souvent écrire un adaptateur par fournisseur et traduire séparément les définitions d’outils. IaGenify SDK 0.3.0 ajoute un client MCP afin de connecter un serveur compatible par une interface commune.

Se connecter une fois et choisir les outils disponibles

La connexion indique l’adresse du serveur et peut inclure son jeton d’authentification. Le développeur sélectionne les outils qu’il veut rendre disponibles. Sans liste, aucun outil n’est activé : l’accès reste explicite.

await api.mcp.connect({
  name: "team-tools",
  url: "https://tools.example.com/mcp",
  token: process.env.TOOLS_TOKEN,
  tools: ["search", "get_record"],
});

L’exemple utilise un serveur générique. Dans une application, les identifiants doivent rester dans le gestionnaire de secrets de l’environnement, jamais dans un bundle navigateur, un article ou un dépôt de code.

Donner à l’agent un ensemble d’outils choisi

Une fois le serveur connecté, un agent peut utiliser les outils qui lui sont associés. Le développeur peut aussi récupérer leurs définitions et les transmettre à sa propre boucle de modèle sans adopter le moteur d’agent du SDK.

const agent = api.agents.create({
  runtime: "local",
  machine,
  model: "your-model",
  mcp: ["team-tools"],
});

const definitions = await api.mcp.tools();

L’option `mcp` rend le choix visible à la création de l’agent. L’omettre utilise les serveurs reliés au compte ; fournir une liste vide indique explicitement qu’aucun ne doit être utilisé.

Les permissions font toujours partie de l’intégration

MCP facilite la connexion des outils, mais ne supprime pas la réflexion sur leurs pouvoirs. Le SDK suit les permissions du serveur et le mode d’exécution de l’agent. Une application devrait limiter les serveurs et opérations à ceux dont la tâche a besoin.

C’est utile lorsqu’une équipe possède déjà un serveur MCP. Elle peut réutiliser cette frontière de protocole, expliciter les outils autorisés et laisser le serveur existant décrire ses opérations.

Un protocole, deux façons de l’utiliser

Certaines applications veulent que IaGenify exécute la boucle de l’agent ; d’autres ont déjà leur propre orchestration et ne veulent que les définitions d’outils. Les deux parcours restent possibles.

Connectez les outils déjà utilisés par l’équipe, choisissez ceux qu’un agent peut voir et gardez cette frontière visible dans le code.

SDK 0.3.0 fait de MCP un type de connexion de première classe. Il simplifie l’intégration tout en laissant à l’application le choix des outils et des permissions.