> ## Documentation Index > Fetch the complete documentation index at: https://docs.metal.ai/llms.txt > Use this file to discover all available pages before exploring further. # Slack integration: install Metal and connect your account > Install the Metal app in your Slack workspace, approve the channels it can answer in, and link your Slack account so @Metal answers with your Metal access. Metal works inside Slack, the chat app many firms use for day-to-day conversation. Once an admin connects Metal to your Slack workspace, people can ask @Metal questions without switching tabs, and Metal answers with the same records that person can see in Metal itself. ## The short version 1. An admin installs the Metal app in Slack. 2. The admin invites @Metal to the channels where people want to use it. 3. Each person links their Slack account to their Metal account once. ## Slack terms in this article | Term | What it means | | - | - | | **Workspace** | Your firm's private Slack area, with its own members and channels. | | **Channel** | A shared conversation in Slack, usually around a team or topic. | | **Direct message** | A private conversation between two people, or between a person and an app such as @Metal. | | **Mention** | Typing `@Metal` in a message so the app is notified. | ## Before you start * **A Metal admin installs the app.** You also need permission to install apps in the Slack workspace. Slack may require a workspace owner to approve new apps, depending on your Slack settings. * **Each person needs a matching email.** Metal links a Slack account to a Metal account by email, so the email on a Slack profile must match the person's Metal email. * **Shared channels are not supported.** @Metal doesn't answer in channels shared with other organizations through Slack Connect. > [!NOTE] > > Slack works one workspace at a time. If your firm has more than one Slack workspace, install Metal in each one. ## Install Metal in Slack (admin) **1. Open the Slack integration in Metal** Go to **Settings → Integrations**, then select **Slack**. **2. Start the install** Click **Install Slack**. If a workspace is already connected, click **Add workspace** instead. **3. Allow Metal in Slack** Slack opens. Choose the workspace, review the permissions, and click **Allow**. Metal asks to send messages and replies as @Metal, read the channels it's added to and direct messages sent to it, read basic profile information including email, and show when it's working on an answer. **4. Confirm the connection** Metal returns to the Slack page with **Slack workspace connected**. The page lists the workspace and a status label such as **Healthy**. Metal reads messages only in channels it's been added to and in direct messages people send it. It can't read other conversations in the workspace. ### Install from a shareable link You can also start the install from Metal's shareable **Add to Slack** link. Send it to the person who manages the Slack workspace. > [!NOTE] > > Shareable-link installs are rolling out. If the link returns an error, install from **Settings → Integrations → Slack** instead. **1. Open the link** Open [Add Metal to Slack](https://slack.com/oauth/v2/authorize?client_id=2910616828069.11956283406215\&scope=assistant:write,chat:write,im:write,im:history,users:read,users:read.email,channels:history,groups:history,app_mentions:read,channels:read,groups:read\&user_scope=). Slack asks which workspace to add Metal to. **2. Choose the workspace and allow Metal** Pick the workspace, review the permissions, and click **Allow**. **3. Sign in to Metal** Sign in with your Metal admin account. Metal connects the workspace to your organization and lists it on the Slack page. Each Slack workspace connects to one Metal organization. If the workspace is already connected to another Metal organization, an admin there must uninstall Metal before the workspace can connect to yours. ### Choose the channels Metal can answer in Installing the app doesn't add it to any channel. An admin adds it where it's needed: 1. In Slack, open the channel. 2. Type `/invite @Metal` and send. A channel becomes available to Metal as soon as the app joins it, and it appears under **Approved channels** on the Slack page. To stop Metal answering in a channel, open the Slack page, click the channel under **Approved channels**, and click **Revoke**. To use the channel again, remove @Metal from the channel in Slack, then invite it again. Direct messages don't need approval. ## Link your Slack account Metal needs to know which Metal account is asking, so it can answer with that person's access. The first time someone uses Metal in Slack, Metal checks for a link. If there isn't one, it sends the person a direct message with a **Connect Metal** button. **1. Open the connect message** In Slack, open the direct message from @Metal and click **Connect Metal**. If you don't have the message, send @Metal a direct message to get one. **2. Sign in to Metal** If Metal asks you to sign in, use your Metal account. **3. Confirm the account** Check the workspace, Slack email, and Slack user ID, then click **Link Slack account**. You link once per workspace. Check the link any time at **Settings → Connections → Slack**. Click **Unlink** there to disconnect your account. Each person links their own account. @Metal answers with the access of the person who asked, so two people can get different answers to the same question. ### If your email doesn't match Metal links accounts by email. If the email on your Slack profile doesn't match your Metal account, Metal can't link them and tells you so. * Update your Slack profile email to match your Metal email, or ask your Metal admin to update your Metal email. * If Metal says it couldn't read an email, your Slack profile may not have one. Add an email, and ask a workspace admin to allow profile email visibility if your workspace restricts it. ## Use Metal in Slack * **Direct message.** Open @Metal in your Slack sidebar under **Apps** and ask a question. Metal replies in the direct message. * **Channels.** Mention @Metal in a channel it's in, and it replies in a thread, the reply chain under your message. Mention it again to continue the conversation. * **Mentions only.** Metal doesn't read or answer channel messages that don't mention it, so say @Metal each time. ## Troubleshooting | What you see | What to do | | - | - | | "This channel isn't approved for the Metal assistant yet." | An admin invites @Metal to the channel. | | Metal doesn't answer in a channel | Check that the app is in the channel and mention @Metal by name. Metal ignores messages that don't mention it. | | "The Metal assistant isn't available in channels shared with other organizations." | Use a channel inside your own workspace, or a direct message. | | Metal replies by direct message instead of in the channel | The person hasn't linked their Slack account yet. Open the direct message and click **Connect Metal**. | | "Your Metal account isn't connected to this Slack workspace yet..." in a direct message | Click **Connect Metal**. If the link expired, message @Metal again for a new one. | | Metal says it couldn't read an email on your Slack profile | Add an email to your Slack profile that matches your Metal email. A workspace admin may need to allow profile email visibility. | | **Slack installation failed** in Metal | Click **Start install again**. If it fails again, contact [support@metal.ai](mailto:support@metal.ai). | | **Slack integration is not configured** in Metal | The Slack app isn't configured for your Metal environment. Contact [support@metal.ai](mailto:support@metal.ai). | | The wrong workspace was connected | Click **Uninstall** on the Slack page, then install again. | ## Disconnect Slack * **Unlink your account.** Go to **Settings → Connections → Slack** and click **Unlink**. @Metal stops answering with your Metal access. * **Remove a workspace (admin).** Go to **Settings → Integrations → Slack**, click **Uninstall** next to the workspace, and confirm. Metal stops answering in that workspace for everyone. ## Related topics - [Enable and connect Metal integrations](https://docs.metal.ai/help/integrations/overview.md) - [Connect Cursor](https://docs.metal.ai/mcp/cursor.md) - [Connect Claude](https://docs.metal.ai/mcp/claude.md) - [Connect ChatGPT](https://docs.metal.ai/mcp/chatgpt.md) - [CRM integration](https://docs.metal.ai/help/integrations/crm.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.