From ae31a2ab3ea06c5f8580862096c0937102748308 Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Wed, 16 Oct 2024 09:21:41 +0200 Subject: [PATCH 01/13] Resolve conflicts --- content/pages/ai-dev-zone/index.md | 56 ++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) diff --git a/content/pages/ai-dev-zone/index.md b/content/pages/ai-dev-zone/index.md index 6d60a8eab..d1f91c26d 100644 --- a/content/pages/ai-dev-zone/index.md +++ b/content/pages/ai-dev-zone/index.md @@ -58,6 +58,7 @@ view sample code, explore Box AI use cases, and more! href="/reference/resources/ai-response/"> Check the API reference for specification details. +<<<<<<< HEAD Documentation Documentation +======= + AI API + + + Browse the guides to learn how to use Box AI Platform API. + + AI API +>>>>>>> d527af77d (Add video section in the AI Dev zone) Check table list of the supported AI models. +<<<<<<< HEAD Documentation +======= + AI API +>>>>>>> d527af77d (Add video section in the AI Dev zone) @@ -86,13 +100,21 @@ view sample code, explore Box AI use cases, and more! Box for AI Integrations

+<<<<<<< HEAD Use Box for AI Integrations to extend LLM models' existing knowledge bases. +======= + Expand the capabilities of your applications beyond the models’ existing knowledge bases. +>>>>>>> d527af77d (Add video section in the AI Dev zone)

+<<<<<<< HEAD Enable access to Box content within LLM workflows with Box reader suite for LlamaIndex. +======= + Enable access of Box content within LLM workflows with Box reader suite for LlamaIndex. +>>>>>>> d527af77d (Add video section in the AI Dev zone) New @@ -115,6 +137,7 @@ view sample code, explore Box AI use cases, and more!
Videos
+<<<<<<< HEAD Watch the latest Box AI API tutorials and demos. @@ -146,6 +169,39 @@ view sample code, explore Box AI use cases, and more! Learn why Box chose to expose Box AI through our public API. +======= + Watch the latest Box AI Platform API tutorials and demos. + + + + Box AI Platform API - In One Minute + + + + Box AI Platform API - Document Q&A + + + + Box AI Platform API - Text generation + + + + Box AI Platform API Demo - Metadata extraction - Freeform + + + + Box AI Platform API - Metadata extraction - Structured + + + + Box AI Platform API - Preview UI element +>>>>>>> d527af77d (Add video section in the AI Dev zone) From 635c0f87bc3503df032f5f3d9b1fe13fb559f313 Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Tue, 18 Feb 2025 18:07:31 +0100 Subject: [PATCH 02/13] Fix conflict --- content/pages/ai-dev-zone/index.md | 58 +----------------------------- 1 file changed, 1 insertion(+), 57 deletions(-) diff --git a/content/pages/ai-dev-zone/index.md b/content/pages/ai-dev-zone/index.md index d1f91c26d..cca771602 100644 --- a/content/pages/ai-dev-zone/index.md +++ b/content/pages/ai-dev-zone/index.md @@ -23,7 +23,7 @@ view sample code, explore Box AI use cases, and more!
Try out interactive demos
- Box AI API is available to all Enterprise Plus and Enterprise Advanced customers. Endpoints related to metadata extraction are currently a beta feature offered subject to Box’s Main Beta Agreement, and the available capabilities may change. + Box AI API is available to all Enterprise Plus and Enterprise Advanced customers. @@ -58,7 +58,6 @@ view sample code, explore Box AI use cases, and more! href="/reference/resources/ai-response/"> Check the API reference for specification details. -<<<<<<< HEAD Documentation Documentation -======= - AI API - - - Browse the guides to learn how to use Box AI Platform API. - - AI API ->>>>>>> d527af77d (Add video section in the AI Dev zone) Check table list of the supported AI models. -<<<<<<< HEAD Documentation -======= - AI API ->>>>>>> d527af77d (Add video section in the AI Dev zone) @@ -100,21 +86,13 @@ view sample code, explore Box AI use cases, and more! Box for AI Integrations

-<<<<<<< HEAD Use Box for AI Integrations to extend LLM models' existing knowledge bases. -======= - Expand the capabilities of your applications beyond the models’ existing knowledge bases. ->>>>>>> d527af77d (Add video section in the AI Dev zone)

