THE DRIVE LOGO

The Drive AI

MCP 서버

The Drive AI MCP

The Drive AI MCP 서버로 Claude, ChatGPT 등 MCP 클라이언트가 Google Drive, OneDrive, SharePoint, Dropbox, The Drive AI에 있는 파일을 찾고, 읽고, 다시 정리할 수 있습니다. 모든 변경은 미리 보여 주고, 직접 확인하며, 되돌릴 수 있습니다.

Claude에 추가Cursor에 추가
https://mcp.thedrive.ai/mcp

읽기 권한 그 이상

파일용 MCP 서버는 대부분 목록, 검색, 읽기까지만 합니다. 이 서버는 파일을 안전하게 변경하기도 합니다. The Drive AI 에이전트가 쓰는 도구를 그대로 전달하기 때문입니다.

먼저 미리 보기

변경은 적용 전에 제안됩니다. 건수, 샘플, 이름 충돌, 위험을 한 문장으로. 아직 아무것도 움직이지 않습니다.

직접 확인

큰 변경이나 삭제가 포함된 변경은 확인이 필요합니다. 확인은 미리 본 바로 그 변경에만 유효하고 15분 동안 유지됩니다.

한 번에 되돌리기

적용한 변경은 통째로 되돌릴 수 있습니다. 파일과 이름이 원래대로 돌아가고 휴지통에 넣은 파일도 복원됩니다.

모든 드라이브

Google Drive(공유 드라이브 포함), OneDrive, SharePoint, Dropbox, The Drive AI 워크스페이스를 하나의 폴더 트리로.

설치

Claude.ai and Claude Desktop

Claude.ai and Claude Desktop

Claude의 커넥터 디렉터리에서 The Drive AI를 열고 Connect를 선택한 뒤 로그인하세요. 커넥터는 계정에 연결되므로 데스크톱 앱에서도 바로 쓸 수 있습니다.

Claude.ai and Claude Desktop에 추가
ChatGPT

ChatGPT

Plugins → + → Add custom MCP server에서 서버 URL을 붙여 넣고 로그인하세요. ChatGPT에서 파일을 변경하려면 관리자가 서버를 게시한 Business 또는 Enterprise 워크스페이스가 필요하고, Pro에서는 사용자 지정 서버가 읽기만 할 수 있습니다.

Cursor

Cursor

클릭 한 번으로 설치.

Cursor에 추가

The Drive AI 계정으로 로그인하며, 로그인 방법은 Google, Microsoft, Apple, 이메일 무엇이든 됩니다. 처음에 어시스턴트가 할 수 있는 일을 확인하고 허용합니다. Settings → MCP에 사용자 이름으로 연결된 모든 것이 표시되고, 거기서 연결을 끊을 수 있습니다.

명령줄에서

Claude CodeClaude Code
claude mcp add --scope local --transport http thedriveai https://mcp.thedrive.ai/mcp
Codex CLICodex CLI
codex mcp add --url https://mcp.thedrive.ai/mcp thedriveai
Gemini CLIGemini CLI
gemini mcp add thedriveai https://mcp.thedrive.ai/mcp --transport http
VS CodeVS Code
code --add-mcp '{"name":"thedriveai","type":"http","url":"https://mcp.thedrive.ai/mcp"}'

이렇게 요청하세요

  • 내 Google Drive의 /Inbox에 있는 파일을 기존 고객 폴더로 옮기고, 파일 이름을 고객, 문서 종류, 날짜로 바꿔 줘.

    파일을 읽고 모든 이동과 이름 변경을 하나의 변경으로 제안한 뒤, 확인하면 적용합니다.

  • 방금 거 되돌려 줘.

    변경 전체를 되돌립니다. 파일이 원래 이름 그대로 /Inbox로 돌아갑니다.

  • 어느 드라이브에 있든 W-9을 전부 찾아 줘.

    워크스페이스와 연결된 모든 드라이브를 한 번에 검색합니다.

  • 공유 드라이브에 중복 파일이 어디 있어?

    내려받지 않고 같은 파일과 비슷한 파일을 묶어 보여 줍니다.

  • 올해 거래처별로 얼마 썼어? /Finance 아래 청구서를 전부 사용해.

    The Drive AI 에이전트에게 작업을 넘기고, 에이전트가 청구서를 하나씩 표로 옮겨 합산합니다.

  • Gmail에 청구서가 들어올 때마다 거래처와 연도별로 정리해 줘.

    The Drive AI 에이전트가 워크플로를 만들어, 채팅이 끝난 뒤에도 계속 실행됩니다.

