Revise

Help›Revise MCP 서버

Revise MCP 서버

마지막 업데이트: 2026년 9월 26일

Revise MCP 서버는 외부 AI 앱을 Revise 계정에 연결합니다. Claude, ChatGPT 및 기타 MCP 클라이언트는 문서를 생성, 읽기, 편집, 댓글 작성, 내보내기 및 공유할 수 있습니다. 에이전트의 편집은 에이전트 이름으로 제안으로 도착하며, 편집기에서 수락하거나 거부할 수 있습니다.

MCP 서버는 모든 요금제에서 무료입니다. 요금제 기반 제한은 없으며, 시간당 속도 제한만 있습니다. Revise 계정이 필요하며, AI 앱은 자체 모델과 구독을 사용합니다.

서버 URL

https://mcp.revise.io/mcp

서버는 스트리밍 가능한 HTTP 전송을 사용합니다. 원격 서버를 지원하는 모든 MCP 클라이언트에 이 URL을 추가하세요. 설정의 외부 에이전트에서도 앱을 연결할 때까지 동일한 URL이 표시됩니다.

Claude 연결

Revise는 Claude 커넥터 디렉터리에 등록되어 있습니다.

1. Claude에서 Revise 목록을 열고 연결하세요.
2. Revise에 로그인하고 허용을 클릭하세요. 로그인 및 액세스 허용을 참조하세요.
3. Claude에게 Revise 문서 작업을 요청하세요.

Claude의 커넥터 설정에서 서버 URL을 사용자 지정 커넥터로 추가할 수도 있습니다. claude.ai에서 추가된 커넥터는 Claude 데스크톱 앱에서도 사용할 수 있습니다.

Claude Code에서는 터미널에서 서버를 추가하세요:

claude mcp add --transport http revise https://mcp.revise.io/mcp

그런 다음 Claude Code에서 /mcp을 실행하고 revise를 선택한 후 인증하세요. Claude Code가 브라우저에서 Revise 로그인 페이지를 엽니다.

ChatGPT 연결

Revise는 ChatGPT의 앱으로 제공됩니다.

1. ChatGPT에서 Revise 앱을 열고 연결하세요.
2. Revise에 로그인하고 허용을 클릭하세요.
3. ChatGPT에게 Revise 문서 작업을 요청하세요.

설정에는 이러한 목록을 여는 Claude로 연결 및 ChatGPT로 연결 버튼이 있습니다. 해당 앱이 연결되면 각 버튼이 사라집니다.

기타 MCP 클라이언트 연결

Codex, Hermes, OpenClaw 및 기타 MCP 클라이언트는 서버 URL로 연결합니다. 클라이언트는 OAuth 로그인을 지원해야 합니다. Revise는 동적 클라이언트 등록 및 PKCE를 지원하므로 클라이언트에 사전 구성된 클라이언트 ID가 필요하지 않습니다.

클라이언트가 등록하는 이름이 Revise의 에이전트 이름이 됩니다. 이 이름은 에이전트의 제안, 댓글 및 커서에 표시됩니다. 사용 가능한 이름이 없는 클라이언트는 AI 에이전트로 표시됩니다. Revise라는 이름은 기본 제공 에이전트용으로 예약되어 있으므로 해당 이름의 외부 클라이언트는 Revise(외부)로 표시됩니다.

로그인 및 액세스 허용

서버에 대한 모든 요청에는 자격 증명이 필요합니다. 클라이언트가 자격 증명 없이 연결하면 서버는 HTTP 401로 응답하고 Revise 로그인을 안내합니다. 그러면 클라이언트가 브라우저에서 Revise 동의 페이지를 엽니다.

1. 로그인하거나 계정을 만드세요. 로그아웃 상태이면 페이지에 가입 양식이 열립니다.
2. 앱이 수행할 수 있는 작업을 검토한 후 허용을 클릭하세요. 거부는 연결을 취소합니다.
3. Revise가 새 탭에서 시작 문서를 열고 원래 탭은 앱으로 돌아갑니다. 브라우저에서 팝업을 차단하는 경우 revise.io에 대한 팝업을 허용하고 허용을 다시 클릭하세요.

Claude 연결에 대한 동의 페이지