-<<<<<<< HEAD Enable access to Box content within LLM workflows with Box reader suite for LlamaIndex. -======= - Enable access of Box content within LLM workflows with Box reader suite for LlamaIndex. ->>>>>>> d527af77d (Add video section in the AI Dev zone) New @@ -137,7 +115,6 @@ view sample code, explore Box AI use cases, and more!
Videos
-<<<<<<< HEAD Watch the latest Box AI API tutorials and demos. @@ -169,39 +146,6 @@ view sample code, explore Box AI use cases, and more! Learn why Box chose to expose Box AI through our public API. -======= - Watch the latest Box AI Platform API tutorials and demos. - - - - Box AI Platform API - In One Minute - - - - Box AI Platform API - Document Q&A - - - - Box AI Platform API - Text generation - - - - Box AI Platform API Demo - Metadata extraction - Freeform - - - - Box AI Platform API - Metadata extraction - Structured - - - - Box AI Platform API - Preview UI element ->>>>>>> d527af77d (Add video section in the AI Dev zone) From b8b97708e1c57d8c439a52dc9b8b3f5eba71b9fc Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Tue, 24 Jun 2025 11:48:57 +0200 Subject: [PATCH 03/13] Add content changes --- .spelling | 1 + content/guides/ai-studio/index.md | 2 +- content/guides/box-mcp/index.md | 40 ++ content/guides/box-mcp/remote/index.md | 96 ++++ content/guides/box-mcp/self-hosted/index.md | 460 ++++++++++++++++++++ content/guides/docgen/index.md | 2 +- content/pages/ai-dev-zone/index.md | 22 +- 7 files changed, 619 insertions(+), 4 deletions(-) create mode 100644 content/guides/box-mcp/index.md create mode 100644 content/guides/box-mcp/remote/index.md create mode 100644 content/guides/box-mcp/self-hosted/index.md diff --git a/.spelling b/.spelling index 89ff79e41..b5ee79278 100644 --- a/.spelling +++ b/.spelling @@ -357,3 +357,4 @@ SVG SVGs px natively +Kus diff --git a/content/guides/ai-studio/index.md b/content/guides/ai-studio/index.md index 515e5eadd..57363f8cf 100644 --- a/content/guides/ai-studio/index.md +++ b/content/guides/ai-studio/index.md @@ -1,5 +1,5 @@ --- -rank: 0 +rank: 2 related_guides: - ai-studio/ai-studio-agents/create-agents - box-ai/ai-tutorials/ask-questions diff --git a/content/guides/box-mcp/index.md b/content/guides/box-mcp/index.md new file mode 100644 index 000000000..6ea1c9b5c --- /dev/null +++ b/content/guides/box-mcp/index.md @@ -0,0 +1,40 @@ +--- +rank: 2 +related_endpoints: [] +related_guides: [] +required_guides: [] +--- + +# Box MCP Server + +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. + +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. + +There are two types of Box MCP Servers: + +- remote Box MCP Server which you can create or enable in the Box Admin Console. It is hosted directly in Box. + +- self-hosted Box MCP Server which you can clone and host on your local machine, as this version in an open source Box Developer community project. + + +Check the detailed guides on both Box MCP Servers, as the level of the implemented tools differs. Learn how to enable Box MCP Server: + + + + Enable the remote Box MCP Server in the Admin Console. It is hosted directly in Box. +
+ Beta +
+ + + An open source Box Developer community project. You can clone this Box MCP Sever and host it on your local machine. +
+ Open source +
+ + + +Watch an interview with Box CTO, Ben Kus, and learn how MCP empowers AI agents to work dynamically across platforms, reducing the development effort. + + \ No newline at end of file diff --git a/content/guides/box-mcp/remote/index.md b/content/guides/box-mcp/remote/index.md new file mode 100644 index 000000000..2d3eacb5b --- /dev/null +++ b/content/guides/box-mcp/remote/index.md @@ -0,0 +1,96 @@ +--- +rank: 0 +related_endpoints: [] +related_guides: [] +required_guides: [] +--- + +# Remote Box MCP Server + +The remote Box MCP Server allows third party AI systems to securely connect and interact with your content in Box. + + + Box MCP Server offered subject to Box’s Main Beta Agreement, meaning the available capabilities may change at any time. Box MCP Server is available for customers with Enterprise Plus or Enterprise Advanced plans. + + +## Access and manage predefined Box MCP Servers + +1. Click Integrations in the sidebar of your Admin Console. +2. Click Box Integrations & Clients in the Integrations window. +3. Scroll down to Individual Integration Controls. +4. Go to the Box MCP Server for Copilot Studio (Beta), or Box MCP Server for Azure API Center (Beta) sections. +5. Click the state icon for the selected MCP server, then choose the state you want to enable. +6. Click Save. + +## Create an unlisted Box MCP Server + +To create a new, unlisted Box MCP Server: + +1. Click Integrations in the sidebar of your Admin Console. +2. Scroll down to **Individual Integration Controls** in the Box Integrations & Clients tab. +3. Search for **Box MCP Server**. +4. Hover on the **Box MCP Server** application, then click Configure. +5. In the **Additional Configuration** section, click on *+ Add Integration Credentials*. +6. Copy the generated Client ID and Client Secret. +7. Enter the Redirect URI provided by the external MCP Client. +8. Under Scopes, ensure that Manage AI is selected. + +## Add Box MCP Server to MCP clients + +To connect to Box from the AI Agent platform, you need to: + +* Add an endpoint URL: `https://mcp.box.com` +* Pass an MCP name: `box-remote-mcp` +* Provide an `authorization_token` + +Exact steps may vary depending on the AI platform. Refer to your platform’s documentation for client-side setup instructions. Check this sample code for reference: + +```python + response = await client.beta.messages.create( + model="claude-3-opus-20240229", # Or your preferred model + max_tokens=4096, + messages=conversation_history, + mcp_servers=[ + { + "type": "url", + "url": "https://mcp.box.com", + "name": "box-remote-mcp", + "authorization_token": BEARER_TOKEN, + } + ], + betas=["mcp-client-2025-04-04"] + ) +``` + +### Anthropic's Messages API + +Connect the remote Box MCP Server with Anthropic's Messages API (beta). 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. + +### Copilot Studio + +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). + +### Azure API Center + +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). + +### Using Box AI Features with the MCP Server + +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. + +## Available tools + +Remote Box MCP Server includes several tools you can use: + +| Tool| Description| +|--------|--------| +| `box-remote-mcp_who_am_i`| Returns detailed information about the currently authenticated Box user.| +| `box-remote-mcp_search_folders_by_name`| Searches for folders within Box by name using keyword matching.| +| `box-remote-mcp_list_folder_content_by_folder_id`| Lists files, folders, and web links in a folder. | +| `box-remote-mcp_search_files_keyword`| Searches for files using keywords. Supports metadata filters, file extension filtering, and field selection.| +| `box-remote-mcp_search_files_metadata`| Searches for files using SQL-like metadata queries. Supports complex filtering with parameters, field selection, and folder scoping.| +| `box-remote-mcp_ai_qa_single_file`| Asks a question to a single file using Box AI.| +| `box-remote-mcp_ai_qa_multi_file`| Asks a question to multiple files using Box AI.| +| `box-remote-mcp_ai_qa_hub`| Asks a question to a Box Hub using Box AI.| +| `box-remote-mcp_ai_extract_freeform`| Extracts metadata from files using Box AI in freeform format without requiring predefined template structures.| +| `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.| \ No newline at end of file diff --git a/content/guides/box-mcp/self-hosted/index.md b/content/guides/box-mcp/self-hosted/index.md new file mode 100644 index 000000000..acb132fa4 --- /dev/null +++ b/content/guides/box-mcp/self-hosted/index.md @@ -0,0 +1,460 @@ +--- +rank: 1 +related_endpoints: [] +related_guides: [] +required_guides: [] +--- + +# Self-hosted Box MCP Server + +The [Self-hosted Box MCP Server](https://github.com/box-community/mcp-server-box.git) is a Python project that integrates with the Box API to perform various operations such as file search, text extraction, AI-based querying, and data extraction. It leverages the Box Python Next Gen SDK library and provides a set of tools to interact with Box files and folders. + +## Installation + +### Prerequisites + +- Python 3.13 or higher +- Box Platform app credentials (Client ID, Client Secret) + +Follow the steps from this section to set up the self-hosted Box MCP Server. + +1. Clone the repository: + +```sh +git clone https://github.com/box-community/mcp-server-box.git +cd mcp-server-box +``` + +2. Install `uv` if it's not installed on your machine: + + + + ```sh + curl -LsSf https://astral.sh/uv/install.sh | sh + ``` + + + ```powershell + powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" + ``` + + + +Restart your terminal afterwards to ensure that the `uv` command gets picked up. + +3. Create and set up our project: + + + + + ```sh + # Create virtual environment and activate it + uv venv + source .venv/bin/activate + + # Lock the dependencies + uv lock + ``` + + + + + + ```sh + # Create virtual environment and activate it + uv venv + .venv\Scripts\activate + + # Lock the dependencies + uv lock + ``` + + + + +4. Create a `.env` file in the root directory and fill your Box Platform app credentials: + +```.env +BOX_CLIENT_ID=your_client_id +BOX_CLIENT_SECRET=your_client_secret +``` + +You can also watch a video tutorial and see example usage of Box MCP tools. + + + +## Running Box MCP Server locally + +To start the Box MCP Server, run the following command: + +```sh +uv --directory /Users/USER_NAME/PATH_TO_PROJECT/mcp-server-box run src/mcp_server_box.py +``` + +Update the path so it reflects your local setup. + +### Use Cursor as the Box MCP client + +Prerequisites: + +- Download [Cursor desktop app](https://www.cursor.com/) + +Follow these instructions to start using Box MCP Sever with Cursor: + +1. Open the Cursor app. +2. Click the cog icon located in the right-top corner to open settings. +3. Select `MCP` within the Cursor Settings tab. +4. Click the `Add new global MCP server` button. This opens the `mcp.json` file. +5. Update the values with your local setup and paste the following JSON: + +```json +{ + "mcpServers": { + "box": { + "command": "uv", + "args": [ + "--directory", + "/Users/USER_NAME/PATH_TO_PROJECT/mcp-server-box", + "run", + "src/mcp_server_box.py" + ] + } + } +} +``` + +6. Save and close the `mcp.json` file. +7. Restart Cursor if necessary. +8. Use the `box_authorize_app_tool` tool to start using Box MCP. + +### Use Claude for Desktop as the Box MCP client + +Prerequisites: + +- Download [Claude for Desktop](https://claude.ai/download) client +- Optionally, set up [`code`](https://code.visualstudio.com/docs/setup/mac#_configure-the-path-with-vs-code) command for VS Code + +Follow these steps to set up Box MCP in Claude for Desktop: + +1. Edit your `claude_desktop_config.json`. + +You can run this command in your terminal: + +```sh +code ~/Library/Application\ Support/Claude/claude_desktop_config.json +``` + +Alternatively, in the main Claude navigation choose `Settings`. Select the Developers tab and click `Edit Config`. This opens a folder window containing `claude_desktop_config.json`. + +2. Add the configuration: + +```json +{ + "mcpServers": { + "mcp-server-box": { + "command": "uv", + "args": [ + "--directory", + "/Users/Users/USER_NAME/PATH_TO_PROJECT/mcp-server-box", + "run", + "src/mcp_server_box.py" + ] + } + } +} +``` + +3. Restart Claude for Desktop +4. Authenticate the Box MCP Server using `box_authorize_app_tool` tool. + +## Available tools + +### Authentication and user tools + +| Tool | Description | Parameters | Returns | +|------|-------------|------------|---------| +| `box_who_am_i` | Gets the current user information and checks the connection status. | None | User information string. | +| `box_authorize_app_tool` | Starts the Box application authorization process. | None | Authorization status message. | + +### Search and navigation tools + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ToolDescriptionParametersReturns
`box_search_tool`Search for files in Box + - `query (str):` Search query. + - `file_extensions (List[str], optional):` Filter by extensions. + - `where_to_look_for_query (List[str], optional):` Locations to search. + - `ancestor_folder_ids (List[str], optional):` Folder IDs to limit the search. + Newline-separated list of file names and IDs
`box_search_folder_by_name`Locate a folder by name`folder_name (str):` Name of the folderFolder ID and information
`box_list_folder_content_by_folder_id`List folder contents +
    +
  • `folder_id (str):` ID of the folder.
    • +
  • `is_recursive (bool):` Whether to list recursively.
    • +
