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 /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

PropriedadeTipoObrigatórioDescriçãoRestrições
idinteger · int32Não——
agentIdinteger · int32Não—min: 1; max: 2147483647
connectorIdinteger · int32Não—min: 1; max: 2147483647
enabledbooleanNão——
allowedToolsarray<string>Sim——
createdAtstring · date-timeNã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

StatusDescriçãoCorpo da resposta
200Associaçã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
PropriedadeTipoObrigatórioDescriçãoRestrições
idinteger · int32Não——
agentIdinteger · int32Não—min: 1; max: 2147483647
connectorIdinteger · int32Não—min: 1; max: 2147483647
enabledbooleanNão——
allowedToolsarray<string>Sim——
createdAtstring · date-timeNão——