stackgate.ai
Log ind Opret profil
Alle integrationer

Fly.io

Forbind Claude, ChatGPT eller Cursor til Fly.io via MCP. Administrer apps, Machines, volumes, secrets, IP-adresser og certifikater med et org- eller deploy-token.

Manual setup 41 værktøjer

Eksempelspørgsmål

Prøv at spørge din AI-klient

  • Hvilke Fly-apps er i min personal-org lige nu?

  • Blev web-Machinen i ams startet færdig efter i nat?

  • Opsummér Machines der er stoppet eller fejler checks.

  • Skriv et udkast til en create_machine-plan for nginx i ams - opret den ikke.

  • Hvilke volumes og certifikater ser ubrugte eller udløbne ud?

Overblik

Forbind Fly.io, så AI-klienter kan administrere apps, Machines, volumes, secrets, IP-tildelinger og certifikater via Fly.io Machines API.

stackgate.ai gemmer dit access token krypteret og kalder https://api.machines.dev/v1 på dine vegne. Værktøjsresultater returneres til din AI-klient for den pågældende anmodning.

Forudsætninger

  • En Fly.io-konto
  • flyctl-CLI'en til at oprette tokens
  • En stackgate.ai-konto

Credentials

  1. Opret et scoped token med fly tokens create. Foretræk et org-token, et readonly-token eller et app deploy-token. Se fly tokens create.
  2. Kopiér tokenet som vist (ofte med præfikset FlyV1). Brug ikke fly auth token.
  3. På stackgate.ai, åbn Mine integrationer → Fly.io, indsæt tokenet, og klik Connect & enable.
  4. Vælg eventuelt en standardorganisation og app i dropdowns, eller spring over.

Behandl tokenet som en adgangskode. Tilbagekald eller rotér det med flyctl, hvis det er kompromitteret.

Efter forbindelsen kan du bruge Edit tool access til at holde hubben på Read-only, hvis tokenet kan skrive.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/fly-io med et Sanctum bearer-token
  • Private gateway: én konfiguration til alle integrationer - brug fly-io__*-navngivne værktøjer

Se Dokumentation for HTTP-autentificering og private gateway-opsætning.

Foreslået arbejdsgang

  1. get_current_token - bekræft tokenet og dets scope.
  2. list_regions - vælg en regionkode før opret-værktøjer.
  3. list_apps / get_app - find app-navne. org_slug falder tilbage til den gemte org eller personal.
  4. list_machines / get_machine - inspicér tilstand, region, image og checks.
  5. start_machine / stop_machine / suspend_machine / restart_machine / wait_machine - livscyklus.
  6. create_machine - kræver et container-image. Bekræft før exec_machine.
  7. list_volumes / create_volume - volumes er host-lokale; opret volumen før den Machine der monterer den.
  8. list_secrets / set_secret - udskriv aldrig secret-værdier, medmindre brugeren beder om det.
  9. list_ip_assignments / assign_ip og certifikatværktøjer - offentlig routing og TLS.
  10. list_postgres_clusters / get_postgres_cluster - inspicér managed Postgres. Denne server opretter eller roterer ikke clusters.

Fejlfinding

  • 422 integration not configured - indsæt et Fly.io-access-token i Mine integrationer.
  • 401 Unauthorized - opret et nyt org-, readonly- eller app deploy-token med fly tokens create og opdatér Mine integrationer. Indsæt ikke et fly auth token.
  • 403 Forbidden - tokenet kan være read-only, app-scopet til en anden app eller mangle tilladelse. Hubbens Read/Write-værktøjsadgang er adskilt fra Fly-tokenscope.
  • Missing org or app - sæt defaults på Fly.io-defaultsiden, eller send org_slug / app_name på værktøjskaldet.
  • 429 Too many requests - Fly begrænser Machine-actions til cirka 1 request pr. sekund. Poll ikke wait_machine i en tæt løkke.
  • Destructive actions - delete_app, delete_machine, delete_volume, remove_ip, delete_secret og exec_machine kan give nedetid. Bekræft hensigten, før du godkender Write-adgang.

Tilgængelige værktøjer

  • get_current_token

    Hent metadata for det forbundne Fly.io-access-token.

  • list_regions

    List Fly.io platform regions available for Machines and volumes.

  • list_apps

    List Fly-apps i en organisation.

  • get_app

    Get details for a Fly app, including organization slug and status.

  • create_app

    Create a Fly app. App names must be unique. Machines belong to an app.

  • delete_app

    Delete a Fly app. Stop Machines first, or set force to stop and delete immediately. This cannot be undone.

  • list_machines

    List Machines for en Fly-app.

  • get_machine

    Get a Fly Machine, including config, state, region, and image.

  • create_machine

    Opret en Fly Machine fra et container-image.

  • start_machine

    Start a stopped or suspended Fly Machine.

  • stop_machine

    Stop a Fly Machine without destroying it. Optional signal (default SIGINT) and timeout before SIGKILL.

  • suspend_machine

    Suspend a Fly Machine and snapshot memory. The next start tries to resume from the snapshot.

  • restart_machine

    Restart a Fly Machine.

  • wait_machine

    Wait until a Machine reaches a state. Default state is started. Do not poll this in a tight loop.

  • delete_machine

    Permanently delete a Fly Machine. This cannot be undone.

  • exec_machine

    Kør en kommando på en Fly Machine. Bekræft før kørsel.

  • list_machine_events

    List recent events for a Fly Machine.

  • list_machine_processes

    List processes running on a Fly Machine.

  • cordon_machine

    Stop routing public requests to a Fly Machine (useful for blue-green deploys).

  • uncordon_machine

    Resume routing public requests to a previously cordoned Fly Machine.

  • list_org_machines

    List Machines across all apps in an organization.

  • list_volumes

    List volumes for a Fly app.

  • get_volume

    Get a Fly volume by ID.

  • create_volume

    Create a Fly volume in a region. Volumes are host-local; create the volume before the Machine that will mount it.

  • extend_volume

    Increase a Fly volume size. size_gb is the new total size, not the increment.

  • delete_volume

    Destroy a Fly volume. Detach or destroy Machines using it first. This cannot be undone.

  • list_org_volumes

    List volumes across all apps in an organization.

  • list_secrets

    List secret names for a Fly app. Metadata only - do not echo values unless the user asks.

  • get_secret

    Get a Fly app secret by name. Avoid echoing the value unless the user asked for it.

  • set_secret

    Create or update a Fly app secret. Existing Machines must be updated or restarted to pick up new secrets.

  • delete_secret

    Delete a Fly app secret.

  • list_ip_assignments

    List IP addresses assigned to a Fly app.

  • assign_ip

    Assign an IP address to a Fly app so it can receive public traffic.

  • remove_ip

    Remove an IP assignment from a Fly app.

  • list_certificates

    List TLS certificates for a Fly app.

  • get_certificate

    Get TLS certificate details for a hostname on a Fly app.

  • request_acme_certificate

    Request an ACME certificate for a hostname on a Fly app.

  • check_certificate

    Check DNS and re-validate a Fly app certificate.

  • delete_certificate

    Remove a TLS certificate from a Fly app.

  • list_postgres_clusters

    List Fly Postgres clusters visible to the connected token.

  • get_postgres_cluster

    Get a Fly Postgres cluster by ID.

MCP-endpoint: https://stackgate.ai/mcp/fly-io (HTTP) eller via private gateway.

Opret konto Dokumentation