연결은 세 가지 권한을 모두 얻습니다. 에이전트는 승인한 계정에서만 작동합니다.

권한	범위	허용 작업
문서 읽기, 검색 및 내보내기	docs:read	문서 나열, 검색, 읽기 및 내보내기
문서 생성, 편집 및 삭제	docs:write	문서 생성, 가져오기, 편집, 댓글 작성 및 휴지통으로 이동
문서 공동 작업에 사람 초대	docs:share	이메일로 특정 사람 초대

클라이언트는 24시간 동안 유효한 액세스 토큰과 30일 동안 유효한 갱신 토큰을 받습니다. 연결을 끊을 때까지 다시 묻지 않고 토큰을 갱신합니다.

문서 편집 토큰

서버는 문서 편집 토큰(rvse_doc_…)도 허용합니다. 각 토큰은 단일 문서에 대해 읽기 및 편집 도구에서만 작동합니다. 토큰을 보유한 에이전트는 request_account_access를 호출하여 승인 링크를 받을 수 있습니다. 15분 이내에 승인하면 동일한 토큰이 계정 전체 액세스 권한을 얻습니다.

MCP 도구

연결된 에이전트는 24개의 도구를 볼 수 있습니다. 에이전트는 요청에서 도구를 선택하며, 직접 호출하지 않습니다. 각 도구에는 하나의 권한이 필요합니다.

문서 찾기 및 읽기

도구	기능	권한
list_documents	최근 편집 순으로 문서를 나열하고 공유 상태와 날짜를 표시합니다.	읽기
search_documents	모든 문서의 텍스트를 검색합니다. 새 문서나 이름이 변경된 문서는 표시되는 데 몇 초가 걸릴 수 있습니다.	읽기
read_document	문서를 Markdown, HTML 또는 일반 텍스트로 읽습니다. HTML에는 서식, 블록 ID 및 댓글 스레드가 포함됩니다. 보류 중인 제안은 기본적으로 수락된 것으로 읽히거나 요청 시 거부된 것으로 읽힙니다. 긴 문서는 페이지로 나누어 반환됩니다.	읽기
search_within_document	단일 문서 내에서 주변 블록과 함께 일치 항목을 찾습니다. 대소문자를 구분하지 않습니다.	읽기
get_document_outline	섹션별 단어 수가 포함된 제목 개요를 반환합니다.	읽기
get_document_info	제목, 공유 상태, URL, 날짜 및 단어 수를 반환합니다.	읽기
get_recent_changes	에이전트가 마지막으로 확인한 이후 추가, 제거 또는 변경된 블록을 반환하며, 사용자의 편집도 포함합니다. 첫 번째 호출은 기준선을 설정합니다.	읽기

열려 있는 문서 작업

도구	기능	권한
list_open_documents	현재 브라우저 탭에서 열려 있는 문서를 나열합니다.	읽기
get_selection	열려 있는 문서에서 커서 또는 선택한 텍스트를 서식, 댓글 및 제안과 함께 읽습니다. 문서가 브라우저에서 열려 있어야 합니다.	읽기

이를 통해 문서 이름을 지정하지 않고 "내가 선택한 단락"에 대한 변경을 요청할 수 있습니다.

편집 및 서식

도구	기능	권한
edit_document	텍스트와 블록을 제안 또는 직접 적용으로 교체, 삽입 또는 삭제합니다. 에이전트 편집이 표시되는 방식을 참조하세요.	쓰기
style_blocks	다시 작성하지 않고 일치하는 블록이나 텍스트의 글꼴 또는 굵기와 같은 서식을 변경합니다.	쓰기
insert_footnote	구절 뒤에 각주를 추가합니다. 페이지 없는 문서에서는 끝주로 표시됩니다.	쓰기
set_page_layout	페이지 크기, 방향, 여백, 열(1~3개), 페이지 번호, 간격, 페이지 없는 모드 또는 APA 7 사전 설정을 설정합니다. 전체 문서 또는 한 섹션에 적용됩니다.	쓰기
replace_document_content	전체 문서를 새 Markdown으로 교체합니다. 이전 콘텐츠는 개정 기록에 남습니다.	쓰기
rename_document	제목을 변경합니다.	쓰기

댓글 및 제안

