---
title: "Figma MCP — OAuth Reconnect Requires Full Claude Code Restart"
source: daily/2026-05-10.md
updated: 2026-05-10
tags: [figma, mcp, oauth, claude-code]
---

# Figma MCP — OAuth Reconnect Requires Full Claude Code Restart

## Problem

If the Figma MCP server disconnects mid-auth-flow (e.g., Claude Code restarts while the browser OAuth popup is open, or the auth token expires), the MCP server enters a broken state. Subsequent tool calls fail silently or return auth errors even after completing OAuth in the browser.

## Fix

**Full Claude Code restart** is required to re-initialize the MCP connection and pick up the new OAuth token:

1. Complete the OAuth flow in the browser if the popup is open
2. Quit Claude Code completely (`Cmd+Q` in the desktop app, or kill the CLI process)
3. Restart Claude Code
4. The Figma MCP will reconnect with the fresh OAuth token on startup

## Why

The Figma MCP server holds OAuth state in memory. A mid-flow disconnect leaves the state machine in an inconsistent position — refreshing the browser or re-triggering auth in the same session does not reset it. A process restart resets all MCP server state cleanly.

## Prevention

Avoid restarting Claude Code while an OAuth browser window is open. If you must restart, close the browser popup first, then restart Claude Code, then re-trigger auth from scratch.
