MCP 経由で Canva を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Canva をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Canva + Gemini

AI に Canva で作業させます。デザインの検索と参照、新しいデザインの作成、PDF、PNG、PowerPoint、動画へのエクスポート（ダウンロードリンク付き）、フォルダーの整理、リンクからの画像アップロード、ブランドテンプレートの参照、デザインへのコメントができます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

CANVA_CLIENT_ID, CANVA_CLIENT_SECRET

ステップ 1 — 認証情報を取得

1. Canva アカウントで、認証アプリによる多要素認証を有効にします（Settings → Login & security）。Canva は、多要素認証を有効にした開発者にだけ REST API へのアクセスを許可します。
2. Canva Developer Portal（https://www.canva.com/developers/apps）を開き、Create an app をクリックして、誰向けのアプリかを選びます。プライベートアプリは自分のチームの管理者が承認し、Canva Enterprise のチームが必要です。パブリックアプリは開発者本人ならすぐに使えますが、ほかの Canva ユーザーが接続できるのは Canva の審査を通過してからです。続いて Outside Canva → Start integrating を開き、REST API を使えるようにします。
3. Configuration → Scopes で、次の 12 個のスコープにチェックを入れます: profile:read, design:meta:read, design:content:read, design:content:write, folder:read, folder:write, asset:read, asset:write, brandtemplate:meta:read, brandtemplate:content:read, comment:read, comment:write。コネクターはこれらすべてを要求します。チェックしていないスコープを求めるサインインは Canva に拒否されます。
4. Authentication で、リダイレクト URL https://cloud.anythingmcp.com/api/mcp-oauth/callback を追加します。AnythingMCP をセルフホストしている場合は <your AnythingMCP URL>/api/mcp-oauth/callback です。Canva は localhost のリダイレクト URL を受け付けないため、ローカル環境では 127.0.0.1 を使います。SERVER_URL を http://127.0.0.1:<port> に設定し、http://127.0.0.1:<port>/api/mcp-oauth/callback を登録してください。
5. Client ID を CANVA_CLIENT_ID にコピーします。Generate secret をクリックし、表示されたシークレットをすぐに CANVA_CLIENT_SECRET に貼り付けます。Canva は一度しか表示しません。
6. コネクターをインストールし、Authorize with Provider をクリックして、Canva でアクセスを許可します。サインインには PKCE 付きの OAuth 2.0 を使うため、AnythingMCP が Canva のパスワードを目にすることはありません。アクセストークン（有効期間は約 4 時間）は AnythingMCP が自動で更新します。リフレッシュトークンは一度しか使えず、更新のたびに新しいものに置き換わります。
7. まず canva_get_me を実行します。Canva のユーザー ID とチーム ID が返るので、認可が機能しているかをすぐに確認できます。

エクスポートはダウンロードリンクで届きます: canva_create_export がジョブを開始し、canva_get_export が完了を知らせます。ファイルごとに 1 つのリンクが返ります（複数ページの画像ではページごとに 1 つ）。リンクの有効期間は 24 時間です。canva_get_design_export_formats で、デザインが対応する形式（デザインの種類に応じて PDF、JPG、PNG、SVG、PowerPoint、GIF、MP4 など）を確認できます。ライセンスのないプレミアム素材を含むデザインは license_required で失敗します。Canva のエクスポート上限は、ユーザーごとに 5 分あたり 75 件、1 日 500 件です。

リンクからのアップロード: canva_upload_asset_from_url が画像や動画を Uploads に追加し、canva_get_asset_upload が完了を知らせます。ファイルは Canva 自身がダウンロードするため、リンクは Canva のダウンローダーに 200 を返す必要があります。自動ダウンロードを拒否するサイトでは、ジョブが fetch_failed で失敗します。

フォルダーとデザイン: root はプロジェクトの最上位、uploads は Uploads フォルダーを表します。デザイン ID は Canva のリンクで /design/ の後に続く部分です（例: https://www.canva.com/design/DAFVztcvd9z/... の DAFVztcvd9z）。canva_create_design は、空のドキュメント、メール、プレゼンテーション、ホワイトボード、またはピクセル指定のカスタムサイズのデザインを作成し、編集リンクを返します。サムネイルのリンクは 15 分、編集リンクと閲覧リンクは 30 日で期限が切れます。

必要なプラン: デザイン、フォルダー、アップロード、エクスポート、コメントは、無料プランを含むすべての Canva プランで使えます。ブランドテンプレートには、それを含むプラン（Pro、Teams、Enterprise）が必要です。利用できる場合は canva_get_capabilities に brand_template が表示されます。

まず確認を: コメントと返信（canva_create_comment、canva_reply_to_comment）は共同編集者に表示されるため、AI は投稿前に文面を見せます。アイテムをゴミ箱に移す canva_delete_folder と canva_delete_asset は、インストール時はオフになっています。

読み取り専用にするには: Developer Portal とコネクターの OAuth 設定で :write スコープのチェックを外し、もう一度認可して、作成、変更、移動を行うツールをオフにします。

プレビュー API: コメントとリンクからのアップロードは Canva のプレビュー API を使います。予告なく変わることがあり、これらを使うパブリックアプリは Canva の審査を通過できません。パブリックアプリでは、canva_upload_asset_from_url、canva_get_asset_upload と 4 つのコメントツールをオフにしてください。

よくあるエラー: invalid_access_token または revoked_access_token は、もう一度認可が必要という意味です。missing_scope の場合は、ポータルとコネクターの OAuth 設定でそのスコープにチェックを入れてから、もう一度認可します。permission_denied や design_not_found（folder_not_found、asset_not_found も同様）は、ID が間違っているか、そのアイテムがあなたのアカウントから見えないことを示します。「requires one of capabilities」という 403 は、ブランドテンプレートのような有料機能です。too_many_requests の場合、ほとんどの呼び出しはユーザーごとに毎分 10〜100 回まで許可されているので、1 分待ってください。

コネクターは、デザインの中身の編集、ブランドテンプレートへの自動入力（autofill）、デザインのサイズ変更、ファイルのインポート、AI による生成、デザインの分析データの参照、Webhook の設定は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Canva のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「タイトルに『pitch deck』を含むデザインを探して、いちばん新しいものの編集リンクを教えてください。」
• 「『Q4 sales review』のプレゼンテーションを PDF でエクスポートして、ダウンロードリンクをください。」
• 「このリンクの商品写真を Canva にアップロードして、それを使った 1080 × 1080 の新しい投稿を作ってください。」
• 「『秋のキャンペーン』というフォルダーを作って、先週のキャンペーンのデザインをすべてそこに移動してください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続