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

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

O SDK passa a ser um cliente MCP: conecte servidores compatíveis, selecione as ferramentas disponíveis e use-as sem criar um adaptador específico para cada fornecedor.

## Key points
- Um servidor compatível com MCP conecta-se por uma interface comum do SDK.
- A conexão pode autorizar uma lista específica de ferramentas, em vez de habilitar tudo por padrão.
- Agentes usam os servidores escolhidos; as definições também podem alimentar seu próprio loop de modelo.

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.

## FAQ
### Preciso de um adaptador IaGenify para cada serviço MCP?
Não. O SDK conecta servidores compatíveis por uma interface cliente comum.

### Todas as ferramentas são habilitadas ao conectar o servidor?
Não. Você pode fornecer uma lista explícita; sem ela, nenhuma ferramenta é habilitada por padrão.

### Posso usar MCP sem `api.agents`?
Sim. `api.mcp.tools()` fornece definições para um loop de modelo próprio.

### Onde devo guardar um token MCP?
Em um gerenciador de segredos do servidor ou na configuração de ambiente, nunca no código do navegador ou no repositório.