Box

resmi

Berinteraksi dengan platform Intelligent Content Management melalui Box AI.

GitHub

102

Apa yang bisa Anda lakukan dengan Box MCP?

Cari file dan folder — Temukan konten di Box menggunakan box_tools_search berdasarkan kata kunci, jenis file, atau metadata.
Daftar, buat, atau kelola folder — Jelajahi isi folder, buat folder baru, atau perbarui dan hapus folder yang sudah ada dengan box_tools_folders.
Baca, unggah, atau unduh file — Ambil konten file, unggah versi baru, atau unduh file melalui box_tools_files.
Kelola tautan bersama — Buat, perbarui, atau hapus tautan bersama untuk file, folder, dan tautan web menggunakan box_tools_shared_links.
Kueri file dengan AI — Ajukan pertanyaan tentang konten file atau data hub melalui box_tools_ai.
Tangani template metadata — Buat dan kelola template metadata serta terapkan nilai instance ke file dengan box_tools_metadata.

Dokumentasi

Server Box MCP

[!WARNING] Repositori ini telah dihentikan dan tidak lagi dipelihara. Box kini menyediakan server MCP terkelola yang didukung secara resmi dengan pengalaman terbaik dan fungsionalitas penuh. Silakan migrasi ke server MCP terkelola: Siapkan Server Box MCP →

Mulai Cepat

Kloning repositori:

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

Opsional namun direkomendasikan: instalasi `uv` untuk lingkungan virtual dan manajemen dependensi:

Homebrew (macOS)

brew install uv

WinGet (Windows)

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

Di macOS dan Linux

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

Di Windows

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

Siapkan lingkungan virtual dan instal dependensi:

uv sync

Atur variabel lingkungan:

Atur variabel lingkungan berikut untuk autentikasi Box di file .env atau lingkungan sistem Anda.

Untuk opsi konfigurasi autentikasi yang lengkap, lihat Panduan Autentikasi.

Menggunakan OAuth2.0 dengan Aplikasi 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

Catatan:

BOX_MCP_SERVER_AUTH_TOKEN digunakan untuk mengautentikasi klien MCP ke server MCP saat menggunakan --mcp-auth-type=token (terpisah dari autentikasi Box)

Jalankan server MCP dalam mode STDIO:

uv run src/mcp_server_box.py

Alat Server MCP Komunitas Box

Berikut ringkasan alat yang tersedia:

Alat yang tersedia	Deskripsi
box_tools_ai	Kueri file dan hub bertenaga AI
box_tools_collaboration	Kelola kolaborasi file/folder
box_tools_docgen	Pembuatan dokumen dan manajemen template
box_tools_files	Operasi file (baca, unggah, unduh)
box_tools_folders	Operasi folder (daftar, buat, hapus, perbarui)
box_tools_generic	Utilitas API Box generik
box_tools_groups	Manajemen grup dan kueri
box_tools_metadata	Manajemen template dan instance metadata
box_tools_search	Cari file dan folder
box_tools_shared_links	Manajemen tautan bersama untuk file/folder/tautan web
box_tools_tasks	Manajemen tugas dan penugasan tugas
box_tools_users	Manajemen pengguna dan kueri
box_tools_web_link	Pembuatan dan manajemen tautan web

Detail Operasi Server MCP Komunitas Box

Parameter antarmuka baris perintah

Untuk menjalankan server MCP dengan konfigurasi tertentu, Anda dapat menggunakan parameter baris perintah berikut:

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)

Untuk informasi detail tentang jenis autentikasi, konfigurasi, dan kasus penggunaan, lihat Panduan Autentikasi.

Konfigurasi Claude Desktop

Mode STDIO

Edit claude_desktop_config.json Anda:

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

Mulai ulang Claude jika sedang berjalan.

Mode HTTP

Dengan asumsi server MCP Anda berjalan di https://mcp.myserver.com/mcp

Buka Claude -> Pengaturan -> Konektor
Pilih Add custom connector
Konfigurasi:
1. Beri nama
2. Masukkan URL, mis. https://mcp.myserver.com/mcp
3. Opsional masukkan client id dan client secret
Klik tambah
Klik sambungkan. Alur OAuth akan dimulai. Selesaikan alur tersebut
Kembali ke Claude, klik Konfigurasi. Anda akan melihat semua alat yang tersedia.

Box