Setup Guide
How to install and configure the @metapowers/figma-mcp server.
Prerequisites
- An AI coding assistant (Claude Code, Codex CLI, etc.) installed
- A Figma personal access token
- Figma Desktop (for write operations via the Bridge Plugin)
Configure the MCP Server
The server is configured automatically when you install the metapowers design plugin. If you need to configure it manually:
export FIGMA_ACCESS_TOKEN="figd_your_token_here"Add this to your shell profile (.zshrc, .bashrc) to persist it.
Token Scopes
When creating your Figma personal access token, enable these scopes:
| Scope | Required For |
|---|---|
| File content (Read) | All design system and visual tools |
| Variables (Read) | Design token extraction and export |
| Library content (Read) | Published components and styles |
Install the Bridge Plugin
For write operations (creating components, FigJam, Slides), you need the Desktop Bridge Plugin:
- Open Figma Desktop and open a file
- Go to Plugins → Development → Import plugin from manifest...
- Select the manifest at
packages/figma-mcp/plugin/manifest.json - Run the plugin — it will auto-connect to the MCP server
The Bridge Plugin connects via WebSocket on ports 9000-9004. The MCP server starts the WebSocket server automatically.
Environment Variables
| Variable | Required | Description |
|---|---|---|
FIGMA_ACCESS_TOKEN | Yes | Your Figma personal access token |
FIGMA_BRIDGE_PORT | No | WebSocket port for Bridge Plugin (default: 9000) |
Verify Installation
Check Figma statusThe MCP server should report its connection status and available tools.