コーディングエージェント向けに、Sprites 上の試作から承認済み Fly アプリ上の Machine へ移す一連の操作を、単一のリモート MCP 接続に寄せる用途。接続先は https://mcp.fly.io で、API トークンの貼り付けは不要。同意画面で組織・対象アプリ・Sprites 権限だけを渡し、discovery は承認外のアプリや権限を返さない。

アカウントとコンテキスト(4 ツール):

  • get_fly_context … 接続に紐づくリソース束、スコープ、Sprites の name_prefix と max_sprites_total など作成制限を表示。付与の説明のみで権限は広げない。
  • list_organizations / get_organization … 明示的に許可したディレクトリ参照の範囲で組織 ID とロールを読む。
  • get_launch_requirements … 課金・SSO・プロバイダ条項などのブロッカー説明とブラウザハンドオフ。

Fly アプリとリソース(47 ツール):

  • Apps … list_apps / get_app / delete_app(削除は fly:apps:delete が必要)。
  • Machines … 一覧・ライフサイクル(起動・停止・再起動・サスペンド・シグナル・cordon/uncordon)、create_machine / delete_machine、exec_machine_command(argv 配列、シェル非暗黙)、リース、メタデータ、メモリ balloon、イベント・バージョン履歴など。機密設定の読取は fly:machines:sensitive:read、変更系は fly:machines:write / delete / exec など個別スコープ。
  • Volumes … CRUD、extend_volume、スナップショット一覧・作成(作成は非同期)。
  • App secrets … 名前・ダイジェストのみ返し値は返さない。update_app_secrets で null は削除(削除同意 fly:secrets:delete が追加で必要)。
  • ネットワーク … list_app_ips(fly:network:read)。TLS は list_app_certificates / get_app_certificate の読取のみ(書込ツールなし)。

Managed Postgres(15 ツール):

  • クラスタ作成・フォーク・プラン一覧、バックアップ、データベースと拡張、ユーザー一覧、アクティブ/スロークエリ、query_postgres_database(読取専用 SQL、5 秒タイムアウト、1000 行超は拒否、bigint/numeric は double 化の注意あり)。
  • FAQ 上、クラスタ削除・ユーザー/パスワード変更・パスワード返却は MCP から行わない。

Sprites(27 ツール):

  • ライフサイクル … list_sprites / create_sprite / destroy_sprite、メンション検索、Inspector、get_sprite_info(メタデータ読取はスリープ中 Sprite を起こさない)。
  • 実行 … exec / exec_list / exec_kill。
  • ファイル … read/write/list/delete/rename/copy(write は最大 16 MiB)。
  • サービスとログ … list/get/create/start/stop、service_logs。
  • チェックポイント … create/list/get/restore。
  • ネットワークポリシー … get/update。

ベータ時点で MCP に含まれないもの(FAQ):

  • Machine 設定の汎用更新、デプロイワークフロー、アプリ新規作成、その他プロダクトのプロビジョニング、組織管理全般。
  • 既存の Sprites 専用 MCP(https://sprites.dev/mcp)は従来どおりで、即時 deprecate 予定はない。

失効は Account → MCP Clients からクライアント単位で revoke。書込がタイムアウトした場合は完了有無を確認してから再実行。

#参考文献