Document Box MCP Server integration with MCP Gateway

[crivetimihai]

Overview

Document how to integrate the official Box MCP Server with MCP Gateway for document management and collaboration workflows.

Server Details

• Provider: Box
• Category: Document Management
• Endpoint: https://mcp.box.com
• Authentication: OAuth2.1 🔐
• Protocol: Standard MCP over HTTPS

Documentation Requirements

File Location

Create: docs/docs/using/servers/box/box-mcp.md

Content Structure

1. Overview

   • Introduction to Box MCP Server
   • Document management capabilities
   • Integration benefits with Box Drive, Box Notes, Box Sign

2. Prerequisites

   • Box account and developer application setup
   • OAuth2.1 application registration in Box Developer Console
   • Required permissions and enterprise settings

3. Authentication Setup

   • OAuth2.1 flow configuration for Box API
   • JWT authentication for enterprise applications
   • Service account setup for server-to-server integration
   • Token management and refresh handling

4. MCP Gateway Integration

   • Server registration in MCP Gateway
   • HTTPS endpoint configuration
   • Authentication middleware for OAuth2.1
   • Error handling and API rate limit management

5. Available Tools

   • Document available Box MCP tools
   • File and folder management operations
   • Collaboration and sharing tools
   • Search and metadata operations
   • User and group management

6. Usage Examples

   • Uploading and downloading files
   • Managing folder structures
   • Setting up file sharing and permissions
   • Document collaboration workflows
   • Integration with Box AI features

7. Troubleshooting

   • OAuth setup and token issues
   • Permission and access errors
   • API rate limiting considerations
   • Enterprise security requirements

Configuration Examples

# MCP Gateway server configuration
servers:
  - id: "box-official"
    name: "Box MCP Server"
    description: "Official Box document management tools"
    transport:
      type: "https"
      endpoint: "https://mcp.box.com"
      auth:
        type: "oauth2"
        client_id: "${BOX_CLIENT_ID}"
        client_secret: "${BOX_CLIENT_SECRET}"
        scopes: ["root_readwrite", "manage_users", "manage_groups"]
        token_endpoint: "https://api.box.com/oauth2/token"
        authorize_endpoint: "https://account.box.com/api/oauth2/authorize"
    settings:
      timeout: 120
      retry_attempts: 3
      rate_limit_handling: true

# Enterprise JWT configuration (alternative)
servers:
  - id: "box-enterprise"
    name: "Box Enterprise MCP Server"
    transport:
      type: "https"
      endpoint: "https://mcp.box.com"
      auth:
        type: "jwt"
        client_id: "${BOX_CLIENT_ID}"
        client_secret: "${BOX_CLIENT_SECRET}"
        enterprise_id: "${BOX_ENTERPRISE_ID}"
        public_key_id: "${BOX_PUBLIC_KEY_ID}"
        private_key: "${BOX_PRIVATE_KEY}"

Navigation Updates

Create docs/docs/using/servers/box/.pages with:

title: Box
nav:
  - box-mcp.md

Update main servers .pages to include Box section.

References

• Box MCP Server
• Box Developer Documentation
• Box OAuth2.1 Setup Guide
• Box JWT Authentication

Acceptance Criteria

• Comprehensive documentation file created
• OAuth2.1 and JWT authentication setup documented
• HTTPS endpoint integration guide provided
• Available Box tools and capabilities documented
• Configuration examples for both OAuth and JWT
• Enterprise setup considerations included
• Troubleshooting section with common issues
• Navigation structure updated
• Cross-references to Box developer resources

Priority

Medium - Part of 0.8.0 public server documentation initiative

Use Cases

• Enterprise document management and collaboration
• File sharing and permission management
• Document workflow automation
• Content management and organization
• Secure file storage and access control
• Integration with business applications