Rootr 사용 가이드

Rootr는 "AI가 함께 쓰는 문서 도구"입니다. 그래서 가장 먼저 할 일은 당신의 AI를 Rootr에 연결하는 것입니다. 연결하는 길은 세 갈래이고, 전부 할 필요 없이 하나만 고르면 됩니다.

비개발자용 방법입니다. 설치도, 터미널도, 설정 파일도 필요 없습니다. Claude와 ChatGPT 모두 아래 주소 하나로 연결됩니다.

1. 1

   AI 설정에서 커넥터(Connectors) → 커스텀 커넥터 추가를 엽니다.

   주소를 넣는 칸에 위 주소를 그대로 붙여넣습니다.

2. 2

   브라우저에 뜬 Rootr 화면에서 로그인하고 허용을 누릅니다.

   이때 연결할 워크스페이스와 권한(읽기 전용 / 읽기+쓰기)을 고릅니다.

3. 3

   AI 화면에 Rootr 도구들이 나타나면 성공입니다.

   시험 삼아 "내 워크스페이스에 어떤 문서가 있어?"라고 물어보세요.

화면 캡쳐로 하나씩 따라 하는 Claude·ChatGPT 연결 가이드 →

Rootr가 연결에 필요한 설정을 자동으로 만들어 줍니다. 당신은 그걸 복사해서 AI에 붙여넣기만 하면 됩니다.

1. 1

   왼쪽 메뉴에서 설정(Settings)을 열고, 연동(Integrations) 탭을 누릅니다.

2. 2

   "AI 에이전트 연동 (MCP)" 항목에서 MCP 키 만들기… 버튼을 누릅니다.

3. 3

   키에 이름을 붙이고, 어디까지 허용할지 권한을 고른 뒤 만들기를 누릅니다.

   이름은 나중에 알아보기 쉽게 — 예: "내 노트북 Claude".

4. 4

   열쇠(API 키)가 채워진 설정이 아래 코드 상자에 자동으로 나타납니다.

5. 5

   내가 쓰는 AI에 맞는 복사 버튼을 누르고, 아래 탭의 안내대로 붙여넣습니다.

개발에 익숙해서 설정 파일을 직접 관리하고 싶다면 아래처럼 넣습니다. 이건 "Rootr에 연결되는 작은 프로그램(rootr-cli)을 AI가 실행하도록" 알려주는 설정입니다. ROOTR_API_KEY에는 위에서 만든 열쇠를, ROOTR_WORKSPACE에는 워크스페이스 id를 넣습니다.

Claude Code라면 이 내용을 ~/.claude.json 파일에, Claude Desktop이라면 claude_desktop_config.json 파일의 mcpServers 부분에 넣습니다. rootr-cli를 컴퓨터에 전역 설치했다면 command를 "rootr"로, args를 ["mcp"]로 짧게 써도 됩니다.

CLI(명령줄 도구)는 검은 터미널 창에 명령을 입력해 Rootr를 다루는 방법입니다. AI 없이 사람이 직접 쓰거나, 정해진 시간에 자동으로 도는 스크립트에 넣을 때 유용합니다. 아래 명령을 순서대로 실행해 보세요.

• 경로 쓰는 법: 슬래시(/)로 시작하면 "폴더 경로"로, 아니면 "문서의 고유 번호(id)"로 알아서 인식합니다.
• "append(덧붙이기)"를 권합니다: 문서 전체를 다시 쓰지 않고 끝에 이어 붙이기만 하므로, 다른 사람이나 다른 프로그램이 동시에 편집해도 서로 충돌하지 않습니다.
• 삭제는 휴지통으로 보내는 방식이라 되돌릴 수 있습니다. 30일이 지나면 자동으로 완전히 지워집니다.
• 한 줄씩 설명이 필요하면 rootr --help를 입력하면 사용법이 나옵니다.

직접 프로그램을 만든다면, 어떤 언어에서든 인터넷 요청(HTTP)으로 Rootr를 부를 수 있습니다. 주소는 https://rootr.io/api/v1이고, 요청할 때마다 열쇠를 x-api-key라는 이름표에 담아 보냅니다. 아래는 터미널에서 바로 시험해 볼 수 있는 예시입니다.

각 명령이 어떤 뜻인지 몰라도 괜찮습니다. 요점은 "열쇠를 헤더에 담아 주소로 요청을 보낸다"는 것입니다. 사용할 수 있는 모든 요청의 전체 목록은 ⑩ 레퍼런스에 링크된 기술 문서(OpenAPI)에서 볼 수 있습니다.

열쇠는 두 종류가 있고, 얼마나 넓은 범위까지 열 수 있는지가 다릅니다. 또 각 열쇠에는 "무엇까지 허용할지"를 정하는 권한(스코프)이 붙습니다. 필요한 만큼만 허용하는 게 안전합니다.

• 권한(스코프) 예: docs:read(문서 읽기) · docs:write(문서 수정) · graph:read(지식 열람) · ask(질문하기) · webhooks:manage(알림 설정). 읽기만 시키고 싶으면 docs:read만 켜면 됩니다.
• 원칙: 대부분의 연결은 워크스페이스 키로 충분합니다. 계정 키는 권한이 넓으니 꼭 필요할 때만 쓰세요.
• 작업실을 오가려면: 워크스페이스 키는 자기 작업실 밖에서는 열리지 않습니다. AI가 rootr_use_workspace로 여러 작업실을 오가게 하려면 계정 키를 쓰거나, 작업실마다 키를 발급해 rootr config --add-key <키>로 등록하세요.

연결이 끝나면 AI에게 자연어로 시키면 됩니다("이 문서 요약해서 아래에 붙여줘"). 결과가 더 안전하고 정확하려면 아래를 지키게 하세요.

