# MCP Tools

This feature is currently in `BETA`. It may change before general availability, due to user and client feedback, but it targeted to be high quality and stable. Documentation may lag behind feature updates. Use in production environments at your own discretion. Please refer to our [Upgrade and Release Process](https://docs.unique.ai/it-operators/installing-and-upgrading-unique/upgrade-and-release-process) for more information.

**Feature Flag Required**  
MCP Tools for Spaces is a feature-flagged capability and must be explicitly enabled for your organization. To activate this feature, please contact your Customer Success representative.

## Functionality  
MCP (Model Context Protocol) Tools allow your space to connect to external services and data sources that have been configured by your organization's connector administrators. These tools extend your AI assistant's capabilities by enabling it to interact with specialized systems and APIs.

**What Space Admins Can Do:**  
- View MCP connectors that have been enabled for your organization  
- Enable or disable connectors for your specific space  
- Control which tools are available to users in your space by selectively enable or disable individual tools within each connector

**What You'll See:**  
- Connector name and description (provided by the connector admin)  
- Available tools for each connector (only tools enabled at the organization level)  
- Tool descriptions and capabilities

---

## Configuration

### Accessing MCP Tools
1. Navigate to your **Space Settings**
2. Go to **Sources & Tools**
3. Available MCP connectors are listed under the **MCP Tools** subsection

### Enabling an MCP Connector
**Step 1: Browse Available Connectors**  
The MCP Tools section displays all connectors that have been **made available to your organization by connector administrators**.

Each connector card shows:  
- Connector name  
- Description of the connector

MCP tools section in Sources & Tools

**Step 2: Open Connector Configuration**  
Click on `Settings` in a connector card Settings to open the configuration menu.

**Step 3: Review Available Tools**  
The overlay displays all **tools that have been enabled for your organization.**  
Note that:  
- Tools disabled by the connector admin will not appear in this list

**Step 4: Enable Tools**  
You have two options:  
- **Option A: Enable All Tools**  
  - Toggle the **Enable** slider to ON  
  - This activates all available tools for your space  
- **Option B: Selective Tool Enablement**  
  - Toggle the **Enable** slider to ON to enable all tools  
  - Disable specific tools that you don't want available in your space by toggling them OFF individually

List of tools from the connector configuration

**Step 5: Save Configuration**  
Click **Save** to apply your changes.

**Step 6: Tools Go Live**  
Once saved, the enabled tools will immediately appear in the chat interface for all users in your space. Users can now interact with these tools through the AI assistant.

---

### Disabling an MCP Connector
To disable a connector entirely:  
1. In the Space configuration navigate to the connector card in `Source & Tools > MCP Tools`
2. Toggle the main **Enable** slider to OFF
3. Click **Update** to save the Space settings

All tools from that connector will be removed from your space's chat interface.

---

### Modifying Tool Selection
To change which tools are enabled:  
1. Open the connector configuration overlay  
2. Toggle individual tools ON or OFF as needed  
3. Click **Save**

Changes take effect immediately for all space users.

---

## Best Practices  
**Review Tool Descriptions**  
Before enabling a connector, review the tool descriptions to understand what capabilities you're adding to your space.

**Start Selective**  
Consider starting with a subset of tools enabled, then expanding based on user needs and feedback.

**Monitor Usage**  
After enabling new tools, evaluate user behavior and usage patterns to ensure the tools are providing value to your team.

**Regular Audits**  
Periodically review enabled connectors and tools to ensure they remain relevant to your space's needs.

---

## Troubleshooting  
### Connector Not Appearing
**Issue:** Expected connector doesn't show in MCP Tools section  
**Solution:**  
- Verify with your connector admin that the connector has been enabled for the organization  
- Refresh your browser

---

### Tools Not Visible in Chat
**Issue:** Enabled tools aren't showing up for space users  
**Solution:**  
1. Confirm you clicked **Save** after enabling the tools  
2. Ask users to refresh their chat interface  
3. Verify the tools are toggled ON in the connector configuration

---

### Limited Tool Selection
**Issue:** Fewer tools than expected are available  
**Solution:**  
- Remember that only organization-enabled tools appear in your space configuration  
- Contact your connector admin if you need access to additional tools from the connector

---

## Additional Resources  
- [Tools Overview](https://docs.unique.ai/administrators/space-management/tools) - Understanding all tools available in Spaces  
- [Create Spaces](https://docs.unique.ai/administrators/space-management/create-spaces) - Complete guide to space configuration  
- [MCP Protocol Specification](https://modelcontextprotocol.io/docs/getting-started/intro) - Technical details about the Model Context Protocol  
- [User Guide: Using MCP Tools in Chat](https://docs.unique.ai/users/spaces/unique-ai-chat/use-unique-ai-tools) - How end users interact with enabled tools