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

# Connecting a tool

> Press Add Connection, pick the app, choose who may use it, and sign in or paste a key.

1. On **Connections**, press **Add Connection**.
2. **Pick the app.** Search the catalog of more than 1,500 apps, or browse by category. Under the results, two other ways in: **A tool server** by URL, or **An API key for another app** by its base URL. See [Custom tools](https://docs.ergoly.ai/work/connections/custom-tools.md).
3. **Access.** Choose who may use it. The narrowest option is the default. See [Placement](https://docs.ergoly.ai/work/connections/placement.md).
4. **Name** it, and add a **Description** in your own words. Workers read the description to decide when to use it.
5. **How to connect.** **Sign in** opens the app's own sign-in in a new tab; every worker placed here then acts as the account you sign in with. **Use a key** takes a key, checks it once, and keeps it out of every worker's reach. **No sign-in** is for tools that need none.
6. Press **Connect** and finish in the other tab. The person who signs in does not need an Ergoly account.

## From Slack

A worker can ask for a connection within its own reach, posting a sign-in link that lasts a few minutes or taking a key pasted in the thread. A workspace admin can also DM a worker `connect <app>`, such as `connect hubspot`, and get a link. Your AI Admin can connect an app for any worker and place it anywhere. See [Connections, under Workers](https://docs.ergoly.ai/workers/connections.md).

## Later

A connection's status is **Active**, **Waiting for sign-in**, **Expired**, **Failed** or **Revoked**. **Reconnect** on the card offers **Finish sign-in**, **Sign in again**, or **Replace key** as the status calls for. **Send reconnect links** at the top DMs each person who owns a pending sign-in with their links. **Remove** confirms on the card.

> [!NOTE]
>
> **Worth knowing.** If you would rather the sign-in screen show your agency's name than Ergoly's, add your own OAuth app under the **Legacy** tab, **Your OAuth apps**, with its client ID, secret, and the redirect URI control gives you to register.


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