メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

POST /v1/vaults 新しい Vault リソースを作成します。Vault は MCP サーバーへのアクセス認証情報を安全に保管するために使用します。作成時には少なくとも 1 つの認証情報が必要です。

​
ヘッダー

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

​
リクエストボディ

フィールド型必須説明
display_namestringはいVault 表示名
credentialsarrayはい認証情報配列、少なくとも 1 つの認証情報オブジェクトを含む

​
credentials 配列要素

フィールド型必須説明
mcp_server_urlstringはいMCP サーバー URL
protocolstringはいプロトコルタイプ、値：sse、streamable_http
typestringはい認証情報タイプ、現在は static_bearer のみサポート
access_tokenstringはいアクセストークン（static_bearer タイプで必須）

​
リクエスト例

curl -X POST https://openapi.qoder.sh/api/v1/cloud/vaults \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "my-mcp-vault",
    "credentials": [
      {
        "mcp_server_url": "https://example.com/mcp",
        "protocol": "sse",
        "type": "static_bearer",
        "access_token": "your-access-token"
      }
    ]
  }'

​
レスポンス例

HTTP 201 Created 
{
  "id": "vault_019e3bb940277f0db05ab74291acf6ef",
  "type": "vault",
  "display_name": "my-mcp-vault",
  "status": "active",
  "metadata": {},
  "credentials": [
    {
      "id": "vcred_019e3bb940297658a632dbf920057eff",
      "vault_id": "vault_019e3bb940277f0db05ab74291acf6ef",
      "mcp_server_url": "https://example.com/mcp",
      "protocol": "sse",
      "type": "static_bearer",
      "status": "active",
      "created_at": "2026-05-18T15:34:16.876188Z",
      "updated_at": "2026-05-18T15:34:16.876188Z"
    }
  ],
  "created_at": "2026-05-18T15:34:16.874877Z",
  "updated_at": "2026-05-18T15:34:16.874877Z"
}

​
エラーレスポンス

HTTPtype説明
400invalid_request_errorcredentials 配列欠落: "At least one credential is required when creating a vault."
400invalid_request_erroraccess_token 欠落: "Field 'access_token' is required for static_bearer type."
401TOKEN_INVALID認証トークンが欠落または無効