MCPサーバー

これらのリソースを使用して、カスタマーワークスペース内のMCP（Model Context Protocol）サーバーをプログラムで管理します。

クイックリファレンス

タイプ	リソース	説明
GET	/api/managed_users/:managed_user_id/ mcp_servers	顧客ワークスペース内のMCPサーバーを一覧表示します。
POST	/api/managed_users/:managed_user_id/ mcp_servers	顧客ワークスペース内にMCPサーバーを作成します。
GET	/api/managed_users/:managed_user_id/ mcp_servers/:handle	顧客ワークスペース内のMCPサーバーの詳細を取得します。
PUT	/api/managed_users/:managed_user_id/ mcp_servers/:handle	顧客ワークスペース内のMCPサーバーを更新します。
DELETE	/api/managed_users/:managed_user_id/ mcp_servers/:handle	顧客ワークスペース内のMCPサーバーを削除します。
POST	/api/managed_users/:managed_user_id/ mcp_servers/:handle/token_renew	顧客ワークスペース内のMCPサーバー認証トークンを更新します。
POST	/api/managed_users/:managed_user_id/ mcp_servers/:handle/assign_tools	顧客ワークスペース内のMCPサーバーにツールを割り当てます。
POST	/api/managed_users/:managed_user_id/ mcp_servers/:handle/assign_user_groups	顧客ワークスペース内のMCPサーバーにユーザーグループを割り当てます。
POST	/api/managed_users/:managed_user_id/ mcp_servers/:handle/remove_user_groups	顧客ワークスペース内のMCPサーバーからユーザーグループを削除します。
PUT	/api/managed_users/:managed_user_id/ mcp_servers/:handle/update_folder	顧客ワークスペース内のMCPサーバーを別のフォルダに移動します。
GET	/api/managed_users/:managed_user_id/ mcp_servers/:mcp_server_handle/server_policies	カスタマーワークスペース内のサーバーポリシー設定を取得します。
PUT	/api/managed_users/:managed_user_id/ mcp_servers/:mcp_server_handle/server_policies	カスタマーワークスペース内のサーバーポリシー設定を更新します。
GET	/api/managed_users/:managed_user_id/ mcp_servers/:mcp_server_handle/tools	顧客ワークスペース内のMCPサーバーのツールを一覧表示します。
PUT	/api/managed_users/:managed_user_id/ mcp_servers/:mcp_server_handle/tools/:id	カスタマーワークスペース内のツールの説明を更新します。
DELETE	/api/managed_users/:managed_user_id/ mcp_servers/:mcp_server_handle/tools/:id	顧客ワークスペース内のツールを削除します。
GET	/api/managed_users/:managed_user_id/ user_groups	顧客ワークスペース内のIDプロバイダーユーザーグループを一覧表示します。

カスタマーワークスペース内のMCPサーバーのリスト表示

カスタマーワークスペース内のMCPサーバーのリストを返します。

shell

GET /api/managed_users/:managed_user_id/mcp_servers

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。

クエリパラメーター

名前	タイプ	説明
project_id	number optional	プロジェクトIDでフィルタリングします。
folder_id	number optional	フォルダIDでフィルタリングします。
authentication_method	string 任意	認証方法でフィルタリングします。受け入れられる値: `token`、`workato_idp`。
page	number optional	ページ番号。デフォルトは1です。
per_page	number optional	ページごとの項目数。最大値は50です。

サンプルリクエスト

shell

curl  -X GET 'https://www.workato.com/api/managed_users/91829/mcp_servers?folder_id=27180380' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

json

{
    "data": [
        {
            "id": 1001,
            "name": "Sales Tools MCP Server",
            "description": "Provides CRM and deal management tools for AI clients",
            "folder_id": 27180380,
            "project_id": 13595198,
            "authentication_method": "token",
            "tools_count": 5
        },
        {
            "id": 1002,
            "name": "HR Automation Server",
            "description": "HR onboarding and employee management tools",
            "folder_id": 27180380,
            "project_id": 13595198,
            "authentication_method": "workato_idp",
            "tools_count": 3
        }
    ],
    "count": 2,
    "page": 1,
    "per_page": 50
}

