MCP
Listar Configurações MCP
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/mcp/list
| Propriedade | Tipo | Descrição |
|---|---|---|
hostId | string (UUID) | Identificador único do host (obrigatório) |
avatarId | string (UUID) | Identificador único do avatar (opcional) |
Exemplo cURL:
curl -X POST \
'{BASE_URL}/api/externalAPIs/public/tolkyReasoning/mcp/list' \
-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óriohostIdausente401: Token de autenticação inválido ou ausente500: Erro interno do servidor
Notas:
- Requer autenticação válida através do
tolkyAuthMiddleware - Se
avatarIdfor fornecido, retorna apenas as configurações MCP associadas a esse avatar - Se apenas
hostIdfor fornecido, retorna todas as configurações MCP do host