Viele nützliche Werkzeuge sprechen bereits das MCP-Protokoll. Für ihre Nutzung über ein SDK mussten Entwickler oft für jeden Anbieter einen Adapter schreiben und Werkzeugdefinitionen übersetzen. IaGenify SDK 0.3.0 ergänzt einen MCP-Client, der kompatible Server über eine gemeinsame Schnittstelle verbindet.
Einmal verbinden, verfügbare Werkzeuge auswählen
Die Verbindung enthält die Server-URL und kann ein Authentifizierungstoken übergeben. Entwickler wählen die freizugebenden Werkzeuge aus. Ohne Liste wird kein Werkzeug aktiviert: Der Zugriff bleibt bewusst.
await api.mcp.connect({
name: "team-tools",
url: "https://tools.example.com/mcp",
token: process.env.TOOLS_TOKEN,
tools: ["search", "get_record"],
});Das Beispiel verwendet einen allgemeinen Server. Zugangsdaten gehören in den Secret-Speicher der Laufzeit, niemals in ein Browser-Bundle, einen Artikel oder ein Quellcode-Repository.
Dem Agenten ausgewählte Werkzeuge geben
Nach der Verbindung kann ein Agent die Werkzeuge dieses Servers nutzen. Entwickler können auch MCP-Definitionen abrufen und an eine eigene Modellschleife übergeben, ohne den Agentenlauf des SDK zu verwenden.
const agent = api.agents.create({
runtime: "local",
machine,
model: "your-model",
mcp: ["team-tools"],
});
const definitions = await api.mcp.tools();Die Option `mcp` macht die Auswahl beim Erstellen eines Agenten sichtbar. Ohne diese Option werden die mit dem Konto verbundenen Server verwendet; eine leere Liste bedeutet ausdrücklich: keine.
Berechtigungen bleiben Teil der Integration
MCP vereinfacht die Verbindung, ersetzt aber nicht die Prüfung der Werkzeugrechte. Das SDK berücksichtigt die Berechtigungen des Servers und den Ausführungsmodus des Agenten. Eine Anwendung sollte nur die für eine Aufgabe nötigen Server und Vorgänge freigeben.
Das ist besonders für Teams hilfreich, die bereits einen MCP-Server betreiben: Sie nutzen die vorhandene Protokollgrenze, wählen erlaubte Werkzeuge aus und lassen den bestehenden Server seine Vorgänge beschreiben.
Ein Protokoll, zwei Einsatzmöglichkeiten
Manche Anwendungen möchten, dass IaGenify den Agentenlauf steuert. Andere haben bereits eine eigene Orchestrierung und benötigen nur die Werkzeugdefinitionen. Das SDK unterstützt beide Wege.
Verbinden Sie die Werkzeuge Ihres Teams, wählen Sie aus, was ein Agent sehen darf, und halten Sie diese Grenze im Code sichtbar.
SDK 0.3.0 macht MCP zu einer erstklassigen Verbindungsart. Die Integration wird einfacher, während die Anwendung die Werkzeuge und Berechtigungen festlegt.
Häufig gestellte Fragen
Brauche ich für jeden MCP-Dienst einen IaGenify-Adapter?
Nein. Das SDK verbindet kompatible Server über eine gemeinsame Client-Schnittstelle.
Werden beim Verbinden alle Werkzeuge aktiviert?
Nein. Sie können eine Liste angeben; ohne Liste wird standardmäßig kein Werkzeug freigegeben.
Kann ich MCP ohne `api.agents` nutzen?
Ja. `api.mcp.tools()` liefert Definitionen für eine eigene Modellschleife.
Wo sollte ein MCP-Token gespeichert werden?
In einem serverseitigen Secret-Speicher oder der Laufzeitkonfiguration, niemals im Browsercode oder Repository.