How to Use the Fly.io MCP in Claude

Q: How do I add the Fly.io MCP Server to Claude Desktop?

Open your claudedesktopconfig.json file and add the server configuration under the mcpServers key. Save the file, restart Claude Desktop, and look for the hammer icon in your chat window.

Q: How do I restart a crashed Fly.io worker node using Claude Desktop?

Tell Claude to find the stopped instance, and it will run startmachine to boot it. It verifies the new runtime state immediately so you know the worker is active.

Manage your Fly.io microVMs directly from your Claude Desktop chat interface using this lightweight MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Fly.io MCP to Claude Desktop

Create your Vinkius account to connect Fly.io to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Fly.io with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Control edge compute from Claude Desktop

This Fly.io MCP Server lets Claude Desktop manage your active Fly Machines on the fly. You ask the chat to scale up, and Claude fires off `create_machine` to spin up a new Firecracker VM in a chosen region. When traffic drops, you tell the chat to clean up, triggering `delete_machine` to instantly drop the Fly Machine and stop the billing clock. There is no need to jump back and forth to your terminal or log into the Fly dashboard to verify state. Claude reads the live setup using `list_machines` and displays exactly what is running, giving you instant infrastructure control right beside your Claude Desktop window.

Run remote diagnostics inside Claude Desktop

The `exec_machine` tool allows Claude Desktop to run shell commands inside your active Fly.io containers. Instead of manually SSHing into a failing instance, you ask Claude to check the process list or run database migrations. Your agent executes the command directly inside the Fly Machine and returns the exact stdout to your Claude Desktop chat window. You can pair this with `get_machine` to inspect the exact Docker image digest currently loaded into RAM. If a deployment gets stuck, Claude spots the mismatch and helps you debug the Fly.io container state without leaving the desktop app.

Manage persistent edge storage via Claude Desktop

The `list_volumes` tool gives Claude Desktop the ability to inspect NVMe storage drives attached to your Fly.io database apps. When configuring stateful apps like PostgreSQL or SQLite, your Claude Desktop agent checks these volumes to ensure data persists across Fly Machine restarts. If a volume is running out of space, you command Claude to inspect the app state via `get_app` to find the internal Wireguard range. This ensures your Fly.io storage configuration matches your network routing before you run any scaling actions inside Claude Desktop.

Setup guide

Set up Fly.io MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Fly.io MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Fly.io MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under flyio-mcp.

json

{
  "mcpServers": {
    "flyio-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Fly.io. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Fly.io now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Fly.io MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the server configuration under the `mcpServers` key. Save the file, restart Claude Desktop, and look for the hammer icon in your chat window.

Yes, you configure the server as a custom connector in your claude.ai integration settings. Paste your secure Vinkius URL, authenticate, and your browser-based agent gets immediate access to your edge machines.

Yes, the desktop client executes shell commands inside your active microVMs using this specific tool. It handles the connection securely through the Vinkius gateway without exposing your local terminal.

Tell Claude to find the stopped instance, and it will run `start_machine` to boot it. It verifies the new runtime state immediately so you know the worker is active.

This setup only transmits Fly.io API tokens and raw machine configuration payloads. Your actual database contents and disk volumes remain isolated on Fly's secure edge network, never passing through the LLM.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript