Box MCP

Box의 공식 Remote MCP 서버를 통해 Box에 저장된 파일과 콘텐츠에 안전하게 접근할 수 있습니다.

개요

Box는 공식 Remote MCP 서버(https://mcp.box.com)를 제공합니다. 이 서버를 통해 AI 에이전트가 Box에 저장된 파일을 검색, 조회, 관리하고 Box AI 기능을 활용할 수 있습니다.

QueryPie AIP에서는 이 공식 MCP 서버를 사전 구성된 Remote MCP로 제공하며, 연동을 위해 Box Developer Console에서 Client ID와 Client Secret을 발급받아야 합니다.

지원 기능

Box 공식 MCP 서버는 다음 기능을 지원합니다:

• 파일 관리: 파일 조회, 업로드, 속성 수정
• 폴더 관리: 폴더 생성, 조회, 콘텐츠 목록 확인
• 검색: 키워드 기반 파일 검색, 메타데이터 기반 검색, 폴더 검색
• Box AI: 메타데이터 추출 (자유 형식 및 구조화, Enhanced 포함)
• 협업: 파일 댓글, 협업자 목록, 태스크 조회
• Hubs: Hub 생성, 관리, 아이템 추가

지원하는 MCP 도구

사용자 관리 도구

who_am_i

현재 인증된 Box 사용자의 프로필 정보를 조회합니다.

파일 관리 도구

get_file_details

파일의 상세 정보 (이름, 크기, 생성/수정 일시, 권한 등)를 조회합니다.

get_file_content

파일의 텍스트 콘텐츠를 추출합니다 (50MB 이하). PDF, 문서, 스프레드시트, 프레젠테이션, 코드 파일 등을 지원합니다. 텍스트 표현이 없는 파일은 오류가 반환됩니다.

upload_file

Box에 새 파일을 업로드합니다. 대상 폴더를 지정할 수 있습니다.

upload_file_version

기존 파일의 새 버전을 업로드합니다. upload_file과 동일하게 텍스트 콘텐츠만 지원합니다.

update_file_properties

파일의 이름, 설명, 태그, 컬렉션 등 메타데이터를 수정합니다.

폴더 관리 도구

list_folder_content_by_folder_id

폴더 내 파일, 폴더, 웹 링크 목록을 조회합니다. 루트 폴더는 ID "0"을 사용합니다.

get_folder_details

폴더의 상세 정보를 조회합니다.

create_folder

새 폴더를 생성합니다.

update_folder_properties

폴더의 이름, 설명, 태그, 컬렉션 등 메타데이터를 수정합니다.

검색 도구

search_files_keyword

키워드 기반으로 파일을 검색합니다. 확장자 필터, 날짜 범위, 메타데이터 필터를 지원합니다.

search_folders_by_name

폴더 이름으로 검색합니다. 특정 상위 폴더 내로 범위를 제한할 수 있습니다.

search_files_metadata

SQL 유사 메타데이터 쿼리로 파일을 검색합니다.

Box AI 도구

ai_extract_structured_from_metadata_template

기존 메타데이터 템플릿을 기반으로 파일에서 구조화된 메타데이터를 추출합니다.

ai_extract_structured_from_metadata_template_enhanced

Enhanced Extract Agent를 사용하여 메타데이터 템플릿 기반의 향상된 추출을 수행합니다. 표준 도구보다 비용이 높으므로, 명시적으로 요청된 경우에만 사용됩니다.

ai_extract_structured_from_fields_enhanced

커스텀 필드 정의를 기반으로 Enhanced Extract Agent를 사용하여 구조화된 메타데이터를 추출합니다. string, float, date, enum, multiSelect 타입을 지원합니다. 표준 도구보다 비용이 높으므로, 명시적으로 요청된 경우에만 사용됩니다.

협업 도구

list_file_comments

파일의 댓글 목록을 조회합니다.

create_file_comment

파일에 댓글을 추가합니다.

list_item_collaborations

파일 및 폴더의 협업자 목록을 조회합니다. 최대 10개 아이템을 동시에 조회할 수 있습니다.

list_tasks

파일에 할당된 태스크 목록을 조회합니다.

Hubs 도구

list_hubs

접근 가능한 Hub 목록을 조회합니다.

get_hub_details

특정 Hub의 상세 정보를 조회합니다.

get_hub_items

Hub 내 아이템 (파일, 폴더, 웹 링크)을 조회합니다.

create_hub

새로운 Hub를 생성합니다.

add_items_to_hub

Hub에 파일, 폴더, 웹 링크를 추가합니다.

update_hub

Hub의 제목이나 설명을 수정합니다.

Client ID / Secret 발급 방법

Step 1: Box Developer Console 접속

1. Box Developer Console 에 접속합니다.
2. Box 계정으로 로그인합니다.

Step 2: OAuth 앱 생성

1. Create New App을 클릭합니다.
2. Custom App을 선택하고, 인증 방식으로 User Authentication (OAuth 2.0)을 선택합니다.
3. 앱 이름을 입력합니다 (예: QueryPie AIP).
4. 앱 생성 후 Configuration 탭으로 이동합니다.

Step 3: OAuth 설정

1. OAuth 2.0 Redirect URI에 AIP에서 제공하는 OAuth 콜백 URL을 입력합니다.
2. Application Scopes에서 Write all files and folders stored in Box를 체크합니다.
3. Client ID와 Client Secret을 확인하고 복사합니다.

Step 4: AIP에서 연동 설정

1. QueryPie AIP 관리 화면에서 Box MCP 항목을 선택합니다.
2. 발급받은 Client ID와 Client Secret을 입력합니다.
3. 연동을 완료합니다.

참고 자료

• Box 공식 문서: Remote Box MCP server 
• Box Developer Console