DOM360
Agentes

Alterar um servidor MCP

PATCH
/agents/{agent_id}/mcp-servers/{server_id}

Altera parte de um servidor MCP e gera uma versão. Devolve o servidor atualizado (com o config mascarado). Um servidor inexistente responde 404.

Autorização

bearer agent-config:write
AutorizaçãoBearer <token>

Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.

Em: header

Escopo: agent-config:write

Parâmetros de caminho

agent_id*string

Id do agente

server_id*string

Id do servidor MCP

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

Alteração parcial de um servidor MCP. Devolver o que a leitura mostrou mantém as credenciais guardadas: o marcador (********), a credencial omitida de um config ou de headers enviados e o endereço sem as credenciais que a leitura tirou valem o guardado; um valor novo substitui e "" apaga.

Corpo da resposta

application/json

application/json

curl -X PATCH "https://example.com/agents/string/mcp-servers/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "built_in_id": "string",  "config": null,  "credentials": {    "property1": "string",    "property2": "string"  },  "has_credentials": true,  "headers": {    "property1": "string",    "property2": "string"  },  "id": "string",  "is_active": true,  "is_default": true,  "name": "string",  "server_type": "string",  "timeout_seconds": 0,  "transport": "string",  "url": "string"}