Box

공식

지능형 콘텐츠 관리 플랫폼과 Box AI를 통해 상호작용합니다.

GitHub

102

Box MCP(으)로 무엇을 할 수 있나요?

파일 및 폴더 검색 — 키워드, 파일 유형 또는 메타데이터로 box_tools_search를 사용하여 Box 전체에서 콘텐츠를 찾습니다.
폴더 나열, 생성 또는 관리 — box_tools_folders로 폴더 내용을 탐색하고, 새 폴더를 만들거나 기존 폴더를 업데이트 및 삭제합니다.
파일 읽기, 업로드 또는 다운로드 — box_tools_files를 통해 파일 내용을 검색하고, 새 버전을 업로드하거나 파일을 다운로드합니다.
공유 링크 관리 — box_tools_shared_links를 사용하여 파일, 폴더 및 웹 링크에 대한 공유 링크를 생성, 업데이트 또는 제거합니다.
AI로 파일 쿼리 — box_tools_ai를 통해 파일 내용이나 허브 데이터에 대해 질문합니다.
메타데이터 템플릿 처리 — box_tools_metadata로 메타데이터 템플릿을 생성 및 관리하고 인스턴스 값을 파일에 적용합니다.

문서

Box MCP 서버

[!WARNING] 이 저장소는 중단되었으며 더 이상 유지 관리되지 않습니다. Box는 이제 최고의 경험과 완전한 기능을 갖춘 공식 지원 호스팅 MCP 서버를 제공합니다. 호스팅 MCP 서버로 마이그레이션하세요: Box MCP 서버 설정 →

빠른 시작

저장소 복제:

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

선택 사항이지만 가상 환경 및 종속성 관리를 위해 권장되는 `uv` 설치:

Homebrew (macOS)

brew install uv

WinGet (Windows)

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

macOS 및 Linux에서

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

Windows에서

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

가상 환경 설정 및 종속성 설치:

uv sync

환경 변수 설정:

Box 인증을 위해 다음 환경 변수를 .env 파일 또는 시스템 환경에 설정하세요.

포괄적인 인증 구성 옵션은 인증 가이드를 참조하세요.

Box 앱과 함께 OAuth2.0 사용

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

참고:

BOX_MCP_SERVER_AUTH_TOKEN는 --mcp-auth-type=token 사용 시 MCP 클라이언트를 MCP 서버에 인증하는 데 사용됩니다 (Box 인증과는 독립적).

STDIO 모드에서 MCP 서버 실행:

uv run src/mcp_server_box.py

Box 커뮤니티 MCP 서버 도구

아래는 사용 가능한 도구 요약입니다:

사용 가능한 도구	설명
box_tools_ai	AI 기반 파일 및 허브 쿼리
box_tools_collaboration	파일/폴더 협업 관리
box_tools_docgen	문서 생성 및 템플릿 관리
box_tools_files	파일 작업 (읽기, 업로드, 다운로드)
box_tools_folders	폴더 작업 (목록, 생성, 삭제, 업데이트)
box_tools_generic	일반 Box API 유틸리티
box_tools_groups	그룹 관리 및 쿼리
box_tools_metadata	메타데이터 템플릿 및 인스턴스 관리
box_tools_search	파일 및 폴더 검색
box_tools_shared_links	파일/폴더/웹 링크에 대한 공유 링크 관리
box_tools_tasks	작업 및 작업 할당 관리
box_tools_users	사용자 관리 및 쿼리
box_tools_web_link	웹 링크 생성 및 관리

Box 커뮤니티 MCP 서버 작업 세부 정보

명령줄 인터페이스 매개변수

특정 구성으로 MCP 서버를 실행하려면 다음 명령줄 매개변수를 사용할 수 있습니다:

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)

인증 유형, 구성 및 사용 사례에 대한 자세한 내용은 인증 가이드를 참조하세요.

Claude 데스크톱 구성

STDIO 모드

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

Claude가 실행 중이면 다시 시작하세요.

HTTP 모드

MCP 서버가 https://mcp.myserver.com/mcp에서 실행 중이라고 가정합니다.

Claude -> 설정 -> 커넥터로 이동
Add custom connector 선택
구성:
1. 이름 지정
2. URL 입력 예: https://mcp.myserver.com/mcp
3. 선택적으로 client id 및 client secret 입력
추가 클릭
연결 클릭. OAuth 흐름이 시작됩니다. 흐름 완료
Claude로 돌아가서 구성을 클릭합니다. 사용 가능한 모든 도구가 표시되어야 합니다.

Box