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

# MCP Integrations

> Connect and manage MCP integrations for your agents and workflows.

MCP (Model Context Protocol) integrations allow your agents and workflows to connect with powerful external tools and data sources in a standardized, secure way.

You can read more about MCP and its protocol at [Model Context Protocol Documentation](https://modelcontextprotocol.io/).

***

## ⚙️ Connecting MCP Integrations

From the **Integrations Library**, you can easily connect to one or more MCP servers.

1. Go to the **Integrations** page in the dashboard.
2. Select the **MCP** tab.
3. From the **Integrations Library**, click **Connect** on your desired MCP provider (for example, Gmail, Zendesk, or Trello).
4. A new tab will open prompting you to **sign in** and authorize the integration.
5. Once authorization is complete, you’ll return to the dashboard, and your **MCP server** will appear under **Active Integrations**.

<Image src="/images/mcp-integrations.png" alt="MCP Integrations Interface" />

***

## 🧩 Using MCP Integrations

Once connected, MCP integrations can be attached to:

* **Assistants** → to perform real-time actions like sending emails, fetching calendar events, or updating CRM data.
* **Workflows** → to automate multi-step tasks using contextual understanding and tool invocation.

You can explore available tools under each MCP integration by expanding the integration card.

> 💡 **Tip:** Each MCP integration can host multiple tools, so you can perform several actions within the same connected provider.

<div className="relative mt-[40px] rounded-xl p-[8px] bg-gradient-to-br from-[#ffa366] via-[#e88a46] to-[#ff5722] shadow-[0_0_35px_rgba(255,123,61,0.6)]">
  <div className="rounded-xl bg-background-light dark:bg-background-dark ring-1 ring-gray-400/30" style={{ padding: "12px" }}>
    <video width="100%" height="100%" autoPlay loop muted playsInline className="m-0 rounded-lg">
      <source src="https://mintcdn.com/firstpeak/PWI5ZlVtKYZTJjQu/videos/mcp_integration.mp4?fit=max&auto=format&n=PWI5ZlVtKYZTJjQu&q=85&s=0226d0f2c22783733311b3f2b2b461fc" type="video/mp4" data-path="videos/mcp_integration.mp4" />
    </video>
  </div>
</div>

***

## 🧰 Adding a Custom MCP Integration

If your desired MCP provider is not available in the pre-listed options, you can easily add it as a **Custom MCP Integration**.

1. Click **Add Custom MCP** in the MCP integrations tab.
2. Provide the following details:
   * **MCP Server URL**
   * **Headers (optional)** — key-value pairs for authentication or custom metadata
   * **Timeout (in seconds)** — to control the connection duration
3. Once configured, the system will automatically **connect to the MCP server**, **fetch the schema**, and add it to your **Active Integrations**.

You can then use this integration like any other provider — attach it to assistants or workflows and start utilizing its tools immediately.

<img src="https://mintcdn.com/firstpeak/PWI5ZlVtKYZTJjQu/images/custom_mcp.png?fit=max&auto=format&n=PWI5ZlVtKYZTJjQu&q=85&s=b1c6eecd00a4219a7630ed5167d0d9a8" alt="Custom MCP" width="1448" height="1090" data-path="images/custom_mcp.png" />

***

## 🔒 Authorization and Security

* MCP integrations use OAuth-based authentication where available.
* Credentials are securely stored and never exposed in plaintext.
* You can disconnect or revoke access at any time from the integration dashboard.

***