Skip to content

Commit 466262e

Browse files
github-actions[bot]github-actions[bot]
committed
guide: Box
1 parent b959e98 commit 466262e

4 files changed

Lines changed: 89 additions & 81 deletions

File tree

‎guides/box/external.md‎

Lines changed: 28 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -4,26 +4,25 @@ setup_version: 1
44

55
# Box
66

7-
Use a Box Admin or Co-Admin account for the enterprise you are connecting.
8-
Sign in to the **Box Admin Console** at
9-
[app.box.com/master](https://app.box.com/master).
7+
You need a Box Admin or Co-Admin account for the enterprise you are
8+
connecting.
109

1110
The Box MCP Server is available on all Box plans, but its tools depend on
12-
your plan. Box AI tools require a Box AI-enabled plan. The Doc Gen scope
13-
requires an Enterprise Advanced license. Box meters and bills API calls made
14-
with the Integration Credentials created below.
15-
16-
Before creating credentials, [enable Box AI](#enable-box-ai-api) or
17-
[enable Box Doc Gen](#enable-doc-gen) if users need those tools. Then create
18-
credentials for the **Custom Box MCP Server** integration.
11+
your plan. Box AI tools require an eligible Box AI plan or purchased Box AI
12+
Units. The Doc Gen scope requires an Enterprise Advanced license. Box meters
13+
and bills API calls made with the Integration Credentials created below.
1914

2015
### Sign in to the Box Admin Console {#open-admin-console}
2116

2217
Sign in to the **Box Admin Console** at
2318
[app.box.com/master](https://app.box.com/master) with your Box Admin or
2419
Co-Admin account.
2520

26-
<!-- screenshot-exception: a sign-in page with no MCP-specific state; the Admin Console landing view is captured in the next step -->
21+
<!-- screenshot-exception: a sign-in page with no MCP-specific state; the Integrations view is captured in the next step -->
22+
23+
Before creating credentials, [enable Box AI](#enable-box-ai-api) or
24+
[enable Box Doc Gen](#enable-doc-gen) if users need those tools. Then create
25+
credentials for the **Custom Box MCP Server** integration.
2726

2827
### Find Custom Box MCP Server under Integrations {#find-custom-box-mcp-server}
2928

@@ -38,8 +37,6 @@ Do not select the **Box MCP Server** tab or a named partner tile.
3837

3938
### Add Integration Credentials {#add-integration-credentials}
4039

41-
Complete the credential entry through **Save** in one sitting.
42-
4340
If **Configuration** appears:
4441

4542
1. Open **Configuration**.
@@ -55,7 +52,7 @@ If **Additional Configuration** appears instead:
5552
6. Click **Save**.
5653
7. Open the created credential entry.
5754

58-
<!-- screenshot: the Custom Box MCP Server configuration surface with either Configuration > Add Integration Credentials or Additional Configuration > + Add Integration Credentials visible, and the new credential entry it creates -->
55+
<!-- screenshot: the visible credential-add control on whichever documented configuration surface the enterprise presents -->
5956

6057
### Set the Redirect URI {#set-redirect-uri}
6158

@@ -65,7 +62,7 @@ Replace the existing value or values in **Redirect URIs** with this value:
6562
{{ gram.oauth.callback_url }}
6663
```
6764

68-
<!-- screenshot: the credential entry's Redirect URIs field containing the Speakeasy AI Control Plane callback URL -->
65+
<!-- screenshot: the credential entry's Redirect URIs field containing the Speakeasy AI Control Plane callback URL, with surrounding tenant and credential details redacted -->
6966

7067
### Copy the Client ID and Client Secret {#copy-client-credentials}
7168

@@ -78,7 +75,7 @@ Copy both values while Box shows them.
7875
4. Store the **Client Secret** like a password for
7976
[Speakeasy setup](speakeasy.md#connect-speakeasy-credentials).
8077

81-
<!-- screenshot-exception: the unique content is secret-bearing text; omit the screenshot rather than expose credentials -->
78+
<!-- screenshot-exception: the unique content is secret-bearing text; omit the screenshot unless every credential value is redacted -->
8279

8380
### Check the Access scopes {#check-access-scopes}
8481

@@ -90,13 +87,11 @@ licensed those features. The Doc Gen scope requires an Enterprise Advanced
9087
license. Scopes cap what the connection can do; each user's existing Box
9188
permissions still limit the content they can access.
9289

93-
<!-- screenshot: the credential entry's Access scopes section with its checkboxes visible; capture the exact labels because the documentation does not name them -->
90+
<!-- screenshot: the credential entry's Access scopes section with the intended non-secret selections visible and all credential values redacted; capture the exact labels because the documentation does not name them -->
9491

9592
### Save the credential entry {#save-credentials}
9693

97-
If you used **Configuration**, click **Save**. If you used **Additional
98-
Configuration**, use the submission control shown for the edited credential
99-
entry.
94+
Save the integration credentials.
10095

10196
<!-- screenshot-exception: a standard button click with no unique state beyond the views captured in the prior steps -->
10297

@@ -110,7 +105,9 @@ resolve the enterprise's Box AI entitlement before continuing.
110105
2. Select **Settings**.
111106
3. Enable **Enable AI API**.
112107

113-
<!-- screenshot: Box AI > Settings with Enable AI API visible -->
108+
Then return to [Find Custom Box MCP Server under Integrations](#find-custom-box-mcp-server).
109+
110+
<!-- screenshot: Box AI > Settings with Enable AI API visible; do not show user or tenant identifiers -->
114111

115112
### Enable Box Doc Gen (Doc Gen tools only) {#enable-doc-gen}
116113

@@ -120,13 +117,15 @@ an Enterprise Advanced license.
120117
1. Open **Enterprise Settings**.
121118
2. Select **Content and Sharing**.
122119
3. Scroll to **Box Doc Gen**.
123-
4. Under **Box Doc Gen Permissions**, select **Enable for all managed users**,
124-
**Enable for select users and groups**, or **Enable for everyone except
125-
select users and groups**.
120+
4. Under **Box Doc Gen Permissions**, choose to enable Doc Gen for all managed
121+
users, selected users and groups, or everyone except selected users and
122+
groups.
123+
124+
By default, Doc Gen is disabled for all managed users.
126125

127-
The default is **Disable for all managed users (default)**.
126+
Then return to [Find Custom Box MCP Server under Integrations](#find-custom-box-mcp-server).
128127

129-
<!-- screenshot: Enterprise Settings > Content and Sharing scrolled to the Box Doc Gen section with its permissions options visible -->
128+
<!-- screenshot: Enterprise Settings > Content and Sharing scrolled to Box Doc Gen with the permissions control visible and identities redacted -->
130129

131130
### Manage tool access before rollout (optional) {#manage-tool-access}
132131

@@ -147,9 +146,9 @@ To control individual tools:
147146
2. Set the toggles under **Read only MCP tools** and **Write MCP tools**.
148147
3. Click **Save**.
149148

150-
File preview requires a client with MCP Apps support. Upload and download URL
151-
tools require an agentic client that can make network requests and may require
152-
domain allowlisting.
149+
File preview requires a compatible application. Upload and download URL
150+
tools require an application that can make network requests; a cloud security
151+
owner may also need to allowlist domains.
153152

154153
If a client still shows the old tool list, refresh its tool list, start a new
155154
chat, or disconnect and reconnect it.

‎guides/box/meta.yaml‎

Lines changed: 30 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
schema_version: 1
33
slug: box
44
title: Box
5-
summary: Connect the Speakeasy AI Control Plane to Box's hosted MCP server with admin-created OAuth credentials.
5+
summary: Connect the Speakeasy AI Control Plane to Box's hosted MCP server with credentials created by a Box Admin or Co-Admin.
66
aliases:
77
- com.pulsemcp.mirror/box
88
speakeasy_add_server: catalog
@@ -35,120 +35,122 @@ remotes:
3535
- oauth-integration
3636
provenance:
3737
- source: pulsemcp
38-
name: com.pulsemcp.mirror/box
38+
locator: com.pulsemcp.mirror/box
39+
name: Box
3940
classification: mirror
4041
status: present
4142
scope: Speakeasy MCP Catalog exact match
42-
observed_at: "2026-08-28T15:35:57Z"
43+
observed_at: "2026-08-28T21:28:00Z"
4344
- source: provider-documentation
4445
locator: https://docs.box.com/en/box-mcp/about-box-mcp-server
4546
name: About Box MCP Server
4647
classification: official
47-
observed_at: "2026-08-28T15:35:57Z"
48+
observed_at: "2026-08-28T21:28:00Z"
4849
- source: provider-documentation
49-
locator: https://developer.box.com/guides/box-mcp/remote/
50+
locator: https://developer.box.com/guides/box-mcp/setup
5051
name: Set up the MCP server
5152
classification: official
52-
observed_at: "2026-08-28T15:35:57Z"
53+
observed_at: "2026-08-28T21:28:00Z"
5354
- source: endpoint-metadata
5455
locator: https://mcp.box.com/.well-known/oauth-protected-resource
5556
name: Box Model Context Protocol Server
5657
classification: official
57-
observed_at: "2026-08-28T15:35:57Z"
58+
observed_at: "2026-08-28T21:28:00Z"
5859
provenance:
5960
- source: pulsemcp
60-
name: com.pulsemcp.mirror/box
61+
locator: com.pulsemcp.mirror/box
62+
name: Box
6163
classification: mirror
6264
status: present
6365
scope: Speakeasy MCP Catalog exact match
64-
observed_at: "2026-08-28T15:35:57Z"
66+
observed_at: "2026-08-28T21:28:00Z"
6567
- source: provider-documentation
6668
locator: https://docs.box.com/llms.txt
6769
name: Box docs index
6870
classification: official
69-
observed_at: "2026-08-28T15:35:57Z"
71+
observed_at: "2026-08-28T21:28:00Z"
7072
- source: provider-documentation
7173
locator: https://docs.box.com/en/box-mcp/about-box-mcp-server
7274
name: About Box MCP Server
7375
classification: official
74-
observed_at: "2026-08-28T15:35:57Z"
76+
observed_at: "2026-08-28T21:28:00Z"
7577
- source: provider-documentation
7678
locator: https://docs.box.com/en/box-mcp/configuring-box-mcp-server/claude-code
7779
name: Claude Code
7880
classification: official
79-
observed_at: "2026-08-28T15:35:57Z"
81+
observed_at: "2026-08-28T21:28:00Z"
8082
- source: provider-documentation
8183
locator: https://docs.box.com/en/box-mcp/configuring-box-mcp-server/anthropic-messages-api
8284
name: Anthropic Messages API
8385
classification: official
84-
observed_at: "2026-08-28T15:35:57Z"
86+
observed_at: "2026-08-28T21:28:00Z"
8587
- source: provider-documentation
8688
locator: https://docs.box.com/en/box-mcp/supported-ai-platforms
8789
name: Supported AI platforms
8890
classification: official
89-
observed_at: "2026-08-28T15:35:57Z"
91+
observed_at: "2026-08-28T21:28:00Z"
9092
- source: provider-documentation
9193
locator: https://docs.box.com/en/box-mcp/admin-controls
9294
name: Manage tool access
9395
classification: official
94-
observed_at: "2026-08-28T15:35:57Z"
96+
observed_at: "2026-08-28T21:28:00Z"
9597
- source: provider-documentation
9698
locator: https://docs.box.com/en/box-mcp/tools
9799
name: Available tools
98100
classification: official
99-
observed_at: "2026-08-28T15:35:57Z"
101+
observed_at: "2026-08-28T21:28:00Z"
100102
- source: provider-documentation
101103
locator: https://docs.box.com/en/box-mcp/pricing
102104
name: Pricing
103105
classification: official
104-
observed_at: "2026-08-28T15:35:57Z"
106+
observed_at: "2026-08-28T21:28:00Z"
105107
- source: provider-documentation
106108
locator: https://docs.box.com/en/box-mcp/faq
107109
name: MCP frequently asked questions
108110
classification: official
109-
observed_at: "2026-08-28T15:35:57Z"
111+
observed_at: "2026-08-28T21:28:00Z"
110112
- source: provider-documentation
111113
locator: https://docs.box.com/en/box-ai/admins/configuring-box-ai
112114
name: Configuring Box AI
113115
classification: official
114-
observed_at: "2026-08-28T15:35:57Z"
116+
observed_at: "2026-08-28T21:28:00Z"
115117
- source: provider-documentation
116118
locator: https://docs.box.com/en/box-admin-tools/box-admin-reference/enterprise-settings-content-sharing-tab
117119
name: Enterprise Settings Content and Sharing
118120
classification: official
119-
observed_at: "2026-08-28T15:35:57Z"
121+
observed_at: "2026-08-28T21:28:00Z"
120122
- source: provider-documentation
121123
locator: https://docs.box.com/en/box-admin-tools/reporting-and-insights/mcp-server-activity-report
122124
name: MCP Server Activity Report
123125
classification: official
124-
observed_at: "2026-08-28T15:35:57Z"
126+
observed_at: "2026-08-28T21:28:00Z"
125127
- source: provider-documentation
126128
locator: https://developer.box.com/guides/box-mcp/
127129
name: Box MCP server
128130
classification: official
129-
observed_at: "2026-08-28T15:35:57Z"
131+
observed_at: "2026-08-28T21:28:00Z"
130132
- source: provider-documentation
131-
locator: https://developer.box.com/guides/box-mcp/remote/
133+
locator: https://developer.box.com/guides/box-mcp/setup
132134
name: Set up the MCP server
133135
classification: official
134-
observed_at: "2026-08-28T15:35:57Z"
136+
observed_at: "2026-08-28T21:28:00Z"
135137
- source: provider-documentation
136138
locator: https://support.box.com/hc/en-us/articles/43847256139923
137139
name: Managing Box MCP Servers
138140
classification: official
139-
observed_at: "2026-08-28T15:35:57Z"
141+
observed_at: "2026-08-28T21:28:00Z"
140142
- source: provider-documentation
141143
locator: https://support.box.com/hc/en-us/articles/30900136778259
142144
name: Adding Integration Credentials for Customer-Instance Integrations
143145
classification: official
144-
observed_at: "2026-08-28T15:35:57Z"
146+
observed_at: "2026-08-28T21:28:00Z"
145147
- source: endpoint-metadata
146148
locator: https://mcp.box.com/.well-known/oauth-protected-resource
147149
name: Box Model Context Protocol Server
148150
classification: official
149-
observed_at: "2026-08-28T15:35:57Z"
151+
observed_at: "2026-08-28T21:28:00Z"
150152
- source: repository-doctrine
151153
locator: doctrine/speakeasy-setup.md
152154
name: Canonical Speakeasy setup
153155
classification: official
154-
observed_at: "2026-08-28T15:35:57Z"
156+
observed_at: "2026-08-28T21:28:00Z"

0 commit comments

Comments
 (0)