scaleway-ops-mcp-server

Scaleway IAM（アプリケーション、APIキー、ポリシー、権限セット）およびオブジェクトストレージのバケットポリシー管理のためのMCPサーバーです。

なぜこれが存在するのか

新しいサービス向けにスコープ付きのScaleway認証情報をプロビジョニングする（IAMアプリケーションを作成し、APIキーを発行し、IAMポリシーをアタッチし、ターゲットバケットにバケットポリシーをアタッチする）のは、これまではWebコンソールから手動で行われていた繰り返し作業です。このサーバーは実際のScaleway APIをラップして、エージェントがツール呼び出しで代わりに実行できるようにします。このサーバーが隠蔽しようとしているAPIの非自明な部分については、docs/gotchas.mdを参照してください。

Related MCP server: AWS Security MCP Server

セットアップ

npm install
npm run build

設定

環境変数（.env.exampleを参照）：

このサーバーが実行される認証情報には、独自のIAMポリシーが必要です。最低限IAMApplicationManager + IAMPolicyManager（組織スコープ）とObjectStorageFullAccess（プロジェクトスコープ）を付与してください。これらが2つの別々のポリシールールでなければならない理由はdocs/gotchas.mdを参照してください。scaleway-ops-mcpアプリケーション（2026-08-12にプロビジョニング済み）はすでにこれを持っています。特に異なるスコープのIDが必要でない限り、新しい認証情報を作成せずにこの認証情報を再利用してください。

実行

Claude Code / 任意のMCPクライアントを介して、stdioサーバーとして：

{
  "mcpServers": {
    "scaleway-ops": {
      "command": "node",
      "args": ["/absolute/path/to/scaleway-ops-mcp-server/dist/index.js"],
      "env": {
        "SCW_ACCESS_KEY": "...",
        "SCW_SECRET_KEY": "...",
        "SCW_ORGANIZATION_ID": "...",
        "SCW_PROJECT_ID": "..."
      }
    }
  }
}

ツール

IAMアプリケーション

• scaleway_iam_create_application、scaleway_iam_list_applications、scaleway_iam_get_application、scaleway_iam_update_application、scaleway_iam_delete_application

IAM APIキー

• scaleway_iam_create_api_key、scaleway_iam_list_api_keys、scaleway_iam_update_api_key、scaleway_iam_delete_api_key

• update_api_keyはdescription/expires_at/default_project_idのみをカバーします – access_key/secret_keyのペアは決して変更されないため、認証情報のローテーションは行われません。

IAMポリシー

• scaleway_iam_create_policy、scaleway_iam_list_policies、scaleway_iam_get_policy、scaleway_iam_update_policy、scaleway_iam_delete_policy

• update_policyはname/description/tagsのみをカバーします。rulesについては、以下の2つのツールを使用してください – get_policyはルールを返しません。

IAMポリシールール（ポリシーオブジェクト自体とは別のエンドポイント – docs/gotchas.mdを参照）

• scaleway_iam_list_policy_rules、scaleway_iam_set_policy_rules（アトミックな全置換PUT、削除＋再作成のロックアウトリスクなし）

IAMユーザー（人間のID、issue #4；招待セマンティクスは未検証 – gotchasを参照）

• scaleway_iam_list_users、scaleway_iam_get_user

• scaleway_iam_create_user（確認ガードあり；実際の招待メールを送信 – 使い捨てメールボックスがないとセマンティクス未検証）

• scaleway_iam_update_user（プロファイルフィールド）、scaleway_iam_delete_user（確認＋所有者拒否＋ゲストスコープのAPIエラーを表示）

• scaleway_iam_lock_user / scaleway_iam_unlock_user（ロックは確認ガードあり – 個人に対して作用）

• scaleway_iam_update_user_password（管理者設定のリセット、確認ガードあり）、scaleway_iam_update_user_username（確認ガードあり）

• scaleway_iam_delete_user_mfa_otp（確認ガードあり、セキュリティ低下）、scaleway_iam_list_user_grace_periods

IAMグループ（issue #5；ポリシーツールがすでに受け入れるgroup_idプリンシパルループを完了 – 完全にライブ検証済み、影響範囲ゼロ）

• scaleway_iam_list_groups（名前は完全一致、部分一致ではない）、scaleway_iam_get_group

• scaleway_iam_create_group（確認不要 – 元に戻せる、誰にも副作用なし）、scaleway_iam_update_group（名前/説明/タグ）

• scaleway_iam_delete_group（確認ガードあり；管理/特殊/deletable=falseグループをツール側で拒否）

