[BUG] Figma MCP never transitions from auth mode to operational mode

[DaveLaFontaine]

Preflight Checklist

• I have searched existing issues and this hasn't been reported yet
• This is a single bug report (please file separate reports for different bugs)
• I am using the latest version of Claude Code

What's Wrong?

Description:
The built-in Figma MCP server gets stuck in authentication mode and never exposes actual Figma tools, even after successfully completing the OAuth flow.

What Should Happen?

Steps to reproduce:

Open Claude Code — Figma MCP appears with only authenticate and complete_authentication tools
Call authenticate → receive OAuth URL
Open URL in browser → log in to Figma → browser shows "Authentication Successful"
Back in Claude: the auth tools disconnect, but no Figma tools appear — the MCP server simply goes away
After a delay, the MCP server reconnects — but only with the auth tools again (step 1 repeats)
Expected behavior:
After OAuth completes, the Figma MCP should expose its full set of tools (get_file, get_comments, etc.)

Actual behavior:
The MCP server disconnects after auth and never transitions to an operational state. The OAuth token does not appear to be persisted anywhere (not in macOS Keychain, not in ~/.claude/, not in ~/Library/Application Support/Claude/). Every restart and every auth attempt results in the same loop.

Error Messages/Logs

Additional context:

~/.claude/mcp-needs-auth-cache.json always shows {"figma":{"timestamp":...}} even after successful auth
No Figma-related token found in macOS Keychain (security find-generic-password returns nothing)

Steps to Reproduce

Steps to reproduce:

Open Claude Code — Figma MCP appears with only two tools: mcp__figma__authenticate and mcp__figma__complete_authentication
Call mcp__figma__authenticate → receive an OAuth URL
Open that URL in a browser → log in to Figma → browser shows "Authentication Successful / You can close this window. Return to Claude Code."
Back in Claude Code: the auth tools disconnect (system reminder: "MCP server disconnected")
No Figma tools appear. The MCP server goes silent.
After a delay, the MCP server reconnects — but only the two auth tools reappear. Loop repeats from step 1.

Claude Model

Sonnet (default)

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

2.1.142

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response

[DaveLaFontaine]

Files silently with no logs

Additional investigation findings:

~/.claude/mcp-needs-auth-cache.json always shows {"figma":{"timestamp":...}} even after a successful auth flow
No Figma token found anywhere:
macOS Keychain (security find-generic-password returns nothing for figma/mcp.figma.com)
~/.claude/ — no token files
~/Library/Application Support/Claude/ — no token files
Claude Code's own OAuth tokens refresh correctly every 30 seconds (confirmed in logs) — the issue is specific to the Figma MCP token

[github-actions]

Found 3 possible duplicate issues:

1. [BUG] HTTP MCP OAuth tokens written to macOS Keychain but not loaded at session start — re-auth required every session #57674
2. [BUG] Figma MCP OAuth token not recognized on restart — re-authentication required every session #54742
3. [BUG] Figma MCP OAuth Token Not Persisting After Authentication #35957

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[github-actions]

This issue has been automatically closed as a duplicate of #57674.

If this is incorrect, please re-open this issue or create a new one.

🤖 Generated with Claude Code

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.