• 내용 추가는 "덧붙이기(append)", 부분 수정은 "찾아 바꾸기(edit)"를 먼저 쓰게 하세요. 문서 전체를 새로 쓰는 방식은 실수로 기존 내용을 지울 수 있어, 정말 필요할 때만 씁니다.
• 워크스페이스를 처음부터 구조로 만들 땐, AI가 먼저 계획을 세우고 몇 가지 질문을 한 뒤 만들게 하세요(무작정 만들지 않도록).
• 변경 알림(웹훅)을 다시 AI가 받게 해두었다면, "AI 자신이 만든 변경"은 무시하도록 하세요. 안 그러면 자기가 만든 알림에 자기가 반응하는 무한 반복이 생깁니다.

연결하면 AI는 아래 도구들을 쓸 수 있게 됩니다. 종류별로 묶어 요약한 표이며, 각 도구의 자세한 설명은 ⑩ 레퍼런스에 있습니다. 지금은 "이만큼 다양한 일을 시킬 수 있구나" 정도만 보시면 됩니다.

워크스페이스(작업실)가 여러 개면, 매번 설정을 다시 하지 않고 대화 중에 바로 옮겨 다닐 수 있습니다. AI에게 "회사 워크스페이스로 바꿔줘"처럼 말하면 됩니다(이름으로도, 고유 번호로도 됩니다).

• 계정 키(PAT)를 쓰는 경우: 내가 속한 어느 워크스페이스로든 바로 옮길 수 있습니다.
• 워크스페이스마다 키가 따로 있는 경우: 키를 한 번만 등록해두면(rootr config --add-key <키> --label "영업팀"), 옮길 때 그 워크스페이스에 맞는 키가 자동으로 선택되고 기억됩니다.
• 원격 커넥터(주소만 붙여넣는 방식)는 승인할 때 고른 워크스페이스 하나에만 연결됩니다 — 보안을 위해 일부러 그렇게 되어 있습니다. 다른 작업실이 필요하면 그 작업실로 커넥터를 하나 더 만드세요.

AI나 프로그램이 부르는 요청 중 "읽기·검색·질문"에만 한도가 있습니다. 문서를 쓰거나 파일을 올리는 건 한도를 쓰지 않습니다(용량 제한만 적용).

• 80%를 쓰면 AI가 "오늘 남은 조회 N회"라고 미리 알려줍니다 — 작업 도중 갑자기 막히지 않도록.
• 다 쓰면 AI가 한도 도달을 알리고 업그레이드 링크를 안내합니다. 다음 날 자정에 다시 채워집니다.

Rootr가 처음이라면 이 순서대로만 따라오세요. 개발 지식은 필요 없습니다.

2.1 가입하고 로그인하기

• 이메일과 비밀번호로 가입하거나, 구글 계정으로 클릭 한 번에 시작할 수 있습니다.
• 처음 로그인하면 "첫 워크스페이스(작업 공간)를 만드세요"라는 안내가 나옵니다. 워크스페이스는 문서와 폴더가 담기는 나만의 공간입니다.

2.2 문서와 폴더 만들기

화면 왼쪽에 트리(나뭇가지처럼 펼쳐지는 목록)가 있습니다. 여기서 폴더를 만들어 분류하고, 그 안에 문서를 만듭니다. 컴퓨터의 폴더/파일과 똑같다고 생각하시면 됩니다.

2.3 "AI로 만들기"로 한 번에 구성하기

빈 화면부터 하나하나 만들 필요가 없습니다. "무엇을 하고 싶은지" 한 문장으로 적으면(예: "신제품 출시 준비 공간 만들어줘"), AI가 몇 가지를 되물은 뒤 폴더·문서·표까지 갖춘, 바로 쓸 수 있는 구조를 자동으로 만들어 줍니다.

문서를 저장하면, 뒤에서 자동으로 그 내용이 "지식 지도"로 정리됩니다(자세한 건 ⑥장). 그리고 곧바로 ①장으로 가서 AI를 연결하세요 — 그때부터가 Rootr의 진짜 힘입니다.

Rootr의 문서는 "블록"이라는 조각들로 이뤄집니다. 제목, 문단, 목록, 표, 그림 하나하나가 블록입니다. 원하는 곳에 끼워 넣고 순서를 바꿀 수 있어, 글쓰기가 훨씬 자유롭습니다.

• 실시간 공동 편집: 여러 명이 같은 문서를 동시에 열어 고쳐도, 서로의 변경이 즉시 반영됩니다. 누가 어디를 보고 있는지도 표시됩니다.
• 버전 기록(자동 저장 이력): 문서를 고칠 때마다 이전 상태가 자동으로 저장됩니다. 실수로 지웠어도 예전 버전으로 되돌릴 수 있습니다(오른쪽 위 시계 아이콘).
• 특별한 블록들: 강조 상자(콜아웃), 태그(꼬리표), 그리고 순서도 같은 그림을 코드로 그리는 mermaid 다이어그램을 넣을 수 있습니다. AI가 문서를 쓸 때도 이런 다이어그램을 자동으로 그려 줍니다.
• 외부에서 넣은 내용도 실시간 반영: AI나 프로그램이 API로 문서에 글을 추가하면, 지금 그 문서를 열어 보고 있는 화면에도 바로 나타납니다.

아래는 버전 기록 화면입니다. 문서를 고친 시점들이 목록으로 남아, 언제든 그때 내용을 확인하거나 되돌릴 수 있습니다.

"/" 를 눌러 넣는 것들

빈 줄에서 / 를 누르면 넣을 수 있는 블록 목록이 뜹니다. 한글로 찾아집니다 — /토글, /목차, /북마크, /끼워 처럼요.

끼워 넣은 카드에는 표는 앞 몇 행이, 시트는 왼쪽 위 칸들이, 발표자료는 장 수가 미리 보입니다. 볼 권한이 없는 것은 카드가 열리지 않으니, 끼워 넣기가 권한을 넓히지는 않습니다.

