A different Figma workflow
Claude's FigJam connector is not the same as Claude Code + Figma MCP
The names are close enough to create confusion. Claude can connect to Figma through a user-facing connector that turns conversation and source material into FigJam diagrams. Claude Code can connect to Figma's broader MCP server for design context, design-to-code, Code Connect and supported write-to-canvas workflows. Both use Figma capabilities, but they serve different moments in the work.
Use Claude and FigJam when a team needs to see a process, decision, plan or system together. The output is an editable collaborative board rather than production code. Use Claude Code and the Figma MCP server when a developer needs structured context from Figma Design or Figma Make while working inside a repository.
Figma says the connector in Claude currently supports FigJam rather than its other products. That limitation is useful because it clarifies the promise. You are not asking Claude to become a visual product designer. You are asking it to structure information as a diagram that people can refine on a shared canvas.
In Claude, the diagram can appear as a preview and respond to follow-up requests before you open it in FigJam. That makes Claude a good drafting surface for a non-technical user. In a Claude Code workflow, diagram generation and editing behave differently; Figma notes that additional diagram edits happen in FigJam. Choose the surface based on who owns the next action.
Choosing the form
Start with the question, not the diagram type
Teams often ask for a flowchart because it is the diagram name they remember. I choose the form only after identifying the question the canvas must answer. The table below is a useful filter.
Flowchart
What happens next?
Good for: Onboarding, support escalation, approval processes and operational handoffs.
Watch for: A flowchart becomes unreadable when every exception is treated as a main path.
Decision tree
Which choice should we make?
Good for: Qualification, troubleshooting, policy decisions and product routing.
Watch for: The branch criteria must be mutually understandable, not merely short labels.
Sequence diagram
Who talks to whom, and in what order?
Good for: API calls, authentication, payment flows and service interactions.
Watch for: Do not hide retries, failures and asynchronous events that change the system behavior.
State diagram
What states can this thing occupy?
Good for: Subscriptions, orders, tickets, documents and interface controls.
Watch for: Every transition should have a trigger and impossible transitions should stay impossible.
Gantt chart
When does the work happen?
Good for: Launch plans, migrations, research programs and cross-team delivery.
Watch for: Dates generated without owners, dependencies and capacity are decorative rather than operational.
Architecture diagram
How is the system organized?
Good for: Services, data stores, queues, third-party dependencies and trust boundaries.
Watch for: A clean box diagram can conceal data sensitivity, protocols and failure behavior.
A journey map and a system sequence diagram may describe the same feature, but they answer different questions. The journey map follows the person's experience. The sequence diagram follows messages between systems. Trying to make one diagram satisfy both audiences usually creates a crowded board nobody trusts.
Ask Claude to recommend a format and explain the choice. If the source includes several distinct questions, request separate diagrams connected by a small index rather than one enormous canvas. FigJam makes it easy to keep related views in one board without collapsing them into a single unreadable artifact.
Connection
How to connect Figma and create the first diagram
Begin in Claude's connector or tools settings and add Figma. Sign in with the Figma account that should own or edit the resulting board, review the requested access and approve it. You need an existing Figma account. Figma says the diagram integration is available across its plans, although account, region and AI-feature availability can affect what appears.
For the first test, use source material you understand well. A one-page launch brief is better than a 70-page strategy deck because you can recognize omissions immediately. Ask Claude to summarize the source into actors, outcomes, decisions, dependencies, dates and unknowns. Correct that structured list before generating the visual.
Next, name the diagram and audience. “Create a diagram” invites Claude to make aesthetic choices without an operational target. “Create a support escalation flow that a new agent can follow during a live customer call” gives the visual a job. Specify the starting event, ending states, branch criteria and information that must remain visible.
Review the preview in Claude. Ask for fewer crossing lines, clearer branch labels or a separate exception lane. Once the logic is sound, open it in FigJam. That is where the team can rearrange objects, add comments, assign owners and attach links. Claude should accelerate the first structured draft, while FigJam becomes the collaborative record.
Read the attached project brief before drawing anything.
First extract:
- actors and owners
- the event that starts the process
- decisions and branch criteria
- dependencies and handoffs
- failure or exception paths
- unresolved questions
Then recommend one diagram type for a cross-functional launch review.
Explain the choice and wait for approval before creating the FigJam diagram.Source discipline
Turn messy source material into a trustworthy visual
Diagrams create a dangerous sense of certainty. A box and arrow look intentional even when Claude inferred both from an ambiguous paragraph. I therefore separate sourced facts, reasonable inferences and unknowns. The visual should not make those categories indistinguishable.
For a project plan, dates must come from the brief or be marked as proposals. Owners should be named roles or people rather than “team.” Dependencies should describe what must be true, not merely which task appears above another. For a system diagram, protocols, data classifications and trust boundaries should be explicit when known and visibly unknown when absent.
PDFs often contain repeated headers, old versions and diagrams flattened as images. Ask Claude which sections it used and whether pages conflict. A screenshot may omit surrounding context. A meeting transcript may contain suggestions that were never approved. The pre-diagram extraction step is how you catch these problems before they become polished boxes.
When the source is incomplete, make an assumption lane in FigJam. This is more honest and more useful than hiding uncertainty in a footnote. The team can resolve each assumption and move it into the main diagram. The board then records how understanding changed, not only the final arrangement.
Four practical builds
Prompts that produce a working artifact, not visual decoration
1. Customer-support escalation
Give Claude the policy, service levels and sample tickets. Ask for a flowchart that begins when a frontline agent cannot resolve the issue. Require branch labels based on severity, customer tier, data sensitivity and outage status. Include owner, response-time target and terminal state for every branch. Ask Claude to put policy gaps in a separate section rather than inventing a rule.
2. Product launch plan
Provide the approved launch date, workstreams, known dependencies and team capacity. Ask for a Gantt chart with milestones rather than a bar for every minor task. Require an owner and acceptance condition for each milestone. Highlight the critical path and show where legal, security or app-store review can move the date. Request a second “decision required” section for unresolved scope.
3. Authentication sequence
Supply the architecture notes and relevant API documentation. Ask for actors such as browser, application server, identity provider and database. Require the protocol or token at each step, the redirect, session creation, refresh path and failure behavior. Have an engineer verify every message. A sequence diagram is especially capable of looking plausible while reversing an important security responsibility.
4. Research synthesis
Give Claude interview notes with participant labels and a research question. Ask it to cluster observations without collapsing disagreement. Create a FigJam board with evidence, interpretation, implication and open question as separate sections. Keep quotations attached to participant identifiers and obtain appropriate consent before placing sensitive research into a connected AI workflow.
Quality control
A diagram review has three passes
PASS 1
Logic
Are the actors, transitions, dependencies and branch criteria correct? Can every path reach a valid end?
PASS 2
Reading
Can the intended audience understand the diagram without the author narrating it? Are labels concrete and lines easy to follow?
PASS 3
Action
Does the board make the next decision, owner or unresolved question obvious? Can the team update it after the meeting?
Logic comes first because a beautifully arranged mistake is harder to challenge. Ask the subject-matter owner to trace representative paths aloud. In a state diagram, try an impossible transition. In a timeline, move a dependency and see which dates should change. In an architecture diagram, follow sensitive data from entry to storage.
Reading comes next. Reduce crossing connectors, shorten labels without removing meaning and create clear entry points. Use sections or lanes consistently. Do not encode critical meaning only through color; colleagues with color-vision differences and exported grayscale copies still need to understand the board.
The action pass determines whether the diagram will survive. Add an owner and review date. Link source documents. Mark assumptions. Archive superseded versions instead of silently overwriting history. A diagram becomes valuable when it supports a decision and remains maintainable after the workshop.
From workshop to work
The board should produce decisions, owners and durable records
A generated diagram earns its place after the meeting, not during the impressive first minute. I use the FigJam result as a shared reasoning surface, then convert the accepted parts into the systems where work is actually governed. A launch timeline should create or update project tasks. An architecture discussion should produce a decision record. A support flow should update the operating procedure and ownership matrix. The board remains the visual explanation, but it is not the only record of what the team agreed.
Before a workshop, I ask Claude to mark uncertainty visibly. Confirmed steps can use normal nodes; assumptions can carry an "ASSUMPTION" prefix; unresolved choices can sit in a separate question lane. That makes disagreement useful. Participants can challenge a branch without wondering whether it came from source material, an AI inference or the facilitator's memory. I also put the source title and date on the board so nobody mistakes an old plan for current policy.
During the session, I assign one person to edit logic and another to capture decisions. The logic editor changes nodes and connections only after the group agrees. The decision recorder writes a compact note with the decision, owner, date, alternatives considered and follow-up. This avoids a common failure where the canvas changes continuously but the reasoning behind those changes disappears. For a complex process, I duplicate the initial generated section before the meeting so the team can compare the proposed and accepted versions.
At the end, I run a closeout prompt against the reviewed board: "List every confirmed decision, named owner, deadline, unresolved question, dependency and contradiction. Do not invent missing owners or dates. Separate information shown on the board from your recommendations." I read that output against the canvas rather than pasting it directly into a project tool. The summary is a completeness check, not a replacement for human confirmation.
Within one working day, the owner moves actions into the project system and links each task back to the relevant FigJam section. Technical decisions move into versioned records near the code. Policy changes move into the controlled handbook or procedure. Research evidence stays connected to the original repository with participant protection intact. I add those backlinks to the board, creating a useful index between the visual model and the durable artifacts.
The maintenance rule is simple: identify a named owner and a trigger for review. A customer journey may need review after a major release; an incident flow after every serious incident; a quarterly plan at each planning cycle. When the source system changes, update the durable record first and then bring the diagram into line. If nobody can say which artifact wins during a conflict, the workflow has created another source-of-truth problem.
Before
Label evidence, assumptions and open questions.
During
Edit agreed logic and record why decisions changed.
After
Move actions and decisions into governed systems.
Maintain
Assign an owner, review trigger and winning source.
Boundaries
Privacy, governance and the limits of a generated canvas
A connector moves information between services. Before uploading a customer transcript, architecture document or personnel plan, apply the same data-classification rules you would use for any other connected AI tool. Remove secrets and unnecessary personal data. Use approved organizational accounts and confirm retention and access controls for your environment.
The Figma account that receives the board matters. Check team ownership and sharing settings before opening a diagram broadly. A useful habit is to create the first draft in a restricted project, complete the logic review and only then move or share the cleaned board with the wider team.
Claude can structure what it sees, but it does not know the unwritten political, operational or technical reality around the document. It may simplify conflicting stakeholder goals into a false linear process. It may infer a dependency because two tasks appear near each other. It may choose a reasonable date that nobody has staffed. The quality checklist is not bureaucracy; it is what prevents visual fluency from being mistaken for truth.
Finally, do not use a FigJam board as the only durable technical specification. Link it to requirements, tickets, code and decision records. The diagram should make the system easier to discuss. It should not become an unversioned substitute for all the artifacts that make the work accountable.
Sources and related work
Keep the workflow current
Figma and Claude are changing their connector and MCP capabilities quickly. The limits in this guide reflect official documentation checked on July 24, 2026. Verify current plan access and supported surfaces when a control has moved or a capability is missing.
Frequently asked questions
Can Claude create FigJam diagrams?
Yes. Figma's official connector for Claude can turn a prompt or source material into editable FigJam diagrams, including flowcharts, decision trees, Gantt charts, sequence diagrams and state diagrams. Claude shows a preview in the conversation and provides an Edit in Figma route so the diagram can become a shared FigJam artifact.
Does the Claude connector create normal Figma Design files?
Figma's dedicated connector inside Claude currently focuses on FigJam diagrams, not general Figma Design files. Claude Code connected through the broader Figma MCP server is a different workflow and can work with Figma Design, FigJam and design-to-code context. Choose the connector for collaborative diagrams and the MCP coding workflow for product implementation.
What is the difference between Claude and Claude Code for FigJam?
In Claude, you can generate a diagram, preview it in the conversation and refine it through follow-up prompts before opening it in FigJam. In Claude Code, the Figma MCP workflow can generate or work with FigJam content, but Figma says additional edits to a generated diagram happen in FigJam. Claude is therefore the easier surface for an iterative non-coding diagram conversation.
Which Figma plan is required for Claude and FigJam?
Figma's Help Center says the Claude and FigJam diagram integration is available on any Figma plan, but you need an existing Figma account and access to the relevant AI features. Product access can change, so confirm the current plan and regional availability when the connector is not visible.
Can I give Claude a PDF or screenshot and ask for a FigJam diagram?
Yes. Figma describes a workflow in which Claude can create a diagram from written prompts, PDFs, images or screenshots. The quality still depends on the source. Ask Claude to extract actors, decisions, dependencies and unknowns before diagramming so a messy document does not become a confidently wrong visual.
Are Claude-generated architecture diagrams reliable?
They are useful first drafts, not automatically reliable technical records. Claude can organize services, interactions and dependencies from supplied documentation, but an engineer must verify protocols, trust boundaries, data stores, failure modes and deployment details. Mark assumptions and unknowns visibly before the diagram is shared as architecture truth.