박스-mcp-서버

용법

필요한 것:

• BOX_USER_ID

다음 중 하나:

• BOX_JWT_BASE64 (권장)

• BOX_JWT_CONFIG_PATH

• BOX_JWT

Related MCP server: Google Drive server

인증

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

JWT를 얻는 방법

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

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

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

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

1. App + Enterprise Access 애플리케이션을 제공하고

2. make API calls using the as-user header 활성화합니다.

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

Base64 인코딩 JWT

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

지엑스피1

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

클로드 데스크톱 구성

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

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

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

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

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

클로드 데스크톱 구성

역량

1. 파일 검색

2. 파일 읽기

• [x] PDF

• [x] 단어

• [ ] 기타

개발

필수 조건

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

• Node.js(권장 v22 이상)

• 엔피엠

• git

• 도텐브

개발 환경 설정

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

1. 저장소를 포크하세요

   • 이 저장소의 오른쪽 상단에 있는 "포크" 버튼을 클릭하세요.

   • 이렇게 하면 Github 계정 아래에 저장소의 사본이 생성됩니다.

2. 포크 복제:

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

3. 업스트림 원격 추가

   git remote add upstream https://github.com/hmk/box-mcp-server.git

4. dotenv 파일을 복사하세요

   cp .env.template .env

5. 종속성 설치:

   npm install

6. index.js를 최신 상태로 유지하려면 watch를 실행하세요.

   npm run watch

7. 모델 컨텍스트 프로토콜 개발 서버를 시작합니다.

   dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js

8. 개발 서버가 환경 변수를 올바르게 로드하지 못한 경우 mcp 검사기의 왼쪽에 BOX_DEV_TOKEN 설정하세요.