​
Salvar Configuração MCP

Cria uma nova configuração de servidor MCP ou edita uma existente. O MCP permite integração com servidores externos para expandir as capacidades dos avatares.

Endpoint: POST /api/externalAPIs/public/tolkyReasoning/saveMCPConfigHelper

PropriedadeTipoDescrição
idstring (UUID)ID da configuração (opcional - para edição)
hostIdstring (UUID)Identificador único do host (obrigatório)
avatarIdstring (UUID)Identificador único do avatar (obrigatório)
namestringNome da configuração MCP (obrigatório)
configobjectConfiguração do servidor MCP (obrigatório)
enabledbooleanSe a configuração está ativa (padrão: true)
controlConvbooleanSe controla conversas (padrão: false)
transportTypestringTipo de transporte: “streamable”, “sse” ou “stdio” (padrão: “streamable”)
versionstringVersão da configuração (padrão: “1.0.0”)

Exemplo cURL:

curl -X POST \
  '{BASE_URL}/api/externalAPIs/public/tolkyReasoning/saveMCPConfigHelper' \
  -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 de Exemplo:

{
  "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"
  }
}

Códigos de Erro:

  • 400: Campos obrigatórios ausentes ou transportType inválido
  • 401: Token de autenticação inválido ou ausente
  • 500: Erro interno do servidor

Notas:

  • Para criar: envie hostId, avatarId, name e config
  • Para editar: inclua o id da configuração existente
  • transport_type aceita apenas: “streamable”, “sse” ou “stdio”
  • Requer autenticação válida através do tolkyAuthMiddleware
Listar Configurações MCPDeletar Configuração MCP