カスタマーワークスペース内でのMCPサーバーの作成

カスタマーワークスペース内に新しいMCPサーバーを作成します。

shell

POST /api/managed_users/:managed_user_id/mcp_servers

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。

ペイロード

名前	タイプ	説明
name	string 必須	サーバー名。
folder_id	number 必須	MCPサーバーのフォルダID。
説明	string 任意	サーバーの説明。
asset_id	number optional	APIコレクションID。プロジェクトアセットサーバーを作成する場合は省略します。
tools	array of objects optional	作成時にサーバーに割り当てるツール。各オブジェクトには`trigger_application`（string）と`id`（string）が必要です。 `workato_recipe_function`および`workato_api_platform`ツールを使用する場合、`id`は数値です。 `workato_genie`ツールを使用する場合、`id`は文字列ハンドルです。

サンプルリクエスト

shell

curl  -X POST 'https://www.workato.com/api/managed_users/91829/mcp_servers' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "name": "Sales Tools MCP Server",
            "description": "Provides CRM and deal management tools for AI clients",
            "folder_id": 27180380,
            "tools": [
              {
                "trigger_application": "workato_api_platform",
                "id": "98231"
              }
            ]
          }'

サンプルレスポンス

json

{
    "data": {
        "id": 1001,
        "name": "Sales Tools MCP Server",
        "description": "Provides CRM and deal management tools for AI clients",
        "asset_type": "api_collection",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 1,
        "mcp_url": "https://www.workato.com/mcp/servers/sales-tools-mcp-server?token=abc123xyz",
        "auth_type": "token",
        "idp_user_group_ids": [],
        "api_collection": null,
        "created_at": "2025-10-15T13:41:05.207-07:00",
        "updated_at": "2025-10-15T13:41:05.207-07:00"
    }
}

カスタマーワークスペース内のMCPサーバー詳細の取得

カスタマーワークスペース内の特定のMCPサーバーの詳細を取得します。

shell

GET /api/managed_users/:managed_user_id/mcp_servers/:handle

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。

サンプルリクエスト

shell

curl  -X GET 'https://www.workato.com/api/managed_users/91829/mcp_servers/sales-tools-mcp-server' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

json

