# Criar conexão MCP de agente

Cria uma associação entre agente e conector MCP do mesmo tenant. Informe Enabled e a lista AllowedTools; uma lista vazia não libera ferramentas. Não permite duplicar o mesmo conector para um agente. Requer UpdateAgent e ViewConnectors.

Source: https://zild.ai/pt-BR/docs/api-reference/post-api-AgentMcpConnection

POST `/AgentMcpConnection`

Cria uma associação entre agente e conector MCP do mesmo tenant. Informe Enabled e a lista AllowedTools; uma lista vazia não libera ferramentas. Não permite duplicar o mesmo conector para um agente. Requer UpdateAgent e ViewConnectors.

## Autenticação

**Autenticação obrigatória.** Envie sua chave de API de usuário no header X-API-Key.

## Parâmetros

Esta operação não possui parâmetros de rota, query ou header.

## Corpo da requisição

**Content type:** `application/json` · **Schema:** `AgentMcpConnectionDto`



<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>agentId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>min: 1; max: 2147483647</td></tr><tr><td><code>connectorId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>min: 1; max: 2147483647</td></tr><tr><td><code>enabled</code></td><td><code>boolean</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>allowedTools</code></td><td><code>array&lt;string&gt;</code></td><td>Sim</td><td>—</td><td>—</td></tr><tr><td><code>createdAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>



## Exemplo de requisição



```
curl --request POST \
  --url 'https://api.zild.ai/AgentMcpConnection' \
  --header 'X-API-Key: YOUR_USER_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 0,
  "agentId": 0,
  "connectorId": 0,
  "enabled": true,
  "allowedTools": [
    "string"
  ],
  "createdAt": "2026-09-22T18:00:00Z"
}'
```



## Respostas



<table class="api-params"><thead><tr><th>Status</th><th>Descrição</th><th>Corpo da resposta</th></tr></thead><tbody><tr><td><code>200</code></td><td>Associação criada.</td><td><code>application/json</code> · <code>AgentMcpConnectionDto</code></td></tr></tbody></table>

**Exemplo de resposta (200):**



```
{
  "id": 0,
  "agentId": 0,
  "connectorId": 0,
  "enabled": true,
  "allowedTools": [
    "string"
  ],
  "createdAt": "2026-09-22T18:00:00Z"
}
```



## Modelos de dados

`AgentMcpConnectionDto`

<table class="api-params"><thead><tr><th>Propriedade</th><th>Tipo</th><th>Obrigatório</th><th>Descrição</th><th>Restrições</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>agentId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>min: 1; max: 2147483647</td></tr><tr><td><code>connectorId</code></td><td><code>integer · int32</code></td><td>Não</td><td>—</td><td>min: 1; max: 2147483647</td></tr><tr><td><code>enabled</code></td><td><code>boolean</code></td><td>Não</td><td>—</td><td>—</td></tr><tr><td><code>allowedTools</code></td><td><code>array&lt;string&gt;</code></td><td>Sim</td><td>—</td><td>—</td></tr><tr><td><code>createdAt</code></td><td><code>string · date-time</code></td><td>Não</td><td>—</td><td>—</td></tr></tbody></table>