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

# Connectors

> Connect the services your Personas can use, and choose what they may change.

Connectors is where you connect accounts and servers so your Personas can act across them. You also choose what each connector may change and review the tool calls that ran. Click your name at the bottom of the sidebar, then **Settings**, then **Connectors**.

> [card] [Connect an account](#connect-an-account)
>
> Sign in to Slack, Brex, an Apple app, or another service.

> [card] [Choose what it may change](#writes-and-approval)
>
> Turn a connector's writes off, or choose whether each one asks first.

> [card] [Add a custom server](#add-a-custom-server)
>
> Bring tools from an MCP server you choose.

> [card] [Review tool actions](#action-history)
>
> See which tools ran, and whether they worked.

## Connect an account

**1. Open Connectors**

Click your name at the bottom of the sidebar, then **Settings**, then **Connectors**.

**2. Connect**

Under **Tools** or **Apple native tools**, click **Connect** on the service you want. Finish the sign-in, token, or macOS permission prompt that opens.

**3. Check the row**

The row shows **Connected** when it works. Click the row to see the account it uses and its **Write action** setting.

**4. Add it to a Persona**

Connecting does not add the connector to every Persona. Open **Persona settings**, click **Abilities**, and add it under **Connectors**. See [How to add a connector to a Persona](https://developers.webai.com/connectors/overview.md#how-to-add-a-connector-to-a-persona).

> [!NOTE]
>
> Connectors are in the desktop app. The **Tools**, **Apple native tools**, and **Custom Servers** sections need a Tier 2 or higher Mac. See [System requirements](https://developers.webai.com/getting-started/system-requirements.md).

> [!NOTE]
>
> A connector does nothing until a [Persona](https://developers.webai.com/using-webai/personas.md) has it. Each Persona has its own list under **Abilities**.

**Data connectors** and **Context sources** appear when they are turned on for your account.

## Writes and approval

Open a connected row to see what the connector can do. A connector that can send, create, change, or trade has a **Write action** switch. It is on until you turn it off. With it off, that connector's writes are not offered to the model.

Below the switch, choose how writes run:

* **Always ask** is the default. webAI asks you to approve each write before it runs.
* **Always allow** runs that connector's writes without asking.

Read-only connectors, such as Brex and Hugging Face, have no **Write action** switch.

## Add a custom server

**Custom Servers** lets you connect any MCP compatible server. Click **Add server**, fill in the server, then click **Add server** again to save it. A custom server is third-party code you choose to run or connect to. See [Custom MCP server](https://developers.webai.com/connectors/mcp-server.md) for the fields and the controls on each server.

## Disconnect

Open a connected row and click the trash icon. Confirm **Disconnect**. webAI removes that connector's saved credentials from this device. Chat can no longer use that connector until you connect it again.

## Action history

**Recent tool actions** lists tool calls on this device. Each row shows when it ran, the tool name, **Read** or **Write**, and the result: **Success**, **Failure**, **Rejected**, or **Cancelled**.

Tools without an account can appear here too, such as a [web search](https://developers.webai.com/connectors/web-search.md).

Click **Clear** to empty the list. That does not disconnect any connector.

## Common questions

> [accordion] How do I connect an account?
>
> Open **Settings → Connectors**, click **Connect** on the connector you want, and finish any sign-in or permission prompt. The row shows **Connected** when it works. See
> [Connectors](https://developers.webai.com/connectors/overview.md) for what each one can do.

> [accordion] Do writes need my approval?
>
> By default, yes. **Always ask** is the default, so webAI asks you to approve each write before it runs. If you choose **Always allow** for a connector, its writes run without asking. Turn **Write action** off to stop offering that connector's writes.

> [accordion] Can I add my own MCP server?
>
> Yes. Find **Custom Servers** and click **Add server**. A custom server is third-party code you choose to run or connect to, and it handles what you send it. See
> [Custom MCP server](https://developers.webai.com/connectors/mcp-server.md).

> [accordion] What is Action history?
>
> **Recent tool actions** lists recent tool calls from this computer so you can see what ran. Click **Clear** to empty it.

> [accordion] Where do I see every connector?
>
> See [Connectors](https://developers.webai.com/connectors/overview.md) for requirements and how to add one to a Persona. Each connector page in that section lists the calls Chat may make.


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