Azure Files

Azure Files 공유에 저장된 파일과 디렉터리를 탐색하고, 필요한 파일을 읽거나 파일 저장소로 가져올 수 있습니다.

주요 기능

• Azure Storage 계정의 파일 공유 목록 조회
• 공유 내 디렉터리와 파일 탐색
• 파일 또는 디렉터리 메타데이터 조회
• 텍스트 파일 내용 읽기
• PDF, Office 문서, 바이너리 파일 다운로드
• 파일명 또는 경로 일부를 기준으로 파일 검색

기본 정보

인증 방식

Microsoft OAuth 인증을 사용합니다.

사용 범위

이 MCP는 Azure Files 클라우드 스토리지에 접근합니다. 사용자의 로컬 파일 시스템을 탐색하거나 읽는 용도로 사용하지 않습니다.

지원하는 MCP 도구

list_shares

설정된 Azure Storage 계정에서 접근 가능한 Azure Files 공유 목록을 조회합니다. 사용자가 공유 이름을 지정하지 않은 경우 먼저 사용합니다.

list_directory

지정한 공유와 디렉터리 경로 아래의 파일 및 하위 디렉터리를 조회합니다. 결과에는 이름, 경로, 유형, 크기 정보가 포함될 수 있습니다.

get_file_metadata

파일이나 디렉터리의 메타데이터를 조회합니다. 파일 내용을 읽거나 다운로드하기 전에 크기와 콘텐츠 유형을 확인할 때 사용합니다.

read_file

Azure Files에 저장된 텍스트 파일 내용을 채팅 응답 안에서 바로 읽습니다. 바이너리 파일이나 큰 파일은 download_file을 사용합니다.

download_file

Azure Files의 파일을 파일 저장소로 다운로드하고 aip-temp:// 또는 aip-drive:// URI를 반환합니다. PDF, Office 문서, 이미지, 바이너리 파일처럼 채팅에 직접 표시하기 어려운 파일에 사용합니다.

search_files

파일명 또는 경로에 포함된 문자열을 기준으로 Azure Files를 검색합니다. 본문 전체 검색은 지원하지 않으며, 검색 범위가 너무 넓으면 경로나 검색어를 좁혀 다시 실행하는 것이 좋습니다.

사용 예시

• “Azure Files에서 reports 공유의 2026년 매출 보고서를 찾아줘”
• “finance 공유의 /monthly 폴더에 어떤 파일이 있는지 보여줘”
• “Azure Files에 있는 summary.txt 내용을 읽어줘”
• “계약서 PDF를 파일로 가져와서 요약해줘”

주의사항

• Azure Storage 계정과 Azure Files 공유에 접근할 수 있는 Microsoft 계정 권한이 필요합니다.
• read_file은 텍스트 형식 파일에 적합합니다. PDF, Office 문서, 이미지, 대용량 파일은 다운로드 후 다른 도구나 Skill과 함께 처리하세요.
• search_files는 파일명과 경로 기준 검색이며, 파일 본문 내용은 검색하지 않습니다.