댓글과 하위 페이지

• 댓글: 문단을 골라 댓글을 달 수 있습니다. @이름으로 부르면 그 사람에게 알림이 갑니다.
• 하위 페이지: 왼쪽 트리에서 문서를 마우스 오른쪽 버튼으로 눌러 "하위 문서 만들기"를 고르면, 그 문서 아래에 문서가 붙습니다. 표 아래에도 만들 수 있습니다.
• 읽음 확인: 꼭 읽어야 하는 공지는 대상자를 지정해 두면 누가 읽었는지 비율로 보입니다.

"노드"는 트리(왼쪽 목록)에 들어가는 항목 하나하나를 부르는 말입니다. 문서도 노드, 폴더도 노드, 표도 노드입니다. Rootr에는 아래처럼 여러 종류의 노드가 있고, 하려는 일에 맞는 걸 고르면 됩니다. 먼저 전체를 한눈에 보고, 그다음 중요한 것들을 하나씩 설명합니다.

DATABASE (표) — 형식이 정해진 목록

엑셀 표와 노션 데이터베이스를 합친 것이라고 보시면 됩니다. 각 칸(열)마다 "이 칸은 글자, 저 칸은 날짜, 이 칸은 상태(선택)" 하고 형식을 정합니다. 같은 데이터를 네 가지 방식으로 볼 수 있습니다 — 표(table), 칸반 보드(board, 상태별로 카드가 열을 이룸), 달력(calendar), 타임라인. 행 추가·수정은 화면에서도, AI에게 시켜서도 됩니다.

카드를 누르면 오른쪽에 상세 화면이 열리고, 속성 아래에 본문 메모(상세 내용)를 적을 수 있습니다. 이 메모는 표 밑에 달리는 문서 한 장이라, AI에게도 시킬 수 있습니다 — 행을 만들거나 고칠 때 body(상세 내용)를 같이 주면 됩니다.

자동으로 채워지는 칸 — 손대지 않아도 늘 맞습니다

아래 칸들은 값을 넣는 칸이 아니라 사실을 보여 주는 칸입니다. 서버가 볼 때마다 계산하므로 사람이 고칠 수 없고, 그래서 어긋나지 않습니다.

수식에는 if·concat·round·min·max·dateBetween(날짜 사이 일수) 같은 것들을 쓸 수 있습니다. 예를 들어 if(dateBetween({마감}, now()) < 0, "지남", "남음") 처럼 씁니다. 번호는 지운 번호를 다시 쓰지 않습니다 — 어제 얘기한 TASK-42가 오늘 다른 행을 가리키면 안 되기 때문입니다.

표에 자물쇠 걸기 (노션에 없는 기능)

표 화면 위쪽 "권한" 버튼에서 세 가지를 걸 수 있습니다. 셋 다 관리자에게는 걸리지 않고, 설정하지 않은 표는 예전과 똑같이 동작합니다.

• 칸·뷰는 관리자만 변경: 편집자는 행만 채웁니다. 남이 만든 칸이 지워지는 사고를 막습니다.
• 본인이 만든 행만 보기: 지원서·신고함처럼 서로의 제출물을 보면 안 되는 표에 씁니다. 관리자는 전부 봅니다.
• 관리자만 고칠 수 있는 칸: 승인 여부·최종 점수처럼 아무나 고치면 안 되는 칸을 따로 잠급니다.

문서 안에 다른 것 끼워 넣기 (노션보다 넓습니다)

노션은 문서 안에 "표"만 끼울 수 있지만, Rootr는 표·스프레드시트·발표자료·화이트보드·폼·녹음·이슈까지 전부 끼울 수 있습니다. 회의록 문서 안에 그 회의의 녹음과 결정 사항 표와 발표 자료가 같이 있는 편이 자연스럽기 때문입니다.

문서에서 "/" 를 누르고 "끼워 넣기"를 고른 뒤 이름으로 찾으면 됩니다. 끼워 넣은 카드에는 표는 앞 몇 행이, 시트는 왼쪽 위 칸들이, 발표자료는 장 수가 미리 보입니다. 볼 권한이 없는 것은 카드도 열리지 않으니, 끼워 넣기가 권한을 넓히지는 않습니다.

같은 자리에서 "목차"와 "북마크"도 넣을 수 있습니다. 목차는 문서의 제목들을 모아 길잡이를 만들고, 북마크는 링크를 주소 한 줄 대신 카드로 보여 줍니다.

WHITEBOARD · PRESENTATION · FORM

• 화이트보드: 도형과 연결선으로 자유롭게 그리는 넓은 캔버스입니다. 구조도나 아이디어 정리에 좋습니다.
• 발표(PRESENTATION): 슬라이드를 만드는 곳입니다. 슬라이드의 제목·본문·메모에 적은 "글"이 지식 지도에 자동으로 연결되므로, 중요한 내용은 반드시 글로 적고, 이미지에는 설명(캡션)을 달아 주세요.
• 설문/폼(FORM): 신청·설문을 받는 양식입니다. 휴가 신청처럼 워크스페이스 안에서 구성원이 바로 낼 수 있고, 필요하면 바깥 사람에게 링크로 보낼 수도 있습니다. 받은 응답은 표(DATABASE)에 자동으로 모이고, 낸 사람은 자기가 낸 것만 봅니다.

AI에게 "이 구조를 그림으로 그려서 슬라이드에 넣어줘"라고 하면, 구조도·업무 흐름도·순서도·데이터 흐름도·상태도 다섯 가지 중 맞는 것을 골라 그려 넣습니다. 그려진 그림은 화면뿐 아니라 PDF·PPTX로 내보낼 때도 그대로 나옵니다. 다만 그림 속 글자는 검색·지식 지도에 잡히지 않으니, 중요한 내용은 슬라이드 제목과 본문에도 적어 두세요.