도구	기능	권한
leave_comment	구절에 댓글 스레드를 시작하거나 기존 스레드에 답글을 답니다. 텍스트는 변경되지 않습니다.	쓰기
resolve_suggestions	전체 문서 또는 특정 블록에서 에이전트 자신의 보류 중인 제안을 수락하거나 거부합니다.	쓰기
clean_document	보내기 위해 문서를 준비합니다. 댓글 또는 숨은 텍스트를 제거하고, 모든 보류 중인 제안(누구의 것이든)을 수락하거나 거부하고, 작성자를 "작성자"로 변경하고, 파일 속성을 지울 수 있습니다. 실행 취소할 수 없으므로 에이전트가 먼저 사용자에게 묻습니다.	쓰기

생성, 가져오기 및 내보내기

도구	기능	권한
create_document	선택적으로 Markdown에서 문서를 생성합니다.	쓰기
import_document	공개 URL의 파일에서 문서를 생성합니다.	쓰기
upload_document	에이전트 컴퓨터의 파일에서 문서를 생성합니다. 에이전트가 curl 명령을 실행하므로 셸 및 네트워크 액세스가 필요합니다.	쓰기
export_document	Markdown, 일반 텍스트, HTML, Word(.docx) 또는 PDF로 내보냅니다.	읽기

형식 및 제한 사항은 가져오기 및 내보내기를 참조하세요.

공유 및 삭제

도구	기능	권한
invite_collaborator	이메일로 사람을 뷰어, 제안자 또는 편집자로 초대합니다. 에이전트에서 공유를 참조하세요.	공유
delete_document	문서를 휴지통으로 이동합니다. 복원할 수 있습니다.	쓰기

에이전트 편집이 표시되는 방식

기본적으로 edit_document, style_blocks 및 insert_footnote은 각 변경 사항을 제안으로 제안합니다: 추가된 텍스트는 녹색, 제거된 텍스트는 빨간색입니다. 제안 카드에는 에이전트 이름이 표시됩니다. 누군가 수락할 때까지 아무것도 변경되지 않습니다.

Claude의 제안과 편집한 단락 끝에 있는 Claude의 커서

• 20단어 미만의 문서에서는 검토할 내용이 없으므로 편집이 직접 적용됩니다.
• 더 긴 문서에서는 "편집을 직접 적용"하도록 에이전트에게 요청하여 제안을 건너뛸 수 있습니다. 적용된 편집은 에이전트 이름으로 개정 기록에 계속 표시됩니다.
• 에이전트의 커서는 마지막으로 편집한 블록 끝에 있습니다. 커서를 가리키면 에이전트의 로고가 표시됩니다. 에이전트의 마지막 작업 후 5분이 지나면 사라집니다.
• 에이전트가 활성 상태인 동안 문서 제목 옆 헤더에 로고가 표시됩니다.
• 활동이 5분 동안 없으면 헤더에 에이전트 이름과 마지막 편집 시간(예: Claude 5시간 전 활성)이 표시됩니다.

편집기 헤더의 활성 에이전트

문서를 열어 둔 모든 사람이 동일한 제안, 커서 및 헤더 표시를 볼 수 있습니다. 에이전트의 쓰기는 실시간으로 동기화되므로 작업하는 동안 계속 입력할 수 있습니다.

에이전트의 제안 검토

• 제안 카드에서 수락 또는 거부를 클릭하거나 검토 탭에서 하나씩 진행하세요. AI 변경 검토를 참조하세요.
• 에이전트에게 "좋아 보인다" 또는 "그것들 철회해"라고 말하세요. 에이전트는 resolve_suggestions로 자신의 제안을 수락하거나 거부합니다. 사용자의 제안, 협력자의 제안 또는 다른 에이전트의 제안은 해결할 수 없습니다.

기본 제공 에이전트의 채팅에서 모두 수락 및 모두 거부는 외부 에이전트의 제안을 건너뜁니다.

가져오기 및 내보내기

에이전트는 도구로 가져오기 및 내보내기를 수행합니다. 편집기에서 가져오기와 비교하는 방법은 외부 에이전트로 가져오기 및 내보내기를 참조하세요.

