Rawdoc
앱 열기
ChatGPT·Claude에 문서 연결하기
목차
ChatGPT나 Claude 같은 AI 앱에 내 문서를 이어 두면, 대화하면서 문서를 찾아 읽게 하거나 정리한 내용을 새 문서로 남기게 할 수 있습니다. 연결에는 MCP(Model Context Protocol, AI 앱이 바깥 서비스의 기능을 불러 쓰는 표준 규약)를 씁니다. 원격 MCP 서버를 추가할 수 있는 AI 앱이면 어느 것이든 같은 방법으로 잇습니다.
로그인해서 쓰는 계정의 문서만 연결됩니다. 로그인하지 않고 이 브라우저에만 둔 문서는 AI 앱이 볼 수 없습니다.
연결하기
서버 주소는 이 앱을 여는 주소의 도메인 뒤에 /mcp를 붙인 https://<이 앱 도메인>/mcp입니다.
- AI 앱의 설정에서 원격 MCP 서버를 추가하는 곳을 찾아 이 주소를 넣습니다. 메뉴 이름과 위치는 AI 앱마다 다르니 그 앱의 안내를 따릅니다
- AI 앱이 연결을 시작하면 이 앱의 화면이 열립니다. 그 브라우저에서 로그인해 있지 않으면
앱 연결을 계속하려면 로그인하세요.줄이 붙은 로그인 화면이 먼저 뜹니다. Google 또는 GitHub로 로그인하면 다음 화면으로 넘어갑니다 - 허용할지 묻는 화면을 읽고
허용을 누르면 AI 앱으로 돌아갑니다.거부를 누르면 연결되지 않습니다
허용 화면에는 맨 위에 연결하려는 앱의 이름, 그 아래 로그인한 이메일이 나옵니다. 할 수 있는 일에는 문서·폴더 목록과 본문 읽기 (공유받은 문서 포함), 문서·폴더 만들기·고치기·옮기기, 문서·폴더를 휴지통으로 보내기 세 줄이 있고, 돌아갈 곳: 뒤에는 허용한 뒤 돌아갈 주소가 보입니다.
앱 이름은 AI 앱이 연결을 시작하면서 스스로 알려 준 이름이고, 없으면 돌아갈 주소가 그 자리에 들어갑니다. 이름만 믿지 말고 돌아갈 곳이 내가 쓰는 AI 앱의 주소인지 본 뒤 허용을 누릅니다. 이메일이 연결하려던 계정과 다르면 거부하고 그 계정으로 다시 로그인합니다.
연결하다 멈출 때
연결 요청을 처리하지 못하면 앱을 연결하지 못했습니다 화면에 이유가 한 줄로 나옵니다. 어느 경우든 AI 앱에서 연결을 처음부터 다시 시작하면 됩니다.
| 화면의 줄 | 뜻 |
|---|---|
연결 요청 시간이 지났습니다. … |
연결 화면을 열어 둔 채 오래 두었습니다 |
연결하려는 앱을 찾을 수 없습니다. … |
AI 앱의 등록 정보가 이 앱에 없습니다 |
앱이 알려 준 돌아갈 주소가 등록된 주소와 달라 연결을 멈췄습니다. … |
돌아갈 주소가 맞지 않아, 안전을 위해 AI 앱으로 돌려보내지 않았습니다 |
연결 요청을 처리하지 못했습니다. … |
그 밖의 경우입니다 |
앱이 할 수 있는 일
AI 앱은 아래 도구를 불러 씁니다. 어느 도구를 언제 부를지는 AI 앱이 대화에 맞춰 정합니다.
| 도구 | 하는 일 |
|---|---|
search |
내 문서의 제목·본문에서 글자를 찾습니다. 최근에 고친 순으로 200개까지, 영문은 대소문자를 가리지 않습니다. 공유받은 문서는 찾지 않습니다 |
fetch |
문서 하나의 원문 전체와 판 번호를 읽습니다. 공유받은 문서도 읽습니다 |
list_documents |
내 문서 목록을 최근에 고친 순으로 한 번에 200개씩 봅니다. 폴더를 주면 그 폴더 바로 안의 문서만 봅니다 |
list_folders |
내 폴더를 트리로 봅니다 |
list_shared |
공유받은 문서 목록을 봅니다 |
create_document |
새 문서를 만듭니다. 폴더를 주지 않으면 최상위에 만듭니다 |
create_folder |
새 폴더를 만듭니다 |
move_document |
내 문서를 다른 폴더나 최상위로 옮깁니다. 본문은 바뀌지 않습니다 |
update_document |
문서의 본문 전체나 제목을 바꿉니다 |
delete_document |
내 문서를 휴지통으로 보냅니다 |
delete_folder |
내 폴더와 하위 폴더를 지우고 안의 문서를 휴지통으로 보냅니다 |
공유받은 문서는 편집 권한이면 고칠 수 있고, 보기 권한이면 읽기만 합니다. 옮기기와 지우기는 문서 주인만 할 수 있습니다. 공유하는 법은 문서를 공유하고 함께 편집하기에 있습니다.
금고 문서
금고 문서는 이 연결로 열 수 없습니다. 목록과 검색에서 빠지고, 문서 id로 읽거나 고치려 해도 거절됩니다. 금고 폴더도 폴더 목록에 나오지 않고, 그 안에 문서·폴더를 만들거나 문서를 옮겨 넣을 수도 없습니다. 금고 문서는 브라우저에서 암호화해 저장하므로 서버가 내용을 읽지 못하기 때문입니다. 자세한 내용은 금고로 문서 암호화하기에 있습니다.
고친 내용이 부딪칠 때
update_document는 본문의 일부가 아니라 전체를 바꿉니다. 그래서 AI 앱은 먼저 fetch로 문서와 판 번호를 읽고, 고칠 때 그 번호를 함께 보냅니다.
그 사이 브라우저나 명령줄 도구, 공유받은 사람이 문서를 고쳐 판 번호가 달라졌다면 아무것도 쓰지 않습니다. 대신 지금 문서를 AI 앱에 돌려주고, 그 문서에 고칠 내용을 다시 얹어 새 판 번호로 보내라고 알립니다. AI 앱이 들고 있던 옛 사본이 그사이 고친 내용을 덮어쓰지 않게 하는 장치입니다.
브라우저에서 그 문서를 계속 치고 있으면 판 번호가 자주 바뀌어 AI 앱의 고치기가 거듭 멈출 수 있습니다. 치기를 멈춘 뒤 다시 시켜 봅니다.
지우기는 휴지통으로
AI 앱이 지운 문서는 곧바로 목록·검색·공유 링크에서 빠지지만, 영구히 지워지지는 않고 휴지통에 30일 동안 남습니다. 그 안에 앱의 휴지통에서 복원하면 돌아옵니다. 휴지통 줄에는 {앱 이름}에서 지움이 붙어 내가 지운 문서와 구별됩니다.
delete_folder로 지운 폴더는 하위 폴더와 함께 사라지고, 폴더에 걸린 초대와 읽기 전용 링크도 되살아나지 않습니다. 복원한 문서는 원래 폴더가 없으면 최상위로 갑니다. 금고 문서나 금고 폴더가 하나라도 든 폴더는 지우지 않고 아무것도 바꾸지 않습니다.
AI 앱에 넘기는 안내에는 지우기 전에 사용자에게 물어보라는 말이 들어 있습니다. 실제로 묻는지는 그 AI 앱이 정하므로, 지우기를 맡길 때는 대상을 분명히 말합니다.
쓰기 한도
AI 앱의 만들기·고치기·옮기기·지우기는 모두 쓰기로 셉니다. 이 앱과 명령줄 도구가 쓰는 계정 한도를 함께 써서, 합쳐 1분에 120번·하루 5,000번까지입니다. 하루 횟수는 한국 시간 오전 9시에 0부터 다시 셉니다. AI 앱이 한도를 다 쓰면 이 앱에서 내가 고친 내용도 함께 한도에 걸립니다.
한도에 걸리면 AI 앱은 기다릴 시간과 /limits 주소가 든 오류를 받습니다. 그 주소를 열면 쓰기 제한에 걸렸습니다 화면에서 다시 쓸 수 있을 때까지 남은 시간을 봅니다. 로그인한 브라우저에서 열면 지금 상태: 줄에 오늘 쓴 횟수도 나옵니다.
연결 보기와 끊기
사이드바 설정의 연결된 앱 탭에 허용한 AI 앱이 최근에 연결한 순으로 나옵니다. 줄마다 앱 이름과 연결한 날짜, 마지막 사용 시각이 보이고, 연결만 하고 쓰지 않았으면 아직 사용 안 함이 붙습니다. 마지막 사용 시각은 앞서 적은 때부터 10분이 지나야 새로 적으므로 최대 10분쯤 늦게 보일 수 있습니다.
연결 끊기는 확인 없이 바로 실행됩니다. 끊은 뒤 그 AI 앱은 문서를 읽지도 고치지도 못하고, 다시 쓰려면 AI 앱에서 연결 과정을 처음부터 거칩니다. AI 앱이 그동안 만들거나 고친 문서는 그대로 남습니다. 목록을 보고 끊는 것은 인터넷에 연결되어 있을 때만 됩니다.
API 토큰과는 따로
명령줄 도구가 쓰는 API 토큰과 AI 앱 연결은 따로 관리됩니다. 연결된 앱은 계정 메뉴 API 토큰 목록에 나오지 않고, 한쪽을 끊거나 폐기해도 다른 쪽은 그대로입니다. MCP 서버 주소는 API 토큰을 받지 않으므로 AI 앱에 토큰을 붙여 넣을 일도 없습니다. 터미널에서 도는 AI 코딩 도구라면 터미널에서 문서 읽고 쓰기의 명령줄 도구를 쓸 수도 있습니다.