프롬프트, 결과, 한계까지 처음부터 끝까지 따라가 본 작업은 활용 사례에, 설정과 문제 해결은 Claude와 Google Drive에 있습니다(영어).

확인은 이렇게 작동합니다

기본 설정에서는 삭제가 없는 20건 이하의 작업은 바로 적용됩니다. 파일을 휴지통에 넣거나, 현재 폴더 밖에서 작업하거나, 20건을 넘는 변경은 한 번 확인이 필요하고, 5,000건을 넘으면 건수를 확인합니다. 워크스페이스 관리자가 이 한도를 바꿀 수 있습니다.

확인이 필요하면 어시스턴트가 미리 보기를 보여 주고 묻습니다. MCP 확인 프롬프트를 지원하는 클라이언트에서는 클라이언트 화면에 질문이 나타납니다. 확인은 미리 본 바로 그 변경에만 유효하고 15분 뒤 만료됩니다. 수백 건이 넘는 변경은 백그라운드에서 실행되며, 어시스턴트가 진행 상황을 알려 줄 수 있습니다.

도구

찾기와 읽기

  • fs_tree, fs_digest폴더 구조: 개요, 개수, 크기, 종류, 경과 기간
  • fs_ls폴더 목록을 페이지 단위로
  • fs_find, fs_glob종류, 크기, 날짜, 이름 패턴으로 파일 찾기
  • fs_grep이름이나 문서 안의 정확한 단어
  • fs_search주제나 키워드로 문서 찾기
  • fs_read페이지, 시트, 녹음의 대본 읽기
  • fs_stat, fs_versions파일의 세부 정보와 이전 버전
  • fs_access파일이나 폴더에 접근할 수 있는 사람
  • fs_duplicates, fs_hash_backfill같은 파일과 비슷한 파일

변경

  • changeset_propose변경(이동, 이름 변경, 새 폴더, 복사, 휴지통으로 이동, 문서 생성 또는 편집)을 구성하고 미리 보기를 반환
  • changeset_apply적용. 변경이 크거나 삭제가 포함되면 확인을 요청
  • changeset_status백그라운드에서 실행 중인 변경의 진행 상황
  • changeset_undo적용한 변경을 통째로 되돌리기

공유와 저장

  • share_set, share_revoke워크스페이스 파일을 사람들과 공유하거나 접근 권한 해제
  • share_publish공개 링크 켜기 또는 끄기
  • create_file_from_attachment, create_file_from_url어시스턴트에게 준 파일을 폴더에 저장
  • create_upload_ticket, create_file_from_upload, upload_file_content어시스턴트가 가진 데이터를 업로드

출처 증명

  • certify_document파일을 인증합니다. 워크스페이스에서든, 연결한 드라이브의 원래 위치에서든. 지금 상태의 파일을 누가 보증하는지(해시, 사람, 에이전트, 출처, 바로 그 내용에 대한 승인)를 담은 서명된 영구 출처 기록입니다. 전자 서명이 아닙니다. PDF에는 기록이 파일 안에 담깁니다. 먼저 사용자에게 묻습니다.
  • verify_document파일이나 해시를 공개 레지스트리와 대조하고, PDF라면 파일만으로 증명되는 내용을 확인

에이전트

  • agent_ask, agent_continue작업 전체를 The Drive AI 에이전트에게 넘기기: 여러 파일의 합계, 내보내기, 워크플로, 전자 서명, 파일 요청
  • job_status백그라운드 작업 추적
  • approval_statusThe Drive AI에서 사용자의 결정을 기다리는 변경 추적
  • get_current_user로그인한 사람과 그 사람의 워크스페이스

