Azure Files

Azure Files 공유에 저장된 파일과 디렉터리를 탐색하고, 필요한 파일을 읽거나 파일 저장소로 가져올 수 있습니다. 필요한 경우 Azure Files 공유에 새 디렉터리를 만들고, 작업 중 생성된 파일을 업로드하거나 기존 파일을 교체할 수 있습니다. 파일과 디렉터리의 이름을 바꾸거나 같은 공유 안의 다른 경로로 이동할 수도 있습니다.

주요 기능

Azure Storage 계정의 파일 공유 목록 조회
공유 내 디렉터리와 파일 탐색
파일 또는 디렉터리 메타데이터 조회
텍스트 파일 내용 읽기
PDF, Office 문서, 바이너리 파일 다운로드
파일명 또는 경로 일부를 기준으로 파일 검색
기존 디렉터리 아래 새 디렉터리 생성
AIP 파일 저장소의 파일을 Azure Files 공유로 업로드
기존 파일의 내용 교체
파일 또는 디렉터리 이름 변경 및 같은 공유 내 이동

기본 정보

인증 방식

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를 검색합니다. 본문 전체 검색은 지원하지 않으며, 검색 범위가 너무 넓으면 경로나 검색어를 좁혀 다시 실행하는 것이 좋습니다.

create_directory

지정한 공유의 기존 부모 디렉터리 아래에 새 디렉터리를 생성합니다. 한 번에 한 단계의 디렉터리만 생성하며, 상위 디렉터리가 없으면 먼저 생성할 위치를 확인해야 합니다. 대상 디렉터리가 이미 있으면 새로 생성하지 않고 기존 디렉터리로 처리합니다.

upload_file

채팅, Skill, 다른 MCP 도구 등에서 생성되거나 가져온 AIP 파일 URI를 Azure Files 공유의 기존 디렉터리에 새 파일로 업로드합니다. 대상 파일명이 이미 존재하면 업로드가 실패하며, 기존 파일을 덮어쓰거나 자동으로 이름을 바꾸지 않습니다.

replace_file

채팅, Skill, 다른 MCP 도구 등에서 준비한 파일로 Azure Files의 기존 파일 전체를 교체합니다. 새 파일을 만들 때는 upload_file을 사용하세요.

파일 내용과 콘텐츠 유형은 준비한 파일 기준으로 바뀝니다.
기존 파일의 사용자 지정 메타데이터와 SMB ACL은 유지합니다.
디렉터리는 교체할 수 없으며, 대상 파일이 이미 있어야 합니다.
사용자가 기존 파일을 교체하거나 덮어쓰라고 명시한 경우에만 사용합니다.

rename_item

같은 SMB File Share 안에서 기존 파일 또는 디렉터리의 이름을 바꾸거나 다른 경로로 이동합니다. 예를 들어 reports/draft.md를 archive/final.md로 이동할 수 있습니다.

원본 경로와 대상 경로는 서로 달라야 합니다.
대상의 상위 디렉터리는 미리 있어야 합니다.
대상 경로에 이미 파일이나 디렉터리가 있으면 덮어쓰지 않고 실패합니다.
작업이 완료되면 원본 경로는 더 이상 사용할 수 없습니다.

사용 예시

“Azure Files에서 reports 공유의 2026년 매출 보고서를 찾아줘”
“finance 공유의 /monthly 폴더에 어떤 파일이 있는지 보여줘”
“Azure Files에 있는 summary.txt 내용을 읽어줘”
“계약서 PDF를 파일로 가져와서 요약해줘”
“finance 공유의 /monthly 아래에 2026-08 폴더를 만들어줘”
“방금 만든 보고서를 Azure Files의 reports/2026 폴더에 업로드해줘”
“finance 공유의 monthly/summary.xlsx를 방금 수정한 파일로 덮어써줘”
“finance 공유의 drafts/plan.md를 archives/2026/plan-final.md로 옮겨줘”

주의사항

Azure Storage 계정과 Azure Files 공유에 접근할 수 있는 Microsoft 계정 권한이 필요합니다.
read_file은 텍스트 형식 파일에 적합합니다. PDF, Office 문서, 이미지, 대용량 파일은 다운로드 후 다른 도구나 Skill과 함께 처리하세요.
search_files는 파일명과 경로 기준 검색이며, 파일 본문 내용은 검색하지 않습니다.
create_directory는 여러 단계의 폴더를 한 번에 만들지 않습니다. 필요한 경우 상위 디렉터리부터 순서대로 생성해야 합니다.
upload_file은 Azure Files의 기존 디렉터리에 새 파일을 저장하는 기능입니다. 대상 디렉터리를 자동 생성하지 않으며, 기존 파일을 덮어쓰지 않습니다.
upload_file, replace_file, rename_item은 현재 SMB Azure Files 공유만 지원합니다. NFS 공유에서는 사용할 수 없습니다.
rename_item은 File Share 사이의 이동을 지원하지 않습니다. 같은 공유 안에서만 이름 변경 또는 이동할 수 있습니다.
replace_file은 버전 관리나 동시 수정 방지를 제공하지 않습니다. 수정본을 준비한 뒤 다른 사용자가 대상 파일을 변경해도 그 변경은 교체 과정에서 덮어써집니다. 최신 내용을 반영해야 한다면 교체 전에 대상 파일을 다시 내려받아 수정본을 준비하세요.
파일을 업로드, 교체하거나 이름을 바꾸려면 읽기 권한 외에 쓰기 권한이 필요합니다. 권한을 새로 부여받았다면 Microsoft OAuth 연결을 다시 설정한 후 시도하세요.