| name | figma-mcp-setup |
| description | Guía e instala el MCP remoto de Figma (~18 tools) en Antigravity, OpenCode o LM Studio (uno por vez) sin Node.js. Usar cuando pidan configurar Figma MCP, figma-remote, OpenCode, LM Studio, conectar Figma, o solo ven 2 tools. El agente DEBE guiar al usuario paso a paso si no es técnico. Cada usuario usa su propia cuenta Figma. |
Figma MCP Setup (Antigravity + OpenCode + LM Studio)
Goal
Conectar https://mcp.figma.com/mcp (~18 tools) en el IDE que indique el usuario.
Cada persona usa su propia cuenta Figma — nunca compartir ni reutilizar tokens ajenos.
Agent behavior — GUIDE MODE (mandatory)
Assume the user may not know terminal, Python, or Figma tokens. Do not dump commands and stop.
- Ask one thing at a time — which IDE? (Antigravity / OpenCode / LM Studio — solo uno por ejecución)
- Check Python — run
python3 --version (Windows: python --version). If missing, link python.org/downloads and wait.
- Explain Figma PAT before running auth:
- Figma → avatar → Settings → Security → Personal access tokens → Generate
- User pastes when script prompts (hidden input is normal)
- Run setup from skill root (you execute, user authorizes browser):
python3 scripts/setup.py --target <TARGET>
- Tell user explicitly: "Se abrirá el navegador → pulsa Allow con tu cuenta Figma"
- After success: "Cierra tu IDE por completo y ábrelo de nuevo"
- Verify together:
- Antigravity: MCP panel →
figma-remote → ~18 tools
- OpenCode:
opencode mcp list → figma connected
- LM Studio: Program → mcp.json →
figma (~18 tools); needs v0.3.17+ and "Allow calling servers from mcp.json"
- If stuck → read GUIA-USUARIO.md section matching their error
Use plain Spanish. Short steps. Confirm each step before the next.
Choose target
| User says | --target |
|---|
| Antigravity | antigravity |
| OpenCode | opencode |
| LM Studio | lmstudio |
| Otro IDE después | repetir setup con otro --target (reutiliza tokens con --skip-auth) |
| Renew token | full setup again (or --skip-auth only if figma-mcp-tokens.json exists locally) |
Windows: python instead of python3.
What gets written (on user's machine only)
| IDE | Config path | Server name |
|---|
| Antigravity | ~/.gemini/config/mcp_config.json | figma-remote |
| OpenCode | ~/.config/opencode/opencode.json + ~/.local/share/opencode/mcp-auth.json | figma |
| LM Studio | ~/.lmstudio/mcp.json | figma |
Never commit or share figma-mcp-tokens.json, mcp_config.json, mcp-auth.json, or ~/.lmstudio/mcp.json.
Scripts
| Script | When |
|---|
scripts/setup.py | Main — auth + IDE config |
scripts/figma_mcp_auth.py | OAuth only |
scripts/setup_antigravity.py | Antigravity config only |
scripts/setup_opencode.py | OpenCode config only |
scripts/setup_lmstudio.py | LM Studio config only |
scripts/check_share_safe.py | Before sharing folder (no tokens) |
User-facing guide
Full step-by-step for non-technical users: GUIA-USUARIO.md
Constraints
- Guide step-by-step; do not assume technical knowledge
- Never share or paste another user's tokens
- No Node.js required
- Disable
figma-dev-mode-mcp-server in Antigravity if present (only 2 tools)
- LM Studio: requires v0.3.17+; enable "Allow calling servers from mcp.json" in Server Settings
Skill install paths
| Scope | Path |
|---|
| Global | ~/.gemini/antigravity/skills/figma-mcp-antigravity/ |
| Workspace | .agent/skills/figma-mcp-antigravity/ |
