Adicione uma credencial de servidor MCP a um vault.
Cabeçalhos da requisição
|
Cabeçalho |
Obrigatório |
Descrição |
|
Authorization |
Sim |
Token Bearer para autenticação. Formato: Bearer $QODER_PAT. |
|
Content-Type |
Sim |
Deve ser application/json. |
Parâmetros de caminho
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
vault_id |
string |
Sim |
Identificador exclusivo do vault ao qual adicionar a credencial. |
Corpo da requisição
|
Campo |
Tipo |
Obrigatório |
Descrição |
|
mcp_server_url |
string |
Sim |
URL do servidor MCP autorizado por esta credencial. |
|
protocol |
string |
Sim |
Protocolo de transporte. Valores aceitos: sse ou streamable_http. |
|
type |
string |
Sim |
Tipo da credencial. Atualmente, apenas static_bearer tem suporte. |
|
access_token |
string |
Sim |
Token de acesso apresentado ao servidor MCP. Obrigatório quando o tipo é static_bearer. |
Exemplo de requisição
curl -X POST "https://api.qoder.com.cn/api/v1/cloud/vaults/vault_019e3bb940277f0db05ab74291acf6ef/credentials" \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json" \
-d '{
"mcp_server_url": "https://example.com/mcp-stream",
"protocol": "streamable_http",
"type": "static_bearer",
"access_token": "your-access-token"
}'Exemplo de resposta
HTTP 201 Created
{
"id": "vcred_019e3bb98877759e862750b495c1fce8",
"vault_id": "vault_019e3bb940277f0db05ab74291acf6ef",
"mcp_server_url": "https://example.com/mcp-stream",
"protocol": "streamable_http",
"type": "static_bearer",
"status": "active",
"created_at": "2026-05-18T15:34:35.387093Z",
"updated_at": "2026-05-18T15:34:35.387093Z"
}Campos da resposta
|
Campo |
Tipo |
Descrição |
|
id |
string |
Identificador exclusivo da credencial, com prefixo vcred_. |
|
vault_id |
string |
ID do vault proprietário da credencial. |
|
mcp_server_url |
string |
URL do servidor MCP autorizado por esta credencial. |
|
protocol |
string |
Protocolo de transporte. Valores aceitos: sse ou streamable_http. |
|
type |
string |
Tipo da credencial. |
|
status |
string |
Estado da credencial. Novas credenciais assumem o status active por padrão. |
|
created_at |
string |
Timestamp de criação no formato ISO 8601. |
|
updated_at |
string |
Timestamp da última atualização no formato ISO 8601. |
Erros
|
HTTP |
Tipo |
Gatilho |
|
400 |
invalid_request_error |
Campo obrigatório ausente: 'access_token' é necessário para o tipo static_bearer. |
|
401 |
authentication_error |
Token de autenticação ausente ou inválido. |
|
404 |
not_found_error |
O vault especificado não existe ou foi excluído. |
Observações
Por segurança, o valor de access_token nunca é retornado na resposta.
Um vault pode armazenar várias credenciais.
As credenciais ficam ativas imediatamente após a criação.
Para obter detalhes completos sobre o envelope de erro, consulte Erros.