독립 에이전트

Claude와 ChatGPT는 위의 서버로 연결합니다. CLI, 코딩 에이전트, 스크립트는 채팅 호스트가 필요 없습니다. The Drive AI가 인증 서버가 되어, 에이전트가 스스로 로그인하거나 가입합니다. 무엇을 해도 되는지는 여전히 사용자가 정합니다. 에이전트가 스스로 만든 계정이 사용자 쪽에서 어떻게 보이는지는 에이전트용 페이지에서 설명합니다(영어).

등록한 뒤 로그인

https://service.thedrive.ai/.well-known/oauth-authorization-server에 명시된 등록 엔드포인트에서 공개 클라이언트로 등록하세요(이름, 브라우저가 있다면 리디렉션 URI. PKCE 사용, 시크릿 없음). 브라우저가 있으면 사용자가 thedrive.ai에서 로그인합니다. 없으면 device grant를 사용합니다. 사용자에게 여덟 글자 코드를 보여 주면 사용자가 https://thedrive.ai/oauth/mcp/device에서 승인하고, 에이전트는 토큰 엔드포인트를 폴링합니다. 어느 쪽이든 이후에는 액세스 토큰을 bearer로 https://mcp.thedrive.ai/mcp에 연결합니다. 채팅 호스트와 같은 엔드포인트이며, 만료 전에 토큰 엔드포인트에서 갱신하세요.

필요한 스코프만 요청

read, write, share, ask. 사용자는 허용할 때 이를 확인하고, 나중에 Settings → MCP에서 범위를 줄이거나 권한을 끝낼 수 있습니다. 권한 밖의 호출은 그대로 전달할 수 있는 문구로 거부됩니다.

아직 계정이 없나요? 만드세요

등록된 클라이언트는 https://service.thedrive.ai/api/v1/oauth/mcp/signup에서 스스로 가입할 수 있으며, 워크스페이스와 인수 링크를 바로 받습니다. 링크는 사용자가 로그인하기 전에 에이전트가 만든 것을 보여 주고, 버튼 하나로 사용자의 것이 됩니다. 그때까지 계정은 임시입니다. 무료, 1 GB, 에이전트 작업 총 20회, 워크스페이스 밖으로는 아무것도 나가지 않으며, 7일 뒤 삭제됩니다. 인수하면 파일이 사용자의 워크스페이스로 복사되고 에이전트는 사용자로서 계속 일합니다.

셸은 있지만 MCP 클라이언트가 없나요? CLI를 쓰세요

npx @thedriveai/cli login(사용자가 코드를 승인), npx @thedriveai/cli signup --agent "<에이전트 이름>"(아직 계정이 없을 때. 인수 링크를 출력하며, 이름은 사용자에게 보이는 이름입니다), 그다음 ls, tree, cat, put, mkdir, mv, rename, trash, undo, ask, 그 밖의 작업은 tool <name>. 설치할 것이 없고, 인증 정보는 ~/.config/thedrive에 저장됩니다. 전체 방법을 담은 스킬: npx skills add thedriveAI/skills, 또는 https://thedrive.ai/skills/the-drive-ai/SKILL.md에서 읽을 수 있습니다.

승인은 에이전트가 아니라 사용자가

동의가 필요한 변경은 The Drive AI(Settings → MCP → Waiting for you)에서 알림과 함께 사용자의 결정을 기다립니다. 에이전트는 approval_status로 추적할 ID를 받고, 승인되면 기록된 호출이 사용자로서 실행됩니다. 채팅 호스트는 대신 자체 화면에서 묻고, 사용자는 연결마다 방식을 바꿀 수 있습니다. 에이전트가 스스로 만든 계정은 인수되기 전까지 물어볼 사람이 없으므로, 그때까지는 자신의 변경을 스스로 확인하고 공유는 무조건 거부됩니다.

  • read보기만 하는 모든 작업: 찾기, 읽기, 목록, 접근 권한자 확인
  • write본인 파일 변경: changeset 제안·적용·되돌리기, 파일 저장
  • share파일에 접근할 수 있는 사람 변경
  • ask본인의 작업 한도로 The Drive AI 에이전트 실행
