# IaGenify SDK 0.3.0: conecta agentes a los servidores MCP que elijas.

Canonical URL: https://www.iagenify.com/es/news/iagenify-sdk-mcp-client

El SDK incorpora un cliente MCP: conecta servidores compatibles, selecciona las herramientas disponibles y úsalas sin crear un adaptador específico para cada proveedor.

## Key points
- Un servidor compatible con MCP se conecta mediante una interfaz común del SDK.
- La conexión puede autorizar una lista concreta de herramientas en lugar de habilitarlas todas.
- Los agentes pueden usar servidores seleccionados y las definiciones también sirven para tu propio bucle de modelo.

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.

## FAQ
### ¿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.