+ 		Folder content in JSON format
+ +### File operations + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ToolDescriptionParametersReturns
`box_read_tool`Read the text content of a Box file + - `file_id (str):` ID of the file to read. + File content
`box_upload_file_from_path_tool`Upload a file from local path + - `file_path (str):` Local file path.
+ - `folder_id (str, optional):` Destination folder ID.
+ - `new_file_name (str, optional):` New file name. + 		File details or error message
`box_upload_file_from_content_tool`Upload content as a file + - `content (str|bytes):` Content to upload.
+ - `file_name (str):` File name.
+ - `folder_id (str, optional):` Destination folder ID.
+ - `is_base64 (bool, optional):` If content is base64 encoded. + 		Upload success message
`box_download_file_tool`Download a file from Box + - `file_id (str):` File ID.
+ - `save_file (bool, optional):` Whether to save locally.
+ - `save_path (str, optional):` Local save path. + 		File content or save confirmation
+ +### Folder Management + + + + + + + + + + + + + +
ToolDescriptionParametersReturns
`box_manage_folder_tool`Create, update, or delete folders + - `action (str):` `create`, `delete`, or `update`. + - `folder_id (str, optional):` Folder ID. + - `name (str, optional):` Folder name. + - `parent_id (str, optional):` Parent folder ID. + - `description (str, optional):` Folder description. + - `recursive (bool, optional):` For recursive delete. + Status message with folder details
+ +### Box AI tools + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ToolDescriptionParametersReturns
`box_ask_ai_tool`Ask Box AI about a file + - `file_id (str):` File ID.
+ - `prompt (str):` Question for the AI. + 		AI response
`box_ask_ai_tool_multi_file`Query Box AI using multiple files + - `file_ids (List[str]):` List of file IDs.
+ - `prompt (str):` Instruction for AI. + 		AI-generated answer
`box_hubs_ask_ai_tool`Ask Box AI about a hub + - `hubs_id (str):` ID of the hub.
+ - `prompt (str):` Question for the AI. + 		AI response
`box_ai_extract_data`Extract data from a file using AI + - `file_id (str):` File ID.
+ - `fields (str):` Fields to extract. + 		Extracted data in JSON format
+ +### Box Doc Gen tools + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ToolDescriptionParametersReturns
`box_docgen_create_batch_tool`Generate documents using a template + - `file_id` (str): Template file ID. + - `destination_folder_id` (str): Output folder ID. + - `user_input_file_path` (str): JSON input data path. + - `output_type` (str, optional): Output format. + Batch generation result
`box_docgen_get_job_tool`Fetch a Doc Gen job by ID`job_id (str):` Job identifierJob details in JSON
`box_docgen_list_jobs_tool`List all Doc Gen jobs + - `marker (str, optional):` Pagination marker. + - `limit (int, optional):` Max jobs to return. + List of jobs in JSON
`box_docgen_list_jobs_by_batch_tool`List jobs in a specific batch + - `batch_id (str):` Batch identifier. + - `marker (str, optional):` Pagination marker. + - `limit (int, optional):` Max jobs to return. + Batch jobs details
`box_docgen_template_create_tool`Mark a file as a template`file_id (str):` File ID to markTemplate details
`box_docgen_template_list_tool`List all available templates + - `marker` (str, optional): Pagination marker. + - `limit` (int, optional): Max templates to list. + List of templates
`box_docgen_template_delete_tool`Remove template marking`template_id (str):` Template identifierDeletion confirmation
`box_docgen_template_get_by_id_tool`Get template details`template_id (str):` Template identifierTemplate details
`box_docgen_template_list_tags_tool`List template tags + - `template_id` (str): Template ID. + - `template_version_id` (str, optional): Version ID. + - `marker` (str, optional): Pagination marker. + - `limit` (int, optional): Max tags to return. + List of tags
`box_docgen_template_list_jobs_tool`List jobs using a template + - `template_id (str):` Template identifier. + - `marker (str, optional):` Pagination marker. + - `limit (int, optional):` Max jobs to list. + Job details
+ +## Troubleshooting + +In case of an `Error: spawn uv ENOENT` on MacOS when running the MCP server with Claude Desktop, you can: + +- Remove `uv` and reinstall it with Homebrew: `brew install uv`. +- Provide the full path to the `uv` executable in your configuration: + +```sh +/Users/USER_NAME/.local/bin/uv --directory /Users/USER_NAME/local/mcp-server-box run src/mcp_server_box.py +``` + +In case of additional issues related to setup, post your question on our [Developer Community forum](https://community.box.com/ai-developers-23). \ No newline at end of file diff --git a/content/guides/docgen/index.md b/content/guides/docgen/index.md index c940b2a0a..ba2c365a6 100644 --- a/content/guides/docgen/index.md +++ b/content/guides/docgen/index.md @@ -1,5 +1,5 @@ --- -rank: 0 +rank: 3 related_guides: - docgen/docgen-getting-started - docgen/docgen-templates diff --git a/content/pages/ai-dev-zone/index.md b/content/pages/ai-dev-zone/index.md index c42fa2ad4..e37ba924d 100644 --- a/content/pages/ai-dev-zone/index.md +++ b/content/pages/ai-dev-zone/index.md @@ -90,8 +90,8 @@ view sample code, explore Box AI use cases, and more!

