박스 MCP 서버

박스-mcp-서버

용법

필요한 것:

BOX_USER_ID

다음 중 하나:

BOX_JWT_BASE64 (권장)
BOX_JWT_CONFIG_PATH
BOX_JWT

인증

JSON 웹 토큰(JWT) 인증(권장)

JWT를 얻는 방법

JWT Config를 사용하면 Box에 지속적으로 연결할 수 있습니다.

유료 Box 엔터프라이즈 계정이 필요하거나 무료 개발자 계정 에 가입할 수 있습니다(해당 링크를 클릭하기 전에 Box에서 로그아웃했는지 확인하세요).

Box 개발자 콘솔 로 이동하여 새 애플리케이션을 만드세요. 권한 유형이 JSON 웹 토큰인지 확인하세요.

Configuration > Add and Manage Public Keys 로 이동하여 공개/개인 키 쌍을 생성하세요. 아직 설정하지 않았다면 Box에서 2단계 인증을 설정하고 Box 계정에서 애플리케이션을 관리자 권한으로 승인하라는 메시지가 표시됩니다. 다음 작업을 수행해야 합니다.

App + Enterprise Access 애플리케이션을 제공하고
make API calls using the as-user header 활성화합니다.

Box 애플리케이션의 구성 페이지를 통해 변경할 수 있습니다. 설정을 수정하는 경우 애플리케이션을 다시 인증해야 합니다 .

Base64 인코딩 JWT

JWT를 Base64로 인코딩하려면 터미널에서 다음 명령을 사용하면 됩니다.

지엑스피1

/path/to/your/box-jwt-config.json JWT 설정 파일의 실제 경로로 바꾸세요. 이렇게 하면 Base64로 인코딩된 JWT가 출력되며, 이를 환경 변수에 사용할 수 있습니다.

클로드 데스크톱 구성

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_JWT_BASE64": "YOUR_BASE64_ENCODED_JWT",
        "BOX_USER_ID": "123456"
      }
    }
  }
}

개발자 토큰 인증(가장 쉬움)

개발자 토큰을 사용하는 것은 Box와 통합하는 가장 쉬운 방법이지만, 60분만 지속됩니다.

시작하려면 BOX_DEV_TOKEN Box 개발자 토큰 으로 설정하세요.

Box 개발자 콘솔을 방문하여 새 애플리케이션을 만드세요. 모든 앱이 Box 개발자 토큰을 지원하므로 현재 권한 유형은 중요하지 않습니다.

애플리케이션이 생성되면 구성 설정으로 이동하여 Generate Developer Token 클릭합니다.

클로드 데스크톱 구성

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_DEV_TOKEN": "YOUR_DEV_TOKEN_GOES_HERE"
      }
    }
  }
}

역량

파일 검색
파일 읽기

[x] PDF
[x] 단어
[ ] 기타

개발

필수 조건

시작하기 전에 다음 사항이 설치되어 있는지 확인하세요.

Node.js(권장 v22 이상)
엔피엠
git
도텐브

개발 환경 설정

개발 환경을 설정하려면 다음 단계를 따르세요.

저장소를 포크하세요
- 이 저장소의 오른쪽 상단에 있는 "포크" 버튼을 클릭하세요.
- 이렇게 하면 Github 계정 아래에 저장소의 사본이 생성됩니다.
포크 복제:
git clone https://github.com/YOUR_USERNAME/box-mcp-server.git cd box-mcp-server
업스트림 원격 추가
git remote add upstream https://github.com/hmk/box-mcp-server.git
dotenv 파일을 복사하세요
cp .env.template .env
종속성 설치:
npm install
index.js를 최신 상태로 유지하려면 watch를 실행하세요.
npm run watch
모델 컨텍스트 프로토콜 개발 서버를 시작합니다.
dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
개발 서버가 환경 변수를 올바르게 로드하지 못한 경우 mcp 검사기의 왼쪽에 BOX_DEV_TOKEN 설정하세요.

Box MCP Server

Integrations