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:

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.