コーディングエージェント向けに、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。書込がタイムアウトした場合は完了有無を確認してから再実行。