Skip to main content
uSpecs runs entirely in Cursor and connects to Figma through the Figma Console MCP. You need three things to get started:
  1. Cursor: the AI code editor that runs uSpecs agent skills
  2. Figma Console MCP: the bridge that connects Cursor to your Figma files
  3. Template library: the Figma file containing documentation templates
You only need to complete this setup once. After that, you can generate specs anytime by opening the project in Cursor.

​
1. Install Cursor

Cursor is the AI code editor that powers uSpecs. All agent skills run inside Cursor’s chat.
1

Download Cursor

Go to cursor.com and download the app for your platform.
2

Clone the uSpecs repository

Clone the repository to your local machine.
git clone https://github.com/redongreen/uSpec.git
3

Open the project in Cursor

Open the uSpec folder in Cursor. The agent skills in .cursor/skills/ load automatically. No extra configuration needed.
You can verify skills are available by typing @create-voice in Cursor’s chat. It should autocomplete to the skill file.

​
2. Set up Figma Console MCP

The Figma Console MCP connects Cursor to Figma Desktop, giving the agent access to your component data, variables, styles, and screenshots.

​
Get a Figma personal access token

1

Go to the Figma API settings

Open figma.com/developers/api#access-tokens
2

Create a token

Click “Get personal access token”, enter a description like Figma Console MCP, and copy the token. It starts with figd_.
Copy the token immediately. You won’t be able to see it again after closing the dialog.

​
Configure the MCP in Cursor

Add the Figma Console MCP to your Cursor MCP configuration: 
{
  "mcpServers": {
    "figma-console": {
      "command": "npx",
      "args": ["-y", "figma-console-mcp@latest"],
      "env": {
        "FIGMA_ACCESS_TOKEN": "figd_YOUR_TOKEN_HERE"
      }
    }
  }
}
This uses the NPX setup, which gives you all 56+ tools including design creation and variable management. For alternative installation methods, troubleshooting, and the latest configuration options, see the Figma Console MCP documentation.

​
Connect to Figma Desktop

The Desktop Bridge plugin provides real-time access to your Figma file data. It comes bundled with the Figma Console MCP.
1

Install the Desktop Bridge plugin

The Desktop Bridge plugin is included in the figma-console-mcp npm package. After running npx figma-console-mcp@latest, find the plugin at node_modules/figma-console-mcp/figma-desktop-bridge/manifest.json. In Figma Desktop, go to Plugins → Development → Import plugin from manifest… and select this file.
2

Run the plugin

Open the Desktop Bridge plugin in your Figma file. It auto-connects via WebSocket. No special launch flags needed.
3

Verify the connection

In Cursor’s chat, type: “Check Figma status”The agent should confirm an active connection.
When the connection is active, Cursor can read your Figma file data, take screenshots, and access variables and styles.

​
3. Set up the template library

If you’re an Uber designer, you can skip this step!
uSpecs uses Figma component templates to render documentation. You need to add these templates to your Figma organization and configure uSpecs to use them.

​
Get the template file

1

Open the Community file

Go to the uSpecs Template on Figma Community.
2

Duplicate to your drafts

Click Open in Figma to add a copy to your drafts.
3

Publish as a library

Move the file to your team or organization project, then publish it as a library:
  1. Open the file in Figma
  2. Go to the Assets panel
  3. Click the book icon and select Publish library
  4. Confirm the publish
This makes the templates available for uSpecs to import.
If you’re working solo or testing, you can skip publishing and use the file directly. The setup skill will still work as long as you have the file open.

​
Configure the templates

Run the setup skill in Cursor to connect uSpecs to your template library:
1

Open the Desktop Bridge plugin

In Figma Desktop, open the Desktop Bridge plugin in your template library file.
2

Run the setup skill

In Cursor’s chat, type:
@setup-library https://www.figma.com/design/YOUR_FILE_ID/uSpecs-Template
Replace the URL with the link to your copy of the template file.
3

Wait for confirmation

The agent extracts component keys from your templates and updates the configuration automatically.
When you see “Setup complete! You are now ready to use uSpecs”, your template library is configured.

​
Verify and start using uSpecs

Once setup is complete, head to the Quickstart to create your first spec and verify everything is connected.

​
Setup issues

  • Confirm the uSpecs project folder is open in Cursor (not a parent directory)
  • Check that .cursor/skills/ contains the skill folders
  • Restart Cursor after cloning the repository
  • Confirm Figma Desktop is running (not the web version)
  • Close and reopen the Desktop Bridge plugin in Figma
  • Make sure only one instance of Figma Desktop is running
  • Check that your Figma access token is configured correctly in Cursor’s MCP settings
For issues with skills or Figma connection, see the Troubleshooting guide.