Box MCP Server

Что умеет сервер

Box MCP — это хостируемый сервер Box по адресу mcp.box.com: запускать его самим не нужно. Инструменты сгруппированы по областям. Для файлов и папок есть чтение содержимого и деталей, предпросмотр, список содержимого папки, копирование, создание папок, загрузка файлов и новых версий, перемещение и правка свойств. Для поиска доступны поиск файлов по ключевым словам, по метаданным и поиск папок по имени.

Отдельные наборы работают с метаданными (шаблоны и значения), комментариями, задачами и коллаборациями, хабами Box и генерацией документов по шаблонам (Doc Gen). Инструменты Box AI отвечают на вопросы по одному файлу, нескольким файлам или хабу, часто с цитатами, и извлекают структурированные данные из файлов.

Когда использовать

Сервер нужен, если ваши документы лежат в Box и агент должен работать с ними, не перенося данные наружу: искать договоры и отчёты, задавать вопросы по набору файлов, вытаскивать поля из документов в метаданные, собирать подборки в хабах. Подключается он к ИИ-платформам и IDE: в документации есть отдельные инструкции для Claude Code, Cursor и GitHub Copilot в VS Code.

Прежний самохостящийся сервер Box (открытый проект сообщества) объявлен устаревшим, и документация просит не начинать на нём новую работу. Для новых интеграций используйте удалённый сервер.

Ограничения и безопасность

Подключение начинается с администратора: он включает MCP в Admin Console, а для собственных клиентов создаёт Integration Credentials (Client ID, Client Secret, адрес перенаправления и права доступа). Агент работает от имени пользователя, который вошёл по OAuth. Права доступа Box действуют на каждый запрос: сервер не подменяет личность пользователя и не видит файлов, которые ему и так недоступны.

Часть инструментов по умолчанию выключена, и их должен включить администратор. Среди них перемещение файлов и папок, запись метаданных, обновление свойств, создание общих ссылок и приглашение коллабораторов, загрузка новых версий и выдача ссылок на скачивание и загрузку. Инструменты со ссылками на загрузку и скачивание требуют от клиента прямых сетевых запросов, поэтому работают только в средах, где агент исполняет код. Право docgen.readwrite требует лицензию Enterprise Advanced.

Адрес сервера: https://mcp.box.com, имя сервера для клиентов: box-remote-mcp. Сначала администратор включает MCP в Box Admin Console (раздел Integrations) и создаёт Integration Credentials. Для клиентов, которым нужны адреса OAuth, документация указывает:

Authorization URL: https://account.box.com/api/oauth2/authorize
Token Exchange URL: https://api.box.com/oauth2/token
Scopes: root_readwrite, ai.readwrite, docgen.readwrite

Claude Code

Нужна учётная запись Box Enterprise с включённым администратором MCP. Выполните команду, затем в Claude Code команду /mcp, чтобы убедиться, что box-remote-mcp подключён:

claude mcp add box --transport http https://mcp.box.com

Вместо команды можно выполнить /plugin, найти Box и установить плагин.

Cursor

В Cursor откройте Settings, Tools and MCPs, Add Custom MCP (откроется mcp.json) и вставьте конфигурацию со своими Client ID и Client Secret:

{
  "mcpServers": {
    "box": {
      "url": "https://mcp.box.com",
      "auth": {
        "CLIENT_ID": "your_client_id",
        "CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Затем вернитесь в Tools and MCPs и нажмите connect для авторизации.

GitHub Copilot в VS Code

Сервер есть в реестре GitHub MCP на странице Box MCP server. Откройте её, нажмите Install MCP server, подтвердите установку в VS Code и пройдите OAuth. При регистрации OAuth-приложения добавьте адреса перенаправления:

http://127.0.0.1:33418
https://vscode.dev/redirect

Anthropic Messages API

Пример из документации Box: сервер передаётся в параметре mcp_servers.

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"]
)