How to connect Fly to Claude

Connect Claude Web, Desktop and Cowork to Fly MCP. Deploy latest image to fly in tokyo, list all running fly apps by region, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Fly

Api KeyOauth2

Fly.io transforms containers into micro-VMs running globally. Instantly deploy apps close to your users for low latency and high availability.

45 Tools

Managed auth

Connect Fly without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Fly account to Claude via Composio Connect, enabling it to deploy latest image to Fly in Tokyo, list all running Fly apps by region, scale up your Fly app to 3 instances, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Fly with

OpenAI Agents SDK Claude Agent SDK Claude Code Grok Bot Codex OpenClaw Hermes Atomic Agent Google ADK LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI Pydantic AI AutoGen

Connecting Fly to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash

https://connect.composio.dev/mcp

Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Fly account

Back in Claude, ask it to connect to Fly or give it any Fly-related task.

For example, ask Claude to:

"Deploy latest image to Fly in Tokyo"
"List all running Fly apps by region"
"Scale up your Fly app to 3 instances"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Fly account is ready to use.

What is the Fly Claude Connector, and what's possible with it?

The Fly MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Fly account. It provides structured and secure access so your agent can perform Fly operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Fly?

The connector can show as connected, but Claude must use it in each Fly conversation.

Click + at the lower left of the chat, or type /.
Hover Connectors.
Turn on Composio.
Ask Claude to connect to Fly again.

2. Why does Claude show an MCP server error before Fly connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Fly.

Check that the connector URL is https://connect.composio.dev/mcp.
Connectors run from Anthropic's cloud, so your device network is usually not the problem.
Add the connector again from Customize > Connectors, then ask Claude to connect Fly.
If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Fly authorization link not work?

The Composio connector is one server. Your Fly account connects separately when Claude asks for it.

If the browser does not open, or the link expires, ask Claude to retry the Fly connection.
Composio creates a fresh Fly authorization link.
Open that link in your browser and finish the Fly sign-in.

4. Why do Fly actions fail after they worked before?

The Fly connection can expire or lose permission.

Ask Claude to inspect the Fly connection.
If the connection is unhealthy, disconnect it when Claude prompts you.
Reconnect the Fly account and retry the action.
If Claude shows a permission prompt, approve it before Claude changes data in Fly.
If the action still fails with a permission error, check that the connected account has that permission in Fly itself.

5. How do I switch to a different Fly account?

Claude can manage the Fly connection for you.

Ask Claude to disconnect or delete the current Fly account.
Ask Claude to connect Fly again.
Open the new Composio authorization link for Fly.
Sign in with the other Fly account in the browser.
After the account connects, ask Claude to retry the Fly task.

6. Why is my Fly connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Fly connection works in Claude Web, Desktop, and Cowork.

In Claude Desktop, open Customize > Connectors.
Next to Composio, click ⋮ and click Clear cache.
If Fly tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Fly.

TOOLS

Supported Tools

Every Fly action and event your agent gets out of the box.

Add WireGuard Peer

Tool to add a WireGuard peer connection to a Fly.

Check App Name Availability

Tool to validate an app name for Fly.

Check Jobs

Execute GraphQL queries against the Fly.

Check User Only Token

Check whether the authentication token only allows user access.

Create Health Check Job

Tool to create a health check job for monitoring application endpoints in Fly.

Create Check Job Run

Triggers a run of an existing health check job on Fly.

Create Delegated WireGuard Token

Tool to create a delegated WireGuard token for peer management in a Fly.

Create Third-Party Configuration

Tool to create a third-party service configuration for discharging macaroon caveats.

Delete Delegated WireGuard Token

Tool to delete a delegated WireGuard token from a Fly.

Delete Organization

Tool to delete a Fly.

Delete Remote Builder

Tool to delete a remote builder configuration for a Fly.

Delete Third Party Configuration

Tool to delete a third-party service configuration from Fly.

