Box

Box MCP Sunucusu

[!WARNING] Bu depo kullanımdan kaldırılmıştır ve artık bakımı yapılmamaktadır. Box artık en iyi deneyimi ve tam işlevselliği sunan, resmi olarak desteklenen barındırılan bir MCP sunucusu sağlamaktadır. Lütfen barındırılan MCP sunucusuna geçiş yapın: Box MCP Sunucusunu Kurun →

Hızlı Başlangıç

Depoyu klonlayın:

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

Sanal ortam ve bağımlılık yönetimi için isteğe bağlı ancak önerilen uv kurulumu:

Homebrew (macOS)

brew install uv

WinGet (Windows)

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

macOS ve Linux'ta

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

Windows'ta

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

Sanal ortamı kurun ve bağımlılıkları yükleyin:

uv sync

Ortam değişkenlerini ayarlayın:

Box kimlik doğrulaması için aşağıdaki ortam değişkenlerini bir .env dosyasında veya sistem ortamınızda ayarlayın.

Kapsamlı kimlik doğrulama yapılandırma seçenekleri için Kimlik Doğrulama Kılavuzu belgesine bakın.

Box Uygulaması ile OAuth2.0 Kullanımı

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

Not:

• BOX_MCP_SERVER_AUTH_TOKEN, --mcp-auth-type=token kullanılırken MCP istemcisini MCP sunucusuna kimlik doğrulamak için kullanılır (Box kimlik doğrulamasından bağımsızdır)

MCP sunucusunu STDIO modunda çalıştırın:

uv run src/mcp_server_box.py

Box Topluluk MCP Sunucusu Araçları

Aşağıda mevcut araçların bir özeti bulunmaktadır:

Mevcut araçlar	Açıklama
box_tools_ai	Yapay zeka destekli dosya ve hub sorguları
box_tools_collaboration	Dosya/klasör iş birliklerini yönetme
box_tools_docgen	Belge oluşturma ve şablon yönetimi
box_tools_files	Dosya işlemleri (okuma, yükleme, indirme)
box_tools_folders	Klasör işlemleri (listeleme, oluşturma, silme, güncelleme)
box_tools_generic	Genel Box API yardımcı programları
box_tools_groups	Grup yönetimi ve sorguları
box_tools_metadata	Meta veri şablonu ve örnek yönetimi
box_tools_search	Dosya ve klasörleri arama
box_tools_shared_links	Dosyalar/klasörler/web bağlantıları için paylaşılan bağlantı yönetimi
box_tools_tasks	Görev ve görev atama yönetimi
box_tools_users	Kullanıcı yönetimi ve sorguları
box_tools_web_link	Web bağlantısı oluşturma ve yönetimi

Box Topluluk MCP Sunucusu İşlem Detayları

Komut satırı arayüz parametreleri

MCP sunucusunu belirli yapılandırmalarla çalıştırmak için aşağıdaki komut satırı parametrelerini kullanabilirsiniz:

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)

Kimlik doğrulama türleri, yapılandırmalar ve kullanım durumları hakkında ayrıntılı bilgi için Kimlik Doğrulama Kılavuzu belgesine bakın.

Claude Masaüstü Yapılandırması

STDIO modu

claude_desktop_config.json dosyanızı düzenleyin:

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

Claude çalışıyorsa yeniden başlatın.

HTTP Modu

MCP sunucunuzun https://mcp.myserver.com/mcp üzerinde çalıştığını varsayalım

1. Claude -> Ayarlar -> Bağlayıcılar'a gidin
2. Add custom connector seçeneğini belirleyin
3. Yapılandırmalar:
   1. Bir ad verin
   2. URL'yi girin, örn. https://mcp.myserver.com/mcp
   3. İsteğe bağlı olarak client id ve client secret bilgilerini girin
4. Ekle'ye tıklayın
5. Bağlan'a tıklayın. OAuth akışı başlamalıdır. Akışı tamamlayın
6. Claude'a geri dönün, Yapılandır'a tıklayın. Mevcut tüm araçları görmelisiniz.