SIGNED (서명문서) — 전자결재이자 연구노트

겉모습은 평범한 문서인데, [올리기]를 누르는 순간 본문이 얼어붙습니다. 그 뒤로는 화면에서도, AI로도, 옛 버전 되돌리기로도 고칠 수 없습니다. 결재라인에 적어 둔 사람들이 차례대로 서명하고, 서명마다 바깥 기관의 시각 도장(공인시점확인)과 앞뒤로 이어지는 해시가 붙습니다. 그래서 나중에 "이 문서 진짜 그때 그대로냐"에 화면 한 장으로 답할 수 있습니다.

국가 R&D 과제의 전자연구노트가 요구하는 세 가지 — ① 전자서명 ② 시각 자동기록 ③ 위·변조 확인 — 가 그대로 이 셋입니다. 전자결재와 연구노트를 따로 만들지 않았습니다: 하는 일이 같기 때문입니다. 서명이 찍힌 문서는 삭제되지 않습니다(보존 30년). 폴더째 지워도 그 안의 서명문서 때문에 막힙니다.

• 만들기: 왼쪽 트리에서 [새로 만들기] → "새 서명문서". 본문은 올리기 전까지 평소처럼 고칩니다.
• 서명할 사람: 오른쪽 서명 패널에서 순서대로 넣습니다. 연구노트라면 점검자(연구책임자) 한 명만 골라도 "쓴 사람 → 확인할 사람" 두 단계가 자동으로 만들어집니다.
• 서명: [올리기]를 누르면 메일로 6자리 확인 코드가 옵니다. 비밀번호가 아니라 메일 코드입니다 — 구글로만 가입한 분은 비밀번호가 아예 없기 때문입니다.
• 되돌려보내기(반려): 사유를 적어 돌려보내면 문서가 다시 풀려 고칠 수 있습니다.
• 고쳐야 할 때: 서명된 문서는 고치는 게 아니라 [개정본 만들기]로 새 판을 냅니다. 원본은 "정정됨"으로 그대로 남습니다 — 지침이 고친 흔적과 원본이 모두 보이기를 요구합니다.
• 증명: [검증 결과 보기]를 누르면 본문·서명·시각 도장·기록 연결을 다시 계산해 보여 줍니다. 인쇄해서 제출용으로 쓸 수 있습니다.

내 차례가 되면 메일이 옵니다. 앞사람이 서명을 마치는 순간 다음 사람에게 "서명해 주세요"라는 메일이 가고, 그 안의 링크를 누르면 바로 그 문서가 열립니다. 따로 찾아다닐 곳은 없습니다 — 문서로 들어가 오른쪽 서명 패널에서 서명하시면 됩니다.

회사 밖 사람에게 서명받기

서명할 사람을 넣을 때 메일 주소만 적으면 그분은 Rootr 계정이 없어도 됩니다. 올리는 순간 그 주소로 링크가 담긴 메일이 가고, 링크를 열면 문서를 읽고 바로 서명할 수 있습니다. 거래처와 주고받는 합의서·요구사항 변경 확인서처럼 상대가 우리 회사 사람이 아닐 때 씁니다.

• 링크만으로는 서명되지 않습니다. 링크는 읽을 수 있게 해 줄 뿐이고, 도장을 찍으려면 같은 메일함으로 오는 6자리 코드가 한 번 더 필요합니다. 링크가 남에게 전달돼도 그 사람은 서명하지 못합니다.
• 서명 화면에 보이는 다른 분들의 메일 주소는 가려집니다(ki*@corp.com). 링크 하나가 연락처 명단이 되지 않게 하기 위해서입니다.
• 그 링크로는 그 문서 하나만 열립니다. 워크스페이스의 다른 것에는 손댈 수 없습니다.
• 상대가 되돌려보낼 수도 있습니다 — 사유를 적으면 문서가 풀려 고칠 수 있습니다.

서명이 다 끝나면 PDF 사본이 자동으로 메일에 첨부돼 나갑니다 — 밖의 상대에게도, 서명한 우리 쪽 사람에게도 갑니다. 사본에는 본문과 함께 누가 언제 서명했는지, 본문 지문(해시), 그리고 나중에 진짜인지 확인할 수 있는 주소가 들어 있습니다. 그대로 인쇄해 철하시면 됩니다.

표(DATABASE)의 행을 열고 서명문서를 고르면, 그 행은 서명·시점확인이 붙는 기록이 됩니다. 실험 기록 대장·점검 대장처럼 "행 하나 = 서명해야 하는 기록 하나"인 표에 씁니다. 표 전체를 그렇게 두려면 AI에게 시키면 됩니다(그 표의 기본값이 됩니다). 서명이 찍힌 행은 삭제가 막힙니다.

AI에게도 시킬 수 있습니다 — 문서를 만들고, 결재라인을 짜고, 목록을 보고, 위·변조를 검증하는 것까지 전부 됩니다. 서명만은 대신 눌러 주지 않습니다. 확인 코드가 사람 메일로만 가고, 그게 "사람이 눌렀다"의 유일한 증거이기 때문입니다. AI는 코드를 보내 달라고 한 뒤 여러분에게 6자리를 물어봅니다.

ISSUE_TRACKER (이슈) · LOG (데이터 기록)

