git404hub

what is zcode-figma-mcp fr?

darkgenius/zcode-figma-mcp — explained in plain English

Analysis updated 2026-05-18

1JavaScriptAudience · developerComplexity · 3/5Setup · moderate

tl;dr

A helper script that lets ZCode authenticate with Figma's MCP server by working around Figma's fixed list of approved client names, then saving the resulting login into ZCode's credentials file.

vibe map

mindmap
  root((repo))
    What it does
      OAuth workaround
      Token injection
      Credential encryption
    Tech stack
      Node.js
      JavaScript
      OAuth
    Use cases
      Figma MCP auth
      Token refresh
      Connection debugging
    Audience
      ZCode users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Connect ZCode to Figma's MCP server even though ZCode isn't on Figma's approved client list.

VIBE 2

Manually inject OAuth tokens into ZCode's encrypted credentials file.

VIBE 3

Re-authenticate with Figma's MCP server when saved access tokens expire.

VIBE 4

Debug why ZCode's Figma MCP connection isn't showing as connected.

what's the stack?

Node.jsJavaScriptOAuthMCP

how it stacks up fr

darkgenius/zcode-figma-mcp0xmukesh/docusaurus-tutorial1tsmejp/palworld-docker-wine
Stars111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-12-27
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity3/52/54/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires ZCode to have already attempted (and failed) a Figma MCP connection once before running this script.

No license information is stated in the README.

in plain english

zcode-figma-mcp is a small helper script that solves a specific compatibility problem between two developer tools. ZCode is a coding assistant that can connect to external services through something called MCP, a protocol that lets it use extra tools like Figma's design service. Normally, connecting to Figma's MCP server requires going through a login process, but Figma only allows a fixed list of approved application names to complete that login, and ZCode is not on that approved list, so the standard connection attempt fails before it even starts. This script works around the restriction by using a different, already approved application name during the login step, completing the full login process that way, and then taking the resulting access codes and saving them directly into ZCode's own local storage of login credentials. Once that is done, ZCode can use those saved credentials normally the next time it starts, without needing to go through its own blocked login attempt again. To use the script, you need Node.js version 20 or newer, and you must have already tried connecting ZCode to the Figma service at least once, even though that attempt fails, because ZCode needs to have recorded some initial information about the connection first. Running the script opens your web browser so you can approve the login through Figma's own website, then it captures the response, encrypts it using the same method ZCode already uses to protect its saved credentials, and writes it into ZCode's credentials file. It automatically makes a backup of that file first and double checks that what it wrote can be read back correctly before finishing. The saved login eventually expires, roughly every ninety days, at which point you simply run the script again and restart ZCode. The project also documents a handful of specific error messages and their fixes, covering things like browser connection issues on Mac computers and cases where the script cannot figure out which saved entry belongs to Figma.

prompts (copy fr)

prompt 1
Walk me through running this script to authenticate ZCode with Figma's MCP server.
prompt 2
Explain how this script figures out which server-id belongs to the Figma MCP connection.
prompt 3
Help me troubleshoot a localhost connection error after clicking Authorize in the browser.
prompt 4
Show me how ZCode encrypts and stores its OAuth credentials so I understand what this script writes.

Frequently asked questions

what is zcode-figma-mcp fr?

A helper script that lets ZCode authenticate with Figma's MCP server by working around Figma's fixed list of approved client names, then saving the resulting login into ZCode's credentials file.

What language is zcode-figma-mcp written in?

Mainly JavaScript. The stack also includes Node.js, JavaScript, OAuth.

What license does zcode-figma-mcp use?

No license information is stated in the README.

How hard is zcode-figma-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is zcode-figma-mcp for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.