[{"data":1,"prerenderedAt":1642},["ShallowReactive",2],{"nav-docs":3,"page-/ko/docs/admin/ai/mcp":985,"surround-/ko/docs/admin/ai/mcp":1636,"raw-/ko/docs/admin/ai/mcp":1639},[4,56,290,627,734,878,911,968],{"title":5,"path":6,"stem":7,"children":8,"page":55},"스페이스빌더 시작하기","/getting-started","00.getting-started",[9,13,17,23,29,33,38,42,46,50],{"title":10,"path":11,"stem":12,"children":-1},"스페이스빌더 소개","/getting-started/overview","00.getting-started/00.overview",{"title":14,"path":15,"stem":16,"children":-1},"SetFN 계정 생성","/getting-started/create-setfn-account","00.getting-started/05.create-setfn-account",{"title":18,"path":19,"stem":20,"tags":21,"children":-1},"Linux에 설치하기","/getting-started/install-linux","00.getting-started/10.install-linux",[22],"recommended",{"title":24,"path":25,"stem":26,"tags":27,"children":-1},"Docker로 설치하기","/getting-started/install-docker","00.getting-started/12.install-docker",[28],"preparing",{"title":30,"path":31,"stem":32,"children":-1},"Windows에 설치하기","/getting-started/install-windows","00.getting-started/14.install-windows",{"title":34,"path":35,"stem":36,"tags":37,"children":-1},"macOS에 설치하기","/getting-started/install-macos","00.getting-started/16.install-macos",[28],{"title":39,"path":40,"stem":41,"children":-1},"초기 설정","/getting-started/initial-setup","00.getting-started/20.initial-setup",{"title":43,"path":44,"stem":45,"children":-1},"라이선스 활성화","/getting-started/license-activation","00.getting-started/30.license-activation",{"title":47,"path":48,"stem":49,"children":-1},"접속 주소 확인 (로컬/내부망)","/getting-started/access-url","00.getting-started/35.access-url",{"title":51,"path":52,"stem":53,"tags":54,"children":-1},"외부 접속 방식 선택","/getting-started/access-domain","00.getting-started/40.access-domain",[22],false,{"title":57,"path":58,"stem":59,"children":60,"page":55},"스페이스 관리하기","/admin","10.admin",[61,76,134,163,202,224,237,244,273],{"title":62,"path":63,"stem":64,"children":65,"page":-1},"관리자 홈","/admin/home","10.admin/00.home/00.index",[66,68,72],{"title":67,"path":63,"stem":64,"children":-1},"관리자 메뉴 둘러보기",{"title":69,"path":70,"stem":71,"children":-1},"관리자 페이지 접속","/admin/home/admin-page-access","10.admin/00.home/00.admin-page-access",{"title":73,"path":74,"stem":75,"children":-1},"라이선스 관리","/admin/home/license","10.admin/00.home/20.license",{"title":77,"path":78,"stem":79,"children":80,"page":55},"사용자 관리","/admin/user-management","10.admin/10.user-management",[81,85,91,95,99,103,107,111,115,119,124,129],{"title":82,"path":83,"stem":84,"children":-1},"가입 정책 및 기본 권한 설정하기","/admin/user-management/signup-policy","10.admin/10.user-management/02.signup-policy",{"title":86,"path":87,"stem":88,"tags":89,"children":-1},"가입 약관 등록하기","/admin/user-management/signup-terms","10.admin/10.user-management/04.signup-terms",[90],"new",{"title":92,"path":93,"stem":94,"children":-1},"사용자 계정 만들기","/admin/user-management/invite-new-member","10.admin/10.user-management/10.invite-new-member",{"title":96,"path":97,"stem":98,"children":-1},"사용자 계정 수정하기","/admin/user-management/edit-member","10.admin/10.user-management/11.edit-member",{"title":100,"path":101,"stem":102,"children":-1},"관리자 추가하기","/admin/user-management/add-new-admin","10.admin/10.user-management/12.add-new-admin",{"title":104,"path":105,"stem":106,"children":-1},"팀 관리","/admin/user-management/team","10.admin/10.user-management/22.team",{"title":108,"path":109,"stem":110,"children":-1},"레벨 관리","/admin/user-management/level","10.admin/10.user-management/24.level",{"title":112,"path":113,"stem":114,"children":-1},"접속 기록 확인하기","/admin/user-management/access-log","10.admin/10.user-management/30.access-log",{"title":116,"path":117,"stem":118,"children":-1},"계정·보안 정책 설정하기","/admin/user-management/account-security","10.admin/10.user-management/32.account-security",{"title":120,"path":121,"stem":122,"tags":123,"children":-1},"로봇 확인(CAPTCHA) 설정하기","/admin/user-management/captcha","10.admin/10.user-management/33.captcha",[90],{"title":125,"path":126,"stem":127,"tags":128,"children":-1},"안내 발송 설정하기","/admin/user-management/notice-settings","10.admin/10.user-management/34.notice-settings",[90],{"title":130,"path":131,"stem":132,"tags":133,"children":-1},"회원에게 단체 안내 메일 보내기","/admin/user-management/bulk-mail","10.admin/10.user-management/36.bulk-mail",[90],{"title":135,"path":136,"stem":137,"children":138,"page":55},"서비스 구성","/admin/service-config","10.admin/20.service-config",[139,143,147,151,155,159],{"title":140,"path":141,"stem":142,"children":-1},"파일 영역 설정","/admin/service-config/file-area","10.admin/20.service-config/10.file-area",{"title":144,"path":145,"stem":146,"children":-1},"웹훅 설정","/admin/service-config/webhook-settings","10.admin/20.service-config/16.webhook-settings",{"title":148,"path":149,"stem":150,"children":-1},"커뮤니티 설정","/admin/service-config/community-space","10.admin/20.service-config/22.community-space",{"title":152,"path":153,"stem":154,"children":-1},"AI 챗봇 정책 설정","/admin/service-config/community-ai-chatbot","10.admin/20.service-config/24.community-ai-chatbot",{"title":156,"path":157,"stem":158,"children":-1},"메일 설정","/admin/service-config/email-settings","10.admin/20.service-config/30.email-settings",{"title":160,"path":161,"stem":162,"children":-1},"브랜딩 설정","/admin/service-config/brand","10.admin/20.service-config/40.brand",{"title":164,"path":165,"stem":166,"children":167,"page":55},"지식 서비스","/admin/knowledge","10.admin/30.knowledge",[168,172,178,182,186,190,194,198],{"title":169,"path":170,"stem":171,"children":-1},"지식 서비스 살펴보기","/admin/knowledge/overview","10.admin/30.knowledge/00.overview",{"title":173,"path":174,"stem":175,"children":176},"수집·인덱싱","/admin/knowledge/indexing","10.admin/30.knowledge/10.indexing",[177],{"title":173,"path":174,"stem":175,"children":-1},{"title":179,"path":180,"stem":181,"children":-1},"검색 관리","/admin/knowledge/search","10.admin/30.knowledge/20.search",{"title":183,"path":184,"stem":185,"children":-1},"지식 저장소","/admin/knowledge/storage","10.admin/30.knowledge/30.storage",{"title":187,"path":188,"stem":189,"children":-1},"지식 저장소 운영하기","/admin/knowledge/storage-operations","10.admin/30.knowledge/32.storage-operations",{"title":191,"path":192,"stem":193,"children":-1},"Qdrant 연결","/admin/knowledge/qdrant","10.admin/30.knowledge/34.qdrant",{"title":195,"path":196,"stem":197,"children":-1},"Qdrant 서버 준비하기","/admin/knowledge/qdrant-server-setup","10.admin/30.knowledge/35.qdrant-server-setup",{"title":199,"path":200,"stem":201,"children":-1},"Milvus 연결","/admin/knowledge/milvus","10.admin/30.knowledge/36.milvus",{"title":203,"path":204,"stem":205,"children":206,"page":55},"AI 서비스","/admin/ai","10.admin/35.ai",[207,211,215,220],{"title":208,"path":209,"stem":210,"children":-1},"AI 서비스 관리하기","/admin/ai/overview","10.admin/35.ai/00.overview",{"title":212,"path":213,"stem":214,"children":-1},"모델·런타임 설정하기","/admin/ai/models","10.admin/35.ai/10.models",{"title":216,"path":217,"stem":218,"tags":219,"children":-1},"도구·연동 설정하기","/admin/ai/integrations","10.admin/35.ai/20.integrations",[90],{"title":221,"path":222,"stem":223,"children":-1},"MCP 서버 관리하기","/admin/ai/mcp","10.admin/35.ai/30.mcp",{"title":225,"path":226,"stem":227,"children":228,"page":55},"플러그인","/admin/plugin","10.admin/40.plugin",[229,233],{"title":230,"path":231,"stem":232,"children":-1},"플러그인 관리하기","/admin/plugin/overview","10.admin/40.plugin/00.overview",{"title":234,"path":235,"stem":236,"children":-1},"확장 플러그인 설정","/admin/plugin/settings","10.admin/40.plugin/10.settings",{"title":238,"path":239,"stem":240,"children":241,"tags":243},"운영·감사 기록 확인하기","/admin/operations","10.admin/45.operations/00.index",[242],{"title":238,"path":239,"stem":240,"tags":243,"children":-1},[90],{"title":245,"path":246,"stem":247,"children":248,"page":55},"보안 관리","/admin/security","10.admin/50.security",[249,253,257,261,265,269],{"title":250,"path":251,"stem":252,"children":-1},"보안 개요","/admin/security/overview","10.admin/50.security/00.overview",{"title":254,"path":255,"stem":256,"children":-1},"감사 로그 확인하기","/admin/security/audit-log","10.admin/50.security/05.audit-log",{"title":258,"path":259,"stem":260,"children":-1},"차단 관리","/admin/security/block-management","10.admin/50.security/10.block-management",{"title":262,"path":263,"stem":264,"children":-1},"보안 설정","/admin/security/security-setting","10.admin/50.security/12.security-setting",{"title":266,"path":267,"stem":268,"children":-1},"승인 대기 기기 처리하기","/admin/security/device-approvals","10.admin/50.security/14.device-approvals",{"title":270,"path":271,"stem":272,"children":-1},"IP 접근 제한","/admin/security/ip-restriction","10.admin/50.security/16.ip-restriction",{"title":274,"path":275,"stem":276,"children":277,"page":55},"시스템 관리","/admin/system-admin","10.admin/60.system-admin",[278,282,286],{"title":279,"path":280,"stem":281,"children":-1},"디바이스 정보","/admin/system-admin/device-info","10.admin/60.system-admin/10.device-info",{"title":283,"path":284,"stem":285,"children":-1},"서버 재시작 및 시스템 유지보수","/admin/system-admin/server-restart","10.admin/60.system-admin/12.server-restart",{"title":287,"path":288,"stem":289,"children":-1},"백그라운드 서비스","/admin/system-admin/background-service","10.admin/60.system-admin/14.background-service",{"title":291,"path":292,"stem":293,"children":294,"page":55},"워크스페이스 사용하기","/workspace","20.workspace",[295,328,345,416,532,579,609],{"title":296,"path":297,"stem":298,"children":299,"page":55},"메뉴","/workspace/menu","20.workspace/05.menu",[300,304,308,312,316,320,324],{"title":301,"path":302,"stem":303,"children":-1},"워크스페이스 소개","/workspace/menu/overview","20.workspace/05.menu/00.overview",{"title":305,"path":306,"stem":307,"children":-1},"팀 스페이스","/workspace/menu/team-space","20.workspace/05.menu/05.team-space",{"title":309,"path":310,"stem":311,"children":-1},"클라이언트 스페이스","/workspace/menu/client-space","20.workspace/05.menu/06.client-space",{"title":313,"path":314,"stem":315,"children":-1},"즐겨찾기","/workspace/menu/favorites","20.workspace/05.menu/10.favorites",{"title":317,"path":318,"stem":319,"children":-1},"최근 문서","/workspace/menu/recent","20.workspace/05.menu/20.recent",{"title":321,"path":322,"stem":323,"children":-1},"외부 공유","/workspace/menu/external-share","20.workspace/05.menu/30.external-share",{"title":325,"path":326,"stem":327,"children":-1},"휴지통","/workspace/menu/trash","20.workspace/05.menu/40.trash",{"title":329,"path":330,"stem":331,"children":332,"page":55},"계정","/workspace/account","20.workspace/10.account",[333,337,341],{"title":334,"path":335,"stem":336,"children":-1},"회원가입 및 로그인","/workspace/account/signup","20.workspace/10.account/10.signup",{"title":338,"path":339,"stem":340,"children":-1},"비밀번호 재설정","/workspace/account/reset-password","20.workspace/10.account/20.reset-password",{"title":342,"path":343,"stem":344,"children":-1},"계정 설정","/workspace/account/account-settings","20.workspace/10.account/30.account-settings",{"title":346,"path":347,"stem":348,"children":349,"page":55},"폴더","/workspace/folder","20.workspace/20.folder",[350,354,358,362,366,372,377,381,385,390,394,398,402,406,412],{"title":351,"path":352,"stem":353,"children":-1},"폴더 기본 기능","/workspace/folder/basic","20.workspace/20.folder/10.basic",{"title":355,"path":356,"stem":357,"children":-1},"여러 폴더 한꺼번에 만들기","/workspace/folder/bulk-folder-creation","20.workspace/20.folder/12.bulk-folder-creation",{"title":359,"path":360,"stem":361,"children":-1},"필터","/workspace/folder/filter","20.workspace/20.folder/13.filter",{"title":363,"path":364,"stem":365,"children":-1},"폴더 보기 옵션 설정","/workspace/folder/folder-view-options","20.workspace/20.folder/14.folder-view-options",{"title":367,"path":368,"stem":369,"tags":370,"children":-1},"폴더를 게시판으로 사용하기","/workspace/folder/board-view","20.workspace/20.folder/15.board-view",[371],"hot",{"title":373,"path":374,"stem":375,"tags":376,"children":-1},"폴더 웹 보기","/workspace/folder/folder-web-view","20.workspace/20.folder/16.folder-web-view",[371],{"title":378,"path":379,"stem":380,"children":-1},"폴더 정리","/workspace/folder/folder-organize","20.workspace/20.folder/17.folder-organize",{"title":382,"path":383,"stem":384,"children":-1},"폴더 공지 (README)","/workspace/folder/folder-readme","20.workspace/20.folder/18.folder-readme",{"title":386,"path":387,"stem":388,"tags":389,"children":-1},"폴더/파일 목록 내보내기","/workspace/folder/folder-export","20.workspace/20.folder/20.folder-export",[371],{"title":391,"path":392,"stem":393,"children":-1},"레벨별 접근 권한 설정","/workspace/folder/level-access-permissions","20.workspace/20.folder/24.level-access-permissions",{"title":395,"path":396,"stem":397,"children":-1},"팀별 접근 권한 설정","/workspace/folder/team-access-permissions","20.workspace/20.folder/26.team-access-permissions",{"title":399,"path":400,"stem":401,"children":-1},"파일 규칙 설정하기","/workspace/folder/file-rules","20.workspace/20.folder/28.file-rules",{"title":403,"path":404,"stem":405,"children":-1},"폴더 웹훅","/workspace/folder/webhook","20.workspace/20.folder/30.webhook",{"title":407,"path":408,"stem":409,"children":410},"폴더 지식인덱스 설정하기","/workspace/folder/knowledge-index","20.workspace/20.folder/32.knowledge-index",[411],{"title":407,"path":408,"stem":409,"children":-1},{"title":413,"path":414,"stem":415,"children":-1},"업무 자동화 폴더","/workspace/folder/automation","20.workspace/20.folder/40.automation",{"title":417,"path":418,"stem":419,"children":420,"page":55},"파일","/workspace/file","20.workspace/30.file",[421,425,430,434,438,442,446,450,454,459,463,467,472,476,480,484,488,492,496,500,504,508,512,516,520,524,528],{"title":422,"path":423,"stem":424,"children":-1},"파일 관리 기본 기능","/workspace/file/overview","20.workspace/30.file/00.overview",{"title":426,"path":427,"stem":428,"tags":429,"children":-1},"파일 보면서 목록 확인하기","/workspace/file/list-in-file","20.workspace/30.file/05.list-in-file",[371],{"title":431,"path":432,"stem":433,"children":-1},"마크다운, 텍스트 파일 보기 및 편집","/workspace/file/text-file-viewer","20.workspace/30.file/10.text-file-viewer",{"title":435,"path":436,"stem":437,"children":-1},"HTML 파일 보기","/workspace/file/html-viewer","20.workspace/30.file/11.html-viewer",{"title":439,"path":440,"stem":441,"children":-1},"CSV 파일 보기 및 편집","/workspace/file/csv-viewer","20.workspace/30.file/12.csv-viewer",{"title":443,"path":444,"stem":445,"children":-1},"이미지/동영상 파일 보기","/workspace/file/image-file-viewer","20.workspace/30.file/13.image-file-viewer",{"title":447,"path":448,"stem":449,"children":-1},"오피스/PDF 파일 보기","/workspace/file/office-viewer","20.workspace/30.file/14.office-viewer",{"title":451,"path":452,"stem":453,"children":-1},"웹페이지 붙여넣기 (HTML)","/workspace/file/paste-html","20.workspace/30.file/20.paste-html",{"title":455,"path":456,"stem":457,"tags":458,"children":-1},"스크린샷 붙여넣기","/workspace/file/paste-screenshot","20.workspace/30.file/21.paste-screenshot",[371],{"title":460,"path":461,"stem":462,"children":-1},"마크다운 붙여넣기 (MD)","/workspace/file/paste-md","20.workspace/30.file/22.paste-md",{"title":464,"path":465,"stem":466,"children":-1},"스크린 녹화하기","/workspace/file/screen-recording","20.workspace/30.file/23.screen-recording",{"title":468,"path":469,"stem":470,"tags":471,"children":-1},"빠른노트","/workspace/file/quick-note","20.workspace/30.file/24.quick-note",[90,371],{"title":473,"path":474,"stem":475,"children":-1},"파일 태그","/workspace/file/file-tag","20.workspace/30.file/33.file-tag",{"title":477,"path":478,"stem":479,"children":-1},"파일 이름 일괄 변경","/workspace/file/bulk-name-revise","20.workspace/30.file/34.bulk-name-revise",{"title":481,"path":482,"stem":483,"children":-1},"파일 변환","/workspace/file/file-convert-overview","20.workspace/30.file/40.file-convert-overview",{"title":485,"path":486,"stem":487,"children":-1},"템플릿 파일","/workspace/file/templates","20.workspace/30.file/41.templates",{"title":489,"path":490,"stem":491,"children":-1},"할일 목록 (Todo)","/workspace/file/template-todo","20.workspace/30.file/42.template-todo",{"title":493,"path":494,"stem":495,"children":-1},"결재 서식","/workspace/file/template-approval","20.workspace/30.file/43.template-approval",{"title":497,"path":498,"stem":499,"children":-1},"칸반 보드","/workspace/file/template-kanban","20.workspace/30.file/44.template-kanban",{"title":501,"path":502,"stem":503,"children":-1},"타임라인","/workspace/file/template-timeline","20.workspace/30.file/45.template-timeline",{"title":505,"path":506,"stem":507,"children":-1},"메모장","/workspace/file/template-memo","20.workspace/30.file/46.template-memo",{"title":509,"path":510,"stem":511,"children":-1},"AI 채팅 파일","/workspace/file/ai-chat-file","20.workspace/30.file/47.ai-chat-file",{"title":513,"path":514,"stem":515,"children":-1},"파일 변경 기록 확인","/workspace/file/audit-trail","20.workspace/30.file/50.audit-trail",{"title":517,"path":518,"stem":519,"children":-1},"파일 버전 관리","/workspace/file/version-trail","20.workspace/30.file/51.version-trail",{"title":521,"path":522,"stem":523,"children":-1},"편집 잠금","/workspace/file/file-lock","20.workspace/30.file/52.file-lock",{"title":525,"path":526,"stem":527,"children":-1},"파일 암호화","/workspace/file/file-encrypt","20.workspace/30.file/53.file-encrypt",{"title":529,"path":530,"stem":531,"children":-1},"디스크 파일 등록","/workspace/file/disk-file-registration","20.workspace/30.file/60.disk-file-registration",{"title":533,"path":534,"stem":535,"children":536,"page":55},"협업","/workspace/cooperation","20.workspace/35.cooperation",[537,541,545,549,554,558,562,566,571,575],{"title":538,"path":539,"stem":540,"children":-1},"파일·폴더 댓글","/workspace/cooperation/file-comments","20.workspace/35.cooperation/00.file-comments",{"title":542,"path":543,"stem":544,"children":-1},"채팅","/workspace/cooperation/chat","20.workspace/35.cooperation/10.chat",{"title":546,"path":547,"stem":548,"children":-1},"협업 채팅 및 편집 잠금","/workspace/cooperation/collaboration-chat","20.workspace/35.cooperation/11.collaboration-chat",{"title":550,"path":551,"stem":552,"tags":553,"children":-1},"팀원 작업 위치 따라가기","/workspace/cooperation/follow-team-location","20.workspace/35.cooperation/12.follow-team-location",[371],{"title":555,"path":556,"stem":557,"children":-1},"멘션","/workspace/cooperation/mention","20.workspace/35.cooperation/14.mention",{"title":559,"path":560,"stem":561,"children":-1},"쪽지","/workspace/cooperation/dm","20.workspace/35.cooperation/16.dm",{"title":563,"path":564,"stem":565,"children":-1},"알림 보관함","/workspace/cooperation/notification-inbox","20.workspace/35.cooperation/18.notification-inbox",{"title":567,"path":568,"stem":569,"tags":570,"children":-1},"팀 활동 확인하기","/workspace/cooperation/file-activity","20.workspace/35.cooperation/30.file-activity",[371],{"title":572,"path":573,"stem":574,"children":-1},"외부 공유 링크 만들기","/workspace/cooperation/share-link-creation","20.workspace/35.cooperation/40.share-link-creation",{"title":576,"path":577,"stem":578,"children":-1},"외부 공유 이메일 전송","/workspace/cooperation/share-link-email","20.workspace/35.cooperation/42.share-link-email",{"title":580,"path":581,"stem":582,"children":583,"page":55},"검색","/workspace/search","20.workspace/40.search",[584,588,593,597,601,605],{"title":585,"path":586,"stem":587,"children":-1},"파일 검색","/workspace/search/search","20.workspace/40.search/00.search",{"title":589,"path":590,"stem":591,"tags":592,"children":-1},"문맥 검색 (AI 검색)","/workspace/search/context-search","20.workspace/40.search/10.context-search",[371],{"title":594,"path":595,"stem":596,"children":-1},"이미지 검색","/workspace/search/image-search","20.workspace/40.search/20.image-search",{"title":598,"path":599,"stem":600,"children":-1},"채팅 검색","/workspace/search/chat-search","20.workspace/40.search/30.chat-search",{"title":602,"path":603,"stem":604,"children":-1},"댓글 검색","/workspace/search/comment-search","20.workspace/40.search/40.comment-search",{"title":606,"path":607,"stem":608,"children":-1},"유의어 검색","/workspace/search/synonym-search","20.workspace/40.search/50.synonym-search",{"title":610,"path":611,"stem":612,"children":613,"page":55},"AI","/workspace/ai","20.workspace/50.ai",[614,618,623],{"title":615,"path":616,"stem":617,"children":-1},"AI 기능 요약","/workspace/ai/overview","20.workspace/50.ai/00.overview",{"title":619,"path":620,"stem":621,"tags":622,"children":-1},"로컬 AI에게 업무 요청하기","/workspace/ai/ai-work","20.workspace/50.ai/10.ai-work",[371],{"title":624,"path":625,"stem":626,"children":-1},"외부 AI 활용하기","/workspace/ai/external-ai","20.workspace/50.ai/20.external-ai",{"title":628,"path":629,"stem":630,"children":631,"page":55},"웹스페이스","/webspace","40.webspace",[632,636,640,644,648,652,657,661,665,669,673,702],{"title":633,"path":634,"stem":635,"children":-1},"웹스페이스(Webspace)란?","/webspace/overview","40.webspace/00.overview",{"title":637,"path":638,"stem":639,"children":-1},"웹사이트 배포하기","/webspace/website-release","40.webspace/10.website-release",{"title":641,"path":642,"stem":643,"children":-1},"스키마 파일(.sfn) 만들기","/webspace/create-database","40.webspace/20.create-database",{"title":645,"path":646,"stem":647,"children":-1},"API 빌드 및 데이터베이스 배포하기","/webspace/api-overview","40.webspace/24.api-overview",{"title":649,"path":650,"stem":651,"children":-1},"프론트엔드 샘플 확인하기","/webspace/frontend-example","40.webspace/26.frontend-example",{"title":653,"path":654,"stem":655,"tags":656,"children":-1},"팀 내부용 웹서비스 만들기","/webspace/internal-webservice","40.webspace/32.internal-webservice",[371],{"title":658,"path":659,"stem":660,"children":-1},"외부 공개용 웹서비스 만들기","/webspace/external-webservice","40.webspace/34.external-webservice",{"title":662,"path":663,"stem":664,"children":-1},"SQL 가져오기와 내보내기","/webspace/sql-converter","40.webspace/42.sql-converter",{"title":666,"path":667,"stem":668,"children":-1},"개발자 팁 2: Code 컨버터","/webspace/code-converter","40.webspace/44.code-converter",{"title":670,"path":671,"stem":672,"children":-1},"성능과 확장","/webspace/performance","40.webspace/48.performance",{"title":674,"path":675,"stem":676,"children":677,"page":55},"웹스페이스 관리","/webspace/admin","40.webspace/50.admin",[678,682,686,690,694,698],{"title":679,"path":680,"stem":681,"children":-1},"웹스페이스 관리 시작하기","/webspace/admin/overview","40.webspace/50.admin/00.overview",{"title":683,"path":684,"stem":685,"children":-1},"운영 현황","/webspace/admin/operations","40.webspace/50.admin/10.operations",{"title":687,"path":688,"stem":689,"children":-1},"워크스페이스 접근","/webspace/admin/workspace-access","40.webspace/50.admin/20.workspace-access",{"title":691,"path":692,"stem":693,"children":-1},"API · 사이트 보안","/webspace/admin/api-site-security","40.webspace/50.admin/30.api-site-security",{"title":695,"path":696,"stem":697,"children":-1},"서비스 및 용량","/webspace/admin/service-capacity","40.webspace/50.admin/40.service-capacity",{"title":699,"path":700,"stem":701,"children":-1},"배포 관리와 프론트엔드 릴리스","/webspace/admin/deployments","40.webspace/50.admin/50.deployments",{"title":703,"path":704,"stem":705,"children":706,"page":55},"웹스페이스 따라해보기","/webspace/examples","40.webspace/60.examples",[707,711,715,719,724,729],{"title":708,"path":709,"stem":710,"children":-1},"웹스페이스 응용편","/webspace/examples/overview","40.webspace/60.examples/00.overview",{"title":712,"path":713,"stem":714,"children":-1},"나만의 업무 시스템 만들기","/webspace/examples/my-own-system","40.webspace/60.examples/10.my-own-system",{"title":716,"path":717,"stem":718,"children":-1},"실시간 오목 게임 만들기","/webspace/examples/realtime-gomoku","40.webspace/60.examples/20.realtime-gomoku",{"title":720,"path":721,"stem":722,"tags":723,"children":-1},"폴더 파일로 자료 게시판 만들기","/webspace/examples/folder-board","40.webspace/60.examples/30.folder-board",[90],{"title":725,"path":726,"stem":727,"tags":728,"children":-1},"공동 몬스터 레이드 만들기","/webspace/examples/monster-raid","40.webspace/60.examples/40.monster-raid",[90],{"title":730,"path":731,"stem":732,"tags":733,"children":-1},"AI 상담 채팅 샘플 배포하기","/webspace/examples/ai-support-chat","40.webspace/60.examples/50.ai-support-chat",[90],{"title":735,"path":736,"stem":737,"children":738,"page":55},"플러그인 사용하기","/plugin","50.plugin",[739,743,760,809,827,857],{"title":740,"path":741,"stem":742,"children":-1},"플러그인 개요","/plugin/overview","50.plugin/00.overview",{"title":744,"path":745,"stem":746,"children":747,"page":55},"캘린더","/plugin/calendar","50.plugin/10.calendar",[748,752,756],{"title":749,"path":750,"stem":751,"children":-1},"캘린더 소개","/plugin/calendar/overview","50.plugin/10.calendar/00.overview",{"title":753,"path":754,"stem":755,"children":-1},"일정 생성, 수정 및 삭제하기","/plugin/calendar/create-event","50.plugin/10.calendar/10.create-event",{"title":757,"path":758,"stem":759,"children":-1},"활동 기록 확인하기","/plugin/calendar/file-activity","50.plugin/10.calendar/40.file-activity",{"title":761,"path":762,"stem":763,"children":764,"page":55},"이메일","/plugin/email","50.plugin/20.email",[765,769,773,777,781,785,789,793,797,801,805],{"title":766,"path":767,"stem":768,"children":-1},"이메일 소개","/plugin/email/overview","50.plugin/20.email/00.overview",{"title":770,"path":771,"stem":772,"children":-1},"이메일 설정","/plugin/email/setfn-email-setting","50.plugin/20.email/05.setfn-email-setting",{"title":774,"path":775,"stem":776,"children":-1},"외부 이메일 연결","/plugin/email/external-email","50.plugin/20.email/07.external-email",{"title":778,"path":779,"stem":780,"children":-1},"이메일 기본 기능","/plugin/email/email-basic","50.plugin/20.email/10.email-basic",{"title":782,"path":783,"stem":784,"children":-1},"메일 AI 어시스턴트 사용하기","/plugin/email/email-ai-assistant","50.plugin/20.email/15.email-ai-assistant",{"title":786,"path":787,"stem":788,"children":-1},"이메일 작성 및 전송","/plugin/email/email-compose","50.plugin/20.email/20.email-compose",{"title":790,"path":791,"stem":792,"children":-1},"파일 첨부하기","/plugin/email/email-attachment","50.plugin/20.email/30.email-attachment",{"title":794,"path":795,"stem":796,"children":-1},"이메일 폴더 관리","/plugin/email/email-folders","50.plugin/20.email/40.email-folders",{"title":798,"path":799,"stem":800,"children":-1},"이메일 자동 분류하기","/plugin/email/email-auto-classify","50.plugin/20.email/50.email-auto-classify",{"title":802,"path":803,"stem":804,"children":-1},"이메일 파일 보관 및 공유","/plugin/email/email-open-in-space","50.plugin/20.email/60.email-open-in-space",{"title":806,"path":807,"stem":808,"children":-1},"이메일 보안","/plugin/email/email-security","50.plugin/20.email/70.email-security",{"title":810,"path":811,"stem":812,"children":813,"page":55},"워크플로우 (업무자동화)","/plugin/workflow","50.plugin/30.workflow",[814,818,823],{"title":815,"path":816,"stem":817,"children":-1},"워크플로우 소개","/plugin/workflow/overview","50.plugin/30.workflow/00.overview",{"title":819,"path":820,"stem":821,"tags":822,"children":-1},"새 워크플로우 만들기","/plugin/workflow/new-workflow","50.plugin/30.workflow/10.new-workflow",[371],{"title":824,"path":825,"stem":826,"children":-1},"실행 기록 확인하기","/plugin/workflow/execution-history","50.plugin/30.workflow/20.execution-history",{"title":828,"path":829,"stem":830,"children":831,"page":55},"파인튜닝 (AI 학습)","/plugin/fine-tuning","50.plugin/40.fine-tuning",[832,837,841,845,849,853],{"title":833,"path":834,"stem":835,"tags":836,"children":-1},"파인튜닝 소개","/plugin/fine-tuning/overview","50.plugin/40.fine-tuning/00.overview",[371],{"title":838,"path":839,"stem":840,"children":-1},"학습 데이터 전처리","/plugin/fine-tuning/pre-processing","50.plugin/40.fine-tuning/10.pre-processing",{"title":842,"path":843,"stem":844,"children":-1},"학습","/plugin/fine-tuning/training","50.plugin/40.fine-tuning/20.training",{"title":846,"path":847,"stem":848,"children":-1},"평가","/plugin/fine-tuning/evaluation","50.plugin/40.fine-tuning/30.evaluation",{"title":850,"path":851,"stem":852,"children":-1},"채팅 테스트","/plugin/fine-tuning/chat-test","50.plugin/40.fine-tuning/40.chat-test",{"title":854,"path":855,"stem":856,"children":-1},"내보내기","/plugin/fine-tuning/export","50.plugin/40.fine-tuning/50.export",{"title":858,"path":859,"stem":860,"children":861,"page":55},"EDC (데이터 수집)","/plugin/edc","50.plugin/50.edc",[862,866,870,874],{"title":863,"path":864,"stem":865,"children":-1},"EDC 소개","/plugin/edc/overview","50.plugin/50.edc/00.overview",{"title":867,"path":868,"stem":869,"children":-1},"데이터 입력, Audit Trail","/plugin/edc/data-entry","50.plugin/50.edc/10.data-entry",{"title":871,"path":872,"stem":873,"children":-1},"빌더","/plugin/edc/builder","50.plugin/50.edc/20.builder",{"title":875,"path":876,"stem":877,"children":-1},"사용자/기관 설정","/plugin/edc/account","50.plugin/50.edc/30.account",{"title":879,"path":880,"stem":881,"children":882,"page":55},"FAQ","/faq","99.FAQ",[883,887,891,895,899,903,907],{"title":884,"path":885,"stem":886,"children":-1},"SetFN vs 클라우드 서비스 비교","/faq/comparison-cloud","99.FAQ/10.comparison-cloud",{"title":888,"path":889,"stem":890,"children":-1},"SetFN vs NAS 비교","/faq/comparison-nas","99.FAQ/20.comparison-nas",{"title":892,"path":893,"stem":894,"children":-1},"보안 정책","/faq/security-policy","99.FAQ/30.security-policy",{"title":896,"path":897,"stem":898,"children":-1},"SetFN은 왜 빠른가요","/faq/why-fast","99.FAQ/40.why-fast",{"title":900,"path":901,"stem":902,"children":-1},"라이선스 FAQ","/faq/license-faq","99.FAQ/50.license-faq",{"title":904,"path":905,"stem":906,"children":-1},"AI 기능 FAQ","/faq/ai-faq","99.FAQ/60.ai-faq",{"title":908,"path":909,"stem":910,"children":-1},"문제 해결 가이드","/faq/troubleshooting","99.FAQ/70.troubleshooting",{"title":912,"path":913,"stem":914,"children":915,"page":55},"응용편(초안)","/draft","draft",[916,920,924,928,932,936,940,944,948,952,956,960,964],{"title":917,"path":918,"stem":919,"children":-1},"예시 1. 소개 페이지 만들기","/draft/static-intro","draft/05.static-intro",{"title":921,"path":922,"stem":923,"children":-1},"예시 2. 공지 게시판 만들기","/draft/public-notice-board","draft/07.public-notice-board",{"title":925,"path":926,"stem":927,"children":-1},"예시 3. 커피챗 예약 시스템 만들기","/draft/coffee-chat-booking","draft/08.coffee-chat-booking",{"title":929,"path":930,"stem":931,"children":-1},"예시 4. 휴가 신청 시스템 만들기","/draft/leave-request","draft/09.leave-request",{"title":933,"path":934,"stem":935,"children":-1},"예시 5. 실시간 팀 채팅 만들기","/draft/team-chat","draft/10.team-chat",{"title":937,"path":938,"stem":939,"children":-1},"예시 6. 채용 지원 서류 제출함 만들기","/draft/client-submission","draft/11.client-submission",{"title":941,"path":942,"stem":943,"children":-1},"예시 7. 팀과 레벨에 따른 이슈 트래커 만들기","/draft/crm-basic","draft/12.crm-basic",{"title":945,"path":946,"stem":947,"children":-1},"예시 8. 이슈 상태별 필터와 통계 요약 화면 만들기","/draft/crm-search-filter","draft/13.crm-search-filter",{"title":949,"path":950,"stem":951,"children":-1},"예시 9. 실시간 커뮤니티 채팅과 운영 기능 만들기","/draft/community-moderation","draft/14.community-moderation",{"title":953,"path":954,"stem":955,"children":-1},"예시 10. 실시간 출석체크·투표 만들기","/draft/attendance-poll","draft/15.attendance-poll",{"title":957,"path":958,"stem":959,"children":-1},"예시 11. 찬반 논쟁 배틀 만들기","/draft/debate-battle","draft/16.debate-battle",{"title":961,"path":962,"stem":963,"children":-1},"예시 13. 공지사항 읽음 확인 만들기","/draft/announcement-read","draft/18.announcement-read",{"title":965,"path":966,"stem":967,"children":-1},"예시 14. 재고 관리 시스템 만들기","/draft/inventory-management","draft/19.inventory-management",{"title":969,"path":970,"stem":971,"children":972,"page":55},"SJAUTO","/sjauto","sjauto",[973,976,979,982],{"title":69,"path":974,"stem":975,"children":-1},"/sjauto/admin-page-access","sjauto/00.admin-page-access",{"title":334,"path":977,"stem":978,"children":-1},"/sjauto/signup","sjauto/10.signup",{"title":509,"path":980,"stem":981,"children":-1},"/sjauto/ai-chat-file","sjauto/ai-chat-file",{"title":712,"path":983,"stem":984,"children":-1},"/sjauto/webspace-schema-example","sjauto/webspace-schema-example",{"id":986,"title":221,"body":987,"cover":1619,"description":1620,"extension":1621,"image":1619,"meta":1622,"navigation":1624,"path":222,"seo":1625,"stem":223,"tags":1619,"thumbnail":1619,"__hash__":1635},"docs_ko/10.admin/35.ai/30.mcp.md",{"type":988,"value":989,"toc":1610},"minimal",[990,994,1007,1012,1025,1029,1050,1056,1063,1066,1069,1073,1076,1162,1165,1170,1193,1197,1234,1238,1254,1258,1274,1278,1315,1319,1324,1331,1335,1346,1349,1410,1413,1423,1430,1476,1518,1527,1538,1566,1572,1576,1584,1588,1606],[991,992,221],"h1",{"id":993},"mcp-서버-관리하기",[995,996,997,998,1002,1003,1006],"p",{},"MCP 서버는 ",[999,1000,1001],"code",{},"Codex",", ",[999,1004,1005],{},"Claude Code"," 같은 외부 AI 클라이언트가 워크스페이스의 파일, 검색, 팀 활동 같은 기능을 표준화된 방식으로 호출할 수 있게 연결하는 서버입니다.",[1008,1009,1011],"h2",{"id":1010},"시작하기-전에","시작하기 전에",[1013,1014,1015,1019,1022],"ul",{},[1016,1017,1018],"li",{},"필요 권한: 관리자",[1016,1020,1021],{},"연결 키를 발급할 구성원과 허용할 작업, 공간, 폴더 경로를 확인합니다.",[1016,1023,1024],{},"외부 AI 공급자에게 전달될 수 있는 자료의 범위를 먼저 검토합니다.",[1008,1026,1028],{"id":1027},"mcp-설정-열기","MCP 설정 열기",[1030,1031,1032,1035,1044],"ol",{},[1016,1033,1034],{},"관리자 페이지에 접속합니다.",[1016,1036,1037,1039,1040,1043],{},[999,1038,203],{}," > ",[999,1041,1042],{},"도구·연동","을 선택합니다.",[1016,1045,1046,1049],{},[999,1047,1048],{},"MCP 서버","를 펼칩니다.",[1051,1052,1053],"danger",{},[995,1054,1055],{},"MCP 기능을 사용하면, 문서 내용 등 데이터가 외부 AI 공급자에게 전송될 수 있습니다.\n데이터 보안에 주의해주세요.",[995,1057,1058],{},[1059,1060],"img",{"alt":1061,"src":1062},"AI 서비스의 도구·연동 화면","./_screenshots/admin-ai-integrations.png",[995,1064,1065],{},"관리는 두 단계로 이루어집니다. 관리자가 조직 전체에 허용할 최대 범위를 먼저 정하고, 구성원용 연결 키에는 그보다 좁은 작업·공간·경로 범위를 설정합니다.",[1067,1068],"hr",{},[1008,1070,1072],{"id":1071},"_1-조직-공통-기능-설정","1. 조직 공통 기능 설정",[995,1074,1075],{},"모든 외부 AI 연결에 공통으로 적용할 최대 허용 범위를 정합니다. 여기서 허용하지 않은 기능은 사용자가 개별 키에서도 켤 수 없습니다.",[1077,1078,1079,1095],"table",{},[1080,1081,1082],"thead",{},[1083,1084,1085,1089,1092],"tr",{},[1086,1087,1088],"th",{},"허용 도구",[1086,1090,1091],{},"설명",[1086,1093,1094],{},"개수",[1096,1097,1098,1110,1121,1132,1142,1152],"tbody",{},[1083,1099,1100,1104,1107],{},[1101,1102,1103],"td",{},"기본 정보",[1101,1105,1106],{},"현재 위치와 시간, 작업 승인 상태를 확인합니다.",[1101,1108,1109],{},"3개",[1083,1111,1112,1115,1118],{},[1101,1113,1114],{},"파일 읽기",[1101,1116,1117],{},"폴더와 파일 내용을 확인합니다.",[1101,1119,1120],{},"5개",[1083,1122,1123,1126,1129],{},[1101,1124,1125],{},"파일·문서 검색",[1101,1127,1128],{},"파일 이름이나 문서 내용으로 자료를 찾습니다.",[1101,1130,1131],{},"2개",[1083,1133,1134,1137,1140],{},[1101,1135,1136],{},"팀 정보",[1101,1138,1139],{},"팀 대화와 활동 내역을 조회합니다. 외부 AI 공급자에게 관련 내용이 전달될 수 있습니다.",[1101,1141,1131],{},[1083,1143,1144,1147,1150],{},[1101,1145,1146],{},"파일·폴더 변경",[1101,1148,1149],{},"파일과 폴더를 만들거나 수정하고 이동합니다.",[1101,1151,1120],{},[1083,1153,1154,1156,1159],{},[1101,1155,325],{},[1101,1157,1158],{},"승인을 받은 파일만 복구 가능한 휴지통으로 이동합니다. 폴더는 지원하지 않습니다.",[1101,1160,1161],{},"1개",[995,1163,1164],{},"각 허용 도구는 아래 세부 기능(도구)으로 구성됩니다.",[995,1166,1167],{},[1168,1169,1103],"strong",{},[1013,1171,1172,1179,1186],{},[1016,1173,1174,1175,1178],{},"작업 승인 상태 확인(",[999,1176,1177],{},"getApprovalStatus","): 변경 작업을 진행해도 되는지 확인합니다 · 승인 흐름 필수 도구",[1016,1180,1181,1182,1185],{},"현재 위치 확인(",[999,1183,1184],{},"getCurrentPath","): 현재 보고 있는 가상 폴더 위치를 확인합니다",[1016,1187,1188,1189,1192],{},"현재 시간 확인(",[999,1190,1191],{},"getCurrentTime","): 서버의 현재 날짜와 시간을 확인합니다",[995,1194,1195],{},[1168,1196,1114],{},[1013,1198,1199,1206,1213,1220,1227],{},[1016,1200,1201,1202,1205],{},"폴더 내용 보기(",[999,1203,1204],{},"listResources","): 폴더 안의 파일과 하위 폴더를 확인합니다",[1016,1207,1208,1209,1212],{},"파일 읽기(",[999,1210,1211],{},"readFile","): 파일 내용을 읽거나 큰 파일의 다운로드 주소를 확인합니다",[1016,1214,1215,1216,1219],{},"큰 텍스트 파일 읽기(",[999,1217,1218],{},"readTextFileRange","): 용량이 큰 텍스트 파일을 나누어 읽습니다",[1016,1221,1222,1223,1226],{},"즐겨찾기 보기(",[999,1224,1225],{},"listFavoriteResources","): 즐겨찾기에 등록한 문서를 확인합니다",[1016,1228,1229,1230,1233],{},"최근 문서 보기(",[999,1231,1232],{},"listRecentResources","): 최근에 열어본 문서를 확인합니다",[995,1235,1236],{},[1168,1237,1125],{},[1013,1239,1240,1247],{},[1016,1241,1242,1243,1246],{},"파일 찾기(",[999,1244,1245],{},"internalFindFiles","): 이름이나 파일 종류로 파일을 찾습니다",[1016,1248,1249,1250,1253],{},"문서 내용 검색(",[999,1251,1252],{},"internalSearchContent","): 문서 안에서 원하는 내용을 빠르게 검색합니다",[995,1255,1256],{},[1168,1257,1136],{},[1013,1259,1260,1267],{},[1016,1261,1262,1263,1266],{},"팀 대화 검색(",[999,1264,1265],{},"searchChat","): 내가 볼 수 있는 팀 대화에서 내용을 찾습니다",[1016,1268,1269,1270,1273],{},"팀 활동 내역 확인(",[999,1271,1272],{},"getAuditLogs","): 내가 볼 수 있는 팀의 작업 기록을 확인합니다",[995,1275,1276],{},[1168,1277,1146],{},[1013,1279,1280,1287,1294,1301,1308],{},[1016,1281,1282,1283,1286],{},"텍스트 일부 수정(",[999,1284,1285],{},"applyPatch","): 다른 변경과 충돌하지 않도록 텍스트의 필요한 부분만 수정합니다",[1016,1288,1289,1290,1293],{},"폴더 만들기(",[999,1291,1292],{},"createFolder","): 새 폴더를 만듭니다",[1016,1295,1296,1297,1300],{},"파일 만들기(",[999,1298,1299],{},"createFile","): 새 파일을 만듭니다",[1016,1302,1303,1304,1307],{},"파일 내용 수정(",[999,1305,1306],{},"updateFile","): 기존 파일의 내용을 수정합니다",[1016,1309,1310,1311,1314],{},"파일·폴더 이동(",[999,1312,1313],{},"moveFile","): 파일이나 폴더의 위치를 옮깁니다",[995,1316,1317],{},[1168,1318,325],{},[1013,1320,1321],{},[1016,1322,1323],{},"파일을 휴지통으로 이동: 승인을 받은 뒤 휴지통으로 옮깁니다",[995,1325,1326,1327,1330],{},"전체 선택/전체 해제로 한 번에 조정하거나, 도구별로 개별 설정할 수 있습니다. 설정 후 ",[999,1328,1329],{},"저장"," 버튼을 클릭합니다.",[1008,1332,1334],{"id":1333},"_2-구성원용-외부-ai-연결-키","2. 구성원용 외부 AI 연결 키",[995,1336,1337,1338,1341,1342,1345],{},"관리자는 ",[999,1339,1340],{},"구성원 외부 AI 연결 키","에서 대상 구성원을 선택하고 용도별 키를 발급할 수 있습니다. 키에 허용하는 작업과 공간은 조직 정책과 해당 구성원의 기존 권한을 넘을 수 없습니다. ",[999,1343,1344],{},"키 발급","을 선택해 새 키를 만듭니다.",[995,1347,1348],{},"키를 발급할 때 다음을 설정할 수 있습니다.",[1077,1350,1351,1360],{},[1080,1352,1353],{},[1083,1354,1355,1358],{},[1086,1356,1357],{},"항목",[1086,1359,1091],{},[1096,1361,1362,1370,1378,1386,1394,1402],{},[1083,1363,1364,1367],{},[1101,1365,1366],{},"구성원",[1101,1368,1369],{},"이 키로 연결할 사용자 계정을 지정합니다.",[1083,1371,1372,1375],{},[1101,1373,1374],{},"키 이름",[1101,1376,1377],{},"키의 용도를 구분할 이름을 입력합니다.",[1083,1379,1380,1383],{},[1101,1381,1382],{},"만료일자",[1101,1384,1385],{},"이 키가 유효한 기간을 지정합니다.",[1083,1387,1388,1391],{},[1101,1389,1390],{},"작업 허용 범위",[1101,1392,1393],{},"조직이 허용한 도구 중, 이 키에서 실제로 사용할 기능만 좁혀서 선택합니다.",[1083,1395,1396,1399],{},[1101,1397,1398],{},"공간",[1101,1400,1401],{},"이 키로 접근할 팀 폴더 또는 개인 폴더를 지정합니다.",[1083,1403,1404,1407],{},[1101,1405,1406],{},"경로",[1101,1408,1409],{},"접근을 허용할 폴더 경로를 지정합니다.",[995,1411,1412],{},"키를 발급하면 원본 키, MCP 엔드포인트, CLI 설정 명령이 함께 제공됩니다. 원본 키는 발급 직후 한 번만 표시되므로 바로 안전한 위치에 저장합니다.",[1414,1415,1420],"pre",{"className":1416,"code":1418,"language":1419},[1417],"language-text","MCP endpoint: https://my-company.setfn.me/api/mcp\n","text",[999,1421,1418],{"__ignoreMap":1422},"",[995,1424,1425,1426,1429],{},"먼저 ",[999,1427,1428],{},"SETFN_MCP_TOKEN"," 환경 변수에 발급받은 키를 설정한 뒤, 사용하는 클라이언트에 맞는 명령으로 등록합니다.",[1414,1431,1435],{"className":1432,"code":1433,"language":1434,"meta":1422,"style":1422},"language-bash shiki shiki-themes github-light github-dark monokai","# Codex CLI\ncodex mcp add setfn --url \"https://my-company.setfn.me/api/mcp\" --bearer-token-env-var SETFN_MCP_TOKEN\n","bash",[999,1436,1437,1446],{"__ignoreMap":1422},[1438,1439,1442],"span",{"class":1440,"line":1441},"line",1,[1438,1443,1445],{"class":1444},"s8-w5","# Codex CLI\n",[1438,1447,1449,1453,1457,1460,1463,1467,1470,1473],{"class":1440,"line":1448},2,[1438,1450,1452],{"class":1451},"srTi1","codex",[1438,1454,1456],{"class":1455},"sstjo"," mcp",[1438,1458,1459],{"class":1455}," add",[1438,1461,1462],{"class":1455}," setfn",[1438,1464,1466],{"class":1465},"s7F3e"," --url",[1438,1468,1469],{"class":1455}," \"https://my-company.setfn.me/api/mcp\"",[1438,1471,1472],{"class":1465}," --bearer-token-env-var",[1438,1474,1475],{"class":1455}," SETFN_MCP_TOKEN\n",[1414,1477,1479],{"className":1432,"code":1478,"language":1434,"meta":1422,"style":1422},"# Claude Code\nclaude mcp add --transport http setfn \"https://my-company.setfn.me/api/mcp\" --header \"Authorization: Bearer $SETFN_MCP_TOKEN\"\n",[999,1480,1481,1486],{"__ignoreMap":1422},[1438,1482,1483],{"class":1440,"line":1441},[1438,1484,1485],{"class":1444},"# Claude Code\n",[1438,1487,1488,1491,1493,1495,1498,1501,1503,1505,1508,1511,1515],{"class":1440,"line":1448},[1438,1489,1490],{"class":1451},"claude",[1438,1492,1456],{"class":1455},[1438,1494,1459],{"class":1455},[1438,1496,1497],{"class":1465}," --transport",[1438,1499,1500],{"class":1455}," http",[1438,1502,1462],{"class":1455},[1438,1504,1469],{"class":1455},[1438,1506,1507],{"class":1465}," --header",[1438,1509,1510],{"class":1455}," \"Authorization: Bearer ",[1438,1512,1514],{"class":1513},"sMOD_","$SETFN_MCP_TOKEN",[1438,1516,1517],{"class":1455},"\"\n",[995,1519,1520,1523,1524,1526],{},[999,1521,1522],{},"CLI 설정 복사"," 버튼으로 위 설정을 그대로 복사할 수 있습니다. 여기까지 등록하면 ",[999,1525,1001],{},"든 다른 MCP 클라이언트든, 발급한 키의 권한 범위 안에서 바로 워크스페이스 기능을 호출할 수 있습니다.",[995,1528,1529,1530,1533,1534,1537],{},"키를 발급한 뒤에도 언제든 ",[1168,1531,1532],{},"회전","하거나 ",[1168,1535,1536],{},"폐기","할 수 있습니다.",[1077,1539,1540,1550],{},[1080,1541,1542],{},[1083,1543,1544,1547],{},[1086,1545,1546],{},"동작",[1086,1548,1549],{},"의미",[1096,1551,1552,1559],{},[1083,1553,1554,1556],{},[1101,1555,1532],{},[1101,1557,1558],{},"기존 키를 무효화하고 같은 설정(권한·공간·경로)으로 새 키를 발급합니다. 키가 노출되었을 가능성이 있을 때, 연동을 끊지 않고 안전하게 교체하는 방법입니다.",[1083,1560,1561,1563],{},[1101,1562,1536],{},[1101,1564,1565],{},"키를 즉시 무효화합니다. 더 이상 이 키로는 어떤 요청도 인증되지 않습니다.",[995,1567,1568,1569,1571],{},"키를 교체하면 ",[999,1570,1428],{}," 값과 클라이언트에 등록한 키도 새로 발급받은 값으로 함께 갱신해야 합니다.",[1008,1573,1575],{"id":1574},"보안-주의-사항","보안 주의 사항",[1013,1577,1578,1581],{},[1016,1579,1580],{},"MCP 엔드포인트는 외부에 그대로 공개하지 않는 것을 권장합니다. 외부 연동이 필요한 경우 HTTPS, 인증 토큰, IP 제한, 권한 범위 제한을 적용하고, 호출 가능한 도구를 필요한 범위로만 제한하세요.",[1016,1582,1583],{},"특히 파일 접근, 코드 실행, 메일 발송, 워크플로우 실행처럼 영향 범위가 큰 도구와 연결된 MCP 서버는 내부망 또는 신뢰된 네트워크에서만 사용하는 것이 안전합니다.",[1008,1585,1587],{"id":1586},"관련-문서","관련 문서",[1013,1589,1590,1596,1601],{},[1016,1591,1592],{},[1593,1594,208],"a",{"href":1595},"/ko/docs/admin/ai/",[1016,1597,1598],{},[1593,1599,216],{"href":1600},"/ko/docs/admin/ai/integrations/",[1016,1602,1603],{},[1593,1604,342],{"href":1605},"/ko/docs/workspace/account/account-settings/",[1607,1608,1609],"style",{},"html pre.shiki code .s8-w5, html code.shiki .s8-w5{--shiki-default:#6A737D;--shiki-dark:#6A737D;--shiki-sepia:#88846F}html pre.shiki code .srTi1, html code.shiki .srTi1{--shiki-default:#6F42C1;--shiki-dark:#B392F0;--shiki-sepia:#A6E22E}html pre.shiki code .sstjo, html code.shiki .sstjo{--shiki-default:#032F62;--shiki-dark:#9ECBFF;--shiki-sepia:#E6DB74}html pre.shiki code .s7F3e, html code.shiki .s7F3e{--shiki-default:#005CC5;--shiki-dark:#79B8FF;--shiki-sepia:#AE81FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html .sepia .shiki span {color: var(--shiki-sepia);background: var(--shiki-sepia-bg);font-style: var(--shiki-sepia-font-style);font-weight: var(--shiki-sepia-font-weight);text-decoration: var(--shiki-sepia-text-decoration);}html.sepia .shiki span {color: var(--shiki-sepia);background: var(--shiki-sepia-bg);font-style: var(--shiki-sepia-font-style);font-weight: var(--shiki-sepia-font-weight);text-decoration: var(--shiki-sepia-text-decoration);}html pre.shiki code .sMOD_, html code.shiki .sMOD_{--shiki-default:#24292E;--shiki-dark:#E1E4E8;--shiki-sepia:#F8F8F2}",{"title":1422,"searchDepth":1448,"depth":1611,"links":1612},3,[1613,1614,1615,1616,1617,1618],{"id":1010,"depth":1448,"text":1011},{"id":1027,"depth":1448,"text":1028},{"id":1071,"depth":1448,"text":1072},{"id":1333,"depth":1448,"text":1334},{"id":1574,"depth":1448,"text":1575},{"id":1586,"depth":1448,"text":1587},null,"관리자가 조직의 MCP 도구 범위를 정하고 구성원용 외부 AI 연결 키를 발급하는 방법을 안내합니다.","md",{"slug":1623},"/admin/ai/mcp/",true,{"title":1626,"description":1627,"ogType":1628,"twitterCard":1629,"keywords":1630},"MCP 서버 관리하기 | Admin Docs","관리자가 조직 전체에 허용할 최대 범위를 정하고, 각 사용자가 그 범위 안에서 외부 AI 연결 키를 발급해 Codex, Claude Code 같은 외부 AI 클라이언트가 MCP로 워크스페이스 기능을 호출하도록 관리하는 방법을 설명합니다.","article","summary_large_image",[1631,1632,1633,1634,1344,1001,1005],"MCP 서버 관리","MCP","조직 공통 기능 설정","사용자별 외부 AI 연결 키","RwreRqkNziTj3JFOUOZ6-zjWSqoWnpb69ca6Ue6iFhg",[1637,1638],{"title":216,"path":217,"stem":218,"children":-1},{"title":230,"path":231,"stem":232,"children":-1},{"title":221,"filename":1640,"content":1641},"mcp","# MCP 서버 관리하기\r\n\r\nMCP 서버는 `Codex`, `Claude Code` 같은 외부 AI 클라이언트가 워크스페이스의 파일, 검색, 팀 활동 같은 기능을 표준화된 방식으로 호출할 수 있게 연결하는 서버입니다.\r\n\r\n## 시작하기 전에\r\n\r\n- 필요 권한: 관리자\r\n- 연결 키를 발급할 구성원과 허용할 작업, 공간, 폴더 경로를 확인합니다.\r\n- 외부 AI 공급자에게 전달될 수 있는 자료의 범위를 먼저 검토합니다.\r\n\r\n## MCP 설정 열기\r\n\r\n1. 관리자 페이지에 접속합니다.\r\n2. `AI 서비스` > `도구·연동`을 선택합니다.\r\n3. `MCP 서버`를 펼칩니다.\r\n\r\n::danger\r\nMCP 기능을 사용하면, 문서 내용 등 데이터가 외부 AI 공급자에게 전송될 수 있습니다.\r\n데이터 보안에 주의해주세요.\r\n::\r\n\r\n![AI 서비스의 도구·연동 화면](./_screenshots/admin-ai-integrations.png)\r\n\r\n관리는 두 단계로 이루어집니다. 관리자가 조직 전체에 허용할 최대 범위를 먼저 정하고, 구성원용 연결 키에는 그보다 좁은 작업·공간·경로 범위를 설정합니다.\r\n\r\n---\r\n\r\n## 1. 조직 공통 기능 설정\r\n\r\n모든 외부 AI 연결에 공통으로 적용할 최대 허용 범위를 정합니다. 여기서 허용하지 않은 기능은 사용자가 개별 키에서도 켤 수 없습니다.\r\n\r\n| 허용 도구 | 설명 | 개수 |\r\n|------|------|------|\r\n| 기본 정보 | 현재 위치와 시간, 작업 승인 상태를 확인합니다. | 3개 |\r\n| 파일 읽기 | 폴더와 파일 내용을 확인합니다. | 5개 |\r\n| 파일·문서 검색 | 파일 이름이나 문서 내용으로 자료를 찾습니다. | 2개 |\r\n| 팀 정보 | 팀 대화와 활동 내역을 조회합니다. 외부 AI 공급자에게 관련 내용이 전달될 수 있습니다. | 2개 |\r\n| 파일·폴더 변경 | 파일과 폴더를 만들거나 수정하고 이동합니다. | 5개 |\r\n| 휴지통 | 승인을 받은 파일만 복구 가능한 휴지통으로 이동합니다. 폴더는 지원하지 않습니다. | 1개 |\r\n\r\n각 허용 도구는 아래 세부 기능(도구)으로 구성됩니다.\r\n\r\n**기본 정보**\r\n- 작업 승인 상태 확인(`getApprovalStatus`): 변경 작업을 진행해도 되는지 확인합니다 · 승인 흐름 필수 도구\r\n- 현재 위치 확인(`getCurrentPath`): 현재 보고 있는 가상 폴더 위치를 확인합니다\r\n- 현재 시간 확인(`getCurrentTime`): 서버의 현재 날짜와 시간을 확인합니다\r\n\r\n**파일 읽기**\r\n- 폴더 내용 보기(`listResources`): 폴더 안의 파일과 하위 폴더를 확인합니다\r\n- 파일 읽기(`readFile`): 파일 내용을 읽거나 큰 파일의 다운로드 주소를 확인합니다\r\n- 큰 텍스트 파일 읽기(`readTextFileRange`): 용량이 큰 텍스트 파일을 나누어 읽습니다\r\n- 즐겨찾기 보기(`listFavoriteResources`): 즐겨찾기에 등록한 문서를 확인합니다\r\n- 최근 문서 보기(`listRecentResources`): 최근에 열어본 문서를 확인합니다\r\n\r\n**파일·문서 검색**\r\n- 파일 찾기(`internalFindFiles`): 이름이나 파일 종류로 파일을 찾습니다\r\n- 문서 내용 검색(`internalSearchContent`): 문서 안에서 원하는 내용을 빠르게 검색합니다\r\n\r\n**팀 정보**\r\n- 팀 대화 검색(`searchChat`): 내가 볼 수 있는 팀 대화에서 내용을 찾습니다\r\n- 팀 활동 내역 확인(`getAuditLogs`): 내가 볼 수 있는 팀의 작업 기록을 확인합니다\r\n\r\n**파일·폴더 변경**\r\n- 텍스트 일부 수정(`applyPatch`): 다른 변경과 충돌하지 않도록 텍스트의 필요한 부분만 수정합니다\r\n- 폴더 만들기(`createFolder`): 새 폴더를 만듭니다\r\n- 파일 만들기(`createFile`): 새 파일을 만듭니다\r\n- 파일 내용 수정(`updateFile`): 기존 파일의 내용을 수정합니다\r\n- 파일·폴더 이동(`moveFile`): 파일이나 폴더의 위치를 옮깁니다\r\n\r\n**휴지통**\r\n- 파일을 휴지통으로 이동: 승인을 받은 뒤 휴지통으로 옮깁니다\r\n\r\n전체 선택/전체 해제로 한 번에 조정하거나, 도구별로 개별 설정할 수 있습니다. 설정 후 `저장` 버튼을 클릭합니다.\r\n\r\n## 2. 구성원용 외부 AI 연결 키\r\n\r\n관리자는 `구성원 외부 AI 연결 키`에서 대상 구성원을 선택하고 용도별 키를 발급할 수 있습니다. 키에 허용하는 작업과 공간은 조직 정책과 해당 구성원의 기존 권한을 넘을 수 없습니다. `키 발급`을 선택해 새 키를 만듭니다.\r\n\r\n키를 발급할 때 다음을 설정할 수 있습니다.\r\n\r\n| 항목 | 설명 |\r\n|------|------|\r\n| 구성원 | 이 키로 연결할 사용자 계정을 지정합니다. |\r\n| 키 이름 | 키의 용도를 구분할 이름을 입력합니다. |\r\n| 만료일자 | 이 키가 유효한 기간을 지정합니다. |\r\n| 작업 허용 범위 | 조직이 허용한 도구 중, 이 키에서 실제로 사용할 기능만 좁혀서 선택합니다. |\r\n| 공간 | 이 키로 접근할 팀 폴더 또는 개인 폴더를 지정합니다. |\r\n| 경로 | 접근을 허용할 폴더 경로를 지정합니다. |\r\n\r\n키를 발급하면 원본 키, MCP 엔드포인트, CLI 설정 명령이 함께 제공됩니다. 원본 키는 발급 직후 한 번만 표시되므로 바로 안전한 위치에 저장합니다.\r\n\r\n```\r\nMCP endpoint: https://my-company.setfn.me/api/mcp\r\n```\r\n\r\n먼저 `SETFN_MCP_TOKEN` 환경 변수에 발급받은 키를 설정한 뒤, 사용하는 클라이언트에 맞는 명령으로 등록합니다.\r\n\r\n```bash\r\n# Codex CLI\r\ncodex mcp add setfn --url \"https://my-company.setfn.me/api/mcp\" --bearer-token-env-var SETFN_MCP_TOKEN\r\n```\r\n```bash\r\n# Claude Code\r\nclaude mcp add --transport http setfn \"https://my-company.setfn.me/api/mcp\" --header \"Authorization: Bearer $SETFN_MCP_TOKEN\"\r\n```\r\n\r\n`CLI 설정 복사` 버튼으로 위 설정을 그대로 복사할 수 있습니다. 여기까지 등록하면 `Codex`든 다른 MCP 클라이언트든, 발급한 키의 권한 범위 안에서 바로 워크스페이스 기능을 호출할 수 있습니다.\r\n\r\n키를 발급한 뒤에도 언제든 **회전**하거나 **폐기**할 수 있습니다.\r\n\r\n| 동작 | 의미 |\r\n|------|------|\r\n| 회전 | 기존 키를 무효화하고 같은 설정(권한·공간·경로)으로 새 키를 발급합니다. 키가 노출되었을 가능성이 있을 때, 연동을 끊지 않고 안전하게 교체하는 방법입니다. |\r\n| 폐기 | 키를 즉시 무효화합니다. 더 이상 이 키로는 어떤 요청도 인증되지 않습니다. |\r\n\r\n키를 교체하면 `SETFN_MCP_TOKEN` 값과 클라이언트에 등록한 키도 새로 발급받은 값으로 함께 갱신해야 합니다.\r\n\r\n## 보안 주의 사항\r\n\r\n- MCP 엔드포인트는 외부에 그대로 공개하지 않는 것을 권장합니다. 외부 연동이 필요한 경우 HTTPS, 인증 토큰, IP 제한, 권한 범위 제한을 적용하고, 호출 가능한 도구를 필요한 범위로만 제한하세요.\r\n\r\n- 특히 파일 접근, 코드 실행, 메일 발송, 워크플로우 실행처럼 영향 범위가 큰 도구와 연결된 MCP 서버는 내부망 또는 신뢰된 네트워크에서만 사용하는 것이 안전합니다.\r\n\r\n## 관련 문서\r\n\r\n- [AI 서비스 관리하기](/ko/docs/admin/ai/)\r\n- [도구·연동 설정하기](/ko/docs/admin/ai/integrations/)\r\n- [계정 설정](/ko/docs/workspace/account/account-settings/)\n",1791199137158]