Figma MCP Server

# Troubleshooting Figma MCP Server ## "Invalid token" Error (403) If you're getting a 403 "Invalid token" error, here are the common causes and solutions: ### 1. Token Has Expired or Is Invalid **Solution:** Generate a new Personal Access Token: 1. Go to [Figma Account Settings](https://www.figma.com/settings) 2. Scroll down to "Personal access tokens" 3. Click "Create a new personal access token" 4. Give it a descriptive name (e.g., "MCP Server") 5. Click "Create token" 6. Copy the token and update your `.env` file: ``` FIGMA_TOKEN=your_new_token_here ``` ### 2. Using File Access Token Instead of Personal Access Token File access tokens (starting with `figd_`) have limited permissions. **Solution:** Use a Personal Access Token instead (starts with `figd_` but is longer and has full API access). ### 3. File Is Private The Figma file must be accessible to the token owner. **Solution:** - If it's your file: Make sure you're logged in with the account that created the token - If it's someone else's file: - Ask them to share the file with you (with can view permissions) - Or ask them to make the file public ### 4. Testing Access You can test if your token works by running: ```bash curl -H "X-Figma-Token: YOUR_TOKEN" \ "https://api.figma.com/v1/files/YwUqmarhRx74Gb4zePtEUx" ``` Replace `YOUR_TOKEN` with your actual token. ### 5. Token Permissions Make sure your token has the necessary scopes: - File content read access - Node data access ### Still Having Issues? 1. Double-check there are no extra spaces or newlines in your `.env` file 2. Restart your terminal/editor after updating the `.env` file 3. Make sure the file key is correct (copy it from the URL) 4. Check the Figma file is not deleted or moved ## File Key Format From a URL like: ``` https://www.figma.com/design/YwUqmarhRx74Gb4zePtEUx/Mimecast-UI-Kit?node-id=8384-4 ``` - **File Key**: `YwUqmarhRx74Gb4zePtEUx` (between `/design/` and the next `/`) - **Node ID**: `8384-4` (after `node-id=`, but replace `-` with `:` if needed) ## Need Help? - [Figma API Documentation](https://www.figma.com/developers/api) - [Figma Community Forum](https://forum.figma.com/)