IaGenify SDK 0.3.0: conecte agentes aos servidores MCP que você escolher.

Muitas ferramentas úteis já falam o protocolo MCP. Para usá-las por um SDK, desenvolvedores frequentemente precisavam criar um adaptador para cada fornecedor e traduzir as definições das ferramentas. O IaGenify SDK 0.3.0 adiciona um cliente MCP para conectar servidores compatíveis por uma interface comum.

Conecte uma vez e escolha as ferramentas disponíveis

A conexão informa a URL do servidor e pode incluir seu token de autenticação. O desenvolvedor seleciona quais ferramentas disponibilizar. Sem uma lista, nenhuma é habilitada: o acesso permanece explícito.

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

O exemplo usa um servidor genérico. Em um aplicativo, credenciais devem ficar no gerenciador de segredos do ambiente, nunca em um bundle do navegador, artigo ou repositório.

Dê ao agente um conjunto de ferramentas escolhido

Depois de conectado, o servidor pode fornecer ferramentas ao agente. Também é possível obter as definições MCP e passá-las ao seu próprio loop de turnos do modelo, sem adotar o mecanismo de agentes do SDK.

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

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

A opção `mcp` torna a seleção visível ao criar o agente. Se omitida, usam-se os servidores conectados à conta; uma lista vazia indica explicitamente que nenhum deve ser usado.

As permissões continuam fazendo parte da integração

MCP facilita conectar ferramentas, mas não elimina a necessidade de avaliar o que elas podem fazer. O SDK respeita as permissões do servidor e o modo de execução do agente. O aplicativo deve limitar servidores e operações ao que cada tarefa necessita.

Isso é útil para equipes que já têm um servidor MCP. Elas reutilizam essa fronteira de protocolo, escolhem as ferramentas autorizadas e deixam o servidor existente descrever as operações disponíveis.

Um protocolo, duas formas de usar

Alguns aplicativos querem que o IaGenify execute o loop do agente; outros já têm sua própria orquestração e precisam apenas das definições das ferramentas. O SDK oferece os dois caminhos.

Conecte as ferramentas que sua equipe já usa, escolha o que o agente pode ver e mantenha esse limite visível no código.

O SDK 0.3.0 torna o MCP um tipo de conexão de primeira classe. A integração fica mais simples, enquanto o aplicativo continua decidindo as ferramentas e permissões.