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.
POST
/AgentMcpConnectionCria 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
| Propriedade | Tipo | Obrigatório | Descrição | Restrições |
|---|---|---|---|---|
id | integer · int32 | Não | — | — |
agentId | integer · int32 | Não | — | min: 1; max: 2147483647 |
connectorId | integer · int32 | Não | — | min: 1; max: 2147483647 |
enabled | boolean | Não | — | — |
allowedTools | array<string> | Sim | — | — |
createdAt | string · date-time | Não | — | — |
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
| Status | Descrição | Corpo da resposta |
|---|---|---|
200 | Associação criada. | application/json · AgentMcpConnectionDto |
Exemplo de resposta (200):
{
"id": 0,
"agentId": 0,
"connectorId": 0,
"enabled": true,
"allowedTools": [
"string"
],
"createdAt": "2026-09-22T18:00:00Z"
}
Modelos de dados
AgentMcpConnectionDto
| Propriedade | Tipo | Obrigatório | Descrição | Restrições |
|---|---|---|---|---|
id | integer · int32 | Não | — | — |
agentId | integer · int32 | Não | — | min: 1; max: 2147483647 |
connectorId | integer · int32 | Não | — | min: 1; max: 2147483647 |
enabled | boolean | Não | — | — |
allowedTools | array<string> | Sim | — | — |
createdAt | string · date-time | Não | — | — |