Tools
Prerequisites
Feature menu: Access to AI Studio / Tools menu is required.
Permissions: Read-Write access is required for add/edit/delete operations. Read-Only access allows viewing only.
Overview
The Tools module is the key entry point for extending agent capabilities. It allows external service tools to be securely integrated into the platform via the Model Context Protocol (MCP). Once an MCP Server URL is configured, the platform automatically loads its associated tools (such as log query, metrics analysis, change retrieval, etc.) for use by agents in fault diagnosis, intelligent summarization, and other scenarios.
Platform tip: "The platform includes built-in MCP tools ready to use out of the box. You can also connect your own MCP Server — currently only streamable HTTP is supported — to integrate tools such as log queries and metrics analysis directly into your fault diagnosis workflows, providing standardized and extensible tool invocation capabilities."
The Tools module offers two views that can be toggled at the top of the page: MCP Services View (default) and Tools View, each providing a different perspective for managing tool resources.
Value
Out-of-the-box: Built-in MCP tools are ready to use without any configuration, letting you get started with fault diagnosis immediately.
Standardized extensibility: Compliant with the MCP protocol — provide a valid Server URL and your custom tools are integrated in bulk, with no upper limit on extensibility.
Dual-view management: Switch between MCP Services View and Tools View to manage either entire service connections or individual tools flexibly, with label-based categorization.
Fine-grained invocation control: When configuring agents, specify the exact set of tools available, preventing tool misuse and improving execution efficiency and security.
View Description
MCP Services View (Default)
Displays each MCP Server as a card showing its basic information and the number of tools it contains. This is the primary interface for managing server connection configurations — adding, editing, and deleting MCP Servers.
The built-in MCP Server has a distinct visual style and is always pinned to the top of the list. It cannot be edited or deleted — only viewed.
Tools View
Displays individual tools in a flat list, aggregating all tools from all MCP Servers into a single view. This is ideal for finding and managing tools from a tool-centric perspective. You can add labels to tools in this view; labels can be used for filtering and are also visible in the MCP Services View detail panel.
Operations
View MCP service list: The Tools page defaults to MCP Services View. Use the search bar to filter by MCP service name (fuzzy match).
Add an MCP Server: Click "Add", fill in the service information and URL, save — the system validates connectivity automatically and loads the associated tool list upon success.
Refresh tool list: Click "Update" to refresh the tool lists of all added MCP Servers. URL connectivity is validated at the same time; a failure message is shown if any Server fails.
View service details: Click an MCP service card to open the detail panel showing the service's basic information and its list of tools (name, description, parameters).
Edit an MCP Server: Click the action button (⋯) on the card and select "Edit" to modify any field of the service configuration.
Delete an MCP Server: Click the action button (⋯) on the card and select "Delete". Confirm in the dialog. Agents using tools from this server may be affected.
Manage tools in Tools View: Switch to Tools View to filter by tool name, description, label, or parent MCP Server. Click a tool card to view its details, and add or modify labels.
Getting Started
Adding an MCP Server
Log in to Bonree ONE and go to AI Studio > Tools.
In MCP Services View, click "Add" to open the Add form.
Fill in the fields according to the table below:
| Field | Required | Description | Default | Validation |
|---|---|---|---|---|
| Name | Required | Display name of the MCP service, used for identification in the UI | — | 2–50 characters; letters, digits, Chinese, underscore, hyphen, brackets |
| Icon | Optional | A default icon is provided. Upload a custom image (JPG/PNG, ≤200 KB) or choose from the icon library. | Default icon | JPG or PNG, ≤200 KB |
| Unique Identifier | Required | Unique key used by the backend to distinguish services. Must be unique within the same account and environment. | — | 2–100 characters; lowercase letters, digits, hyphens only |
| Description | Optional | Supplementary description of the MCP service. Maximum 500 characters. | — | Max 500 characters |
| URL | Required | Endpoint URL of the MCP Server. Only streamable HTTP protocol is supported. | — | 5–500 characters; valid URL (http:// or https://) |
| Advanced — Request Headers | Optional | Additional HTTP headers sent to the MCP Server. Up to 10 key-value pairs. | — | Name and value each ≤50 characters |
| Request Timeout (s) | Required | Maximum wait time for the request to be accepted | 30 | Non-negative integer, ≤3600 |
| Execution Timeout (s) | Required | Maximum wait time for tool execution to complete | 300 | Non-negative integer, ≤3600 |
Click "Save". The system validates the URL connectivity. If successful, the tool list associated with this MCP Server is automatically loaded.
Adding Labels to Tools in Tools View
Click the view toggle at the top of the page to switch to "Tools View".
Find the target tool card and click it to open the tool detail panel. Add or modify labels in the label section.
Labels support up to 10 characters (Chinese characters, letters, digits). Once added, labels can be used for filtering in the Tools View filter bar and are also visible in the MCP service detail panel.
MCP Services View Details
Service Card Fields
| Field | Description |
|---|---|
| Icon | The service's identifying icon |
| Service Name | Display name of the MCP service |
| Tool Count | Total number of tools loaded from this MCP Server |
| Description | User-provided description; blank if not filled in |
| Last Updated By | Account that last modified this service |
| Last Updated At | Timestamp of last modification; cards sorted by this in descending order. Built-in service is always pinned first. |
| Action Button | Appears on hover; provides Edit and Delete options. Not shown for built-in services. |
Service Detail Panel
Click an MCP service card to open the detail panel, which shows the service's basic information card, request headers (if configured), and the tool list for this service (including tool name, description, parameters, and labels). Hover over a tool row to see its full details in a tooltip.
Tools View Details
Features
Tools View aggregates all tools from all MCP Servers into a single flat list, supporting multi-dimensional filtering to quickly locate target tools.
| Filter | Description |
|---|---|
| Tool Name / Description | Fuzzy keyword match |
| Label | Multi-select dropdown; lists all labels added by users |
| Parent MCP Server | Single-select dropdown; filter by source service |
Notes
The built-in MCP Server cannot be edited or deleted. It is always pinned to the top of the list and supports view-only access.
The unique identifier cannot be changed after saving. If a change is needed, delete the service and re-add it.
Labels added to tools in Tools View are synced and visible in the MCP Services View detail panel. Labels are scoped to this module and do not interact with labels elsewhere on the platform.
The "Update" operation refreshes tool lists for all added MCP Servers simultaneously. If a Server's URL fails connectivity validation, that Server's tool update fails and a specific error message is shown.