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óriohostId
ausente401
: Token de autenticação inválido ou ausente500
: 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