{
    "data": {
        "id": 1001,
        "name": "Sales Tools MCP Server",
        "description": "Provides CRM and deal management tools for AI clients",
        "asset_type": "api_collection",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 5,
        "mcp_url": "https://www.workato.com/mcp/servers/sales-tools-mcp-server?token=abc123xyz",
        "auth_type": "token",
        "idp_user_group_ids": [],
        "api_collection": null,
        "created_at": "2025-10-15T13:41:05.207-07:00",
        "updated_at": "2025-10-16T09:22:11.100-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーの更新

カスタマーワークスペース内の既存のMCPサーバーを更新します。

shell

PUT /api/managed_users/:managed_user_id/mcp_servers/:handle

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。

ペイロード

名前	タイプ	説明
name	string 任意	サーバー名。
説明	string 任意	サーバーの説明。
auth_type	string 任意	認証タイプ。受け入れられる値: `token`、`workato_idp`。
idp_user_group_ids	array of strings optional	サーバーにアクセスできるIDプロバイダーユーザーグループID。 `auth_type`が`workato_idp`の場合にのみ適用されます。
folder_id	number optional	サーバーの移動先フォルダID。

サンプルリクエスト

shell

curl  -X PUT 'https://www.workato.com/api/managed_users/91829/mcp_servers/sales-tools-mcp-server' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "name": "Sales & CRM Tools MCP Server",
            "description": "Provides CRM, deal management, and pipeline tools for AI clients",
            "auth_type": "token"
          }'

サンプルレスポンス

json

{
    "data": {
        "id": 1001,
        "name": "Sales & CRM Tools MCP Server",
        "description": "Provides CRM, deal management, and pipeline tools for AI clients",
        "asset_type": "api_collection",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 5,
        "mcp_url": "https://www.workato.com/mcp/servers/sales-tools-mcp-server?token=abc123xyz",
        "auth_type": "token",
        "idp_user_group_ids": [],
        "api_collection": null,
        "created_at": "2025-10-15T13:41:05.207-07:00",
        "updated_at": "2025-10-17T11:05:33.812-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーの削除

カスタマーワークスペース内のMCPサーバーを削除します。

shell

DELETE /api/managed_users/:managed_user_id/mcp_servers/:handle

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。

サンプルリクエスト

shell

curl  -X DELETE 'https://www.workato.com/api/managed_users/91829/mcp_servers/sales-tools-mcp-server' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

成功時に204 No Contentを返します。

カスタマーワークスペース内のMCPサーバー認証トークンの更新

カスタマーワークスペース内のMCPサーバー用の新しい認証トークンを生成し、以前のトークンを無効にします。セキュリティイベント後、または定期的な認証情報ローテーションポリシーの一環として、認証情報をローテーションするためにこのエンドポイントを使用します。

shell

POST /api/managed_users/:managed_user_id/mcp_servers/:handle/token_renew

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。

サンプルリクエスト

shell

curl  -X POST 'https://www.workato.com/api/managed_users/91829/mcp_servers/sales-tools-mcp-server/token_renew' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

更新されたトークンを含む新しいmcp_urlを持つ、更新済みのMCPサーバーオブジェクトを返します。

json

{
    "data": {
        "id": 1001,
        "name": "Sales & CRM Tools MCP Server",
        "description": "Provides CRM, deal management, and pipeline tools for AI clients",
        "asset_type": "api_collection",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 5,
        "mcp_url": "https://www.workato.com/mcp/servers/sales-tools-mcp-server?token=newtoken789",
        "auth_type": "token",
        "idp_user_group_ids": [],
        "api_collection": null,
        "created_at": "2025-10-15T13:41:05.207-07:00",
        "updated_at": "2025-10-18T08:00:00.000-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーへのツールの割り当て

カスタマーワークスペース内のMCPサーバーに1つ以上のツールを割り当てます。サーバーにすでに割り当てられているツールは重複されません。

shell

POST /api/managed_users/:managed_user_id/mcp_servers/:handle/assign_tools

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。

ペイロード

名前	タイプ	説明
tools	オブジェクトの配列必須	割り当てるツール。各オブジェクトには`trigger_application`（string）と`id`（string）が必要です。

サンプルリクエスト

shell

curl  -X POST 'https://www.workato.com/api/managed_users/91829/mcp_servers/sales-tools-mcp-server/assign_tools' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "tools": [
              {
                "trigger_application": "workato_api_platform",
                "id": "98232"
              },
              {
                "trigger_application": "workato_genie",
                "id": "my-genie-handle"
              }
            ]
          }'

サンプルレスポンス

更新済みのMCPサーバーオブジェクトを返します。

json

{
    "data": {
        "id": 1001,
        "name": "Sales & CRM Tools MCP Server",
        "description": "Provides CRM, deal management, and pipeline tools for AI clients",
        "asset_type": "api_collection",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 7,
        "mcp_url": "https://www.workato.com/mcp/servers/sales-tools-mcp-server?token=newtoken789",
        "auth_type": "token",
        "idp_user_group_ids": [],
        "api_collection": null,
        "created_at": "2025-10-15T13:41:05.207-07:00",
        "updated_at": "2025-10-18T09:15:22.000-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーへのユーザーグループの割り当て

カスタマーワークスペース内のMCPサーバーにIDプロバイダーのユーザーグループを割り当てます。サーバーのauth_typeがworkato_idpの場合にのみ適用されます。

shell

POST /api/managed_users/:managed_user_id/mcp_servers/:handle/assign_user_groups

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。

ペイロード

名前	タイプ	説明
idp_user_group_ids	文字列の配列必須	追加するユーザーグループのID。

サンプルリクエスト

shell

curl  -X POST 'https://www.workato.com/api/managed_users/91829/mcp_servers/hr-automation-server/assign_user_groups' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "idp_user_group_ids": ["group-abc123", "group-def456"]
          }'

サンプルレスポンス

割り当てられたユーザーグループIDがidp_user_group_idsに反映された、更新済みのMCPサーバーオブジェクトを返します。

json

{
    "data": {
        "id": 1002,
        "name": "HR Automation Server",
        "description": "HR onboarding and employee management tools",
        "asset_type": "project_asset",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 3,
        "mcp_url": "https://www.workato.com/mcp/servers/hr-automation-server?token=hrtoken456",
        "auth_type": "workato_idp",
        "idp_user_group_ids": ["group-abc123", "group-def456"],
        "api_collection": null,
        "created_at": "2025-10-15T10:00:00.000-07:00",
        "updated_at": "2025-10-18T10:30:00.000-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーからのユーザーグループの削除

カスタマーワークスペース内のMCPサーバーからIDプロバイダーのユーザーグループを削除します。

shell

POST /api/managed_users/:managed_user_id/mcp_servers/:handle/remove_user_groups

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。

ペイロード

名前	タイプ	説明
idp_user_group_ids	文字列の配列必須	削除するユーザーグループのID。

サンプルリクエスト

shell

curl  -X POST 'https://www.workato.com/api/managed_users/91829/mcp_servers/hr-automation-server/remove_user_groups' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "idp_user_group_ids": ["group-abc123"]
          }'

サンプルレスポンス

指定されたグループがidp_user_group_idsから削除された、更新済みのMCPサーバーオブジェクトを返します。

json

{
    "data": {
        "id": 1002,
        "name": "HR Automation Server",
        "description": "HR onboarding and employee management tools",
        "asset_type": "project_asset",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 3,
        "mcp_url": "https://www.workato.com/mcp/servers/hr-automation-server?token=hrtoken456",
        "auth_type": "workato_idp",
        "idp_user_group_ids": ["group-def456"],
        "api_collection": null,
        "created_at": "2025-10-15T10:00:00.000-07:00",
        "updated_at": "2025-10-18T11:00:00.000-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーの別フォルダへの移動

カスタマーワークスペース内のMCPサーバーを指定したフォルダに移動します。

shell

PUT /api/managed_users/:managed_user_id/mcp_servers/:handle/update_folder

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。

ペイロード

名前	タイプ	説明
folder_id	number 必須	移動先フォルダID。

サンプルリクエスト

shell

curl  -X PUT 'https://www.workato.com/api/managed_users/91829/mcp_servers/hr-automation-server/update_folder' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "folder_id": 27180399
          }'

サンプルレスポンス

新しいフォルダを反映した、更新済みのMCPサーバーオブジェクトを返します。

json

{
    "data": {
        "id": 1002,
        "name": "HR Automation Server",
        "description": "HR onboarding and employee management tools",
        "asset_type": "project_asset",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 3,
        "mcp_url": "https://www.workato.com/mcp/servers/hr-automation-server?token=hrtoken456",
        "auth_type": "workato_idp",
        "idp_user_group_ids": ["group-def456"],
        "api_collection": null,
        "created_at": "2025-10-15T10:00:00.000-07:00",
        "updated_at": "2025-10-18T12:00:00.000-07:00"
    }
}

カスタマーワークスペース内のサーバーポリシー設定の取得

MCPサーバーのセキュリティポリシー設定を取得します。これには、レート制限、クォータ制限、Classless Inter-Domain Routing（CIDR）、およびIPアドレスが含まれます。

shell

GET /api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/server_policies

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。

サンプルリクエスト

shell

curl  -X GET 'https://www.workato.com/api/managed_users/91829/mcp_servers/sales-tools-mcp-server/server_policies' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

json

{
    "id": 501,
    "mcp_server_id": 1001,
    "rate_limits": {
        "per_minute": 60
    },
    "quota_limits": {
        "per_day": 10000
    },
    "ip_allow_list": ["203.0.113.0/24"],
    "ip_deny_list": [],
    "created_at": "2025-10-15T13:41:05.207-07:00",
    "updated_at": "2025-10-16T09:22:11.100-07:00"
}

カスタマーワークスペース内のサーバーポリシー設定の更新

カスタマーワークスペース内のMCPサーバーのセキュリティポリシー設定を更新します。

shell

PUT /api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/server_policies

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。

ペイロード

名前	タイプ	説明
mcp_server_policy	object required	ポリシー設定オブジェクト。
mcp_server_policy[rate_limits]	object optional	レート制限設定。
mcp_server_policy[quota_limits]	object optional	クォータ制限設定。
mcp_server_policy[ip_allow_list]	array of strings optional	許可するIPアドレスまたはCIDR範囲。
mcp_server_policy[ip_deny_list]	array of strings optional	拒否するIPアドレスまたはCIDR範囲。

サンプルリクエスト

shell

curl  -X PUT 'https://www.workato.com/api/managed_users/91829/mcp_servers/sales-tools-mcp-server/server_policies' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "mcp_server_policy": {
              "rate_limits": { "per_minute": 30 },
              "quota_limits": { "per_day": 5000 },
              "ip_allow_list": ["203.0.113.0/24", "198.51.100.42"],
              "ip_deny_list": []
            }
          }'

サンプルレスポンス

json

{
    "id": 501,
    "mcp_server_id": 1001,
    "rate_limits": {
        "per_minute": 30
    },
    "quota_limits": {
        "per_day": 5000
    },
    "ip_allow_list": ["203.0.113.0/24", "198.51.100.42"],
    "ip_deny_list": [],
    "created_at": "2025-10-15T13:41:05.207-07:00",
    "updated_at": "2025-10-18T14:00:00.000-07:00"
}

カスタマーワークスペース内のMCPサーバーのツールのリスト表示

カスタマーワークスペース内のMCPサーバーに割り当てられたツールのページ分割されたリストを返します。

shell

GET /api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。

クエリパラメーター

名前	タイプ	説明
vua_required	boolean optional	VUA（Verified User Authentication）が必要かどうかでフィルタリングします。
search	string 任意	ツールを名前でフィルタリングする検索語句。
page	number optional	ページ番号。デフォルトは1です。
per_page	number optional	ページごとの項目数。デフォルトは100です。最大は100です。

サンプルリクエスト

shell

curl  -X GET 'https://www.workato.com/api/managed_users/91829/mcp_servers/sales-tools-mcp-server/tools' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

json

{
    "data": [
        {
            "id": 3001,
            "name": "Create Salesforce Lead",
            "description": "Creates a new lead record in Salesforce CRM",
            "trigger_application": "workato_api_platform",
            "action_applications": ["salesforce"],
            "flow_id": 66870001,
            "vua_required": false
        },
        {
            "id": 3002,
            "name": "Send Deal Notification",
            "description": "Sends a Slack notification when a deal stage changes",
            "trigger_application": "workato_recipe_function",
            "action_applications": ["slack"],
            "flow_id": 66870002,
            "vua_required": true
        }
    ],
    "count": 2,
    "page": 1,
    "per_page": 100
}

カスタマーワークスペース内のツールの説明の更新

カスタマーワークスペース内のMCPサーバー内にあるツールの説明を更新します。基盤となるレシピやAPIエンドポイントに影響を与えずに、AIクライアントに表示される説明を変更します。

shell

PUT /api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools/:id

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。
id	number 必須	ツールID。

ペイロード

名前	タイプ	説明
説明	string 任意	ツールの新しい説明。

サンプルリクエスト

shell

curl  -X PUT 'https://www.workato.com/api/managed_users/91829/mcp_servers/sales-tools-mcp-server/tools/3001' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "description": "Creates a new lead record in Salesforce CRM with name, email, and company details"
          }'

サンプルレスポンス

json

{
    "id": 3001,
    "name": "Create Salesforce Lead",
    "description": "Creates a new lead record in Salesforce CRM with name, email, and company details",
    "trigger_application": "workato_api_platform",
    "action_applications": ["salesforce"],
    "flow_id": 66870001,
    "vua_required": false
}

カスタマーワークスペース内のツールの削除

カスタマーワークスペース内のMCPサーバーからツールを削除します。

APIエンドポイントは削除できません

レシピ関数またはGenieエージェントに基づくツールのみ削除できます。 APIエンドポイントツールを削除しようとすると、400 Bad Requestエラーが返されます。

shell

DELETE /api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools/:id

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。
id	number 必須	ツールID。

サンプルリクエスト

shell

curl  -X DELETE 'https://www.workato.com/api/managed_users/91829/mcp_servers/sales-tools-mcp-server/tools/3002' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

成功時に204 No Contentを返します。

カスタマーワークスペース内のIDプロバイダーユーザーグループのリスト表示

カスタマーワークスペースで利用可能なIDプロバイダーのユーザーグループのページ分割されたリストを返します。 workato_idp認証を使用するMCPサーバーにアクセス権を割り当てる場合は、このレスポンスのグループIDを使用します。

shell

GET /api/managed_users/:managed_user_id/user_groups

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。

クエリパラメーター

名前	タイプ	説明
page	number optional	ページ番号。デフォルトは1です。
per_page	number optional	ページごとの項目数。デフォルトは100です。最大は100です。

サンプルリクエスト

shell

curl  -X GET 'https://www.workato.com/api/managed_users/91829/user_groups' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

json

{
    "data": [
        {
            "id": "group-abc123",
            "name": "Sales Team",
            "users_count": 24,
            "created_at": "2025-01-10T08:00:00.000Z",
            "updated_at": "2025-09-15T12:30:00.000Z"
        },
        {
            "id": "group-def456",
            "name": "HR Admins",
            "users_count": 6,
            "created_at": "2025-01-10T08:00:00.000Z",
            "updated_at": "2025-08-20T10:00:00.000Z"
        }
    ],
    "count": 2,
    "page": 1,
    "per_page": 100
}

Last updated:

MCPサーバー ​

クイックリファレンス ​

カスタマーワークスペース内のMCPサーバーのリスト表示 ​

URLパラメーター ​

クエリパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内でのMCPサーバーの作成 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバー詳細の取得 ​

URLパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーの更新 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーの削除 ​

URLパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバー認証トークンの更新 ​

URLパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーへのツールの割り当て ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーへのユーザーグループの割り当て ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーからのユーザーグループの削除 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーの別フォルダへの移動 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のサーバーポリシー設定の取得 ​

URLパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のサーバーポリシー設定の更新 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーのツールのリスト表示 ​

URLパラメーター ​

クエリパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のツールの説明の更新 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のツールの削除 ​

URLパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のIDプロバイダーユーザーグループのリスト表示 ​

URLパラメーター ​

クエリパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

MCPサーバー

クイックリファレンス

カスタマーワークスペース内のMCPサーバーのリスト表示

URLパラメーター

クエリパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内でのMCPサーバーの作成

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバー詳細の取得

URLパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーの更新

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーの削除

URLパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバー認証トークンの更新

URLパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーへのツールの割り当て

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーへのユーザーグループの割り当て

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーからのユーザーグループの削除

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーの別フォルダへの移動

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のサーバーポリシー設定の取得

URLパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のサーバーポリシー設定の更新

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーのツールのリスト表示

URLパラメーター

クエリパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のツールの説明の更新

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のツールの削除

URLパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のIDプロバイダーユーザーグループのリスト表示

URLパラメーター

クエリパラメーター

サンプルリクエスト

サンプルレスポンス