• scaleway_iam_add_group_member（1人のユーザーおよび/または1つのアプリケーション）、scaleway_iam_add_group_members（一括、追加） – 両方とも管理/特殊/editable=falseグループを拒否

• scaleway_iam_set_group_members（確認ガードあり；全置換 – 省略されたメンバーは削除される）、scaleway_iam_remove_group_member（確認ガードあり） – 同じ特殊/編集不可拒否

IAM SSHキー（issue #6；projectsスコープの権限 – このサーバーの他のIAMツールとは異なる – gotchasを参照）

• scaleway_iam_list_ssh_keys、scaleway_iam_get_ssh_key、scaleway_iam_create_ssh_key（公開鍵のみ – 秘密鍵のように見えるものを拒否）、scaleway_iam_update_ssh_key（名前変更のみ）、scaleway_iam_delete_ssh_key（確認ガードあり）

IAM JWT（issue #6；ブラウザ/コンソールセッショントークン、APIキーではない）

• scaleway_iam_list_jwts、scaleway_iam_get_jwt、scaleway_iam_delete_jwt（確認ガードあり） – listは権限に関係なくアプリケーション/APIキー認証情報に対して構造的に403を返す（gotchas参照）；get/deleteがより良い結果をもたらす場合に備えて、修正された/jwtsパスに従って実装。

IAM SAML SSO（issue #6；組織全体 – これが見つかったライブインシデントについてはgotchasを参照）

• scaleway_iam_get_saml_config、scaleway_iam_enable_saml / update_saml / disable_saml（すべて確認ガードあり、組織全体の影響範囲）、scaleway_iam_list/add/get/delete_saml_certificate（破壊的なものは確認ガードあり；単一証明書パスは未検証、gotchas参照）

IAM SCIMプロビジョニング（issue #6；SAMLと同じ組織全体の注意）

• scaleway_iam_get_scim_config、scaleway_iam_enable_scim / disable_scim（確認ガードあり）、scaleway_iam_list/create/delete_scim_token（作成/削除は確認ガードあり；トークンシークレットはAPIキーと同様に一度だけ返される）

IAMセキュリティ設定（issue #6；組織全体の認証ポリシー – 両方向でライブ検証済み）

• scaleway_iam_get_security_settings、scaleway_iam_update_security_settings（確認ガードあり；渡されたフィールドのみ変更）

IAM権限セット

• scaleway_iam_list_permission_sets – ポリシーを作成/アタッチする前にこれを呼び出してください。docs/gotchas.mdを参照。

オブジェクトストレージバケット（S3互換エンドポイント、IAM APIとは別の認証パス）

• scaleway_s3_create_bucket、scaleway_s3_list_buckets、scaleway_s3_delete_bucket – バケットのライフサイクル。

オブジェクトストレージバケット設定（issue #7；動作の事実は2026-08-18にライブ検証済み、docs/gotchas.mdを参照）

• タグ：scaleway_s3_get/put/delete_bucket_tagging（put = 全置換）。

• CORS：scaleway_s3_get/put/delete_bucket_cors（put = 全置換）。

• バージョニング：scaleway_s3_get_bucket_versioning、scaleway_s3_set_bucket_versioning（停止は確認が必要）。

• ウェブサイト：scaleway_s3_get/put/delete_bucket_website（putはエンドポイントを公開、確認が必要）。

• 可視性：scaleway_s3_get/set_bucket_visibility – 簡易ACLによる大まかな公開/非公開（公開は確認が必要；バケットポリシーが細かいメカニズム）。

• ライフサイクルルール：scaleway_s3_get/put/delete_bucket_lifecycle（put/deleteは確認ガードあり – 有効期限ルールはオブジェクトを完全に削除）。

• 暗号化設定：scaleway_s3_get/put/delete_bucket_encryption – 実際の切り替え可能な設定（コンソール確認済み）、不活性なメタデータではない；docs/gotchas.mdを参照。

• オブジェクトロック：scaleway_s3_get_object_lock、scaleway_s3_enable_object_lock（一方通行：無効化不可、バージョニング前提条件は処理済み、その後バージョニングは固定；作成時のロックフラグはScalewayによって黙って無視される）。

• バケットログやバケットメトリクスのツールはありません：ScalewayのS3エンドポイントは両方に対してNotImplementedを返します。

オブジェクトストレージバケットポリシー

• scaleway_s3_get_bucket_policy、scaleway_s3_put_bucket_policy、scaleway_s3_delete_bucket_policy

オブジェクトストレージオブジェクト（シングルパートのみ；マルチパート/大容量ファイルのアップロードは対象外）

