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

# Connectors

> Connect a Driven Agent to external services, control tool permissions, and use connected tools in chat.

Connectors give an Agent access to tools from external services. A connector can add brokerage features, research data, productivity tools, or other capabilities provided by the service.

Each connector belongs to one Agent. Connect it separately if another Agent should use the same service.

## Connect from Explore

1. Open the Agent that should use the connector.
2. Click **Connectors**, then open **Explore**.
3. Select a connector to review its author, server URL, description, and available tools.
4. Click **Connect**.
5. Complete the service's authorization flow if prompted.

After the connection succeeds, it appears under **My connectors**.

## Add a custom connector

Use a custom connector when a service gives you a compatible server URL that is not listed in **Explore**.

1. Open **Connectors** and click **Add connector**.
2. Enter a name and the **Server URL** supplied by the connector developer.
3. If the developer requires your own OAuth application, open **Advanced settings** and enter its client ID and optional client secret. Otherwise, leave these fields empty.
4. Click **Add** and complete authorization if Driven opens an authorization page.

<Warning>
  Only connect servers from developers you trust. Connector developers control the tools their servers expose and may change those tools over time. Review the connector URL, requested access, and available tools before using it.
</Warning>

## Choose a permission mode

Open a connected connector's detail page to change **Permissions**. New connectors default to **Allow read-only actions**.

| Mode                        | Behavior                                                                           |
| --------------------------- | ---------------------------------------------------------------------------------- |
| **Allow read-only actions** | Driven can run tools classified as read-only. Other actions require your approval. |
| **Allow all actions**       | Driven can run the connector's tools without asking each time.                     |
| **Ask every time**          | Driven asks for approval before every connector tool call.                         |

Read-only classification uses the connector server's labels and tool-name patterns. Treat it as a safeguard, not a guarantee. Review approval requests carefully, especially when a tool can trade, send messages, modify records, or disclose data.

## Use a connector in chat

You can use a connector in four ways:

* Describe what you need in natural language. The Agent can automatically choose a relevant connected connector for the task.
* Click the **Connectors** icon in the chat composer and choose a connected service.
* Type `/` and choose a connector from the **Connectors** section.
* Open a connected connector's detail page and click **Try now**.

The selected connector appears as a chip in the composer. Write your request and send it normally. The Agent can then use that connector's tools for the request. If an action requires approval, review the proposed action and choose whether to approve or deny it.

## Manage a connector

Open **My connectors** to manage every connector attached to the current Agent.

* Turn the switch off to pause a connector without removing its stored connection.
* Turn it on to make it available again.
* Select **Re-authorize** if its authorization has expired or failed.
* Open the detail page to review the current server URL, tools, and permission mode.
* Select **Disconnect** from the `...` menu to remove the connector and its stored credentials immediately.

Connector settings do not have an edit flow. To change the server URL or OAuth client credentials, disconnect the connector and add it again.

## Troubleshooting

* **Connectors is missing or disabled:** the feature may not be enabled for your account yet.
* **Authorization did not finish:** open **My connectors** and select **Authorize** or **Re-authorize**.
* **No tools appear:** open the connector detail page. The server may currently expose no tools, or the connection may need to be retried.
* **A connector stopped working:** verify that the server URL is still current, re-authorize if prompted, and confirm the external service is available.

## Related

* [Agents](/concepts/agents) - connectors are configured separately for each Agent
* [Skills](/concepts/skills) - reusable workflows that can use available tools
* [Data sources](/reference/data-sources) - the built-in financial data available without a connector