Dropbox 원격 MCP 서버에 연결하는 방법

Q: 연결은 얼마나 안전하나요?

<p>Dropbox MCP는 보안 인증을 위해 Dropbox OAuth를 사용합니다. 데이터는 Dropbox의 기존 개인 정보 보호 및 보안 표준에 따라 보호됩니다.</p>

업데이트된 날짜 Mar 18, 2026

Cursor 또는 Claude Code와 같은 IDE에서 Dropbox 파일을 탐색하거나 쿼리하려는 개발자.
검색, 추론 또는 워크플로 자동화를 위해 Dropbox를 데이터 원본으로 연결하는 AI 에이전트 빌더.
AI 어시스턴트를 사용하여 문서를 검토하거나, 파일을 정리하거나, 콘텐츠를 공유하거나, 다른 사람으로부터 파일을 수집하는 전문가.
Dropbox 콘텐츠를 사용하여 초안, 요약, 메모 또는 참고 자료를 작성하는 작가 또는 연구자.
Cursor, Claude 또는 ChatGPT와 같은 MCP 호환 클라이언트를 사용하여 Dropbox 파일 및 폴더로 작업하기.

사용 가능한 도구

도구	설명
ListFolder	디렉터리 콘텐츠를 탐색합니다(호출당 최대 100개 항목). 기본 파일 정보를 가져옵니다: 이름, 크기, 수정 날짜, 파일 ID. 커서를 사용하여 페이지 단위로 탐색합니다. 스페이스와 특수 문자가 포함된 경로를 처리합니다.
GetFileMetadata	상세한 파일 속성을 가져옵니다: 크기, 날짜, MIME 유형. 파일 경로 또는 파일 ID로 작동합니다. 사람이 읽을 수 있는 형식(예: '2.71 MB").
GetFileContent	PDF, Word 문서 및 기타 텍스트로 표현 가능한 파일에서 텍스트를 추출합니다. 최대 5MB의 파일을 지원합니다. 콘텐츠 링크: (텍스트 추출에 실패한 경우를 포함하여) 모든 파일에 대한 Dropbox 링크를 제공합니다.
GetUsageAndQuota	현재 용량 사용량을 바이트 단위로 검색합니다(사용된 총 용량). 현재 용량 할당량을 바이트 단위로 검색합니다(사용 가능한 총 용량). 팀 사용자와 개별 사용자를 지원합니다. 팀에 속한 사용자의 경우, 이 도구는 팀 전체의 사용량과 할당량을 검색합니다.
검색	이름 또는 콘텐츠로 파일 및 폴더를 검색합니다. 폴더, 파일 유형, 마지막 업데이트 날짜 등으로 필터링합니다. 관련성 또는 가장 최근 변경 사항을 기준으로 결과를 정렬합니다. 더 많은 검색 결과를 표시합니다.
폴더 만들기	경로를 지정하여 Dropbox 내 어디에서나 폴더를 만드세요. 응답에는 이후 작업과 쉽게 연결할 수 있는 폴더 세부 정보가 포함됩니다.
파일 만들기	인라인 UTF-8 콘텐츠에서 최대 5MB의 새로운 텍스트 지향 파일을 생성합니다. 메모, Markdown, JSON, 소스 코드와 같은 문서에 가장 적합합니다.
공유 링크 만들기	파일 또는 폴더에 대한 Dropbox 공유 링크를 생성하고, 이메일을 통해 최대 25명의 사용자를 동시에 초대할 수 있는 옵션을 사용하세요. 공유 링크를 제거하는 방법을 알아보세요.
WhoAmI	인증된 Dropbox 사용자의 ID, 팀/계정 컨텍스트 및 루트/홈 네임스페이스 ID를 가져옵니다.
복사	하나 이상의 파일 또는 폴더를 다른 Dropbox 위치로 복사합니다. 대용량 작업은 백그라운드에서 실행될 수 있습니다. CheckJobStatus를 사용하여 진행 상황을 추적할 수 있습니다. 파일의 이전 버전을 복구하는 방법을 알아보세요.
옮기기	Dropbox에서 하나 이상의 파일이나 폴더를 이동하거나 이름을 변경합니다. 대용량 작업은 백그라운드에서 실행될 수 있습니다. CheckJobStatus를 사용하여 진행 상황을 추적할 수 있습니다.
삭제	하나 이상의 파일 또는 폴더를 삭제된 파일로 이동합니다. 파일은 영구적으로 삭제되지 않습니다. 복구 가능 여부는 요금제의 복구 기간에 따라 달라집니다. 삭제된 파일이나 폴더를 복원하거나 복구하는 방법을 알아보세요.
CheckJobStatus	백그라운드 복사, 이동, 삭제 또는 폴더 복원 작업의 상태를 확인합니다.
DownloadLink	하나 이상의 파일에 대한 일회용 임시 다운로드 링크를 생성합니다. MCP 클라이언트가 추출된 텍스트를 읽는 대신 원본 파일을 다운로드할 수 있도록 허용합니다.
ListSharedLinks	로그인한 사용자가 소유한 공유 링크를 봅니다. 원하는 경우 특정 파일 또는 폴더에 대한 결과를 필터링합니다. 폴더를 공유 해제하는 방법을 알아보세요.
GetSharedLinkMetadata	공유 링크에 대한 세부 정보를 봅니다. 대상, 만료일, 비밀번호 보호, 다운로드 설정이 포함됩니다.
파일 요청 생성	다른 사람이 사용자가 선택한 폴더에 파일을 업로드할 수 있도록 파일 요청을 생성합니다. Dropbox 파일 요청을 만들고 관리하는 방법을 알아보세요.
GetFileRequest	ID를 사용하여 특정 파일 요청에 대한 세부 정보를 봅니다.
ListFileRequests	직접 소유한 파일 요청을 봅니다. 업로드 URL, 대상 폴더, 마감일, 열림 상태, 제출된 파일 수가 포함됩니다.
ListFileRevisions	수정 ID, 타임스탬프, 파일 크기, 삭제 상태 등 파일의 수정 기록을 봅니다. 최대 100개의 수정 버전을 최신 수정 버전부터 반환합니다.
RestoreFileRevision	이전에 수정된 파일 버전의 콘텐츠를 Dropbox 경로로 복원합니다. 삭제된 파일을 다시 생성하거나 대상 경로에서 기존 파일을 바꿀 수 있습니다.
ListRestoreEvents	편집, 삭제, 이동, 이름 변경 및 복원을 포함한 파일 및 폴더 활동을 봅니다.
폴더 복원	폴더와 하위 폴더에 대한 변경 사항을 되돌려 폴더와 해당 콘텐츠를 이전 시점으로 복원합니다.
GetTranscript	오디오 또는 동영상 파일을 타임스탬프가 있는 텍스트로 변환합니다. 문장 또는 단어 수준의 타임스탬프를 지원합니다. 대용량 파일에 대한 비동기 처리.
GetMarkdown	PDF 및 Word 문서를 포함하여 지원되는 문서를 Markdown으로 변환합니다. 스캔한 PDF에서 텍스트를 추출하는 OCR을 지원합니다. 선택적 인라인 이미지 삽입. 대용량 문서는 비동기식으로 처리됩니다.

지원되는 MCP 클라이언트

Dropbox MCP 서버는 신뢰할 수 있는 MCP 클라이언트 세트에 대한 동적 클라이언트 등록을 지원합니다. 곧 더 추가될 예정입니다. 현재 지원되는 모든 MCP 클라이언트 목록은 다음과 같습니다.

지원되는 MCP 클라이언트

Claude 코드

Claude 웹

ChatGPT Codex

ChatGPT 웹

Cursor

참고:

도움말 보기를 통해 동적 클라이언트 등록에서 특정 MCP 클라이언트를 지원하도록 요청하세요.
MCP 서버에 연결하기 전에 추가 설정이 필요하지 않습니다.

Dropbox MCP 원격 서버에 연결하는 방법

Dropbox MCP 서버 위치: https://mcp.dropbox.com/mcp

설정 단계는 MCP 클라이언트에 따라 다릅니다.

중요: 새 범위 추가와 같이 Dropbox 앱 설정을 변경하는 경우 Dropbox MCP 서버에 다시 연결해야 합니다.

Cursor로 연결

커넥터 설정하기

Cursor에서 설정을 클릭한 다음 Cursor 설정을 클릭합니다.
도구 및 MCP를 클릭한 다음 새 MCP Server를 클릭합니다.
아래 구성을 복사합니다.

{
  "mcpServers": {
    "Dropbox MCP": {
      "url": "https://mcp.dropbox.com/mcp"
    }
   }
}

Claude 웹/데스크톱으로 연결

사전 요구사항

Claude CustomConnector에 대한 액세스(일부 Claude 요금제에서 사용 가능)

커넥터 설정하기

Claude에서 설정을 클릭한 다음 커넥터를 클릭합니다.
사용자 지정 커넥터 추가를 클릭합니다.
다음을 입력합니다.
- 이름: Dropbox MCP
- Dropbox MCP 서버 URL: https://mcp.dropbox.com/mcp
추가를 클릭합니다.

Claude Code(CLI)로 연결

사전 요구사항

Claude Code CLI 설치됨

커넥터 설정하기

claude mcp add --transport http DropboxMCP https://mcp.dropbox.com/mcp

ChatGPT 웹으로 연결

사전 요구사항

ChatGPT 개발자 모드에 대한 액세스(특정 요금제에서 사용 가능)

개발자 모드 활성화하기

ChatGPT에서 설정을 클릭한 다음 앱 및 커넥터를 클릭합니다.
고급 설정을 클릭합니다.
개발자 모드를 켜짐으로 전환합니다.
확인되지 않은 커넥터에 대한 메시지를 검토한 후 확인을 클릭합니다.

커넥터 설정하기

ChatGPT에서 설정을 클릭한 다음 앱을 클릭합니다.
앱 만들기를 클릭합니다.
다음을 입력합니다.
- 이름: Dropbox MCP
- MCP 서버 URL: https://mcp.dropbox.com/mcp
- 인증: OAuth
'이해했으며 계속 진행하겠습니다'를 선택합니다.
만들기를 클릭합니다.

ChatGPT Codex(CLI)로 연결

사전 요구사항

로컬에 Codex 설치됨

커넥터 설정하기

커넥터 추가:

codex mcp add DropboxMCP --url https://mcp.dropbox.com/mcp

2. 커넥터에 로그인 합니다.

codex mcp login DropboxMCP

다른 MCP 클라이언트에서 연결하기

MCP 서버에 연결하기 전에 API 자격 증명을 얻으려면 Dropbox 앱이 필요합니다. Dropbox 앱 설정 안내를 따릅니다.

Dropbox 앱 설정

참고: Dropbox 관리자가 앱 등록 또는 연결 가능 여부를 제어할 수 있습니다. 앱을 만들거나 Dropbox를 다른 서비스에 연결하는 옵션이 표시되지 않으면 팀 관리자에게 문의하세요. 앱 통합에 대한 관리자 제어에 대해 자세히 알아보세요.

Dropbox 앱 콘솔로 이동합니다.
앱 만들기를 클릭합니다.
앱을 구성합니다.
- API: 범위 지정 액세스
- 액세스 유형: Dropbox 전체
- 앱 이름: 고유한 이름 선택
권한을 클릭한 다음 다음을 활성화합니다.
- files.metadata.read
- files.content.read
- files.content.write
- sharing.write
- account_info.read
- sharing.read
- file_requests.read
- file_requests.write
MCP 클라이언트에 대한 OAuth 2 리디렉션 URI 추가:
- 특정 OAuth2 리디렉션 URI에 대한 문서를 확인하세요.
- 때때로 MCP 서버에 연결하는 설정 과정에서 확인할 수 있습니다.
자격 증명 수집:
- 설정을 클릭합니다.
- 액세스 토큰 생성을 클릭합니다.
- 액세스 토큰을 복사합니다.
  - 참고: 액세스 토큰은 수명이 짧으므로 만료되면 다시 생성해야 합니다.
- 앱 키를 복사합니다.
- 앱 비밀을 복사합니다.
브랜딩에서 이름, 아이콘, 설명(선택 사항)으로 앱을 사용자 지정합니다.