Figma -Integrationsanleitung

Was die Figma-Integration leistet

Wenn Figma verbunden ist, zeigt Nakama die Projekte und Dateien deines Teams (mit Live-Vorschaubildern) in einem eigenen Panel. Ein Klick auf eine Datei öffnet sie in voller Größe in Figma in deinem Browser; der Kommentar-Feed jeder Datei lebt direkt im Panel – lies Threads, antworte, filtere nach Kommentaren, die dich erwähnen, und verwandle jeden Kommentar in ein Todo.

App hinzufügen (verbinden)

1. Öffne das Nakama-Seitenpanel in Chrome.

2. Drücke die Schaltfläche + (Add) unten in der rechten Leiste, um den Marketplace zu öffnen.

3. Wähle Figma und drücke Connect.

4. Eine Figma-Anmeldeseite öffnet sich als Browser-Tab. Melde dich an und drücke Allow, um Nakama zu autorisieren.

5. Einmalige Einrichtung: Füge deine Figma-Team-URL ein (öffne dein Team auf figma.com und kopiere die Adresse) – die Figma-API hat kein „meine Teams auflisten“, daher fragt Nakama einmal danach.

6. Ein Figma-Symbol erscheint in der Nakama-Leiste und das Panel öffnet sich mit deinen Projekten.

App verwenden

Projekte durchsuchen. Der Panel-Titel ist eine Projektauswahl – wechsle Projekte über das Dropdown-Menü.

Dateien öffnen. Jede Datei zeigt ihr Vorschaubild, ihren Namen und den Zeitpunkt der letzten Änderung. Klicke darauf, und die Datei öffnet sich in Figma in einem Browser-Tab – Nakama versucht nie, Figma innerhalb des Panels auszuführen.

Kommentaren folgen. Drücke die Kommentar-Schaltfläche einer Datei für ihren Feed: Threads gruppiert, ungelöste zuerst, mit einem @me-Filter für Kommentare, die dich erwähnen. Neue Kommentare laufen ein, während der Feed geöffnet ist.

Antworten und reagieren. Verfasse Antworten direkt im Panel; bewege den Mauszeiger über einen Kommentar, um ihn zu deiner Todo-Liste hinzuzufügen. Ziehe eine Datei-Karte auf Slack oder Telegram, um ihren Link zu teilen.

Berechtigungen und Datenverarbeitung

Nakama fordert die Figma-Berechtigungen files:read (Projekte, Dateien, Kommentare) und file_comments:write (Antworten veröffentlichen) an. Dein Figma-Token wird ausschließlich im lokalen Erweiterungsspeicher deines Browsers gespeichert und niemals auf Nakamas Servern; das App-Secret verbleibt serverseitig und dient ausschließlich dem OAuth-Austausch.

App entfernen (trennen)

In Nakama: Drücke + (Add) in der Leiste, um den Marketplace zu öffnen, finde Figma (als Connected angezeigt) und drücke darauf, um die Verbindung zu trennen. Das Symbol verschwindet aus der Leiste und das gespeicherte Token wird aus deinem Browser gelöscht.

In Figma: Du kannst den Zugriff auch unter Figma Settings → Connected apps widerrufen, wodurch er auf Figma-Seite widerrufen wird.

Fehlerbehebung

„Das sieht nicht nach einer Team-URL aus“: Die Team-URL muss /team/<number>/ enthalten – öffne dein Team im Datei-Browser von figma.com und kopiere die vollständige Adresse.

Alles Weitere: Sieh dir das Hilfecenter an oder schreibe an help@rexplore.xyz.