Unique AI Documentation

MCP Tools

3 min read

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 for more information.

info

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. Availabe 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

image-20251124-175536.png

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

image-20251124-175616.png

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

Last updated