Before you begin
To connect Air with Claude, you need a few things ready:
Access to a Business or Enterprise Air workspace
An Air API key generated by a workspace owner or admin
Claude Desktop installed on your device
Retrieving your Air workspace details
API Access is available in Workspace Settings for eligible Business and Enterprise workspaces to workspace owners and admins. Follow these steps to retrieve your API key and Workspace ID from Air. You'll need both to set up the connection in Claude Desktop:
Navigate to your Air Workspace Settings and find 'API Access' on the left hand side of the screen under My Account. This option appears for eligible Business and Enterprise workspaces when you're a workspace owner or admin.
Under API Keys, generate a new API key. Keep this key secure and do not share it.
Under Workspace IDs, retrieve your Workspace ID.
Finding Your Config File
In order to set up Air's MCP server for Claude Desktop, you'll need to find Claude's config file - usually located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS.
To locate this file, open finder and start from the root directory of your laptop (CMD + Shift + H):
To reveal the Library folder, hit CMD + Shift + . - this will reveal all hidden folders in your home directory:
After that, you should see Library -> Application Support -> Claude - this is where the claude config file is located:
You can open this file in your preferred text editor, and paste in the following code snippet, pasting in your retrieved workspace ID and API key:
{ "mcpServers": { "air": { "command": "npx", "args": ["-y", "@air/mcp"], "env": { "AIR_API_KEY": "your-api-key", "AIR_WORKSPACE_ID": "your-workspace-id" } } } }
Afterwards, your Claude config should look something like this:
After this, you should be able to verify Air is connected by running a simple query, i.e. "How many uploads has my workspace have in the last week?"
nvm users: Claude Desktop doesn't load your shell profile, so it may use the wrong Node version. If you get engine errors, use the full path to a Node 20+ npx instead:
JSON
"command": "/Users/you/.nvm/versions/node/v20.19.4/bin/npx"
Find your path with nvm which 20 in a terminal.
See Claude Desktop MCP docs for more details.