canva-automation

Rube MCP による Canva の自動化

Rube MCP 経由で Composio の Canva ツールキットを使い、Canva のデザイン操作を自動化します。

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• canva ツールキットを使用した RUBE_MANAGE_CONNECTIONS による Canva のアクティブな接続
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。ホストの認証と信頼の設定に従ってください。エンドポイントの設定だけでは、Canva の認証は完了しません。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確認します
2. canva ツールキットを指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクから Canva OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

操作上の制限

利用可能な場合は、すでに接続されているアカウントを使用してください。クライアントのインストールや OAuth には該当するユーザーの認証が必要です。認証情報を公開しないでください。変更する前に対象のデザインまたはフォルダーを正確に確認し、このサービスでの使用が許可されたアセットのみをアップロードしてください。URL を提供するためだけに、非公開のアセットを公開しないでください。有効期限のあるエクスポートリンクは非公開にしてください。ジョブのポーリングにはタイムアウトを設定してください。書き込み結果が不確かな場合は、重複を避けるため、再試行する前にジョブや項目の状態を確認してください。ツールのスラッグやパラメーターの例は参考情報です。実際に検出されたスキーマが優先されます。

主なワークフロー

1. デザインの一覧表示と閲覧

使用する場面：既存のデザインを検索したり、Canva ライブラリを閲覧したりする場合

ツールの順序：

1. CANVA_LIST_USER_DESIGNS - オプションのフィルターを使ってすべてのデザインを一覧表示します［必須］

主なパラメーター：

• query：デザイン名で絞り込む検索語
• continuation：前回のレスポンスから取得したページネーショントークン
• ownership：owned、shared、any で絞り込みます
• sort_by：並べ替え項目（例：modified_at、title）

注意点：

• 結果はページ分割されます。continuation トークンがなくなるまで続けてください
• 削除済みのデザインが一時的に表示されることがあります。デザインのステータスを確認してください
• 検索は部分一致であり、あいまい検索ではありません

2. 作成とデザイン

使用する場面：新しい Canva デザインを一から、またはテンプレートから作成する場合

ツールの順序：

1. CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST - 利用可能なブランドテンプレートを閲覧します［任意］
2. CANVA_CREATE_CANVA_DESIGN_WITH_OPTIONAL_ASSET - 新しいデザインを作成します［必須］

主なパラメーター：

• design_type：デザインの種類（例：Presentation、Poster、SocialMedia）
• title：新しいデザインの名前
• asset_id：デザインに含める任意のアセット
• width / height：ピクセル単位のカスタムサイズ

注意点：

• デザインの種類は Canva の事前定義済みの種類と完全に一致させる必要があります
• カスタムサイズには最小値と最大値があります
• アセットを参照する前に、CANVA_CREATE_ASSET_UPLOAD_JOB でアップロードする必要があります

3. アセットのアップロード

使用する場面：デザインで使用する画像やファイルを Canva にアップロードする場合

ツールの順序：

1. CANVA_CREATE_ASSET_UPLOAD_JOB - アセットのアップロードを開始します［必須］
2. CANVA_FETCH_ASSET_UPLOAD_JOB_STATUS - アップロードが完了するまでポーリングします［必須］

主なパラメーター：

• name：アセットの表示名
• url：アップロードするファイルの公開 URL（URL ベースのアップロードの場合）
• job_id：ステップ 1 で返されたアップロードジョブ ID（ステータスのポーリング用）

注意点：

• アップロードは非同期です。完了するまでジョブのステータスを必ずポーリングしてください
• 対応形式には PNG、JPG、SVG、MP4、GIF があります
• ファイルサイズの制限が適用されます。大きなファイルは処理に時間がかかることがあります
• CREATE から返される job_id は、ステータスのポーリングに必要な ID です
• ステータスの値：in_progress、success、failed

4. デザインをエクスポートする

使用する状況：ユーザーがCanvaのデザインをPDF、PNG、またはその他の形式でダウンロードまたはエクスポートしたい場合

ツールの手順：

1. CANVA_LIST_USER_DESIGNS - エクスポートするデザインを探します［前提条件］
2. CANVA_CREATE_CANVA_DESIGN_EXPORT_JOB - エクスポート処理を開始します［必須］
3. CANVA_GET_DESIGN_EXPORT_JOB_RESULT - エクスポートが完了するまでポーリングし、ダウンロードURLを取得します［必須］

主なパラメーター：

• design_id：エクスポートするデザインのID
• format：エクスポート形式（'pdf'、'png'、'jpg'、'svg'、'mp4'、'gif'、'pptx'）
• pages：エクスポートする特定のページ番号（配列）
• quality：エクスポート品質（'regular'、'high'）
• job_id：ステータスをポーリングするためのエクスポートジョブID

注意点：

• エクスポートは非同期です。完了するまで、必ずジョブの結果をポーリングしてください
• 完了したエクスポートのダウンロードURLには有効期限があります
• ページ数の多い大規模なデザインは、エクスポートに時間がかかります
• すべての形式が、すべてのデザインタイプに対応しているわけではありません（例：MP4はアニメーションのみ）
• ポーリング間隔：ステータスを確認する間に2～3秒待機してください

