> ## 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 an account, add it to a Persona, and let Chat use that service.

Connectors let Chat and Personas use accounts you connect, such as Slack, Brex, and Apple apps on this Mac. You connect accounts in **Settings → Connectors**. After you connect an account, add that connector to the Persona that should use it.

## MCP

MCP (Model Context Protocol) is the shared format connectors use so a model can call tools. Without a connector, a Persona answers from what you type and from its instructions. When you add a connector, that Persona can also read or act in that service, so replies can use context from your accounts.

You ask in Chat. The model picks the MCP call. You do not type the call name.

## Built-in tools and custom servers

Some connectors need no account. You add them to a Persona the same way. You can also connect an MCP server you choose.

> [card] [Web search](https://developers.webai.com/connectors/web-search.md)
>
> Let a Persona search the web and cite what it finds.

> [card] [Local files](https://developers.webai.com/connectors/local-files.md)
>
> Let a Persona find files on this Mac and quote them.

> [card] [Custom MCP server](https://developers.webai.com/connectors/mcp-server.md)
>
> Add tools from a remote server or a local command.

## Requirements

Connectors are desktop-only. Account connectors and custom servers need a Tier 2 or higher Mac. See [System requirements](https://developers.webai.com/getting-started/system-requirements.md).

Cloud connectors need a model of 8B parameters or larger. Gemma 4 E2B still qualifies. Apple apps run on this Mac and do not use that size gate.

Cloud connectors send that work to the connected service. Apple connectors use this computer's data, and macOS may ask for Automation, Full Disk Access, or other permissions the first time. See the [Privacy Policy](https://www.webai.com/privacy).

## Writes and approval

A write is a call that sends, creates, changes, cancels, or trades. Each connector that can write has a **Write action** switch in [Settings → Connectors](https://developers.webai.com/settings/connectors.md). It is on until you turn it off. With it off, that connector's writes are not offered.

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

## How to add a connector to a Persona

**1. Connect the account**

If the connector needs a login, open [Settings → Connectors](https://developers.webai.com/settings/connectors.md), click **Connect** on that row, and finish sign-in. The row shows **Connected** when it works.

**2. Open Persona settings**

Click **Personas** in the left sidebar. On the list, open the card menu and click **Edit**. Or open the Persona, then click the settings icon. **Persona settings** opens.

**3. Add the connector**

Click **Abilities**. Under **Connectors**, click **Add**. Search for the connector, then click **Add** on its row.

**4. Sign in if it still needs it**

A connector that needs a login shows **Connect** instead of **Add**. Click **Connect** to sign in. Some connectors, such as DocuSign and Harvey, open **Settings → Connectors** so you can finish setup there. The next message can use the connector once it is added and connected.

Connecting an account under Settings does not add it to every Persona. To take a connector away from a Persona, uncheck it under **Connectors**. When you create a Persona, one setup step lets you choose its connectors.

> [!NOTE]
>
> Open a connector page in the sidebar to see the calls it may make. Every call is logged under **Recent tool actions** in [Settings → Connectors](https://developers.webai.com/settings/connectors.md).

## Common questions

> [accordion] How do I add a connector to a Persona?
>
> Connect the account under **Settings → Connectors** if it needs a login. Open the Persona, then **Persona settings** → **Abilities**. Under **Connectors**, click **Add**, then **Add** on its row. A connector that still needs a login shows **Connect** instead.

> [accordion] Do cloud connectors need a larger model?
>
> Cloud connectors need a model of 8B parameters or larger. Gemma 4 E2B still qualifies. Apple apps on this Mac do not use that size gate.

> [accordion] What's the difference between Apple and cloud connectors?
>
> Cloud connectors such as Slack and Brex send that work to the connected service. Apple connectors use this computer's data, and macOS may ask for Automation, Full Disk Access, or other permissions the first time. See the
> [Privacy Policy](https://www.webai.com/privacy).

> [accordion] Can Chat send, create, or trade without asking me?
>
> Not unless you choose **Always allow** for that connector. **Always ask** is the default, so webAI asks you to approve each write before it runs. **Always allow** runs that connector's writes without asking. Turn **Write action** off in **Settings → Connectors** to stop offering its writes.


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