Figma 連携ガイド

Figma 連携でできること

Figma を接続すると、Nakama がチームのプロジェクトとファイル（ライブサムネイル付き）を専用パネルに表示します。ファイルをクリックするとブラウザの Figma で原寸大に開きます。各ファイルのコメントフィードはパネル内に表示され、スレッドの閲覧・返信、自分宛てのコメントへの絞り込み、任意のコメントの Todo への変換が行えます。

アプリの追加（接続）

1. Chrome で Nakama のサイドパネルを開きます。

2. 右側レール下部の + (Add) ボタンを押して Marketplace を開きます。

3. Figma を選び、接続 を押します。

4. Figma のログインページがブラウザタブとして開きます。ログインして 許可 を押し、Nakama を承認します。

5. 初回のみ: Figma のチーム URL を貼り付けます（figma.com でチームを開き、アドレスバーをコピー）。Figma API には「自分のチーム一覧」がないため、Nakama が一度だけ尋ねます。

6. Nakama のレールに Figma アイコンが表示され、プロジェクトとともにパネルが開きます。

アプリの使い方

プロジェクトを閲覧する。パネルタイトルはプロジェクト選択メニューです。ドロップダウンからプロジェクトを切り替えられます。

ファイルを開く。各ファイルにはサムネイル・名前・最終更新時刻が表示されます。クリックするとブラウザタブの Figma でファイルが開きます。Nakama がパネル内で Figma を動かそうとすることはありません。

コメントに追従する。ファイルのコメントボタンを押すとフィードが表示されます。スレッドはグループ化され未解決が先頭に並び、自分宛てのコメントを絞り込む @me フィルターも備えています。フィードを開いている間、新着コメントが流れ込みます。

返信して操作する。返信はパネル内でそのまま書き込めます。コメントにカーソルを合わせると Todo リストに追加できます。ファイルカードを Slack や Telegram にドラッグするとリンクを共有できます。

権限とデータの取り扱い

Nakama は Figma のスコープ files:read（プロジェクト・ファイル・コメント）と file_comments:write（返信の投稿）をリクエストします。Figma トークンはブラウザのローカル拡張機能ストレージにのみ保存され、Nakama のサーバーには一切保存されません。アプリシークレットは OAuth 交換のためだけにサーバー側に保持されます。

アプリの削除（接続解除）

Nakama 側: レールの + (Add) を押して Marketplace を開き、（接続済みと表示される）Figma を見つけて押すと接続を解除します。アイコンがレールから消え、保存されていたトークンがブラウザから削除されます。

Figma 側: Figma 設定 → 連携済みアプリ からもアクセスを取り消すことができ、Figma 側で取り消されます。

トラブルシューティング

「チーム URL ではないようです」: チーム URL には /team/<number>/ が含まれている必要があります。figma.com のファイルブラウザでチームを開き、完全なアドレスをコピーしてください。

その他のお問い合わせ: ヘルプセンター をご覧いただくか、help@rexplore.xyz までメールでお問い合わせください。