> ## 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.

# Tools and MCP servers

> See which MCP servers a chat's agent can use, where they come from, how to add, remove and sign in to them, and what to do when a tool is missing.

Your agent's tools come from MCP servers: Wonder's own canvas tools, plus the servers set up in Claude Code or Codex on this computer. **Tools**, in the chat's message box, shows the servers the chat's agent can use and whether each one is working.

**Before you start** · Desktop app · Free plan

## See the tools a chat can use

Click **Tools** in the message box: its icon is next to the context ring. The list starts with **Wonder**, then every server the agent has loaded. Hover a server to see how many tools it has. A red dot on **Tools** means a server needs you, for example to sign in.

![The Tools list of a chat: Wonder marked Ready, three servers with a check mark, and Railway with a Sign in button](https://mintcdn.com/wonder-0722b0f6/F-ozoOg52_861U5c/images/control-your-agent/tools-list.webp?fit=max\&auto=format\&n=F-ozoOg52_861U5c\&q=85\&s=1d00211ae72e023083a56b899b420da1)

| The row shows | What it means |
| - | - |
| A check mark, or **Ready** | The agent can use it. |
| **Connecting…** | The agent is starting it. |
| **Sign in** | Sign in before the agent can use it. See [Sign in to a tool](#sign-in-to-a-tool). |
| A warning icon and what went wrong, such as **Couldn't connect.** | It didn't start or couldn't connect. Click the warning icon for the details and what you can do. |
| **Not started** | The agent hasn't started yet. Tools connect when you send a message. |

Until the agent starts, the list says **The list fills in when the agent starts.** When two servers share a name, each shows where it comes from: **claude.ai**, **ChatGPT**, **Repository**, **Plugin** or **Wonder**.

## Where the list comes from

* **Wonder.** The canvas tools your agent uses to read and design in Wonder. Every chat has them, and they can't be removed. See [Wonder MCP tools](https://wonder.design/docs/wonder-mcp-tools.md).
* **Your agents' own settings on this computer.** The MCP servers in your Claude Code or Codex settings, the same ones the agent uses outside Wonder. **Settings > Agents > Tools** lists them for each signed-in agent.
* **The repository.** Servers the repository sets up for Claude Code (its `.mcp.json`) or Codex (its `.codex/config.toml`).
* **Your accounts.** Your claude.ai connectors in Claude chats and your ChatGPT apps in Codex chats. Turn them on or off with **Claude connectors** and **ChatGPT apps in Codex chats** in **Settings > Agents > Access**. See [Agent and chat preferences](https://wonder.design/docs/agent-and-chat-preferences.md#choose-what-your-agents-can-use).
* **Connections.** Figma and Linear, when you've connected them in **Settings > Connections**, show with the source **Wonder**.

There's no switch to turn a server off for one chat. A chat gets every server its agent loads, so to stop offering one, remove it from your agent's settings.

## Add a tool

1. Open **Settings > Agents > Tools** and click **Add tool** in the agent's group.
2. Give it a **Name**, such as `linear`.
3. Under **Runs**, choose **Remote URL** and paste the server's address, or **Local command** and enter the command that starts it.
4. Click **Add tool**.

Wonder adds the server to that agent's own settings, so it works outside Wonder too. New chats load it; start a new chat to use it. Names starting with `wonder` are kept for Wonder's own tools.

## Remove a tool

1. Click the trash icon next to the server in **Settings > Agents > Tools**. For a server that's failing, you can also click its warning icon in the chat's **Tools** list and choose **Remove**.
2. In **Remove this tool?**, click **Remove tool**.

The server is taken out of the agent's own settings, in Wonder and outside it, and running chats stop offering it straight away. You can remove servers from your own settings only. Those set up by the repository or by your claude.ai or ChatGPT account are changed where they were set up.

## Sign in to a tool

1. Click **Tools** and find the server with a **Sign in** button.
2. Click **Sign in**. Your browser opens; finish signing in there.

If Wonder can't sign in to the server itself, the row tells you how: run `/mcp` in Claude Code, or `codex mcp login` in a terminal.

## If something goes wrong

* **A tool you expect isn't in the list.** Click the refresh button in **Tools**. It reads the list again and reconnects every server that failed or needs sign-in, which picks up changes made in your agent's settings. A server you've just added loads in new chats only, so start a new chat.
* **"Couldn't connect."** The server can't be reached. Click **Retry**, or click the warning icon and choose **Fix with agent** to have the chat's agent look into it.
* **"Token rejected. Replace it where this tool is set up."** The server's token has expired or is wrong. Update it in the settings that set up the server. For a repository server in a Claude chat, click **Open .mcp.json**.
* **"Its setup has an error." or "Its program didn't start."** Click the warning icon and choose **Fix with agent**, or correct the server's settings yourself.
* **"Needs …. Add it to your shell profile, then try again."** The server needs an environment variable Wonder can't see. Add it to your shell profile and try again.
* **"Canvas tools are off".** Wonder couldn't give this chat access to your canvas. Check that you're signed in to Wonder, then send your message again.
* **"Wonder can't read Claude Code's settings." or "Wonder can't read Codex's settings."** The agent's settings file has an error. Fix it in your editor, then click **Check again** (the refresh button) in **Settings > Agents > Tools**.

## Related

* [Wonder MCP tools](https://wonder.design/docs/wonder-mcp-tools.md)
* [Choose what a chat works with](https://wonder.design/docs/choose-what-a-chat-works-with.md)
* [Agent and chat preferences](https://wonder.design/docs/agent-and-chat-preferences.md)
* [Wonder MCP troubleshooting](https://wonder.design/docs/wonder-mcp-troubleshooting.md)


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