Workato MCP Server

🤖 Workato MCP サーバー Cursor または Claude 用のモデルコンテキストプロトコル (MCP) サーバーとして設計された Workato API 統合ツールキットへようこそ。このプロジェクトは、カスタム AI ツールを通じて Workato の API とのシームレスなインタラクションを実現します。

✨ 機能 🔄 レシピ管理

• レシピの一覧表示、作成、開始、停止

• レシピ実行ジョブを監視する

• レシピフォルダとプロジェクトを管理する

🔌 接続管理

• 接続を一覧表示して作成する

• 接続の詳細とステータスを表示する

• 接続構成を管理する

🔍 コネクタの検出

• 利用可能なコネクタとその機能を一覧表示する

• コネクタのメタデータとサポートされている操作を表示する

• すべてのプラットフォームコネクタを参照

📂 フォルダとプロジェクトの整理

• フォルダの作成と管理

• レシピと接続を整理する

• プロジェクトレベルの構成を処理する

📊 アクティビティログ

• ワークスペース内のすべてのアクティビティを追跡する

• 時間範囲、ユーザー、イベントの種類でログをフィルタリングします

• リソースの変更とユーザーアクションを監視する

• 複数の環境（開発、サンドボックス、本番など）のサポート

• リソースとイベントの種類による高度なフィルタリング

🔖 タグ管理

• ワークスペースでタグを作成、更新、削除する

• 高度なフィルタリングオプションを使用して利用可能なタグを一覧表示および取得します

• アセット（レシピと接続）にタグを適用または削除する

• 複数のアセットとタグのバッチ操作をサポート

• タイトル、説明、作成者、使用状況でタグをフィルタリングします

• さまざまな基準（タイトル、使用回数など）でタグを並べ替えます

• カラーオプションでタグの外観をカスタマイズ

🚀 はじめに 2. インストール

npm install
# or
yarn install

3. サーバーを構築する

npm run build

4. Cursorへの追加 このプロジェクトは、CursorのMCPサーバーとして使用するように設計されています。設定方法は次のとおりです。

5. オープンカーソル

6. カーソル設定 > 機能 > MCP に移動します

7. + 新しいMCPサーバーを追加をクリック

8. フォームに記入してください:

   • 名前: Workato MCP サーバー

   • タイプ: stdio

   • コマンド: node /path/to/your/project/dist/server.js

   • 環境変数:

     • 「環境変数を追加」をクリックします

     • 名前: WORKATO_API_TOKEN

     • 値: your_token_here

📘 プロのヒント: プロジェクトのビルドされた server.js ファイルへのフルパスを使用します。

代替構成: プロジェクト内の.cursor/mcp.jsonファイルを使用して MCP サーバーを構成することもできます。

{
  "mcpServers": {
    "workato-tools": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "WORKATO_API_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Desktop での使用: Cursor の代わりに Claude Desktop を使用している場合は、Claude デスクトップ構成を編集して MCP サーバーを構成できます。

1. 構成ファイルを開くか作成します。

   # On macOS
   ~/Library/Application Support/Claude/claude_desktop_config.json
   # On Windows
   %APPDATA%\Claude\claude_desktop_config.json
   # On Linux
   ~/.config/Claude/claude_desktop_config.json

2. MCP サーバー構成を追加します。

   {
     "mcp_servers": {
       "workato-tools": {
         "command": "node",
         "args": ["/path/to/your/project/dist/server.js"],
         "env": {
           "WORKATO_API_TOKEN": "your_token_here"
         }
       }
     }
   }

3. ファイルを保存し、Claude Desktopを再起動して変更を有効にします。

この方法では次のことが可能になります。

• MCP 構成のバージョン管理

• 環境変数をconfigに直接含める

• チームメンバー間で同じ構成を共有する（機密値は除く）

• カーソルでプロジェクトを開くときにサーバーを自動的にロードする

🛠️ 利用可能なツール

レシピ管理:

• list-recipes: フィルタリングオプション付きのすべてのレシピを一覧表示します

• create-recipe: 新しいレシピを作成する

• start-recipe: 特定のレシピを開始する

• stop-recipe: 実行中のレシピを停止する

接続管理:

• list-connections: すべての接続を一覧表示する

• create-connection: 新しい接続を作成する

コネクタ ツール:

• list-connectors: 特定のコネクタのメタデータを取得する

• list-all-connectors: 利用可能なすべてのコネクタを一覧表示する

整理ツール:

• list-folders: すべてのフォルダを一覧表示する

• create-folder: 新しいフォルダを作成する

• update-folder: フォルダのプロパティを変更する

• list-projects: すべてのプロジェクトを一覧表示する

• update-project: プロジェクトの詳細を更新する

API 管理:

• list-api-endpoints: コレクションによるフィルタリングオプションを使用して、すべての API エンドポイントを一覧表示します。

アクティビティモニタリング:

• list-activity-logs: 高度なフィルタリングオプションを使用して詳細なアクティビティログを取得します

  • 時間範囲、ユーザー、イベントの種類でフィルタリング

  • 特定のリソースタイプを含めるか除外するか

  • 異なる環境間での変更を追跡する

  • ユーザーアクションとシステムイベントを監視する

タグ管理:

• list-tags: 高度なクエリオプションを使用して、ワークスペースで利用可能なタグを一覧表示およびフィルタリングします。

• create-tag: タイトル、説明、色をカスタマイズして新しいタグを作成する

• update-tag: 既存のタグのプロパティを変更する

• delete-tag: ワークスペースからタグを削除します

• manage-tags: レシピや接続にタグを適用または削除する

ジョブ管理:

• list-recipe-jobs: 特定のレシピのジョブを表示する

• get-job: 詳細な求人情報を取得する

• resume-job: 一時停止したジョブを再開する

🤝 貢献大歓迎です！お気軽にプルリクエストを送信してください。

📝 ライセンス このプロジェクトは MIT ライセンスに基づいてライセンスされています。詳細については、LICENSE ファイルを参照してください。

🐛 問題とサポート バグを見つけたり、サポートが必要な場合は、次の方法で問題を報告してください:

何をしようとしていたか 代わりに何が起こったか 再現手順 環境の詳細

Workatoの自動化のために、Jacob Gorenが❤️を込めて作成しました