> ## Documentation Index
> Fetch the complete documentation index at: https://wonder.design/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connections

> Connect your Figma and Linear accounts to Wonder: paste Figma designs with their images, let agent chats read your Figma files and work on your Linear issues, and reconnect or disconnect them.

Connections link your own accounts in other tools to Wonder. Connect Figma to paste designs with their images, and, in the desktop app, to let your agent chats read your Figma files. Connect Linear to let your agent chats work on your Linear issues.

**Before you start** · Web and desktop · Free plan

Linear is listed in the desktop app only, because only agent chats use it.

## Open your connections

Open **Settings** > **Connections**. The page lists:

| Group | Connection | What it's for |
| - | - | - |
| **Design** | **Figma** | Paste designs from Figma with their images. In the desktop app, agent chats can also read your Figma files. |
| **Planning** | **Linear** | Desktop app only. Agent chats can read and update your Linear issues as you. |
| **MCP** | **Wonder MCP** | Use Wonder from Cursor, Claude Code or Codex. **Open docs** opens the [Wonder MCP](https://wonder.design/docs/wonder-mcp.md) setup page. |

Each connection is yours only. Other people in your workspace don't use it; each teammate connects their own account.

## Connect Figma

1. Next to **Figma**, click **Connect Figma**.
2. Sign in to Figma and allow Wonder to access your account. In the desktop app, this opens in your browser.
3. Return to Wonder.

Wonder shows **Figma connected.** The Figma icon turns to color with a check mark; hover over it to see **Connected as** your Figma name.

With Figma connected:

* **Pasted designs keep their images.** Copy a selection in Figma and paste it on the canvas. Without the connection, layers and layout still come across, but images don't. See [Import from Figma](https://wonder.design/docs/import-from-figma.md).
* **Agent chats can read your Figma files** (desktop app). Paste a Figma link in a chat and the agent gets that design to work from, and it can open your Figma files as you while it works.

## Connect Linear

1. Next to **Linear**, click **Connect Linear**.
2. In your browser, sign in to Linear and allow Wonder to access your Linear workspace.
3. Return to Wonder.

Wonder shows **Linear connected.** The row shows your Linear name and workspace.

Agent chats can then read your Linear issues and update them as you. Ask your agent to pick up an issue, summarize what's assigned to you, or post an update when its work is done. Anything the agent changes in Linear is made under your Linear account.

In a chat's **Tools** list, your Figma and Linear connections show with the source **Wonder**. See [Tools and MCP servers](https://wonder.design/docs/tools-and-mcp-servers.md#where-the-list-comes-from).

## Reconnect a connection

When Figma or Linear stops accepting the connection, for example after Wonder's access is removed in Figma or Linear, the row shows **Reconnect needed** and *Figma no longer accepts the connection* or *Linear no longer accepts the connection*.

Click **Reconnect** on that row and sign in again. Your agent chats and Figma pastes use the new connection from then on.

## Disconnect

Click **Disconnect** on the connection's row. Wonder stops using that account:

* **Figma:** pasted Figma designs come in without their images, and agent chats can no longer read your Figma files.
* **Linear:** agent chats can no longer read or update your Linear issues.

Disconnecting only affects your own connection. To connect a different account, disconnect, then connect again and sign in with the other account.

## If something goes wrong

* **Couldn't connect Figma** or **Couldn't connect Linear**, with **Try again.** The sign-in was canceled or didn't finish. Click **Connect Figma** or **Connect Linear** again and finish signing in in your browser.
* **Could not refresh your Figma connection** or **Could not refresh your Linear connection.** Wonder couldn't load the connection's status. Click **Retry**.
* **Connect your Figma account to attach designs from Figma links.** You pasted a Figma link in a chat without a Figma connection. Connect Figma, then paste the link again.
* **Reconnect your Figma account to attach designs from Figma links.** Your Figma sign-in expired. Click **Reconnect** on the **Figma** row.
* **Your connected Figma account can't open that file.** The Figma account you connected doesn't have access to that file. Ask its owner to share it with you, or connect the account that has access.
* **Linear isn't listed.** Linear appears in the desktop app only. See [Desktop app and browser](https://wonder.design/docs/desktop-app-and-browser.md).

## Related

* [Import from Figma](https://wonder.design/docs/import-from-figma.md)
* [Wonder MCP](https://wonder.design/docs/wonder-mcp.md)
* [Tools and MCP servers](https://wonder.design/docs/tools-and-mcp-servers.md)
* [Choose what a chat works with](https://wonder.design/docs/choose-what-a-chat-works-with.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.