darkgenius/zcode-figma-mcp

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.