API key 管理

key の形式

• プレフィクスはrk_live_で始まる32文字以上の英数字
• Bearer 認証として送る:Authorization: Bearer rk_live_xxxxxxxx
• HTTPS 必須。HTTP で送ったリクエストは認証以前に拒否される

使い方

Claude Desktop の設定ファイルにそのまま貼る形がいちばん早い。

Claude Desktop (JSON・要 Node.js)

{
  "mcpServers": {
    "rakuda-atlas": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://atlas.rakuda.co/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${ATLAS_AUTH_HEADER}"
      ],
      "env": {
        "ATLAS_AUTH_HEADER": "Bearer rk_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Code (bash)

claude mcp add rakuda-atlas \
  --transport http \
  --header "Authorization: Bearer rk_live_xxxxxxxxxxxxxxxxxxxx" \
  https://atlas.rakuda.co/mcp

Cursor を含む各クライアントの詳細手順は /docs/quickstart にまとめてある。

保管ルール

• 環境変数で保持する。Windows なら User 環境変数、macOS なら Keychain か 1Password 等のシークレットマネージャーに置く
• git にコミットしない。.env・.env.local・claude_desktop_config.jsonは.gitignoreに入れておく
• チームで共有しない (1 user1 key が前提なので、複数人で 1 key を使い回すと利用量と責任の所在がぶれる)

現在はサポート経由での再発行のみ受け付けている。dashboard での self-serve 再発行は β 期間後に実装予定。

• 漏洩疑いがあれば support@rakuda.co に旧 key のプレフィクス (rk_live_XXXX...先頭12文字程度) を送って再発行を依頼する
• 受付後、旧 key は即時失効。新しい key を再度メールで送る (こちらも 1 回表示)
• dashboard で自分で再発行できるようにする UI は β 後に実装予定