> 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/admin_manual/directcloud-ai/mcp-api.md).

# MCP API 이력을 확인하는 방법

## 개요

DirectCloud MCP는 Claude와 같은 LLM(생성형 AI)에 DirectCloud MCP 주소를 등록하고 DirectCloud 계정으로 로그인하면, LLM과의 대화만으로 DirectCloud의 주요 기능을 이용할 수 있도록 해주는 연동 기능입니다.\
이 매뉴얼에서는 관리 페이지의 'DirectCloud AI' > 'MCP' > 'MCP API 이력' 메뉴에서, 사용자가 MCP를 통해 호출한 MCP API의 이력을 확인하는 방법을 설명합니다.

***

## 제한·보충사항

* 이 매뉴얼에서 설명하는 동작은 관리자 권한이 있는 사용자만 수행할 수 있습니다.
* DirectCloud MCP는 DirectCloud AI 요금제 중 Elite 및 Elite + 요금제에서만 사용할 수 있습니다.
* DirectCloud MCP를 이용하려면 사용자가 직접 이용 중인 LLM(Claude, ChatGPT 등)이 필요합니다. MCP 커넥터(외부 연동) 등록을 지원하는 LLM이어야 하며, 해당 LLM의 계정 및 이용 환경은 사용자가 직접 준비해야 합니다.
* 준비된 LLM 클라이언트에 DirectCloud MCP 주소를 등록하고, DirectCloud 계정으로 로그인해야 사용이 가능합니다.
* MCP를 활용하는 모든 기능은 로그인한 사용자에게 부여된 접근 권한 범위 내에서만 이용할 수 있으며, 이용 가능한 기능은 대상 저장 영역(Shared Box, Warm Storage, Cold Storage, DLP 등)에 따라 다릅니다.\
  자세한 내용은 [MCP 사용에 대한 권한 및 가능한 기능](https://help.directcloud.net/admin_manual/directcloud-ai/mcp_permission)을 참조해 주시기 바랍니다.
* DirectCloud MCP를 통해 다음 기능을 이용할 수 있습니다.
  * 파일/폴더 찾기 / 폴더 내 파일목록 조회 / 파일 내용 요약(※) / 파일 내용 질문(※) / 요약 파일 생성(※) / 파일 다운로드 링크 제공 / 휴지통 파일 조회 / 특정 파일 삭제
  * '파일 내용 요약', '파일 내용 질문', '요약 파일 생성' 기능은 Shared Box 중 DirectCloud AI가 활성화된 폴더(AI 폴더)에 저장된 파일에 대해서만 이용할 수 있습니다.
* 파일 삭제 기능 제한: 한 번에 최대 100개, 하루 최대 10회
* 기본적으로 모든 사용자는 DirectCloud MCP 사용이 '차단'되어 있으며, 관리자가 '허용'으로 지정한 사용자만 DirectCloud MCP를 사용할 수 있습니다.
* 게스트 계정은 DirectCloud MCP를 사용할 수 없습니다.
* MCP API 이력은 사용자가 MCP를 통해 호출한 API의 기록이며, LLM과 주고받은 대화 내용은 포함하지 않습니다.
* 액세스 토큰 정보는 마스킹 처리되어 이력에 기록되지 않습니다.
* 다운로드되는 CSV 파일의 문자 코드는 '공유 설정' > '세부 기능 설정' 메뉴의 '문자 인코딩'에서 설정됩니다.\
  자세한 내용은 [다운로드하는 CSV 파일의 문자 코드를 설정하는 방법](https://help.directcloud.net/admin_manual/detail_settings/csv_encoding)을 참조해 주시기 바랍니다.

***

## 절차

{% hint style="warning" %}
**MCP API 이력을 확인하기**
{% endhint %}

{% stepper %}
{% step %}

#### 'MCP API 이력' 탭 열기

'DirectCloud AI' > 'MCP' 메뉴를 클릭한 뒤, 상단의 'MCP API 이력' 탭을 클릭합니다.

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2F7i1WFhRx1Oh9D0XtthuL%2Fimage.png?alt=media&amp;token=d6753d21-e798-491c-aaf9-61d991cf4297" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### MCP API 이력 확인하기

MCP API 이력을 확인합니다.

<table data-search="false"><thead><tr><th>항목</th><th>설명</th></tr></thead><tbody><tr><td>번호</td><td>이력의 순번이 표시됩니다.</td></tr><tr><td>이름</td><td>MCP API를 호출한 사용자의 이름이 표시됩니다.</td></tr><tr><td>ID</td><td>해당 사용자의 아이디가 표시됩니다.</td></tr><tr><td>MCP API</td><td>호출된 MCP 기능(API)의 이름이 표시됩니다. (예: 폴더 내 파일목록 조회)</td></tr><tr><td>날짜</td><td>MCP API가 호출된 날짜와 시간이 표시됩니다.</td></tr><tr><td>상태</td><td>요청의 처리 결과가 표시됩니다. (예: 정상, 실패, 인증 만료, 차단)</td></tr><tr><td>요청</td><td>'보기' 버튼을 클릭하면 해당 MCP API 요청의 상세 내용(요청 헤더, 본문 등)을 코드 형태로 확인할 수 있습니다.</td></tr><tr><td>응답</td><td>'보기' 버튼을 클릭하면 해당 MCP API의 응답 내용을 코드 형태로 확인할 수 있습니다.</td></tr><tr><td>응답 시간</td><td>MCP API 응답에 소요된 시간(ms)이 표시됩니다.</td></tr><tr><td>IP</td><td>DirectCloud MCP와 연동된 LLM의 IP 주소가 표시됩니다. LLM이 MCP 커넥터 등 외부 통신에 사용하는 IP 주소이며, 사용자가 접속한 단말의 IP 주소가 아닙니다.</td></tr></tbody></table>
{% endstep %}

{% step %}

#### 요청 또는 응답 상세 내용 확인하기

'요청' 또는 '응답' 항목의 '보기' 버튼을 클릭하면 해당 내용이 코드 형태로 표시됩니다. (아래는 응답 예시)

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2F9nZpgPgp9TXukPtZFndW%2Fimage.png?alt=media&amp;token=75eba431-4866-4a82-b6a1-fb7c9f5f92df" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**MCP API 이력을 필터링하여 표시하기**
{% endhint %}

MCP API 이력 화면 상단에서는 기간, 상태, 이름/ID, 표시 건수로 이력을 필터링하여 확인할 수 있습니다.

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2Fg6IR5Vn2mlFxx3flNefp%2Fimage.png?alt=media&amp;token=99e3c16f-c202-4895-8733-8a13e182826e" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="92.800048828125">No.</th><th>설명</th></tr></thead><tbody><tr><td>1</td><td>MCP API 이력을 표시할 기간을 최근 7일, 최근 15일, 최근 1개월, 최근 3개월 중에서 선택합니다.</td></tr><tr><td>2</td><td>MCP API 이력을 상태 기준으로 필터링하려는 경우 상태를 선택합니다. (전체 상태, 정상, 실패, 인증 만료, 차단)</td></tr><tr><td>3</td><td>MCP API 이력을 필터링하려는 경우 사용자 이름 또는 ID를 입력한 뒤 '검색' 버튼을 클릭합니다.</td></tr><tr><td>4</td><td>MCP API 이력을 표시할 건수를 10, 25, 50, 100 중에서 선택합니다.</td></tr></tbody></table>

{% hint style="warning" %}
**MCP API 이력을 CSV 파일로 다운로드하기**
{% endhint %}

{% stepper %}
{% step %}

#### CSV 파일 다운로드하기

'CSV 다운로드' 버튼을 클릭합니다.\
필터링하여 표시된 결과만 다운로드할 수 있습니다. MCP API 이력은 데이터 양이 많을 수 있으므로, 미리 조건을 지정하여 필터링한 뒤 다운로드하시기를 권장합니다.

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2FNIPIuSVW9oprfNAREOiV%2Fimage.png?alt=media&amp;token=afdc55e1-75ee-4969-8922-c23748279d2e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### CSV 파일 확인하기

CSV 파일을 열어 정상적으로 표시되는지 확인합니다.

<figure><img src="https://1610041171-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFRc8hBWqHCHYh3E0AhFb%2Fuploads%2FWseSv6luryAIq3QRjhBj%2Fimage.png?alt=media&amp;token=b82fab38-48ed-4fe6-be7d-fde008a581c2" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}