https://service.thedrive.ai/.well-known/oauth-authorization-server

에이전트에게 필요한 모든 내용은 이 문서에 있습니다. 에이전트를 위한 안내는 thedrive.ai/agents.md에 있습니다.

요구 사항과 한도

  • Google, Microsoft, Apple, 이메일 중 하나로 로그인하는 The Drive AI 계정. 가입하기. 계정이 없는 에이전트는 스스로 가입한 뒤 계정을 넘겨줄 수 있습니다(위 참고).
  • 연결한 드라이브에는 Max 요금제나 Team 요금제가 필요하고, 워크스페이스 파일은 모든 요금제에서 쓸 수 있습니다. 요금제를 확인하세요.
  • 두 클라우드 사이의 복사와 이동은 폴더 단위로 진행됩니다. 최대 2,000개 파일 또는 2 GB, 파일당 100 MB까지입니다.
  • 공유 도구는 워크스페이스 파일에 적용되며, Google, Microsoft, Dropbox의 권한은 바꾸지 않습니다.
  • 도구를 직접 호출하는 것은 어시스턴트 작업으로 세지 않습니다. agent_ask는 에이전트를 끝까지 실행하므로 작업으로 셉니다.

자주 묻는 질문

Google Drive, OneDrive, Dropbox용 MCP 서버가 있나요?

네. The Drive AI MCP 서버는 Claude, ChatGPT 등 MCP 클라이언트에 Google Drive(공유 드라이브 포함), OneDrive, SharePoint, Dropbox, The Drive AI 워크스페이스를 아우르는 하나의 도구 세트를 제공합니다.

커넥터로 한 변경을 Claude나 ChatGPT에서 되돌릴 수 있나요?

네. 모든 변경은 changeset으로 기록되고, changeset_undo로 통째로 되돌립니다. 이동, 이름 변경, 편집, 휴지통에 넣은 파일 모두 해당됩니다.

도구를 직접 호출하면 어시스턴트 작업이 차감되나요?

아니요. 읽기, 검색, 변경 제안과 적용은 작업으로 세지 않습니다. agent_ask는 The Drive AI 에이전트를 끝까지 실행하므로 작업으로 셉니다.

연결하려면 Google 계정이 필요한가요?

아니요. The Drive AI 계정으로 로그인하면 되고, 로그인 방법은 Google, Microsoft, Apple, 이메일 무엇이든 됩니다. 처음에 어시스턴트가 할 수 있는 일을 확인하고 허용하며, Settings → MCP에서 언제든 연결을 끊을 수 있습니다.

브라우저나 계정 없이도 에이전트가 연결할 수 있나요?

네. 에이전트는 독립 클라이언트로 등록하고 코드로 로그인합니다. 여덟 글자 코드를 보여 주면 thedrive.ai에서 승인하세요. 계정이 없는 에이전트는 스스로 가입한 뒤 계정 인수 링크를 보낼 수 있습니다. 계정은 인수할 때까지 작고 잠긴 상태로 유지되며, 7일 안에 아무도 인수하지 않으면 삭제됩니다.

에이전트가 바꾸는 내용은 누가 승인하나요?

사용자가 합니다. Claude나 ChatGPT에서는 채팅에 질문이 나타납니다. 독립 에이전트라면 변경이 Settings → MCP의 Waiting for you에서 알림과 함께 기다리며, 승인하거나 거절할 때까지 실행되지 않습니다.

어떤 요금제가 필요한가요?

The Drive AI 워크스페이스의 파일은 모든 요금제에서 쓸 수 있습니다. 연결한 Google Drive, OneDrive, SharePoint, Dropbox 계정에서 작업하려면 Max 요금제나 Team 요금제가 필요합니다.

자세한 안내는 MCP server for Google Drive, OneDrive and Dropbox에 있습니다(영어).