figma-create-new-file

Figma で新しいファイルを作成する

create_new_file MCP ツールを使用して、新しい Figma Design、FigJam、または Slides ファイルを作成する手順です。

Step 1: planKey と editorType を解決する

このタスクでユーザーが指定または選択した planKey を使用します。それ以外の場合は、whoami を呼び出して、返されたプランを確認します。

• プランがない場合：ファイルを作成できないことをユーザーに伝えます。
• プランが 1 つの場合：その key を planKey として使用します。
• プランが複数ある場合：利用可能なプランを表示し、ユーザーに 1 つ選択してもらってから、そのプランの key を planKey として使用します。

ツールが提示する入力 enum から選び、リクエストされたファイルの種類に基づいて editorType を推測します。不明な場合は、ユーザーにファイルの種類を指定するよう求めます。

Step 2: create_new_file を呼び出す

次の必須引数をすべて指定して、create_new_file ツールを呼び出します。

• fileName：必須です。ユーザーが指定しない場合は、簡潔な名前を選びます。
• planKey：必須です。Step 1 で解決した planKey を使用します。
• editorType：必須です。Step 1 で選択した editorType を使用します。
• projectId：任意です。特定のプロジェクトにファイルを作成する場合に設定します。

{
  "fileName": "Quarterly planning",
  "planKey": "team::1234567890",
  "editorType": "design"
}

• create_new_file ツールの応答に含まれる file_key を、use_figma などの後続のツール呼び出しで使用します。

Step 3: （Slides のみ）空のグリッドを処理する

新しい Slides ファイルにはスライドがありません。figma.getSlideGrid() は [] を返します。スライドからテーマトークンなどのプロパティを読み取る前に、figma.createSlide() を呼び出すか、空のケースを処理してください。最初の createSlide() の呼び出しによって、行 0 が自動的に作成され、スライドが挿入されます。