• scaleway_s3_put_object、scaleway_s3_get_object、scaleway_s3_list_objects、scaleway_s3_head_object、scaleway_s3_copy_object、scaleway_s3_delete_object、scaleway_s3_delete_objects

• put_object/get_objectはバイナリペイロードをbase64で扱います（encoding: "base64"）；デコードサイズはMAX_PUT_OBJECT_BYTES（デフォルト5 MB）で制限されます。get_objectはUTF-8テキストとバイナリを自動検出し、それに応じてencodingを返します。

• scaleway_s3_get_object_tags、scaleway_s3_put_object_tags（putはタグセット全体を置き換え、put_bucket_policyと同じ置換・マージ不可のセマンティクス）

• scaleway_s3_generate_presigned_url – 時間制限付きのGET/PUT URLで、MCP外の何かに直接オブジェクトアクセスを渡す際に、このサーバーの認証情報を公開しません。

監査証跡 – イベントクエリ（読み取り専用；すべてこのサーバーの認証情報にAuditTrailReadOnlyが必要 – scaleway_iam_set_policy_rulesで付与）

• scaleway_audit_list_events – 誰が、いつ、どこから何をしたか（API/リソースアクティビティ）。

• scaleway_audit_list_authentication_events – 認証アクティビティ（ログイン/トークン/MFAの結果） – 別のエンドポイント。

• scaleway_audit_list_system_events – Scaleway自身のシステムがリソースに対して実行したアクション。

• scaleway_audit_list_combined_events – 3つのストリームすべてを1つの時系列フィードにまとめ、各イベントにapi/auth/systemのタグが付きます。

• scaleway_audit_get_last_events_overview – コンソールの監査証跡ランディングページに表示される最近のイベントスナップショット。

• scaleway_audit_list_products – 監査証跡と統合された製品/サービス/メソッド（有効なフィルター値のカタログ）。

監査証跡 – アラートルール

• scaleway_audit_list_alert_rules、scaleway_audit_set_alert_rules_enabled（追加的）、scaleway_audit_replace_enabled_alert_rules（全置換、確認ガードあり） – Scalewayの事前設定ルール；有効/無効のみ可能で、作成や削除はできません。未知のルールIDはリクエスト全体をアトミックに拒否します（2026-08-18にライブ検証済み）。

• scaleway_audit_list_custom_alert_rules、scaleway_audit_create_custom_alert_rule、scaleway_audit_update_custom_alert_rule（名前/説明のみ）、scaleway_audit_delete_custom_alert_rule、scaleway_audit_set_custom_alert_rules_enabled、scaleway_audit_replace_enabled_custom_alert_rules – 注意：Scalewayはこれらのエンドポイントを文書化していますが、デプロイされたAPIはすべてのカスタムアラートルールメソッドに対してHTTP 501を返します（2026-08-18にライブ検証済み）。ツールは配置されており、そのエラーをそのまま表示します；Scalewayがバックエンドを出荷すれば動作するようになります。

監査証跡 – エクスポートジョブ（監査イベントをオブジェクトストレージバケットに送信）

• scaleway_audit_list_export_jobs、scaleway_audit_create_export_job、scaleway_audit_delete_export_job（確認用ガード付き。将来のエクスポートは停止しますが、既にエクスポートされたオブジェクトは削除しません）。

• アラート/エクスポートの書き込みツールでは、このサーバーの認証情報に AuditTrailReadOnly 以上の権限が必要です。権限エラーはそのまま表示されます。

スコープ

意図的に範囲を絞っています。IAM ID/ポリシー管理（アプリケーション、人間ユーザー、グループ）、SSHキー、JWT、SAML/SCIM/セキュリティ設定、バケットポリシー、バケットのライフサイクルと設定、オブジェクトストレージのオブジェクトCRUD（put/get/list/head/copy/delete/tags/プリサインドURL、シングルパートのみ）、および監査証跡（イベントクエリ、アラートルール、エクスポートジョブ）です。これらは、これまでのところ実際に問題が発生したためです。汎用的なScaleway APIラッパーではありません。コンピュート、データベース、コンテナ、マルチパートアップロード、バケットロギング/メトリクス（ScalewayのS3 APIはこれらを実装していません）、クォータ（実際のエンドポイントが見つかりませんでした - docs/gotchas.mdを参照）は含みません。将来的にこれらが繰り返し必要になった場合も、同様の方法で拡張してください。

開発

npm run dev     # tsc --watch
node scripts/smoke-test.mjs   # exercises real tool calls against the live account via .env - not automated CI