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

# Integrations in Chat

> Let the assistant look things up and act in your connected apps during a chat

> [!NOTE]
>
> Requires the **Integrations (MCP)** feature to be enabled for your organization. Ask your administrator if you can't see it.

Integrations connect tools your team already uses, such as a wiki, a ticket tracker or a CRM. When an integration is available in a chat, the assistant can call its tools while it answers: search pages, read tickets, look up a customer record or create an item.

## Before you start

Three things must be in place before the assistant can use an integration:

1. **Enabled for your organization.** An Owner or Manager turns the integration on. See [MCP servers](https://docs.blackmountain.io/admin/integrations/mcp-servers.md).
2. **Connected to your account.** Open **Integrations**, go to the **Connections** tab, click **+** on the integration and sign in or paste your API key. Every member connects their own account, and nobody sees anyone else's. See [Connections](https://docs.blackmountain.io/integrations/connections.md).
3. **Selected for the chat.** Pick a toolset or an integration in the composer, or use an assistant that has a toolset. See below.

If any of these is missing, the integration's tools are simply not offered in the chat. You don't get an error.

The assistant always acts with your own connected account. It can only see and do what your account is allowed to see and do in that app.

## Use an integration in a chat

You have three ways to bring integration tools into a chat. You can combine them.

**Pick a toolset.** A toolset bundles tools from one or more integrations for a purpose, for example everything needed for support tickets.

1. In the composer, click **+** (or type **@**).
2. Open **Toolset** and select a toolset.

**Pick a single integration.**

1. In the composer, click **+** (or type **@**).
2. Open **MCP server** and select an integration. Only integrations you can use right away are listed: ones you have connected, and ones that need no sign-in.

**Use an assistant with a toolset.** If an assistant has a toolset assigned, its tools are available whenever you chat with that assistant. See [Tools and toolsets](https://docs.blackmountain.io/assistants/tools-and-toolsets.md).

Your selection appears as a chip above the composer. Click the **X** on the chip to remove it.

## Ask the assistant to use it

Ask in plain language. The assistant chooses the right tool and calls it. Each call appears as a row in the chat, so you can see which tools were used.

Example prompts:

* "Find the open tickets assigned to me and summarize them by priority."
* "Search our wiki for the travel expense policy and tell me the limit for hotels."
* "Look up the customer Acme in the CRM and list their open opportunities."
* "Create a ticket for the login bug we just discussed, with the steps to reproduce."

If the assistant doesn't use the integration, name it in your prompt, for example "Use Linear to…".

## Limits and good practice

* **No confirmation step.** The assistant calls tools without asking you first, including tools that create or change data. Before you allow write actions, check which tools your toolset contains, and review the tool rows in the chat afterward.
* **Timeouts.** A tool call that takes longer than 30 seconds is stopped. The assistant sees the error and can try again or answer without it.
* **One integration at a time in the picker.** You can select one integration under **MCP server**. To use several, use a toolset that bundles them.
* Integrations are not used while [Deep Research](https://docs.blackmountain.io/chat/tools/deep-research.md) drafts its research plan.

## Related

> [card] [Integrations](https://docs.blackmountain.io/integrations/introduction.md)
>
> What integrations are and how they work.

> [card] [Connections](https://docs.blackmountain.io/integrations/connections.md)
>
> Connect and reconnect your accounts.

> [card] [Toolsets](https://docs.blackmountain.io/admin/integrations/toolsets.md)
>
> Bundle tools for a purpose.

> [card] [Tools and toolsets](https://docs.blackmountain.io/assistants/tools-and-toolsets.md)
>
> Give an assistant a toolset.


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