Set up AIRO Connect in Claude Code
You can set up AIRO Connect in Claude Code using OAuth 2.0 or an API token.
Before you begin
You need a Workato account with AIRO access and Claude Code installed. API token authentication also requires a Workato API token. Refer to Create an API token for instructions.
Connect with OAuth 2.0
Complete the following steps to connect Claude Code to AIRO Connect using OAuth 2.0:
Open your terminal.
Run the following command to add AIRO Connect, using the URL for your data center:
claude mcp add --transport http workato-airo-mcp-server https://YOUR_DATA_CENTER/airo_mcpFor example, on the US data center, the URL is https://app.workato.com/airo_mcp.
Run the following command to start a new Claude Code session and open the /mcp panel:
claude /mcpUse the arrow keys to select workato-airo-mcp-server, then press Enter to confirm.
Press Enter on Authenticate.
Click Authorize in the browser window that opens, then close the tab and return to Claude Code.
Verify the connection by running /mcp again. workato-airo-mcp-server should appear with a connected status.
Confirm the server responds by prompting Claude Code. For example, List my Workato projects.
Refer to Claude Code's MCP documentation for more configuration options.
Connect with an API token
Complete the following steps to connect Claude Code to AIRO Connect using an API token:
Open your terminal.
Add the following line to your shell profile (~/.zshrc, ~/.bash_profile, or equivalent), replacing <YOUR_API_TOKEN> with the API token you generated:
export WORKATO_API_TOKEN="<YOUR_API_TOKEN>"Restart your terminal, or reload your profile:
source ~/.zshrc # or your shell's profile fileAdd the server, using the URL for your data center and referencing the environment variable in the authorization header:
claude mcp add --transport http workato-airo-mcp-server https://YOUR_DATA_CENTER/airo_mcp \
--header 'Authorization: Bearer ${WORKATO_API_TOKEN}'For example, on the US data center, the URL is https://app.workato.com/airo_mcp.
Use single quotes around the header. This stores the literal ${WORKATO_API_TOKEN} reference in your configuration, and Claude Code expands it when it connects.
Run the following command to start a new Claude Code session and open the /mcp panel:
claude /mcpworkato-airo-mcp-server should appear with a connected status.
Confirm the server responds by prompting Claude Code. For example, List my Workato projects.
Refer to Claude Code's MCP documentation for more configuration options.
Connect another workspace or environment
Add a separate AIRO Connect server entry to your client configuration for each workspace or environment you need to access at the same time, using a unique server name and a separate API token for every entry.
Claude Code caches the OAuth sign-in by server URL rather than by server name, so separate OAuth 2.0 entries to the same AIRO Connect URL share one sign-in and can't provide simultaneous access to more than one workspace or environment.
Repeat the steps in Connect with an API token, using a different server name in place of workato-airo-mcp-server and a different environment variable name in place of WORKATO_API_TOKEN for each entry.
Last updated: