メインコンテンツへスキップ
POST /v1/vaults/{vault_id}/credentials 指定された Vault に新しい MCP サーバー認証情報を追加します。

​
パスパラメータ

パラメータ型必須説明
vault_idstringはいVault の一意識別子

​
ヘッダー

ヘッダー必須説明
AuthorizationはいBearer $QODER_PAT
Content-Typeはいapplication/json

​
リクエストボディ

フィールド型必須説明
mcp_server_urlstringはいMCP サーバーの完全な URL、最大 2048 文字
protocolstringはい通信プロトコル、streamable_http のみ公開
typestringはい認証情報タイプ、現在は static_bearer のみサポート
access_tokenstringはいアクセストークン（static_bearer タイプで必須）

​
リクエスト例

curl -X POST https://api.qoder.com/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"
  }'

​
レスポンス例

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"
}

​
レスポンスフィールド

フィールド型説明
idstring認証情報一意識別子、形式 vcred_*
vault_idstring所属する Vault の ID
mcp_server_urlstringMCP サーバー URL
protocolstringプロトコルタイプ：streamable_http
typestring認証情報タイプ：static_bearer
statusstring状態：active または archived
archived_atstringアーカイブ時刻。アーカイブ済みの場合のみ存在
created_atstring作成時刻（ISO 8601）
updated_atstring最終更新時刻（ISO 8601）

​
エラーレスポンス

HTTPtype説明
400invalid_request_error必須フィールド欠落: "Field 'access_token' is required for static_bearer type."
401TOKEN_INVALID認証トークンが欠落または無効
404not_found_errorVault が存在しないまたはアクセス不可

​
注意事項

  • レスポンスには access_token の値は返されません（セキュリティのため）
  • 1 つの Vault に最大 20 個のアクティブな認証情報を保持できます
  • 認証情報作成後は直ちに active 状態となります

​
関連項目

Vaults

シークレットを安全に保存し、Agent Session に注入する。