Detach Postgres Cluster

Tool to detach a Postgres cluster from a Fly.

Establish SSH Key

Tool to establish an SSH key for a Fly.

Fetch Nodes by IDs

Fetches a list of node objects from Fly.

Get Add-On

Tool to find a Fly.

Get Add-On Provider

Tool to query information about a specific Fly.

Get app details

Tool to retrieve detailed information about a specific Fly.

Get Certificate

Tool to retrieve a certificate by its ID from Fly.

Get Current Token Info

Tool to get information about the current authentication token.

Get Latest Image Details

Tool to retrieve the latest available tag details for a given image repository from Fly.

Get Latest Image Tag

Tool to retrieve the latest available image tag for a Fly.

Get Machine

Tool to get a single machine by ID from Fly.

Get Nearest Region

Tool to retrieve the nearest Fly.

Get Node by ID

Tool to fetch an object by its globally unique ID using Fly.

Get Organization

Tool to find a Fly.

Get Personal Organization

Tool to retrieve the user's personal organization details from Fly.

Get Placements

Tool to get placement recommendations for Machines in Fly.

Get Platform Information

Tool to retrieve Fly.

Get Products and Pricing

Tool to retrieve Fly.

Get Regions

Tool to get the list of available Fly.

Get Viewer Info

Tool to retrieve the authenticated user's account information from Fly.

Issue Certificate

Tool to issue an SSH certificate for accessing Fly.

List Add-On Plans

Tool to list available add-on service plans from Fly.

List Add-Ons

Tool to list add-ons associated with an organization in Fly.

List Apps

Tool to list all Fly Apps in an organization.

List Apps via GraphQL

List all Fly.

Check Locations

Retrieve all available Fly.

List Machines

Tool to list Fly.

List Organization Machines

Tool to list all Machines across all apps in a Fly organization.

Remove WireGuard Peer

Tool to remove a WireGuard peer connection from a Fly.

Set Apps V2 Default

Tool to configure whether new apps in an organization use Apps V2 by default on Fly.

Update Third-Party Configuration

Tool to update an existing third-party service configuration for discharging macaroon caveats.

Validate Config

Tool to validate a Fly.

Validate WireGuard Peers

Tool to validate WireGuard peer IP addresses in a Fly.

FRAMEWORKS

How to build Fly MCP Agent with another framework

OpenAI Agents SDK

Use Fly MCP with OpenAI Agents SDK

Claude Agent SDK

Use Fly MCP with Claude Agent SDK

Claude Code

Use Fly MCP with Claude Code

Grok Bot

Use Fly MCP with Grok Bot

Codex

Use Fly MCP with Codex

OpenClaw

Use Fly MCP with OpenClaw

Hermes

Use Fly MCP with Hermes

Atomic Agent

Use Fly MCP with Atomic Agent

Google ADK

Use Fly MCP with Google ADK

LangChain

Use Fly MCP with LangChain

Vercel AI SDK

Use Fly MCP with Vercel AI SDK

Mastra AI

Use Fly MCP with Mastra AI

LlamaIndex

Use Fly MCP with LlamaIndex

CrewAI

Use Fly MCP with CrewAI

Pydantic AI

Use Fly MCP with Pydantic AI

AutoGen

Use Fly MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Supabase

Oauth2Api Key

Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure.

Codeinterpreter

No Auth

Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms.

GitHub

Oauth2

GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place.

1password

Api Key

1Password is a password manager and digital vault for storing logins, secrets, notes, and secure documents. It helps individuals and teams protect credentials, share access safely, and reduce password risk.

FAQ

Frequently asked questions

With a standalone Fly MCP server, the agents and LLMs can only access a fixed set of Fly tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Fly and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Fly tools.

Yes, absolutely. You can configure which Fly scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Fly data and credentials are handled as safely as possible.

Start with Fly.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Fly tool your agent needs.Free to start.

Start building