Are you an LLM? You can read better optimized documentation at /ja/airo/mcp.md for this page in Markdown format
AIRO MCPサーバー このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。 AIRO MCPサーバーは、Claude Code、Claude Desktop、Cursor、ChatGPTなどのMCP互換AIクライアントにWorkato AIROのプラットフォーム機能全体を公開します。 これにより、自然言語を使用して、AI Development Environmentから直接、レシピの構築、Genieの管理、MCPサーバーの作成、Data tablesのクエリ、ワークスペースアセットの管理を実行できます。
MCPサーバーとしてのAIRO
仕組み AIRO MCPサーバーはWorkato APIトークンで認証します。 このトークンは、AIRO MCP機能が有効化されたAPIクライアントから取得されます。 MCPクライアント構成に追加して接続すると、サーバーは次のカテゴリに整理されたツールを公開します。
カテゴリ 実行できること レシピ ステップレベルの操作、フィールドマッピング、条件、コネクションを含む、レシピの作成、編集、検索、管理 スキルとMCP レシピをスキルに変換し、MCPサーバーを作成または管理する Genieとナレッジベース Genieの作成と設定、ナレッジベースの管理、ナレッジソースの割り当て ブループリントとアセット ブループリント、アセットマップ、アセットメタデータを操作する データ Data tablesとルックアップ テーブルをクエリする ジョブとテスト ジョブ履歴を調査し、テストケースを管理する 管理 プロジェクト、フォルダ、コラボレーター、OAuthプロファイル、オンプレミスグループ、Event streamsを管理する
MCPクライアント内でhelpツールを使用すると、入力スキーマや利用ガイダンスなど、特定のツールに関する詳細情報を取得できます。
AIRO MCPサーバーはWorkatoアカウント権限に従います。 MCPサーバーを通じて実行されるアクションは、Workatoプラットフォームで実行されるアクションと同じアクセス制御に従います。
前提条件 AIRO MCPサーバーを設定する前に、次のものが必要です:
AIROアクセス権を持つWorkatoアカウント MCP互換クライアントがインストールされていること(Claude Code、Claude Desktop、Cursor、ChatGPT、または別のMCPクライアント) Node.js がインストールされ、PATHで使用できること。 ターミナルでnode -vを実行して、インストールを確認します。AIRO MCP機能が有効化されたWorkato APIトークン。 詳細はAPIトークンの生成 を参照してください。 APIトークンを生成する AIRO MCPサーバーには、AIRO MCP機能が有効化されたAPIクライアントから発行されたAPIトークンが必要です。
トークンを生成するには、次の手順を実行します。
2
ワークスペース管理者>APIクライアント>クライアントロール に移動します。
4
ロールのAIRO MCP 機能を有効化します。
クライアントロールのAIRO MCP機能を有効化する
トークンをMCP構成に追加するときは、先頭にBearerを付けます。 例:Bearer wrkaus-xxxxxxxxxxxxxxxxxx。
AIRO MCPサーバーを接続する 次の手順を完了して、AIRO MCPサーバーをMCPクライアントに接続します。
2
APIトークンをプレーンテキストで構成ファイルに書き込まないようにするには、Environment変数に保存します。
bash export WORKATO_API_TOKEN = "<YOUR_API_TOKEN>" 3
AuthorizationヘッダーのEnvironment変数を参照して、サーバーを追加します。
bash claude mcp add --transport http workato-airo-mcp-server https://app.workato.com/airo_mcp \
--header 'Authorization: Bearer ${WORKATO_API_TOKEN}' ヘッダーを一重引用符で囲みます。 これにより、リテラル${WORKATO_API_TOKEN}参照が構成に保存され、Claude Codeが接続時に展開します。
4
新しいClaude Codeセッションを開始します。
5
Claude Codeで/mcpを実行して、コネクションを確認します。 workato-airo-mcp-serverが接続済みステータスで表示されます。
6
Claude Codeにプロンプトを入力して、サーバーが応答することを確認します。 例:List my Workato projects.
その他の構成オプションについては、Claude CodeのMCPドキュメント を参照してください。
2
Settings(設定)>Developer(開発者) に移動し、Edit Config(構成を編集) をクリックしてclaude_desktop_config.jsonを開きます。 ファイルを直接開くこともできます。
macOS:~/Library/Application Support/Claude/claude_desktop_config.json Windows:%APPDATA%\Claude\claude_desktop_config.json 3
次の構成を追加し、<YOUR_API_TOKEN>を生成したトークンに置き換えます。
json {
"mcpServers" : {
"workato-airo-mcp-server" : {
"command" : "npx" ,
"args" : [
"mcp-remote" ,
"https://app.workato.com/airo_mcp" ,
"--transport" ,
"http-first" ,
"--header" ,
"Authorization:${AUTH_HEADER}"
],
"env" : {
"AUTH_HEADER" : "Bearer <YOUR_API_TOKEN>"
}
}
}
} 5
Claude Desktopを再起動し、新しいチャットを開始します。 サーバーが接続されない場合は、Settings(設定)>Developer(開発者) でステータスを確認します。
6
Claudeにプロンプトを入力して、サーバーが応答することを確認します。 例:List my Workato projects.
1
Cursor MCP構成ファイルを開きます。 すべてのプロジェクトに対して直接編集するか、プロジェクトルートの.cursor/mcp.jsonを使用して、サーバーのスコープをそのプロジェクトに限定します。
macOSおよびLinux:~/.cursor/mcp.json Windows:%USERPROFILE%\.cursor\mcp.json CursorデスクトップアプリのCustomize(カスタマイズ) ページから、MCPs>+ New(新規) を選択してファイルを開くこともできます。
2
次の構成を追加し、<YOUR_API_TOKEN>を生成したトークンに置き換えます。
json {
"mcpServers" : {
"workato-airo-mcp-server" : {
"url" : "https://app.workato.com/airo_mcp" ,
"headers" : {
"Authorization" : "Bearer <YOUR_API_TOKEN>"
}
}
}
} 4
コネクションを確認します。 Customize(カスタマイズ) ページでMCPs を選択し、サーバーがツールおよびリソースとともに表示されることを確認します。
5
新しいチャットを開始し、Cursorエージェントにプロンプトを入力して、サーバーが応答することを確認します。 例:List my Workato projects.
新しいチャットを開始
変更を保存した後、エージェントで新しいチャットを開始します。 Cursor agentは、チャットの開始時に利用可能なツールと機能にのみアクセスできます。 チャットの開始後に追加されたMCP設定、サーバー、ツールを、エージェントは検出または使用できません。
その他の構成オプションについては、CursorのMCPドキュメント を参照してください。
ChatGPTでリモートMCPサーバーに接続するには、Developer mode(開発者モード) が必要です。 Developer mode(開発者モード)は、ChatGPTにAIROツールへの読み取りおよび書き込みアクセス権を付与します。 OpenAIはdeveloper mode(開発者モード)をリスクが高い高度な機能として分類しているため、有効化する前にdeveloper modeガイド を参照してください。
1
WebでPro、Plus、Business、Enterprise、またはEducationアカウントを使用してChatGPTにサインインします。 Developer mode(開発者モード)はデスクトップアプリまたはモバイルアプリでは使用できません。
2
Settings(設定)>Apps(アプリ)>Advanced settings(詳細設定) に移動し、Developer mode(開発者モード) をオンにします。
3
Create app をクリックします。 このボタンは、developer mode(開発者モード)をオンにすると表示されます。
4
Name(名前) フィールドにworkato-airo-mcp-serverと入力します。
5
Connection(コネクション) フィールドで、サーバーURLをhttps://app.workato.com/airo_mcpに設定します。
6
Authentication(認証) フィールドで、Header scheme(ヘッダースキーム) をBearer に設定します。
7
I understand and want to continue(理解したうえで続行します) チェックボックスを選択し、Create(作成) をクリックします。
8
Enter access token or API key(アクセストークンまたはAPIキーを入力) フィールドにAPIトークンを入力し、Connect(接続) をクリックします。
9
新しい会話でアプリを試して、コネクションを確認します。
2
メッセージ作成ツールの近くにある+ ボタンをクリックし、使用可能なツールのリストからアプリを選択して会話コンテキストに追加します。
3
モデルにアプリを使用するようプロンプトを入力します。 例:List my Workato projects.
ユースケース 次の例は、AIRO MCPサーバーでの一般的なワークフローを示しています。
レシピを構築してテストする AIROを使用して自然言語の説明から複数ステップのレシピを作成し、Development Environmentを離れずに保存してテストします。
Create a recipe that syncs new Salesforce opportunities to Jira issues.
Add an OpenAI step to summarize the opportunity before creating the Jira issue.
Save the recipe and show me the test cases. ナレッジソースを使用してGenieを作成する Genieをセットアップし、関連するナレッジベースに接続して、ドメイン固有の質問に回答できるようにします。
"Sales Intelligence"という新しいGenieを作成し、CRMナレッジベースを割り当てます。 MCPサーバーを構築する ワークスペースアセットからMCPサーバーを作成し、他のAIクライアントがツールに接続できるようにします。
Build an MCP server called "Sales Tools" using the lead enrichment and deal scoring skills from the Sales Automation project. ジョブの失敗を調査する 最近のジョブ履歴を調査して、プロダクションレシピのエラーを診断します。
List the last 10 jobs for recipe 1555928 and show me any errors. ワークスペースデータをクエリする Data tablesとルックアップ テーブルのレコードを検索し、データの確認やデバッグをサポートします。
Query the customer onboarding data table for records where status is "blocked". ワークスペースアクセスを管理する ワークスペース全体のプロジェクト権限とコラボレーターアクセスを確認します。
List all projects and show which collaborators have access to the Finance Automation project.