Agentes
Adicionar um servidor MCP
Adiciona um servidor MCP ao agente e gera uma versão. Devolve o servidor criado (com o config mascarado). Aceita Idempotency-Key (opcional).
Autorização
bearer agent-config:writeAutorizaçã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
Parâmetros de cabeçalho
Idempotency-Key?|
Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.
Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
Criação de um servidor MCP: um externo (padrão) ou uma integração embutida do catálogo.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/agents/string/mcp-servers" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "transport": "string" }'{ "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"}