- + Allow AI assistants to access enterprise content management capabilities with minimal friction, opening up new possibilities for intelligent document handling and analysis.
@@ -99,6 +99,24 @@ view sample code, explore Box AI use cases, and more! MCP
+ + A Python Developer Community open source project. It integrates with the Box API to perform various operations such as file search, text extraction, AI-based querying, and data extraction. + +
+ New + MCP +
+ + + Seamlessly connect unstructured content in Box with the powerful analytics capabilities of Snowflake, unlocking new insights and automating data-driven workflows. + +
+ New + Connector +
+ Get started with a Python library for building AI agents for Box. From 114f781d61db365165c6d04e32c6e7b5e993da05 Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Tue, 24 Jun 2025 12:06:27 +0200 Subject: [PATCH 04/13] Improve creating mcp instructions --- content/guides/box-mcp/remote/index.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/guides/box-mcp/remote/index.md b/content/guides/box-mcp/remote/index.md index 2d3eacb5b..98df36e16 100644 --- a/content/guides/box-mcp/remote/index.md +++ b/content/guides/box-mcp/remote/index.md @@ -15,10 +15,10 @@ The remote Box MCP Server allows third party AI systems to securely connect and ## Access and manage predefined Box MCP Servers -1. Click Integrations in the sidebar of your Admin Console. -2. Click Box Integrations & Clients in the Integrations window. -3. Scroll down to Individual Integration Controls. -4. Go to the Box MCP Server for Copilot Studio (Beta), or Box MCP Server for Azure API Center (Beta) sections. +1. Click **Integrations** in the sidebar of Box Admin Console. +2. Click **Box Integrations & Clients** in the Integrations window. +3. Scroll down to **Individual Integration Controls**. +4. Go to the **Box MCP Server for Copilot Studio (Beta)**, or **Box MCP Server for Azure API Center (Beta)** sections. 5. Click the state icon for the selected MCP server, then choose the state you want to enable. 6. Click Save. @@ -26,14 +26,14 @@ The remote Box MCP Server allows third party AI systems to securely connect and To create a new, unlisted Box MCP Server: -1. Click Integrations in the sidebar of your Admin Console. +1. Click Integrations in the sidebar of Box Admin Console. 2. Scroll down to **Individual Integration Controls** in the Box Integrations & Clients tab. 3. Search for **Box MCP Server**. 4. Hover on the **Box MCP Server** application, then click Configure. -5. In the **Additional Configuration** section, click on *+ Add Integration Credentials*. +5. In the **Additional Configuration** section, click on **+ Add Integration Credentials**. 6. Copy the generated Client ID and Client Secret. 7. Enter the Redirect URI provided by the external MCP Client. -8. Under Scopes, ensure that Manage AI is selected. +8. Under Scopes, ensure that *Manage AI* is selected. ## Add Box MCP Server to MCP clients From 128a25c4c33b45f8a23af911594820547dd8dc5c Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Tue, 24 Jun 2025 12:16:52 +0200 Subject: [PATCH 05/13] Change pill colors --- content/guides/box-ai/ai-models/index.md | 48 ++++++++++++------------ content/pages/ai-dev-zone/index.md | 8 +--- 2 files changed, 26 insertions(+), 30 deletions(-) diff --git a/content/guides/box-ai/ai-models/index.md b/content/guides/box-ai/ai-models/index.md index c3a2046cc..02f7836a4 100644 --- a/content/guides/box-ai/ai-models/index.md +++ b/content/guides/box-ai/ai-models/index.md @@ -44,10 +44,10 @@ Box AI is powered by the following AI models. These models are integrated with B A multimodal model designed to handle lightweight tasks.
- Default for Box AI for Box Hubs - Default for Box AI for Docs - Default for Box AI for Box Notes Q&A - Chat + Default for Box AI for Box Hubs + Default for Box AI for Docs + Default for Box AI for Box Notes Q&A + Chat Available Standard
@@ -55,7 +55,7 @@ Box AI is powered by the following AI models. These models are integrated with B A multimodal model, highly efficient in handling complex, multi-step tasks.
- Chat + Chat Available Premium
@@ -63,7 +63,7 @@ Box AI is powered by the following AI models. These models are integrated with B A multimodal model designed to handle lightweight tasks.
- Chat + Chat Available Standard
@@ -71,7 +71,7 @@ Box AI is powered by the following AI models. These models are integrated with B A multimodal model, highly efficient in handling complex, multi-step tasks.
- Chat + Chat Preview Available Premium @@ -80,7 +80,7 @@ Box AI is powered by the following AI models. These models are integrated with B A most capable 2nd generation text embedding model. Skilled in text search, code search, and sentence similarity.
- Embeddings + Embeddings Available Standard
@@ -88,7 +88,7 @@ Box AI is powered by the following AI models. These models are integrated with B Gemini multimodal model designed for optimal for high-volume, high-frequency tasks at scale.
- Chat + Chat Available Premium
@@ -96,7 +96,7 @@ Box AI is powered by the following AI models. These models are integrated with B Gemini multimodal model designed for optimal for high-volume, high-frequency tasks at scale.
- Chat + Chat Available Standard
@@ -104,7 +104,7 @@ Box AI is powered by the following AI models. These models are integrated with B Gemini multimodal model designed for optimal for high-volume, high-frequency tasks at scale.
- Chat + Chat Available Standard
@@ -112,8 +112,8 @@ Box AI is powered by the following AI models. These models are integrated with B Gemini multimodal model designed to handle lightweight tasks.
- Default for Box AI Extract - Chat + Default for Box AI Extract + Chat Available Standard
@@ -121,7 +121,7 @@ Box AI is powered by the following AI models. These models are integrated with B A model tailored for various language tasks, including creative writing and conversational AI.
- Chat + Chat Available Standard
@@ -129,7 +129,7 @@ Box AI is powered by the following AI models. These models are integrated with B A model designed for advanced language tasks, focusing on comprehension and context handling.
- Chat + Chat Available Premium
@@ -137,7 +137,7 @@ Box AI is powered by the following AI models. These models are integrated with B A model designed to enhance language understanding and generation tasks.
- Chat + Chat Available Premium
@@ -145,7 +145,7 @@ Box AI is powered by the following AI models. These models are integrated with B A model designed to enhance language understanding and generation tasks
- Chat + Chat Available Premium
@@ -153,7 +153,7 @@ Box AI is powered by the following AI models. These models are integrated with B A model that brings frontier performance to everyday use cases.
- Chat + Chat Available Premium
@@ -161,7 +161,7 @@ Box AI is powered by the following AI models. These models are integrated with B A model that excels at coding and complex problem-solving, powering frontier agent products.
- Chat + Chat Available Premium
@@ -169,7 +169,7 @@ Box AI is powered by the following AI models. These models are integrated with B A model capable of advanced language processing, handling extensive contexts, making it suitable for complex tasks.
- Chat + Chat Available Standard
@@ -177,7 +177,7 @@ Box AI is powered by the following AI models. These models are integrated with B A model built for document-level understanding, interpretation of charts and graphs, and captioning of images.
- Chat + Chat Available Standard
@@ -185,7 +185,7 @@ Box AI is powered by the following AI models. These models are integrated with B A natively multimodal AI model that enables text and multimodal experiences.
- Chat + Chat Available Standard
@@ -200,7 +200,7 @@ Certain Box AI customers may enable additional AI models upon their request and/ A model that excels at enterprise use cases like data extraction, coding, and text summarization.
- Chat + Chat Beta Premium
@@ -208,7 +208,7 @@ Certain Box AI customers may enable additional AI models upon their request and/ A lightweight model that is great for logic-based tasks that do not require deep domain knowledge.
- Chat + Chat Beta Premium
diff --git a/content/pages/ai-dev-zone/index.md b/content/pages/ai-dev-zone/index.md index e37ba924d..979a1e410 100644 --- a/content/pages/ai-dev-zone/index.md +++ b/content/pages/ai-dev-zone/index.md @@ -90,9 +90,9 @@ view sample code, explore Box AI use cases, and more!

