​
Listar Configurações MCP

Retorna uma lista de todas as configurações MCP disponíveis para um host específico, com opção de filtrar por avatar.

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

PropriedadeTipoDescrição
hostIdstring (UUID)Identificador único do host (obrigatório)
avatarIdstring (UUID)Identificador único do avatar (opcional)

Exemplo cURL:

curl -X POST \
  '{BASE_URL}/api/externalAPIs/public/tolkyReasoning/listMCPConfigsHelper' \
  -H 'Content-Type: application/json' \
  -d '{
    "hostId": "uuid-do-host",
    "avatarId": "uuid-do-avatar"
  }'

Resposta de Exemplo:

{
  "code": 200,
  "message": "OK",
  "data": [
    {
      "mcpId": "uuid-da-configuracao-1",
      "hostId": "uuid-do-host",
      "avatarId": "uuid-do-avatar",
      "name": "Servidor MCP Exemplo 1",
      "controlConv": false,
      "transportType": "streamable",
      "config": {
        "url": "https://exemplo1.com/mcp",
      },
      "version": "1.0.0"
    },
    {
      "mcpId": "uuid-da-configuracao-2",
      "hostId": "uuid-do-host",
      "avatarId": "uuid-do-avatar",
      "name": "Servidor MCP Exemplo 2",
      "controlConv": true,
      "transportType": "sse",
      "config": {
        "url": "https://exemplo2.com/mcp",
        "headers": {
          "Authorization": "Basic auth-toke-12345"
        }
      },
      "version": "1.0.0"
    }
  ]
}

Códigos de Erro:

  • 400: Campo obrigatório hostId ausente
  • 401: Token de autenticação inválido ou ausente
  • 500: Erro interno do servidor

Notas:

  • Requer autenticação válida através do tolkyAuthMiddleware
  • Se avatarId for fornecido, retorna apenas as configurações MCP associadas a esse avatar
  • Se apenas hostId for fornecido, retorna todas as configurações MCP do host
Obter Estatísticas FinanceirasSalvar Configuração MCP