Box

oficial

Interaja com a plataforma de Gerenciamento Inteligente de Conteúdo através do Box AI.

GitHub

102

O que você pode fazer com Box MCP?

Pesquisar arquivos e pastas — Encontre conteúdo em todo o Box usando box_tools_search por palavra-chave, tipo de arquivo ou metadados.
Listar, criar ou gerenciar pastas — Navegue pelo conteúdo das pastas, crie novas pastas ou atualize e exclua as existentes com box_tools_folders.
Ler, enviar ou baixar arquivos — Recupere o conteúdo dos arquivos, envie novas versões ou baixe arquivos via box_tools_files.
Gerenciar links compartilhados — Crie, atualize ou remova links compartilhados para arquivos, pastas e links da web usando box_tools_shared_links.
Consultar arquivos com IA — Faça perguntas sobre o conteúdo dos arquivos ou dados do hub através do box_tools_ai.
Gerenciar modelos de metadados — Crie e gerencie modelos de metadados e aplique valores de instância a arquivos com box_tools_metadata.

Documentação

Servidor Box MCP

[!WARNING] Este repositório foi descontinuado e não é mais mantido. A Box agora oferece um servidor MCP hospedado com suporte oficial, melhor experiência e funcionalidade completa. Migre para o servidor MCP hospedado: Configurar o Servidor Box MCP →

Início Rápido

Clonar o repositório:

git clone https://github.com/box-community/mcp-server-box.git
cd mcp-server-box

Opcional, mas recomendado: instalação do `uv` para ambiente virtual e gerenciamento de dependências:

Homebrew (macOS)

brew install uv

WinGet (Windows)

winget install --id=astral-sh.uv  -e

No macOS e Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

No Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Configurar o ambiente virtual e instalar dependências:

uv sync

Definir variáveis de ambiente:

Defina as seguintes variáveis de ambiente para autenticação Box em um arquivo .env ou no ambiente do sistema.

Para opções completas de configuração de autenticação, consulte o Guia de Autenticação.

Usando OAuth2.0 com um App Box

BOX_CLIENT_ID = YOUR_CLIENT_ID
BOX_CLIENT_SECRET = YOUR_CLIENT_SECRET
BOX_REDIRECT_URL = http://localhost:8000/callback

# MCP Server Authentication (for HTTP transports)
BOX_MCP_SERVER_AUTH_TOKEN = YOUR_BOX_MCP_SERVER_AUTH_TOKEN
OAUTH_PROTECTED_RESOURCES_CONFIG_FILE = .oauth-protected-resource.json

Nota:

O BOX_MCP_SERVER_AUTH_TOKEN é usado para autenticar o cliente MCP no servidor MCP ao usar --mcp-auth-type=token (independente da autenticação Box)

Executar o servidor MCP no modo STDIO:

uv run src/mcp_server_box.py

Ferramentas do Servidor Box Community MCP

Abaixo, um resumo das ferramentas disponíveis:

Ferramentas disponíveis	Descrição
box_tools_ai	Consultas a arquivos e hubs com IA
box_tools_collaboration	Gerenciar colaborações em arquivos/pastas
box_tools_docgen	Geração de documentos e gerenciamento de modelos
box_tools_files	Operações com arquivos (ler, enviar, baixar)
box_tools_folders	Operações com pastas (listar, criar, excluir, atualizar)
box_tools_generic	Utilitários genéricos da API Box
box_tools_groups	Gerenciamento e consultas de grupos
box_tools_metadata	Gerenciamento de modelos e instâncias de metadados
box_tools_search	Pesquisar arquivos e pastas
box_tools_shared_links	Gerenciamento de links compartilhados para arquivos/pastas/links web
box_tools_tasks	Gerenciamento de tarefas e atribuições
box_tools_users	Gerenciamento e consultas de usuários
box_tools_web_link	Criação e gerenciamento de links web

Detalhes das Operações do Servidor Box Community MCP

Parâmetros da interface de linha de comando

Para executar o servidor MCP com configurações específicas, use os seguintes parâmetros de linha de comando:

uv run src/mcp_server_box.py --help

usage: mcp_server_box.py [-h] [--transport {stdio,sse,http}] [--host HOST] [--port PORT] [--mcp-auth-type {oauth,token,none}] [--box-auth-type {oauth,ccg,jwt,mcp_client}]

Box Community MCP Server

options:
  -h, --help            show this help message and exit
  --transport {stdio,sse,http}
                        Transport type (default: stdio)
  --host HOST           Host for SSE/HTTP transport (default: localhost)
  --port PORT           Port for SSE/HTTP transport (default: 8005)
  --mcp-auth-type {oauth,token,none}
                        Authentication type for MCP server (default: token)
  --box-auth-type {oauth,ccg,jwt,mcp_client}
                        Authentication type for Box API (default: oauth)

Para informações detalhadas sobre tipos de autenticação, configurações e casos de uso, consulte o Guia de Autenticação.

Configuração do Claude Desktop

Modo STDIO

Edite seu claude_desktop_config.json:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the configuration:

{
    "mcpServers": {
        "mcp-server-box": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-box",
                "run",
                "src/mcp_server_box.py"
            ]
        }
    }
}

Reinicie o Claude se estiver em execução.

Modo HTTP

Supondo que seu servidor MCP esteja rodando em https://mcp.myserver.com/mcp

Vá para Claude -> Configurações -> Conectores
Selecione Add custom connector
Configurações:
1. Dê um nome
2. Insira a URL, ex.: https://mcp.myserver.com/mcp
3. Opcionalmente, insira o client id e o client secret
Clique em adicionar
Clique em conectar. O fluxo OAuth deve iniciar. Complete o fluxo
De volta ao Claude, clique em Configurar. Você deve ver todas as ferramentas disponíveis.

Box