- - Allow AI assistants to access enterprise content management capabilities with minimal friction, opening up new possibilities for intelligent document handling and analysis. + The remote Box MCP Server allows third party AI systems to securely connect and interact with your content in Box.
New @@ -130,7 +130,6 @@ view sample code, explore Box AI use cases, and more! Use the Box MCP server to augment Pydantic AI agents with secure content in Box.
- New Demo
@@ -139,7 +138,6 @@ view sample code, explore Box AI use cases, and more! Transform unstructured documents into structured, queryable data by using the “Box data extract”, an Airbyte source connector.
- New Integration
@@ -148,7 +146,6 @@ view sample code, explore Box AI use cases, and more! Use OpenAI Responses API and a Box Agent to add unstructured data from your Box instance into your agentic workflows.
- New Integration
@@ -157,7 +154,6 @@ view sample code, explore Box AI use cases, and more! Build RAG workflows by embedding Box content into a Weaviate vector database and leveraging Weaviate's new Query Agent.
- New Integration
From 6a96f54ca6930b8e5782e9111ab9b20b1ca356ff Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Tue, 24 Jun 2025 12:29:40 +0200 Subject: [PATCH 06/13] Improve description --- content/guides/box-mcp/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/guides/box-mcp/index.md b/content/guides/box-mcp/index.md index 6ea1c9b5c..774a6670b 100644 --- a/content/guides/box-mcp/index.md +++ b/content/guides/box-mcp/index.md @@ -18,7 +18,7 @@ There are two types of Box MCP Servers: - self-hosted Box MCP Server which you can clone and host on your local machine, as this version in an open source Box Developer community project. -Check the detailed guides on both Box MCP Servers, as the level of the implemented tools differs. Learn how to enable Box MCP Server: +Check the detailed guides on both types of Box MCP Servers, as the level of the implemented tools differs. Learn how to enable Box MCP Server: From da6da859de37bca816b6697b167c2d9d1b8625e4 Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Tue, 24 Jun 2025 13:57:14 +0200 Subject: [PATCH 07/13] Address review comments --- content/guides/box-mcp/self-hosted/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/guides/box-mcp/self-hosted/index.md b/content/guides/box-mcp/self-hosted/index.md index acb132fa4..7057000b1 100644 --- a/content/guides/box-mcp/self-hosted/index.md +++ b/content/guides/box-mcp/self-hosted/index.md @@ -102,7 +102,7 @@ Prerequisites: Follow these instructions to start using Box MCP Sever with Cursor: 1. Open the Cursor app. -2. Click the cog icon located in the right-top corner to open settings. +2. Click the cog icon to open settings. 3. Select `MCP` within the Cursor Settings tab. 4. Click the `Add new global MCP server` button. This opens the `mcp.json` file. 5. Update the values with your local setup and paste the following JSON: From a40ff0a7bd9dfe35127bae2f4af301bbbb50c65d Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Tue, 24 Jun 2025 13:58:36 +0200 Subject: [PATCH 08/13] Address review comments --- content/guides/box-mcp/remote/index.md | 2 +- content/guides/box-mcp/self-hosted/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/guides/box-mcp/remote/index.md b/content/guides/box-mcp/remote/index.md index 98df36e16..4687e3974 100644 --- a/content/guides/box-mcp/remote/index.md +++ b/content/guides/box-mcp/remote/index.md @@ -29,7 +29,7 @@ To create a new, unlisted Box MCP Server: 1. Click Integrations in the sidebar of Box Admin Console. 2. Scroll down to **Individual Integration Controls** in the Box Integrations & Clients tab. 3. Search for **Box MCP Server**. -4. Hover on the **Box MCP Server** application, then click Configure. +4. Hover on the **Box MCP Server** application, then click **Configure**. 5. In the **Additional Configuration** section, click on **+ Add Integration Credentials**. 6. Copy the generated Client ID and Client Secret. 7. Enter the Redirect URI provided by the external MCP Client. diff --git a/content/guides/box-mcp/self-hosted/index.md b/content/guides/box-mcp/self-hosted/index.md index 7057000b1..3be3e4a15 100644 --- a/content/guides/box-mcp/self-hosted/index.md +++ b/content/guides/box-mcp/self-hosted/index.md @@ -164,7 +164,7 @@ Alternatively, in the main Claude navigation choose `Settings`. Select the Devel } ``` -3. Restart Claude for Desktop +3. Restart Claude for Desktop. 4. Authenticate the Box MCP Server using `box_authorize_app_tool` tool. ## Available tools From 9a515261e93467aac83977304a36bfbb04a96552 Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Thu, 10 Jul 2025 14:59:22 +0200 Subject: [PATCH 09/13] AI Dev zone and home page adjustments --- content/microcopy/headers.yml | 13 ++- content/pages/ai-dev-zone/index.md | 165 ++++++++++++++++++++--------- content/pages/index.md | 12 +-- 3 files changed, 128 insertions(+), 62 deletions(-) diff --git a/content/microcopy/headers.yml b/content/microcopy/headers.yml index dba85793f..453d7319f 100644 --- a/content/microcopy/headers.yml +++ b/content/microcopy/headers.yml @@ -51,12 +51,16 @@ primary: ai_dev_zone: text: Box AI Developer Zone - url: /sign/ + url: /ai-dev-zone/ buie: text: Box UI Elements url: /box-ui-elements + mcp: + text: Box MCP Server + url: /guides/box-mcp/ + get_started: // text: The text for the link to the old Get Started guides text: Quick Start @@ -170,13 +174,12 @@ primary: text: Event title: - text: Box Virtual Summit Content + AI + text: BoxWorks Content + AI details: text: |- - Learn how to create context-aware agents with the OpenAI Agents SDK, - start using Model Context Protocol, and discover metadata - extraction with agents. + Learn how to use Box MCP Server, dive into Box AI APIs, + and discover enhanced metadata extraction with agents. cta: text: |- diff --git a/content/pages/ai-dev-zone/index.md b/content/pages/ai-dev-zone/index.md index 979a1e410..fe054ae61 100644 --- a/content/pages/ai-dev-zone/index.md +++ b/content/pages/ai-dev-zone/index.md @@ -12,10 +12,11 @@ centered: false Developer Zone -Box AI Developer Zone features interactive -demos to give you hands-on experience with Box AI API. -With a few clicks you can create prompts, -view sample code, explore Box AI use cases, and more! + Box AI Developer Zone features interactive + demos, sample code, and tools for building + AI agents and intelligent workflows. Explore + use cases, get hands-on experience with + Box AI API, and build agents with Box AI Studio! @@ -29,38 +30,47 @@ view sample code, explore Box AI use cases, and more! Summarize a document in a selected tone of voice. - New + Demo - - Extract document metadata suggestions in the freeform mode. + Use natural langage, or pass a stringified data structure + to extract metadata with Box AI API. - New + Demo + + + Extract document metadata suggestions with Box metadata templates or a predefined data structure. + + Demo - - Extract document metadata suggestions in the structured mode. + + Extract document metadata suggestions with the new Enhanced Extract Agent. Get the best answers thanks to chain-of-thought processing. +
New + Tutorial +
- Documentation and support + Documentation

These resources will get you up and running with Box AI API.

- Check the API reference for specification details. Documentation - Browse the guides to learn how to use Box AI API. @@ -68,29 +78,30 @@ view sample code, explore Box AI use cases, and more! - Check table list of the supported AI models. + Box supports a variety of AI models, categorized along two dimensions: access level and capability tier. Check table list of the supported AI models. Documentation - - Visit Box Developer Community for support and knowledge sharing. + + Override the default AI model configuration and fine + tune LLMs with Box AI API. - Community + Documentation
- Box for AI Integrations + MCP Servers

- Use Box for AI Integrations to extend LLM models' existing knowledge bases. + These resources will get you up and running with Box MCP Server.

- The remote Box MCP Server allows third party AI systems to securely connect and interact with your content in Box. @@ -99,51 +110,95 @@ view sample code, explore Box AI use cases, and more! MCP
- A Python Developer Community open source project. It integrates with the Box API to perform various operations such as file search, text extraction, AI-based querying, and data extraction. + MCP + + + Use Box Doc Gen through the Box MCP server for AI-Powered Document Generation +
- New - MCP + Tutorial
- - Seamlessly connect unstructured content in Box with the powerful analytics capabilities of Snowflake, unlocking new insights and automating data-driven workflows. + + Turn Box MCP Server it into a LangChain-compatible agent using the LangChain MCP Adapters.
- New - Connector + Tutorial
- - Get started with a Python library for building AI agents for Box. + + + + +
+ AI agents +
+

+ Learn how to create advanced AI agents with Box. +

+ + + Create and manage custom AI agents with Box AI Studio API. + +
+ New + Box AI Studio +
+ + + Get started with reusable Agentforce actions that help automate workflows and enhance intelligent agent—based processes within Salesforce. +
New - beta + Salesforce
- - Use the Box MCP server to augment Pydantic AI agents with secure content in Box. - + + Use OpenAI Responses API and a Box Agent to add unstructured data from your Box instance into your agentic workflows. +
- Demo + OpenAI
- - Transform unstructured documents into structured, queryable data by using the “Box data extract”, an Airbyte source connector. - + + Get started with a Python library for building AI agents for Box. + + Beta + + + + + +
+ Box for AI Integrations +
+

+ Use Box for AI Integrations to extend LLM models' existing knowledge bases. +

+ + + + Seamlessly connect unstructured content in Box with the powerful analytics capabilities of Snowflake, unlocking new insights and automating data-driven workflows. +
+ New Integration
- - Use OpenAI Responses API and a Box Agent to add unstructured data from your Box instance into your agentic workflows. + + Transform unstructured documents into structured, queryable data by using the “Box data extract”, an Airbyte source connector.
Integration @@ -157,6 +212,12 @@ view sample code, explore Box AI use cases, and more! Integration
+ + Connect Box and Pinecone to customize vector embeddings and get more relevant answers from LLM. + + Integration + Enable access to Box content within LLM workflows with Box reader suite for LlamaIndex. @@ -169,11 +230,13 @@ view sample code, explore Box AI use cases, and more! Integration - - Connect Box and Pinecone to customize vector embeddings and get more relevant answers from LLM. + + Use the Box MCP server to augment Pydantic AI agents with secure content in Box. - Integration +
+ Demo +
@@ -217,7 +280,7 @@ view sample code, explore Box AI use cases, and more! - - View all videos + + View more videos \ No newline at end of file diff --git a/content/pages/index.md b/content/pages/index.md index 72c42ffd6..4dbcdc1f9 100644 --- a/content/pages/index.md +++ b/content/pages/index.md @@ -35,6 +35,10 @@ All the developer resources to help you get the most from Box products + + + +
I'm new to Box Platform. How do I start? @@ -80,7 +84,7 @@ All the developer resources to help you get the most from Box products - +
@@ -144,7 +148,7 @@ All the developer resources to help you get the most from Box products
- +
- - - -
Additional resources From 62a1afc290dab2d8e96a76659828026a1677360c Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Thu, 10 Jul 2025 20:42:09 +0200 Subject: [PATCH 10/13] Apply review changes --- content/pages/ai-dev-zone/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pages/ai-dev-zone/index.md b/content/pages/ai-dev-zone/index.md index fe054ae61..fe23e0efa 100644 --- a/content/pages/ai-dev-zone/index.md +++ b/content/pages/ai-dev-zone/index.md @@ -126,7 +126,7 @@ centered: false - Turn Box MCP Server it into a LangChain-compatible agent using the LangChain MCP Adapters. + Turn Box MCP Server into a LangChain-compatible agent using the LangChain MCP Adapters.
Tutorial From 0094a564ef65fefae983300965ba22e675509012 Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Fri, 11 Jul 2025 12:21:47 +0200 Subject: [PATCH 11/13] Adjust description --- content/pages/ai-dev-zone/index.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/content/pages/ai-dev-zone/index.md b/content/pages/ai-dev-zone/index.md index fe23e0efa..51c17a250 100644 --- a/content/pages/ai-dev-zone/index.md +++ b/content/pages/ai-dev-zone/index.md @@ -32,15 +32,16 @@ centered: false Demo - Use natural langage, or pass a stringified data structure to extract metadata with Box AI API. Demo - - Extract document metadata suggestions with Box metadata templates or a predefined data structure. + + Extract document metadata suggestions. Pass a Box metadata template + ID or a predefined structure. Demo From 9d2bc7d6cf08d905c57d6df025479851e0a23da1 Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Fri, 11 Jul 2025 12:27:00 +0200 Subject: [PATCH 12/13] Adjust description --- content/pages/ai-dev-zone/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pages/ai-dev-zone/index.md b/content/pages/ai-dev-zone/index.md index 51c17a250..d374dad1b 100644 --- a/content/pages/ai-dev-zone/index.md +++ b/content/pages/ai-dev-zone/index.md @@ -41,7 +41,7 @@ centered: false Extract document metadata suggestions. Pass a Box metadata template - ID or a predefined structure. + ID or a predefined data structure. Demo From 9abfcc5d566cf074b44b7f632b5d5f27a4259159 Mon Sep 17 00:00:00 2001 From: Olga Stefaniuk Date: Wed, 13 Aug 2025 11:43:29 +0200 Subject: [PATCH 13/13] Fix BUIE samples --- content/guides/embed/ui-elements/preview.md | 24 ++++++++++----------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/content/guides/embed/ui-elements/preview.md b/content/guides/embed/ui-elements/preview.md index c99e771ac..e79f7c602 100644 --- a/content/guides/embed/ui-elements/preview.md +++ b/content/guides/embed/ui-elements/preview.md @@ -465,15 +465,15 @@ const suggestedQuestions = [ ]; preview.show(, , { - container: '.preview-container', - contentAnswersProps={ - show: true, - isCitationsEnabled: true, - isMarkdownEnabled: true, - isResetChatEnabled: true, - suggestedQuestions - } - hasHeader: true, + container: '.preview-container', + contentAnswersProps={ + show: true, + isCitationsEnabled: true, + isMarkdownEnabled: true, + isResetChatEnabled: true, + suggestedQuestions + } + hasHeader: true, }); ``` @@ -495,7 +495,7 @@ To localize the `suggestedQuestions` properly, make sure that the prompts are tr import ContentPreview from 'box-ui-elements/es/elements/content-preview'; import { IntlProvider } from "react-intl"; -const suggestedQuestions = [ +const questions = [ { label: 'Key takeaways', prompt: 'What are the key takeaways from this document?', @@ -521,11 +521,11 @@ export default () => { isCitationsEnabled: true, isMarkdownEnabled: true, isResetChatEnabled: true, - suggestedQuestions + suggestedQuestions: questions }} fileId={FILE_ID} token={TOKEN} - hasHeader=true + hasHeader="true" /> );