⚡ Devin AI Desktop Ready 🎨 Figma MCP Protocol ✅ Production Tested 📦 v1.0.0

Master Figma MCP Server & Download the Official Skill

Everything you need to integrate Figma with Devin AI for seamless design-to-code workflows. Includes step-by-step setup, 1-click copyable MCP configuration JSON, real-world troubleshooting solutions, rate limits breakdown, and an instant downloadable Devin Skill file.

🛠️

Skill: figma-mcp-setup

Self-contained instructions for Devin AI & agentic coding assistants

Target: .devin/skills/figma-mcp-setup/SKILL.md

🎯 Quick Start Objective & Prompt

Use this prompt to kick off automatic installation in Devin Desktop

📝 Installation Prompt Template
Saya ingin menginstall Figma MCP Server untuk membaca design context dari file Figma dan mengconvertnya menjadi code. Tolong bantu saya setup Figma MCP Server di Devin Desktop, mulai dari instalasi hingga bisa membaca file Figma dan convert ke HTML/CSS.

✅ Interactive Setup Checklist

Click items to track your installation progress. State is automatically saved in your browser.

Setup Completion Progress 0 of 11 Completed (0%)
1. Software & Environment
Devin Desktop installed and running on macOS / Linux
Figma account with appropriate seat (Full/Dev seat recommended for higher rate limits)
Stable internet connection and default browser configured for OAuth flow
Target Figma file URL with specific node-id ready
2. Session Hygiene & Preparation
Logged out from Figma in primary browser to avoid OAuth account caching
Cleared figma.com browser cookies for a clean authentication session
Verified config directory exists: ~/.config/devin/
3. Authentication & Verification
Created ~/.config/devin/mcp_config.json with Figma serverUrl
Clicked "Authenticate" in Devin Desktop (Settings → Tools → Manage MCPs)
Ran mcp_call_tool whoami and confirmed correct user email
Successfully read design context with get_design_context
🔌

MCP Integration

Direct connection to official Figma MCP server endpoint.

🎨

Design-to-Code

Effortless extraction of design specs, tokens, and node hierarchies.

🛡️

Troubleshooting

Tested solutions for OAuth cache, token expiry, and permissions.

📦

Portable Skill

Ready to drop into any Devin project .devin/skills/ directory.

📖 Complete Step-by-Step Installation

Follow these 9 verified steps to set up Figma MCP in Devin Desktop

Step 01

Verify Environment

Check if Devin Desktop is running and inspect your CLI environment.

Terminal
# Check if Devin Desktop process is active
ps aux | grep -i devin

# Check Claude Code CLI version (for reference)
claude --version
Step 02

Create Devin Config Directory

Devin Desktop looks for MCP definitions in ~/.config/devin/.

Terminal
mkdir -p ~/.config/devin
Step 03

Create MCP Configuration File

Write the official Figma MCP server endpoint into mcp_config.json.

Terminal (Bash Command)
cat > ~/.config/devin/mcp_config.json << 'EOF'
{
  "mcpServers": {
    "figma": {
      "serverUrl": "https://mcp.figma.com/mcp"
    }
  }
}
EOF
💡 Config Path Reference

Devin Desktop: ~/.config/devin/mcp_config.json | Claude CLI: ~/.claude.json | Windsurf: ~/.codeium/mcp_config.json

Step 04

Refresh / Restart Devin Desktop

In Devin Desktop, go to Settings → Tools → Manage MCPs and click the Refresh (🔄) button, or restart the application completely to load the new config file.

Step 05

Authenticate Figma MCP Server

Perform OAuth authentication via the Devin Desktop UI:

  1. Open Devin Desktop Settings → Tools → Manage MCPs.
  2. Find the "figma" server in the active server list.
  3. Click "Authenticate" or "Connect".
  4. A browser window will open automatically. Login with your desired Figma account.
  5. Click "Allow Access" to grant permissions.
Step 06

Verify Authenticated Account

Verify that the MCP tool is authenticated with the expected email address.

Devin MCP Tool Call
mcp_call_tool whoami
Step 07

Test Network & Port Connectivity

Run diagnostic checks to ensure there are no firewall or DNS issues.

Terminal Diagnostics
# Test basic HTTP connectivity (Expected: HTTP/2 405)
curl -I https://mcp.figma.com/mcp

# Test HTTPS Port 443
nc -zv mcp.figma.com 443

# Test Latency & DNS
ping -c 3 mcp.figma.com
nslookup mcp.figma.com
Step 08 & 09

Read Figma Design & Convert to Code

Pass the fileKey and nodeId extracted from your Figma URL:

MCP Design Extraction
# 1. Load design-to-code guidance
mcp_read_resource skill://figma/figma-design-to-code/SKILL.md

# 2. Extract design context (Pass your fileKey and nodeId)
mcp_call_tool get_design_context \
  --fileKey="pDZFdbWxAOYiVlWDLj8UPB" \
  --nodeId="87-151" \
  --skillNames="resource:figma-design-to-code"

⚙️ Copyable MCP Config Generator

