Muchas herramientas útiles ya hablan el protocolo MCP. Para usarlas desde un SDK, los desarrolladores solían necesitar un adaptador por proveedor y una forma separada de traducir las herramientas. IaGenify SDK 0.3.0 añade un cliente MCP para conectar servidores compatibles mediante una interfaz común.
Conecta una vez y selecciona las herramientas
La conexión especifica la URL del servidor y puede incluir su token de autenticación. El desarrollador elige qué herramientas habilita. Si no proporciona una lista, no se activa ninguna: el acceso es explícito.
await api.mcp.connect({
name: "team-tools",
url: "https://tools.example.com/mcp",
token: process.env.TOOLS_TOKEN,
tools: ["search", "get_record"],
});El ejemplo usa un servidor genérico. En una aplicación, las credenciales deben guardarse en el almacén de secretos del entorno, nunca en un bundle del navegador, un artículo o un repositorio.
Dale al agente un conjunto de herramientas elegido
Una vez conectado el servidor, el agente puede usar sus herramientas. También puedes obtener las definiciones MCP y pasarlas a tu propio bucle de turnos de modelo sin adoptar el motor de agentes del SDK.
const agent = api.agents.create({
runtime: "local",
machine,
model: "your-model",
mcp: ["team-tools"],
});
const definitions = await api.mcp.tools();La opción `mcp` hace visible la selección al crear el agente. Si se omite, se utilizan los servidores conectados a la cuenta; una lista vacía indica explícitamente que no se use ninguno.
Los permisos siguen formando parte de la integración
MCP facilita conectar herramientas, pero no elimina la necesidad de revisar sus permisos. El SDK respeta los del servidor y el modo del agente. La aplicación debería limitar los servidores y operaciones a lo que requiere cada tarea.
Esto resulta útil para equipos que ya tienen un servidor MCP: pueden reutilizar ese límite de protocolo, seleccionar herramientas permitidas y dejar que el servidor existente describa sus operaciones.
Un protocolo, dos formas de usarlo
Algunas aplicaciones quieren que IaGenify ejecute el bucle del agente. Otras ya tienen su propia orquestación y solo necesitan las definiciones de herramientas. El SDK permite ambos caminos.
Conecta las herramientas que ya usa tu equipo, elige cuáles ve el agente y deja visible ese límite en el código.
SDK 0.3.0 incorpora MCP como tipo de conexión de primera clase. Simplifica la integración y deja que la aplicación decida las herramientas y los permisos.
Preguntas frecuentes
¿Necesito un adaptador IaGenify para cada servidor MCP?
No. El SDK conecta servidores compatibles mediante una interfaz común.
¿Se habilitan todas las herramientas al conectar el servidor?
No. Puedes especificar una lista; si no lo haces, ninguna se habilita de forma predeterminada.
¿Puedo usar MCP sin `api.agents`?
Sí. `api.mcp.tools()` ofrece definiciones para un bucle de modelo propio.
¿Dónde guardo un token MCP?
En un almacén de secretos del servidor o en la configuración del entorno, nunca en el código del navegador ni en el repositorio.