• 이슈 트래커: 버그나 할 일을 하나씩 "이슈"로 만들어, 번호(#1, #2…)·상태(열림/닫힘)·라벨·담당자·댓글로 추적합니다. 개발 협업 도구(GitHub)의 이슈와 같은 방식입니다.
• LOG(데이터 기록장): 시간에 따라 쌓이는 기록(예: 서버 응답 시간, 장애 이벤트)을 형식을 정해 넣는 곳입니다. 여기서 "관계(relation)" 칸을 쓰면, 그 기록이 어디서 비롯됐는지 자동으로 이어지는 "데이터 계보"가 생깁니다(⑦장).

표는 엑셀과 노션 데이터베이스를 합친 것입니다. 칸(열)마다 "이 칸은 글, 저 칸은 날짜, 이 칸은 상태" 하고 형식을 정해 두면, 그 형식에 맞는 입력창이 셀마다 뜨고 잘못된 값은 애초에 못 들어갑니다. 만드는 법은 왼쪽 사이드바 "문서" 옆 ＋ → 새 데이터베이스입니다.

칸 만들기 — 스무 가지 중에 고릅니다

표 머리줄 맨 오른쪽 끝의 ＋를 누르면 칸 만들기 창이 화면 가운데에 뜹니다. 왼쪽에서 종류를 고르고, 오른쪽에서 그 종류에 필요한 것만 채웁니다. 종류가 스무 가지라 위쪽 찾기 칸에 "전화"처럼 쳐서 걸러낼 수 있고, 종류마다 한 줄 설명이 붙어 있습니다. 휴대폰에서는 아래에서 시트가 올라오고, 종류를 고르면 설정 화면으로 넘어갑니다.

칸은 크게 두 묶음입니다. 직접 넣는 칸은 사람이 값을 채우고, 서버가 채우는 칸은 고칠 수 없고 늘 저절로 맞습니다.

수식 — 함수를 외우지 않아도 됩니다

수식 칸을 고르면 계산식 입력칸 아래에 쓸 수 있는 함수가 설명·예시와 함께 나옵니다. 이름을 치기 시작하면 그 함수만 남고, 골라 누르면 괄호까지 들어갑니다. { 를 열면 이 표의 칸 이름이 나오므로 이름을 정확히 옮겨 적을 필요가 없습니다. 없는 함수나 없는 칸 이름을 쓰면 저장을 누르기 전에 그 자리에서 알려 줍니다.

수식은 살아 있는 계산입니다. 재료가 되는 칸을 고치면 결과가 즉시 따라 바뀝니다. 노션에서 옮겨 온 표도 계산식 자체를 옮기므로, 이전 뒤에 넣은 행에도 계산이 그대로 붙습니다.

관계와 롤업 — 두 표를 잇고, 이어진 것을 모읍니다

"관계" 칸은 다른 표의 행을 가리킵니다. 예를 들어 업무 표에 "프로젝트" 관계 칸을 만들면, 업무 하나하나가 어느 프로젝트에 속하는지 이어집니다. 그다음 프로젝트 표에 "롤업" 칸을 만들면 이어진 업무들을 모아 개수·합계·평균·완료 비율을 보여 줍니다. 대상 행의 값을 고치면 롤업도 따라 바뀝니다.

롤업을 만들려면 관계 칸이 먼저 있어야 합니다. 관계 칸이 없는 표에서 롤업을 고르면 "먼저 관계 칸을 만들어야 합니다"와 함께 바로 만들 수 있는 버튼이 나옵니다.

보기(뷰) 여섯 가지 — 같은 데이터, 다른 눈

표 위쪽 보기 이름 옆 ＋로 보기를 추가합니다. 보기는 데이터를 복사하지 않습니다 — 같은 행을 다른 방식으로 보여 줄 뿐이라, 어디서 고쳐도 전부 함께 바뀝니다.

보드에서 카드를 다른 열로 끌면 그 열의 상태 값이 곧바로 저장됩니다. "단계로 접어 보기"를 켜면 선택지가 많아도 할 일·진행 중·완료 세 묶음으로 접혀 한눈에 들어옵니다. 이 설정은 그 표에 기억됩니다.

보기마다 필터·정렬·보여줄 칸을 따로 정할 수 있습니다. "필터"는 조건에 맞는 행만 남기고(몇 개가 걸렸는지 버튼에 숫자로 보입니다), "속성"은 이 보기에서 감출 칸을 고릅니다 — 값은 지워지지 않고 화면에서만 빠집니다. 정렬은 머리줄을 눌러 오름차순·내림차순을 고릅니다. 보던 보기는 주소에 남아, 새로고침해도 그대로고 링크로 건네도 같은 보기가 열립니다.

행 상세 — 표 밑에 달리는 문서 한 장

행 오른쪽 끝의 "열기"를 누르면 오른쪽에 상세 화면이 열립니다. 위에는 칸 값들이, 아래에는 본문 메모가 있습니다. 이 메모는 일반 문서와 같은 편집기라 목록·표·그림을 넣을 수 있고, 지식 지도에도 함께 들어갑니다. AI에게 행을 만들라고 할 때 본문까지 같이 시킬 수 있습니다.

상세는 일반 문서만이 아닙니다. 아직 아무것도 없는 행을 열면 오른쪽 창에 문서 · 서명문서 · 스프레드시트 · 화이트보드 · 발표자료 · 녹음 · 폼 · 이슈 여덟 개가 나오고, 누르는 것으로 만들어집니다. 행마다 다르게 골라도 됩니다 — 회의 표 한 장에 녹음으로 남긴 회의록과 서명으로 돌린 회람이 같이 있을 수 있습니다. 문서는 그 창에서 바로 쓰고, 나머지는 "열기"를 눌러 제 화면으로 갑니다.

이미 써 둔 문서를 얹을 수도 있습니다 — 같은 자리의 "이미 있는 문서 잇기"에서 이름으로 찾아 고르면 됩니다. 복사해 붙이지 마세요. 이으면 문서는 있던 자리에 그대로 있고 행이 그것을 가리킬 뿐이라, 나중에 행을 지워도 그 문서는 남습니다. 떼려면 행 메뉴의 "연결 끊기" — 이것도 문서를 지우지 않습니다.

AI에게 "회의 기록 표를 만들어 줘, 행마다 녹음으로"라고 시키면 표에 기본값이 박힙니다. 그런 표에서는 고르는 자리에 그 타입이 "기본"으로 표시됩니다 — 그래도 그 행만 다른 것으로 고를 수 있습니다.

한 번에 고르고 · 한 번에 바꾸고 · 한 번에 지우기

행 왼쪽 끝의 네모를 누르면 그 행이 선택됩니다. 머리줄의 네모는 지금 보이는 행 전부를 고릅니다(필터가 걸려 있으면 걸린 것만). 시프트를 누른 채 누르면 지난번 고른 행부터 여기까지 한꺼번에 잡힙니다.

고르면 아래에 막대가 뜹니다 — 몇 개 골랐는지, 날짜 바꾸기, 삭제. 날짜 칸이 있는 표라면 날짜 하나만 고르면 선택한 행 전부의 날짜가 그 날로 바뀝니다. 삭제는 확인을 한 번 받고, 하나라도 막히면 아무것도 지우지 않습니다 — 서명이 찍힌 행이 섞여 있으면 통째로 거절되고 무엇이 걸렸는지 알려 줍니다. 절반만 지워지는 일은 없습니다.

자물쇠 세 가지 (노션에 없는 기능)

표 위쪽 자물쇠 모양 "권한" 버튼에서 겁니다. 셋 다 관리자에게는 걸리지 않고, 설정한 적 없는 표는 예전과 똑같이 동작합니다. 화면에서 감추는 것으로 끝나지 않고 서버에서도 막으므로, API를 직접 부르는 방법으로도 빠져나갈 수 없습니다.

• 칸·뷰는 관리자만 변경 — 편집자에게는 칸 추가·뷰 추가 버튼이 아예 보이지 않습니다. 남이 만든 칸이 지워지는 사고를 막습니다.
• 본인이 만든 행만 보기 — 지원서·신고함처럼 서로의 제출물을 보면 안 되는 표에 씁니다. 남이 낸 행은 목록에 나오지도 않습니다.
• 관리자만 고칠 수 있는 칸 — 승인 여부·최종 점수처럼 아무나 고치면 안 되는 칸만 따로 잠급니다. 잠긴 칸은 머리줄에 자물쇠가 붙고, 편집자 화면에서는 입력 자체가 되지 않습니다.

알림 — 무슨 일이 생기면 지정한 사람에게 (노션에 없는 기능)

표 위쪽 종 모양 "알림" 버튼에서 규칙을 만듭니다. 행이 들어오거나 · 바뀌거나 · 지워질 때 정해 둔 사람에게 알림이 갑니다. 노션은 본인이 직접 "지켜보기"를 눌러야만 받는데, 그러면 담당자가 그 표를 열어 볼 생각을 해야 알림이 켜집니다 — 지원서·신고함·장애 기록처럼 담당이 정해진 표에서는 그게 안 통합니다.

• 누구에게 — 워크스페이스 구성원 중에서 고릅니다. 여러 명도 됩니다.
• 언제 — 행 추가 · 행 수정 · 행 삭제 중에서 고릅니다.
• 어떤 것만 — 칸 하나를 골라 조건을 겁니다. "상태가 긴급일 때만", "제목에 장애가 들어 있을 때만", "담당이 바뀌었을 때만".

여럿이 함께 쓸 때

• 실시간 반영 — 두 사람이 같은 표를 열어 두고 한 명이 고치면, 다른 쪽 화면도 새로고침 없이 따라 바뀝니다. 행 추가·삭제·칸 추가도 마찬가지입니다.
• 같은 행을 동시에 고쳐도 안전 — 한 명은 담당자를, 다른 한 명은 상태를 같은 순간에 고쳐도 둘 다 남습니다.
• 담당자 알림 — "사람" 칸에 누군가를 지정하면 그 사람에게 알림이 갑니다.

표를 다루는 다른 방법들

• 칸 순서 바꾸기 — 머리줄을 끌어 옮기거나, 머리줄 메뉴의 왼쪽/오른쪽 이동을 씁니다. 제목 열도 옮길 수 있습니다.
• 폼으로 받기 — 폼(FORM)에서 이 표를 고르면, 사람들이 낸 응답이 이 표에 행으로 쌓입니다. 폼은 워크스페이스 구성원이 안에서 바로 낼 수 있고(밖으로 링크를 내지 않아도 됩니다), 낸 사람은 자기가 낸 것만 봅니다.
• AI에게 시키기 — 연동한 AI에게 "이 표에 행 추가해줘", "상태를 완료로 바꿔줘"처럼 말로 시킬 수 있습니다(①장).
• 내보내기 — 표는 엑셀(.xlsx)로 내보낼 수 있습니다.

팀으로 쓸 때 가장 중요한 건 "누가 어디까지 볼 수 있느냐"입니다. Rootr는 이걸 아주 간단하게 다룹니다.

역할(권한 등급)

• Owner(소유자): 워크스페이스의 모든 것을 관리. Admin(관리자): 구성원·설정 관리. Member(구성원): 문서 작성·편집. Viewer(뷰어): 보기만 가능.
• 권한은 폴더에서 그 안의 문서로 자동으로 물려받습니다. 즉 폴더 하나에 권한을 정하면 그 안 전체에 적용됩니다. 특정 문서만 예외로 따로 정할 수도 있습니다.

비공개 · 공유 · 공개

• 비공개 노드: "초대된 사람만" 스위치를 켜면, 내가 만든 문서/폴더를 나(와 초대한 사람)만 볼 수 있게 숨길 수 있습니다.
• 공유 링크로 초대: 링크를 보내 워크스페이스 바깥의 사람을 초대할 수 있습니다.
• 외부 공개(발행): 특정 문서를 인터넷 주소(/p/문서이름)로 누구나 볼 수 있게 공개할 수 있습니다. 공개 문서는 외부인이 "이렇게 고치면 어떨까요"라고 수정을 제안할 수 있고, 소유자가 그 제안을 받아들이거나(merge) 거절할(reject) 수 있습니다 — 마치 문서판 협업(Git)처럼요.

문서만이 아니라 무엇이든 공개할 수 있습니다

표·스프레드시트·화이트보드·폼·이슈·로그·CRM·녹음·서명문서도 웹에 공개할 수 있습니다(폴더만 안 됩니다). 특히 표를 공개하면 방문자가 검색해 보고, "복제하기"를 눌러 자기 워크스페이스로 가져갈 수 있습니다 — 칸·뷰(칸반 포함)·행이 그대로 살아 있는 진짜 표로요.

하위 문서도 같이 공개할지 고를 수 있습니다. 켜면 그 아래 전부(손자·증손자까지)가 각자 주소를 받고 공개 페이지에 목록으로 뜹니다. 끄면 그때 딸려 나갔던 것만 닫힙니다 — 따로 공개해 둔 문서는 그대로 있습니다. 부모를 닫거나, 하위 문서를 밖으로 옮기거나, 부모를 지워도 마찬가지로 같이 닫힙니다. 반대로 공개된 문서 안으로 옮긴 것은 저절로 공개되지 않습니다.

공개해도 나가지 않는 것이 있습니다 — 표의 담당자·첨부·관계 칸, 행에 붙은 문서, 폼 응답, 녹음 원본 소리, CRM 연락처와 딜 금액, 서명문서의 서명자 이름. 행이 500개를 넘으면 그만큼만 보여 주고 "몇 개 중 몇 개"라고 화면에 적습니다.

공개한 표는 표로만 보이지 않습니다 — 보이는 방식 9가지

표를 공개하면 어떤 꼴로 보여줄지 고를 수 있습니다. 자료는 그대로고 보이는 방식만 바뀝니다. 표(칸이 많은 자료 그대로) · 카드(격자로 훑어보기) · 갤러리(큰 그림 타일 — 사진이 없으면 제목에서 뽑은 색으로) · 목록(글처럼 제목 크게, 한 줄 요약) · 보드(상태별 칸반) · 연대기(날짜순 세로 흐름) · 달력(월 격자) · 집계(개수 막대와 합계·평균·최대) · 순위(숫자가 큰 것부터).

보기마다 필요한 칸이 있습니다 — 달력·연대기는 날짜 칸, 보드는 선택(상태) 칸, 순위는 숫자 칸. 그 칸이 없는 표에서는 고르는 자리에서 흐리게 표시되고 왜 못 쓰는지 적어 둡니다. 골라 놓고 빈 화면을 보는 일은 없습니다.

분위기도 6가지입니다 — 기본 · 종이 · 다크 · 비비드 · 벤토 · 브루탈. 배경·카드·모서리·글꼴이 함께 바뀌어서 같은 표가 전혀 다른 페이지로 읽힙니다. 배치와 분위기는 따로 저장되니, 색만 바꿔도 배치는 그대로입니다. 고르는 곳은 공유 → 웹에 공개입니다.

웹에 공개하기 — 발행 후에 고를 수 있는 것들

문서 오른쪽 위 "공유" → "웹에 발행"을 누르면 고정 주소가 생깁니다. 공개 페이지는 발행한 시점의 내용을 보여 줍니다 — 이후에 고친 것은 "최신 내용으로 재발행"을 누르기 전까지 밖에 나가지 않습니다. 초안을 다듬는 동안 밖에서 보이지 않게 하려는 것입니다.

잠긴 문서는 본문이 애초에 내려오지 않습니다 — 화면에서 가리는 방식이면 주소를 직접 불러 보는 것만으로 다 보이기 때문입니다. 비밀번호를 바꾸면 이미 열어 둔 사람도 다시 잠깁니다.

변경 제안 — 문서판 협업(Git)

"누구나 변경 제안 허용"을 켜면, 공개 페이지 아래 "변경 제안하기"가 생깁니다. 밖에 있는 사람이 고친 내용을 제안하면 주인에게 알림이 가고, 공유 창의 "제안 N건 검토"에서 어디가 어떻게 바뀌는지 보고 반영하거나 거절합니다(거절 사유는 제안자에게 전달됩니다).

반영은 덮어쓰기가 아니라 병합입니다. 제안자가 문서를 열어 본 시점을 기준으로, 제안자가 고친 부분만 지금 문서 위에 얹습니다. 그래서 그 사이 주인이 다른 문단을 고쳐 두었다면 그 수정도 그대로 남습니다. 같은 줄을 양쪽이 고쳤을 때만 "충돌 N군데"라고 먼저 알려 주고, 확인한 뒤에 넘어갑니다.

지식 지도(지식그래프)란?

문서를 저장하면 Rootr가 뒤에서 자동으로 그 안의 "중요한 대상"과 "관계"를 뽑아냅니다. 예를 들어 사람·팀·서비스·시스템·장애·결정 같은 것들을 찾아내고, "이 장애가 저 서비스에서 일어났다" 같은 연결을 만듭니다. 이렇게 점(대상)과 선(관계)으로 이어진 지도를 "지식그래프", 쉽게 말해 "지식 지도"라고 합니다. 흩어진 문서 여러 개가 하나의 연결된 그림이 되는 것입니다.

• 미니 지도: 문서 하나를 열면, 그 문서가 언급한 대상들을 작은 지도로 바로 볼 수 있습니다.
• 전체 지도 탐색: 그래프 화면에서 특정 대상을 검색하고, 그 주변에 무엇이 연결됐는지, 두 대상 사이에 어떤 경로가 있는지 따라갈 수 있습니다.

Ask — "왜?"라고 물어보기 (근본 원인 분석)

Ask(질문) 기능에 평소 말로 질문하면(예: "지난주부터 결제가 왜 자꾸 실패하지?"), Rootr는 지식 지도와 문서를 함께 뒤져서, 근거(어느 문서의 어느 문장에서 나왔는지)를 함께 붙인 답을 줍니다. 특히 "무엇이 원인인지"를 추적하는 근본 원인 분석(RCA)에 강합니다. 같은 질문을 앞서 배운 CLI나 API의 ask로도 할 수 있습니다.

LOG(데이터 기록장)란?

LOG는 시간에 따라 쌓이는 기록을 담는 특별한 표입니다. 일반 표와 다른 점은, 넣기 전에 "칸의 형식"을 정한다는 것입니다 — 이 칸은 글자, 이 칸은 숫자, 이 칸은 심각도(정보/경고/오류), 이 칸은 시각 하는 식으로요. 그러면 이상한 값이 들어오는 걸 걸러 주고, 평소와 크게 다른 값(이상치)을 자동으로 표시해 줍니다. 서버 응답 시간, 장애 이벤트, 작업 처리 건수 같은 걸 기록하기에 좋습니다.

"계보(리니지)"란?

계보(데이터 리니지)는 "이 데이터가 어디서 왔고, 무엇이 여기서 비롯됐는지"의 연결입니다. 족보(가계도)를 떠올리면 쉽습니다. LOG의 칸 중 "관계(relation)" 형식의 칸을 쓰면, 한 기록이 다른 기록을 가리키게 되고, 그 순간 둘 사이에 계보 선이 자동으로 그어집니다. 그래서 나중에 "이 장애의 원인이 된 앞선 이벤트가 뭐였지?"를 그림으로 따라갈 수 있습니다.

• 넣는 방법: 화면 입력, 파일 업로드(CSV/엑셀), 또는 프로그램/센서에서 실시간 전송까지 지원합니다.
• 자동 연결: 관계 칸에 값을 넣으면 계보 선이 저절로 생깁니다. 따로 관리할 필요가 없습니다.
• 통계: 시간별·항목별로 개수·평균·최대 같은 요약을 볼 수 있습니다.

웹훅(변경 알림)이란?

웹훅은 "Rootr에서 무슨 일이 생기면, 정해둔 다른 프로그램에 그 사실을 자동으로 알려주는 기능"입니다. 예를 들어 "이 폴더의 문서가 바뀌면 우리 팀 채팅으로 알림을 보내라"처럼요. 사람이 계속 지켜볼 필요 없이 변화에 반응하게 만들 수 있습니다.

• 범위 좁히기: 워크스페이스 전체가 아니라 특정 폴더·문서로만 한정하거나, 태그(꼬리표)로 걸러서 원하는 것만 알림받을 수 있습니다(상위 폴더의 태그는 그 안에도 적용됩니다).
• 무엇이 바뀌었는지: 문서/댓글/시스템 종류로 구분되며, 전체 내용이 아니라 "바뀐 부분(차이)"만 담아 보내 안전합니다.
• 서명 키: 알림이 진짜 Rootr에서 온 것인지 확인하는 열쇠가 만들 때 한 번 발급됩니다. 받는 쪽 서버에 저장해 두세요.

또한 이슈 트래커는 실시간(SSE)으로 화면이 갱신되고, 외부 시스템과 양방향으로 연결할 수 있습니다. 앞서 배운 CLI/AI 연결을 정해진 시간에 자동 실행하도록 걸어두면, "문서가 바뀌면 → AI가 요약을 덧붙인다" 같은 자동 흐름도 만들 수 있습니다.

• 여러 계정 동시 사용: 회사 계정과 개인 계정처럼 여러 계정에 함께 로그인해두고, 클릭으로 전환하며 쓸 수 있습니다.
• 요금제: 사용 인원(좌석) · 저장 공간 · AI 사용량을 조합한 방식입니다. AI 기능은 요금제마다 정해진 "그래프 크레딧"만큼 쓸 수 있습니다. 정확한 가격과 포함 범위는 요금제 페이지에서 확인하세요. 3명까지는 무료로 시작할 수 있습니다.
• 가져오기: 다른 곳에 있던 문서를 워크스페이스로 불러올 수 있습니다. Notion(내보낸 ZIP 또는 통합 토큰)과 Confluence 클라우드(사이트 주소 · 계정 이메일 · API 토큰)를 지원하며, 폴더 구조 · 첨부파일 · 문서끼리 걸어둔 링크까지 그대로 옮겨집니다. 토큰은 이번 가져오기에만 쓰이고 저장되지 않습니다.

여기는 직접 프로그램을 만드는 분을 위한 참고 자료 모음입니다. 화면으로만 쓰신다면 이 장은 건너뛰어도 됩니다.

• REST API 전체 명세: 사용할 수 있는 모든 요청이 기계가 읽을 수 있는 형식으로 정리된 문서 — /api/api-docs-json.
• GraphQL 스키마: 또 다른 질의 방식의 전체 구조 — /api/graphql/sdl.
• AI 도구 152종 상세: rootr-cli의 설명서(README)에 각 도구가 무엇을 하는지 자세히 적혀 있습니다.

자주 만나는 오류와 해결

안 되는 것 · 불편한 것 알려주기

무엇이 안 되거나 불편하면 그 자리에서 보내 주세요. 로그인도 API 키도 필요 없고, 키가 잘못된 상태에서도 보내집니다. 사용량 한도에 걸리지 않고 크레딧도 쓰지 않습니다.

AI 에이전트로 연결해 쓰신다면 따로 시키지 않아도 됩니다 — 연결된 AI에게는 "막히거나 이상한 걸 보면 알아서 제보하라"는 안내가 이미 들어가 있어서, 도구가 설명과 다르게 동작하거나 우회를 하게 되면 스스로 보냅니다(rootr_send_feedback). 종류는 오류·불편·제안·칭찬 중에서 고르고, 같은 내용을 10분 안에 다시 보내면 한 건으로 합칩니다.