5. フォルダーで整理する

使用する状況：ユーザーがフォルダーを作成したり、デザインをフォルダーに整理したりしたい場合

ツールの手順：

1. CANVA_POST_FOLDERS - 新しいフォルダーを作成します［必須］
2. CANVA_MOVE_ITEM_TO_SPECIFIED_FOLDER - デザインをフォルダーに移動します［任意］

主なパラメーター：

• name：フォルダー名
• parent_folder_id：階層構造で整理する場合の親フォルダー
• item_id：移動するデザインまたはアセットのID
• folder_id：移動先のフォルダーID

注意点：

• フォルダー名は、同じ親フォルダー内で一意である必要があります
• アイテムをフォルダー間で移動すると、場所が即座に更新されます
• ルートレベルのフォルダーにはparent_folder_idがありません

6. ブランドテンプレートから自動入力する

使用する状況：ユーザーがブランドテンプレートのプレースホルダーにデータを入力してデザインを生成したい場合

ツールの手順：

1. CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST - 利用可能なブランドテンプレートを一覧表示します［必須］
2. CANVA_INITIATE_CANVA_DESIGN_AUTOFILL_JOB - データを使って自動入力を開始します［必須］

主なパラメーター：

• brand_template_id：使用するブランドテンプレートのID
• title：生成するデザインのタイトル
• data：プレースホルダー名と置換値のキーと値のマッピング

注意点：

• テンプレートのプレースホルダーは完全に一致している必要があります（大文字と小文字を区別します）
• 自動入力は非同期です。完了するまでポーリングしてください
• 自動入力に対応しているのはブランドテンプレートのみで、通常のデザインには対応していません
• データ値は、各プレースホルダーで期待される型（テキスト、画像URL）に一致している必要があります

よく使われるパターン

非同期ジョブのパターン

Canvaの多くの操作は非同期です：

1. Initiate job (upload, export, autofill) -> get job_id
2. Poll status endpoint with job_id every 2-3 seconds
3. Check for 'success' or 'failed' status
4. On success, extract result (asset_id, download_url, design_id)

IDの解決

デザイン名 -> デザインID：

1. Call CANVA_LIST_USER_DESIGNS with query=design_name
2. Find matching design in results
3. Extract id field

ブランドテンプレート名 -> テンプレートID：

1. Call CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST
2. Find template by name
3. Extract brand_template_id

ページネーション

• レスポンスにcontinuationトークンが含まれているか確認します
• 次のリクエストのcontinuationパラメーターにトークンを渡します
• continuationが存在しない、または空になるまで続けます

既知の注意点

非同期操作：

• アップロード、エクスポート、自動入力はすべて非同期です
• 常にジョブのステータスをポーリングしてください。すぐに完了すると想定しないでください
• エクスポートのダウンロードURLには有効期限があります。速やかに使用してください

アセット管理：

• デザインで使用する前に、アセットをアップロードする必要があります
• asset_idが有効になるには、アップロードジョブのステータスが'success'になる必要があります
• 対応形式は異なる場合があります。最新の制限についてはCanvaのドキュメントを確認してください

レート制限：

• Canva APIにはエンドポイントごとにレート制限があります
• 一括操作には指数バックオフを実装してください
• API呼び出しを減らすため、可能な場合は操作をまとめてください

レスポンスの解析：

• レスポンスデータはdataキーの下にネストされている場合があります
• ジョブステータスのレスポンスには、完了状態に応じて異なるフィールドが含まれます
• 任意フィールドに対するフォールバックを用意し、堅牢に解析してください

クイックリファレンス

タスク	ツールスラッグ	主なパラメータ
デザインを一覧表示	CANVA_LIST_USER_DESIGNS	query, continuation
デザインを作成	CANVA_CREATE_CANVA_DESIGN_WITH_OPTIONAL_ASSET	design_type, title
アセットをアップロード	CANVA_CREATE_ASSET_UPLOAD_JOB	name, url
アップロードを確認	CANVA_FETCH_ASSET_UPLOAD_JOB_STATUS	job_id
デザインをエクスポート	CANVA_CREATE_CANVA_DESIGN_EXPORT_JOB	design_id, format
エクスポートを取得	CANVA_GET_DESIGN_EXPORT_JOB_RESULT	job_id
フォルダーを作成	CANVA_POST_FOLDERS	name, parent_folder_id
フォルダーに移動	CANVA_MOVE_ITEM_TO_SPECIFIED_FOLDER	item_id, folder_id
テンプレートを一覧表示	CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST	(なし)
テンプレートを自動入力	CANVA_INITIATE_CANVA_DESIGN_AUTOFILL_JOB	brand_template_id, data

使用するタイミング

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用されます。

制限事項

• このスキルは、タスクが上記のスコープに明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が欠けている場合は、停止して確認を求めてください。