> For the complete documentation index, see [llms.txt](https://help.directcloud.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.directcloud.net/user_manual/directcloud-ai/directcloud_mcp.md).
# DirectCloud MCP를 LLM에 연동하여 사용하는 방법
### 개요
DirectCloud MCP는 Claude와 같은 LLM(생성형 AI)에 DirectCloud MCP 주소를 등록하고 DirectCloud 계정으로 로그인하면, LLM과의 대화만으로 DirectCloud의 주요 기능을 이용할 수 있도록 해주는 연동 기능입니다.\
이 매뉴얼에서는 LLM에 DirectCloud MCP를 연동하여 사용하는 방법에 대해 설명합니다.
***
### 제한·보충사항
* 이 매뉴얼에서는 LLM 중 Claude를 기준으로 DirectCloud MCP를 등록하고 사용하는 방법을 설명합니다.
* DirectCloud MCP는 Claude, ChatGPT, Copilot에서 사용할 수 있습니다. 커넥터의 등록 위치·지원 요금제·지원 여부는 LLM에 따라 다르므로, Claude 외의 LLM에서 이용하시는 경우에는 해당 LLM의 공식 안내를 확인해 주시기 바랍니다.
* DirectCloud MCP는 DirectCloud AI 요금제 중 Elite 및 Elite + 요금제에서만 사용할 수 있습니다.
* DirectCloud MCP를 사용하려면, 관리자 페이지에서 자사에 등록된 사용자 중 DirectCloud MCP를 사용할 사용자를 지정해야 합니다.\
자세한 내용은 [DirectCloud MCP를 사용하도록 설정하는 방법](https://help.directcloud.net/admin_manual/directcloud-ai/mcp_setting)을 참고해 주시기 바랍니다.
* DirectCloud MCP를 이용하려면 사용자가 직접 이용 중인 LLM(Claude, ChatGPT 등)이 필요합니다. MCP 커넥터(외부 연동) 등록을 지원하는 LLM이어야 하며, 해당 LLM의 계정 및 이용 환경은 사용자가 직접 준비해야 합니다.
* 준비된 LLM 클라이언트에 DirectCloud MCP 주소를 등록하고, DirectCloud 계정으로 로그인해야 사용이 가능합니다.
* Claude에서 사전 검증된 디렉터리 커넥터(Slack, Box, GitHub 등)는 모든 요금제에서 연결할 수 있으나, DirectCloud MCP와 같이 URL을 직접 등록하는 커스텀 커넥터는 요금제에 따라 등록·연결 방식이 다릅니다.
* 무료(Free) 요금제 : 커스텀 커넥터를 1개까지 등록할 수 있습니다.
* 개인 유료 요금제(Pro/Max) : 개인이 직접 MCP 서버 URL을 등록하고 인증하여 사용합니다.
* 조직 요금제(Team/Enterprise) : 조직 소유자(Owner)가 먼저 조직 설정에서 MCP 서버 URL을 추가한 뒤, 각 조직원이 개별적으로 연결 및 인증하여 사용합니다. 조직 소유자는 '조직 설정 > 커넥터(라이브러리) > +추가 > 사용자 정의 > 웹 커스텀 커넥터 추가'로 이동하여 상단 입력 폼(이름, MCP 주소)을 입력하고 추가합니다.
* MCP를 활용하는 모든 조작은 로그인한 사용자에게 부여된 접근 권한 범위 내에서만 수행됩니다.\
자세한 내용은 [MCP 사용에 대한 권한 및 가능한 기능](https://help.directcloud.net/admin_manual/directcloud-ai/mcp_permission)을 참조해주시기 바랍니다.
* DirectCloud MCP를 통해 다음 기능을 이용할 수 있습니다.
* 파일/폴더 찾기
* 폴더 내 파일목록 조회
* 파일 내용 요약 (※)
* 파일 내용 질문 (※)
* 요약 파일 생성 (※)
* 파일 다운로드 링크 제공
* 휴지통 파일 조회
* 특정 파일 삭제
※ '파일 내용 요약', '파일 내용 질문', '요약 파일 생성' 기능은 Shared Box 중 DirectCloud AI가 활성화된 폴더(AI 폴더)에 저장된 파일에 대해서만 이용할 수 있습니다.\
자세한 내용은 [사용자 페이지의 특정 폴더에서 DirectCloud AI를 활성화하는 방법](https://help.directcloud.net/user_manual/directcloud-ai/activation)을 참조해주시기 바랍니다.
* 파일 삭제 기능에는 다음과 같은 제한이 있습니다.
* 한 번에 삭제할 수 있는 파일은 최대 100개입니다.
* 하루에 요청할 수 있는 삭제 횟수는 최대 10회입니다.
* DirectCloud MCP에서 삭제한 파일은 사용자 페이지에서 삭제한 경우와 동일하게 휴지통으로 이동합니다. 즉시 완전히 삭제되지 않으므로 필요한 경우 휴지통에서 복원할 수 있으며, 휴지통 보관 기간은 관리자가 설정한 정책에 따릅니다.
* Guest 계정은 DirectCloud MCP를 사용할 수 없습니다.
* DirectCloud에 설정된 'IP 주소 제한'이 DirectCloud MCP에도 적용됩니다.
* 회사 단위로 설정된 1일 MCP API 요청 횟수의 한도를 초과하면, 대화창에서 DirectCloud MCP를 사용할 때 오류가 발생합니다. 1일 MCP API 요청 한도는 관리자에게 문의해 주시기 바랍니다.
* 워크플로우가 적용된 기능은 DirectCloud MCP에서 사용할 수 없습니다.
***
### 절차
{% hint style="warning" %}
**Claude에서 DirectCloud MCP 등록 및 사용**
{% endhint %}
{% stepper %}
{% step %}
#### '사용자 지정' 클릭
Claude 화면의 왼쪽 슬라이드 메뉴에서 '사용자 지정'을 클릭합니다.
{% endstep %}
{% step %}
#### '커스텀 커넥터 추가' 클릭
'커넥터'를 클릭하고, 우측의 '+' 버튼을 눌러 메뉴를 엽니다. '커스텀 커넥터 추가'를 클릭합니다.
{% endstep %}
{% step %}
#### 커넥터 정보 입력
커넥터 추가 화면에서 이름과 DirectCloud MCP 주소를 입력하고 추가 버튼을 클릭합니다.
MCP 주소 : `https://mcp.directcloud.net/`
{% endstep %}
{% step %}
#### DirectCloud 로그인
등록한 커넥터를 연결하면 DirectCloud 로그인 화면이 표시됩니다. 회사 코드, 아이디, 비밀번호를 입력하고 로그인 버튼을 클릭합니다.
{% endstep %}
{% step %}
#### DirectCloud 기능 사용
연동이 완료되면 대화창에 요청을 입력하여 DirectCloud의 기능을 사용할 수 있습니다.
예) "DirectCloud에서 '계약서' 폴더에 있는 파일 목록을 보여줘"
{% endstep %}
{% endstepper %}
{% hint style="warning" %}
**Claude 조직 계정(Team/Enterprise)에서 DirectCloud MCP 등록**
{% endhint %}
조직 계정에서는 조직 소유자(Owner)가 조직 설정에서 DirectCloud MCP를 먼저 등록해야 하며, 이후 각 조직원이 개별적으로 연결 및 로그인하여 사용합니다.
{% stepper %}
{% step %}
#### 사용자 정의 웹 커넥터 선택
조직 설정의 '커넥터(라이브러리)' 화면에서 우측 상단의 '+ 추가'를 클릭한 뒤 '사용자 정의 > 웹'을 선택합니다.
{% endstep %}
{% step %}
#### 커넥터 정보 입력 및 추가
'커스텀 커넥터 추가' 창에서 이름과 DirectCloud MCP 주소를 입력합니다. '연결 방법'을 '개별 로그인'으로 두면 각 조직원이 개별적으로 DirectCloud에 로그인하여 연결합니다. 입력 후 '추가' 버튼을 클릭합니다.
MCP 주소 : `https://mcp.directcloud.net/`
{% endstep %}
{% step %}
#### 조직원별 연결 및 로그인
등록이 완료되면 각 조직원은 등록된 커넥터를 연결하고 DirectCloud 계정으로 로그인하여 사용합니다. (연결·로그인 및 사용 방법은 위 'Claude에서 DirectCloud MCP 등록 및 사용'의 4\~5단계와 동일합니다.)
{% endstep %}
{% endstepper %}
{% hint style="info" %}
등록된 커넥터의 내용(이름, MCP 주소)은 이후 변경할 수 없습니다. 변경이 필요한 경우에는 해당 커넥터를 삭제한 뒤 다시 등록해 주시기 바랍니다.
{% endhint %}
{% hint style="warning" %}
**DirectCloud MCP 사용 예시**
{% endhint %}
연동을 완료한 뒤에는 대화창에 다음과 같이 입력하여 DirectCloud MCP를 사용할 수 있습니다.\
요청한 내용에 해당하는 파일이나 폴더가 없거나, DirectCloud MCP에서 지원하지 않는 작업인 경우에는 대화창에 오류 메시지가 표시됩니다.
* 파일·폴더 찾기\
예) "견적서라는 파일을 찾아줘", "'계약서' 폴더에 어떤 파일이 있는지 보여줘"
* 파일 내용 질문하기\
예) "이 자료의 요점을 알려줘", "이 계약서의 위약금 조항은 어떻게 돼?"
* 파일 내용 요약하기\
예) "이 보고서를 3줄로 요약해줘"
* 다운로드 링크 받기\
예) "이 파일의 다운로드 링크를 알려줘"
* 파일 삭제하기\
예) "이 파일을 휴지통으로 옮겨줘"