작업	형식	제한
URL에서 가져오기	.docx, .md, .markdown, .txt, .html, .htm, .rtf, .odt	25MB. URL은 공개 직접 다운로드여야 합니다. 공유 페이지(예: Google Drive 미리보기) 및 AI 앱 내부에 저장된 파일은 작동하지 않습니다.
로컬 파일 업로드	가져오기와 동일	25MB. 업로드 링크는 10분 후 만료됩니다.
내보내기	Markdown, 일반 텍스트, HTML, Word, PDF	Markdown은 대화에서 반환됩니다. 기타 형식은 약 24시간 후 만료되는 다운로드 링크를 반환합니다.

PDF 및 이미지는 MCP를 통해 가져올 수 없습니다. 에이전트가 파일에 도달할 수 없으면 revise.io/docs/upload로 안내하여 직접 업로드하고 문서 링크를 다시 붙여넣도록 합니다. 대용량 내보내기는 Revise 링크를 대신 반환할 수 있습니다. 링크를 열면 브라우저에서 파일이 다운로드됩니다.

에이전트에서 공유

에이전트는 invite_collaborator으로 특정 사람을 초대할 수 있습니다. 역할은 공유 대화상자와 일치합니다(역할 참조):

에이전트가 요청하는 것	역할
read	뷰어
suggest	제안자
write	편집자

Revise 계정이 있는 사람은 즉시 액세스 권한을 얻습니다. 다른 사람은 이메일 초대를 받습니다. 에이전트는 공개 액세스를 켜거나 문서를 공개할 수 없습니다. 공유 대화상자에서 사용자만 할 수 있습니다.

연결된 앱 관리 및 연결 끊기

설정을 열고 외부 에이전트로 이동하세요. 각 연결된 앱에는 연결된 시기와 마지막 활성 시기가 표시됩니다.

Claude가 연결된 설정의 외부 에이전트

1. 앱 옆의 연결 끊기를 클릭하세요.
2. 앱 연결 끊기?에서 삭제를 클릭하세요.

앱은 더 이상 액세스를 갱신할 수 없습니다. 이미 보유한 토큰은 만료될 때까지 최대 24시간 동안 계속 작동합니다. 다시 연결하려면 앱을 다시 연결하고 로그인하세요.

속도 제한 및 요구 사항

항목	제한 또는 요구사항
계정	필수. 무료를 포함한 모든 요금제.
도구 호출	시간당 1,500회
문서 변경 또는 공유 호출	시간당 600회, 1,500회에 포함
문서 크기	저장된 문서 데이터 5MiB. 더 큰 문서는 편집기에서 열리지만 MCP를 통해서는 열리지 않습니다.
가져오기 및 업로드 크기	파일당 25MB
AI 사용량	Revise 사용 한도에 계산되지 않습니다. AI 앱 자체 한도가 적용됩니다.

속도 제한은 1시간 단위의 이동 창을 사용합니다. 한 계정의 모든 OAuth 앱은 동일한 제한을 공유합니다. 더 높은 한도가 필요하면 support@revise.io로 이메일을 보내세요.

문제 해결

문제	해결 방법
앱이 계속 로그인을 요청함	앱에서 연결을 제거하고 다시 추가한 후 허용을 클릭하세요.
허용을 클릭해도 아무 일도 일어나지 않음	revise.io에 대한 팝업을 허용한 후 다시 허용을 클릭하세요.
"속도 제한 초과"	시간 창이 지나기를 기다리거나 support@revise.io로 이메일을 보내세요.
"문서가 MCP 크기 제한 5MiB를 초과합니다"	편집기에서 문서를 열거나 더 작은 문서로 분할하세요. 다시 시도해도 도움이 되지 않습니다.
에이전트가 첨부한 파일을 가져올 수 없음	revise.io/docs/upload에 업로드하고 에이전트에게 문서 링크를 제공하세요.
에이전트의 편집 내용이 문서 텍스트에 없음	보류 중인 제안입니다. 수락하거나 에이전트에게 요청하세요.
에이전트가 방금 만든 문서를 찾을 수 없음	검색 색인 생성에 몇 초가 걸립니다. 대신 문서 목록을 요청하세요.
연결을 끊은 앱이 여전히 작동함	현재 토큰은 24시간 내에 만료됩니다.

참고: 에이전트는 이 페이지를 MCP 리소스 revise-mcp-docs로 Markdown에서 읽을 수 있습니다.