Você pode testar esta rota diretamente em nossa documentação interativa.

Cria ou edita uma configuração MCP. O MCP permite integrar servidores externos para expandir as capacidades dos avatares.

Endpoint

POST /api/externalAPIs/public/tolkyReasoning/mcp/save

Parâmetros

id
string

UUID da configuração (obrigatório apenas para edição).

hostId
string
required

UUID do host.

avatarId
string
required

UUID do avatar.

name
string
required

Nome da configuração.

config
object
required

Configuração do servidor MCP (ex.: url, headers).

enabled
boolean
default: "true"

Se a configuração está ativa.

controlConv
boolean
default: "false"

Se controla conversas.

transportType
string
default: "streamable"

Tipo de transporte: streamable, sse ou stdio.

version
string
default: "1.0.0"

Versão da configuração.

Exemplo

curl -X POST {{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/mcp/save \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "hostId": "uuid-do-host",
    "avatarId": "uuid-do-avatar",
    "name": "Servidor MCP Exemplo",
    "config": {
      "url": "https://exemplo.com/mcp"
    },
    "enabled": true,
    "transportType": "streamable"
  }'

Resposta

{
  "code": 200,
  "message": "OK",
  "data": {
    "mcpId": "uuid-da-configuracao",
    "hostId": "uuid-do-host",
    "avatarId": "uuid-do-avatar",
    "name": "Servidor MCP Exemplo",
    "controlConv": false,
    "transportType": "streamable",
    "config": {
      "url": "https://exemplo.com/mcp"
    },
    "version": "1.0.0"
  }
}

Campos da Resposta

data
object

Erros

CódigoDescrição
400Campos obrigatórios ausentes ou transportType inválido
401Token ausente ou inválido
500Erro interno do servidor