Skip to content

Commit da468b8

Browse files
Add MCP new tools (#803)
* Resolve conflicts * Fix conflict * Add content changes * Improve creating mcp instructions * Change pill colors * Improve description * Address review comments * Address review comments * AI Dev zone and home page adjustments * Apply review changes * Adjust description * Adjust description * Update MPC tooling * Add GA changes * Changes after review * Add Claude Desktop, Le Chat and video demos * Add integrations screenshot * Update footer links --------- Co-authored-by: Justi Sztyper <[email protected]> Co-authored-by: Justyna Sztyper <[email protected]>
1 parent dce14f1 commit da468b8

File tree

7 files changed

+173
-88
lines changed

7 files changed

+173
-88
lines changed

content/guides/box-mcp/img/mcp.png

729 KB
Loading

content/guides/box-mcp/index.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,11 @@ required_guides: []
99

1010
Model Context Protocol ([MCP](https://modelcontextprotocol.io/introduction)) is an open protocol that standardizes how applications provide context to LLMs. MCP servers make building advanced integrations simpler and less time consuming.
1111

12-
Box MCP Server allows third party AI agents from platforms like Copilot Studio, Cursor, Claude for Desktop to access Box content seamlessly. It extends the agent’s capabilities by allowing it to perform actions related to content stored in Box.
12+
Box MCP Server allows third party AI agents from platforms like Copilot Studio, Cursor, Mistral AI, Claude, Mistral Le Chat to access Box content seamlessly. It extends the agent’s capabilities by allowing it to perform actions related to content stored in Box.
13+
14+
<ImageFrame noborder center>
15+
![MCP](./img/mcp.png)
16+
</ImageFrame>
1317

1418
There are two types of Box MCP Servers:
1519

@@ -23,6 +27,9 @@ Check the detailed guides on both types of Box MCP Servers, as the level of the
2327
<TileGrid rows="2">
2428
<Tile type="mcp" title="Remote Box MCP Server" href="/guides/box-mcp/remote">
2529
Enable the remote Box MCP Server in the Admin Console. It is hosted directly in Box.
30+
<div>
31+
<strong style="background-color: #e1ffe7">New</strong>
32+
</div>
2633
</Tile>
2734
<Tile type="mcp" title="Self-hosted Box MCP Server" href="/guides/box-mcp/self-hosted">
2835
An open source Box Developer community project. You can clone this Box MCP Sever and host it on your local machine.
548 KB
Loading
102 KB
Loading

content/guides/box-mcp/remote/index.md

Lines changed: 50 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -7,35 +7,34 @@ required_guides: []
77

88
# Remote Box MCP Server
99

10-
The remote Box MCP Server allows third party AI systems to securely connect and interact with your content in Box.
10+
[Remote MCP Server](https://modelcontextprotocol.io/introduction) is a standardized way for AI Agents to connect and interact with third-party applications like Box, enabling seamless access to content and AI capabilities across platforms. The Box MCP Server acts as a bridge that allows leading AI Agent platforms — such as Copilot Studio, Claude Enterprise, Mistral Le Chat — to securely query and utilize Box data and AI-powered tools without exposing raw file content. Through OAuth authorization, users can grant AI Agents controlled access to their Box accounts, enabling intelligent document handling, advanced search, and multi-file AI queries directly within these external AI environments.
1111

1212
## Access and manage predefined Box MCP Servers
1313

1414
1. Click **Integrations** in the sidebar of Box Admin Console.
15-
2. Click **Box Integrations & Clients** in the Integrations window.
16-
3. Scroll down to **Individual Integration Controls**.
17-
4. Search for predefined Box MCP Server, for example the **Box MCP Server for Copilot Studio**.
18-
5. Hover on the chosen integration, then click **Configure**.
19-
6. Click Save.
15+
2. Use *Categories* filter and choose MCP or search for a predefined Box MCP Server in the search field search at the top of the window.
16+
3. Beside the selected MCP server, click the state, then select the state you want to enable.
2017

21-
## Create an unlisted Box MCP Server
18+
<ImageFrame noborder center>
19+
![MCP](./img/integrations-mcp.png)
20+
</ImageFrame>
2221

23-
To create a new, unlisted Box MCP Server:
22+
## Create an unlisted Box MCP Server
2423

2524
1. Click Integrations in the sidebar of Box Admin Console.
26-
2. Scroll down to **Individual Integration Controls** in the Box Integrations & Clients tab.
27-
3. Search for **Box MCP Server**.
25+
2. Search for **Box MCP Server** in the search field search at the top of the window.
2826
4. Hover on the **Box MCP Server** application, then click **Configure**.
2927
5. In the **Additional Configuration** section, click on **+ Add Integration Credentials**.
30-
6. Enter the Redirect URI provided by the external MCP Client.
31-
7. Copy the generated Client ID and Client Secret.
28+
6. Copy the generated Client ID and Client Secret.
29+
7. Enter the Redirect URI provided by the external MCP Client.
3230
8. Under Scopes, ensure that *Manage AI Requests* is selected.
3331

34-
## Add Box MCP Server to MCP clients
32+
## Add Box MCP Server on the Client Side
3533

3634
To connect to Box from the AI Agent platform, you need to:
3735

38-
* Add an endpoint URL: `https://mcp.box.com`
36+
* Endpoint URL: `https://mcp.box.com`
37+
* Client ID and Client Secret: Box generates these in the Integration Credentials section of your Admin Console when configuring the Box MCP Server, above.
3938
* Pass an MCP name: `box-remote-mcp`
4039
* Provide an `authorization_token`
4140

@@ -58,35 +57,56 @@ Exact steps may vary depending on the AI platform. Refer to your platform’s do
5857
)
5958
```
6059

61-
### Anthropic's Messages API
60+
### Claude Desktop
61+
62+
To start using the remote Box MCP server in [Claude Desktop](https://claude.ai/download), go to Claude app settings and click *Connectors*. Within this view click *Browse connectors* and choose Box. Ensure to grant Claude access to Box.
6263

63-
Connect the remote Box MCP Server with Anthropic's Messages API. Clone [this sample chat bot project](https://github.com/box-community/remote-box-mcp-anthropic) to get started quickly. It allows you to have a conversation with an Anthropic model, which has access to tools provided by the Box remote MCP server. The chatbot runs in a terminal, maintains conversation history for context-aware responses, and uses `asyncio` for asynchronous operation.
64+
See a demo video that showcases how to connect Box MCP with Mistral Claude desktop.
65+
66+
<iframe width="100%" height="500" src="https://www.youtube.com/embed/OJVjXZkPd54?si=PSiV6aKkUnL7CXoG" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
6467

6568
### Copilot Studio
6669

67-
To add an MCP server, follow the instructions provided by the Copilot Studio side. Detailed steps and guidance are available in the official Microsoft documentation: [Add an MCP Server in Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/agent-extend-action-mcp#add-tools-from-an-existing-mcp-connector-to-an-agent).
70+
To add the remote Box MCP server, follow the instructions provided by the Copilot Studio side. Detailed steps and guidance are available in the official Microsoft documentation: [Add an MCP Server in Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/agent-extend-action-mcp#add-tools-from-an-existing-mcp-connector-to-an-agent).
6871

6972
### Azure API Center
7073

71-
To add an MCP server in Azure API Center's Enterprise Registry, follow the instructions provided by Azure. Detailed steps and guidance are available in the official Microsoft documentation: [Add an MCP Server in Azure API Center's Enterprise Registry](https://learn.microsoft.com/en-us/azure/api-center/register-discover-mcp-server).
74+
To add the remote Box MCP server in Azure API Center's Enterprise Registry, follow the instructions provided by Azure. Detailed steps and guidance are available in the official Microsoft documentation: [Add an MCP Server in Azure API Center's Enterprise Registry](https://learn.microsoft.com/en-us/azure/api-center/register-discover-mcp-server).
75+
76+
### Anthropic's Messages API
77+
78+
Connect the remote Box MCP Server with [Anthropic's Messages API](https://docs.anthropic.com/en/api/messages). Clone [this sample chat bot project](https://github.com/box-community/mcp-client-remote-mcp-react) to get started quickly. It allows you to have a conversation with an Anthropic model, which has access to tools provided by the Box remote MCP server.
79+
80+
Watch a video that features a demo project, a React based chat bot that leverages remote Box MCP.
81+
82+
<iframe width="100%" height="500" src="https://www.youtube.com/embed/Rcn8p-nLJtI?si=dWsMnE6reTE-aKQw" title="Box remote MCP" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
83+
84+
### Mistral AI’s Le Chat
85+
86+
To enable Box MCP for [Mistral AI’s Le Chat](https://chat.mistral.ai/chat), visit [connectors page](https://chat.mistral.ai/connections), click *Connect* and grant access to Box. Alternatively, directly form the chat view, click *Tools* and choose Box.
87+
88+
<ImageFrame noborder center>
89+
![MCP](./img/mistral.png)
90+
</ImageFrame>
7291

7392
### Using Box AI Features with the MCP Server
7493

75-
When you use Box AI in third party applications, you can achieve the best experience and highest quality results by accessing the applications through the Box MCP Server. This ensures full functionality, improved performance, and a seamless user experience.
94+
When you use Box AI in third-party applications, you can achieve the best experience and highest quality results by accessing the applications through the Box MCP Server. This ensures full functionality, improved performance, and a seamless user experience.
7695

7796
## Available tools
7897

7998
Remote Box MCP Server includes several tools you can use:
8099

81-
| Tool| Description|
100+
| Tool | Description|
82101
|--------|--------|
83-
| `box-remote-mcp_who_am_i`| Returns detailed information about the currently authenticated Box user.|
84-
| `box-remote-mcp_search_folders_by_name`| Searches for folders within Box by name using keyword matching.|
85-
| `box-remote-mcp_list_folder_content_by_folder_id`| Lists files, folders, and web links in a folder. |
86-
| `box-remote-mcp_search_files_keyword`| Searches for files using keywords. Supports metadata filters, file extension filtering, and field selection.|
87-
| `box-remote-mcp_search_files_metadata`| Searches for files using SQL-like metadata queries. Supports complex filtering with parameters, field selection, and folder scoping.|
88-
| `box-remote-mcp_ai_qa_single_file`| Asks a question to a single file using Box AI.|
89-
| `box-remote-mcp_ai_qa_multi_file`| Asks a question to multiple files using Box AI.|
90-
| `box-remote-mcp_ai_qa_hub`| Asks a question to a Box Hub using Box AI.|
91-
| `box-remote-mcp_ai_extract_freeform`| Extracts metadata from files using Box AI in freeform format without requiring predefined template structures.|
92-
| `box-remote-mcp_ai_extract_structured`| Extracts structured metadata from files using Box AI based on either custom fields definition or an existing metadata template.|
102+
| `who_am_i`| Returns detailed information about the currently authenticated Box user.|
103+
| `get_file_content` | Returns content of a file stored in Box |
104+
| `search_folders_by_name`| Searches for folders within Box by name using keyword matching.|
105+
| `list_folder_content_by_folder_id`| Lists files, folders, and web links in a folder. |
106+
| `search_files_keyword`| Searches for files using keywords. Supports metadata filters, file extension filtering, and field selection.|
107+
| `search_files_metadata`| Searches for files using SQL-like metadata queries. Supports complex filtering with parameters, field selection, and folder scoping.|
108+
| `ai_qa_single_file`| Asks a question to a single file using Box AI.|
109+
| `ai_qa_multi_file`| Asks a question to multiple files using Box AI.|
110+
| `ai_qa_hub`| Asks a question to a Box Hub using Box AI.|
111+
| `ai_extract_freeform`| Extracts metadata from files using Box AI in freeform format without requiring predefined template structures.|
112+
| `ai_extract_structured`| Extracts structured metadata from files using Box AI based on either custom fields definition or an existing metadata template.|

0 commit comments

Comments
 (0)