MCP
Salvar Configuração MCP
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/mcp/save
Propriedade | Tipo | Descrição |
---|---|---|
id | string (UUID) | ID da configuração (opcional - para edição) |
hostId | string (UUID) | Identificador único do host (obrigatório) |
avatarId | string (UUID) | Identificador único do avatar (obrigatório) |
name | string | Nome da configuração MCP (obrigatório) |
config | object | Configuração do servidor MCP (obrigatório) |
enabled | boolean | Se a configuração está ativa (padrão: true) |
controlConv | boolean | Se controla conversas (padrão: false) |
transportType | string | Tipo de transporte: “streamable”, “sse” ou “stdio” (padrão: “streamable”) |
version | string | Versão da configuração (padrão: “1.0.0”) |
Exemplo cURL:
curl -X POST \
'{BASE_URL}/api/externalAPIs/public/tolkyReasoning/mcp/save' \
-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álido401
: Token de autenticação inválido ou ausente500
: Erro interno do servidor
Notas:
- Para criar: envie
hostId
,avatarId
,name
econfig
- 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