Customize parameters or copy the verified JSON config with one click

mcp_config.json
{
  "mcpServers": {
    "figma": {
      "serverUrl": "https://mcp.figma.com/mcp"
    }
  }
}

📊 Figma Plan Rate Limits

Limits apply per user seat on the Figma MCP Server

Plan Tier Full / Dev Seat View / Collab Seat
Starter (Free) 200 / day (10/min) 20 / month
Professional 200 / day (15/min) 6 / month
Organization 200 / day (20/min) 6 / month
Enterprise 600 / day (20/min) 6 / month
⚡ Rate-Limit Exempt Tools

add_code_connect_map, create_new_file, and whoami do NOT consume rate quota.

🛠️ Devin Skill: figma-mcp-setup

Drop this skill file into your project to make Devin autonomously execute Figma setup

Skill Name

figma-mcp-setup

Default Location

.devin/skills/figma-mcp-setup/SKILL.md

Invocation Mode

Autonomous / Model Invoked

File Size

~10.1 KB (349 lines)

SKILL.md (Preview)
---
name: figma-mcp-setup
description: "Complete guide for installing and configuring Figma MCP Server in Devin Desktop. Covers environment checks, installation, authentication troubleshooting, and common issues based on real-world setup experience. Use this when user wants to integrate Figma with Devin AI for design-to-code workflows."
disable-model-invocation: false
---

# Figma MCP Server Setup Guide

Complete installation and configuration guide for Figma MCP Server in Devin Desktop, based on real-world troubleshooting experience.

## When to Use This Skill
Use this skill when the user wants to:
- Install Figma MCP Server for design-to-code workflows
- Integrate Figma with Devin AI
- Read Figma designs and convert them to code
- Troubleshoot Figma MCP connection issues
- Switch between different Figma accounts

... (Click Download SKILL.md or Copy Skill Code above for the full 349 lines) ...

⚡ Interactive Troubleshooting Database

Real problems encountered during setup and their exact, battle-tested solutions

🔍

🔐 Issue 1: "! Needs authentication" Status in MCP List

❌ Symptoms

MCP server appears in list with yellow "! Needs authentication" badge. Cannot call Figma tools.

✅ Solution
  1. Verify config file is at ~/.config/devin/mcp_config.json.
  2. In Devin Desktop UI, navigate to Settings → Tools → Manage MCPs.
  3. Click "Authenticate" to launch the browser OAuth window (cannot be completed via CLI).
  4. Ensure browser popups are not blocked.

👤 Issue 2: Wrong Figma Account Authenticated (Work vs Personal)

❌ Symptoms

mcp_call_tool whoami shows a different account than expected (e.g. work email instead of personal) or permission denied on personal design files.

✅ Solution
  1. Open your web browser and completely log out from figma.com.
  2. Clear all figma.com cookies from your browser history.
  3. In Devin Desktop, disconnect and click "Authenticate" again.
  4. Log in with your intended personal/team account and confirm with mcp_call_tool whoami.

🔄 Issue 3: Browser Session OAuth Cache Reverts to Previous Account

❌ Symptoms

Clicking "Authenticate" immediately logs in without prompting for credentials because of active browser tokens.

✅ Solution

Open an Incognito/Private browser window or set up a dedicated browser profile for MCP OAuth authentication.

📁 Issue 4: Config File Not Detected / Wrong File Location

❌ Symptoms

Figma server does not appear in Devin Desktop Manage MCPs list after editing config.

✅ Solution

Confirm the path is ~/.config/devin/mcp_config.json (NOT ~/.claude.json or ~/.codeium/mcp_config.json) and restart Devin Desktop.

🚫 Issue 5: File Access Denied / Node ID Missing

❌ Symptoms

"You don't have edit access to this file" or empty design context returned.

✅ Solution

Make sure the Figma URL format includes the node-id: https://www.figma.com/design/{FILE_KEY}/{NAME}?node-id={NODE_ID}.

🌐 Issue 6: Network Connectivity & Firewall Inspection

✅ Diagnostic Verification

Run this command to test all network layers in one go:

curl -I https://mcp.figma.com/mcp && nc -zv mcp.figma.com 443

📥 Project Downloads & Artifacts Hub

Download any resource or copy configuration JSON with a single click

🛠️

Devin Skill File

The complete portable skill file for Devin AI, ready to be placed in .devin/skills/figma-mcp-setup/SKILL.md.

Format: Markdown (.md) Size: ~10.1 KB
⚙️

MCP Config File

Ready-to-use JSON configuration file formatted for Devin Desktop at ~/.config/devin/mcp_config.json.

Format: JSON (.json) Size: ~120 Bytes
📝

Markdown Case Study

Comprehensive setup guide & troubleshooting case study in GitHub Flavored Markdown.

Format: Markdown (.md) Size: ~12.6 KB
📥 Download Guide (.md)
🌐

Classic HTML Guide

Original standalone HTML documentation with full Indonesian case study transcript.

Format: HTML (.html) Size: ~29.3 KB
📖 Open HTML Guide