Revise
官方可與你的代理協作使用的文字處理器
你可以用 Revise MCP 做什麼？
-
尋找並閱讀文件 — 請您的助理列出、搜尋或閱讀您的 Revise 文件，包括大綱和最近的變更，透過
list_documents、search_documents、read_document及相關工具。 -
編輯和格式化內容 — 請您的助理提出或套用編輯、設定區塊樣式、插入註腳，或調整頁面版面，使用
edit_document、style_blocks、insert_footnote和set_page_layout。 -
留言與審閱建議 — 指示您的助理留下評論、接受或拒絕其自身的待處理建議，或清理文件以供分享，使用
leave_comment、resolve_suggestions和clean_document。 -
建立、匯入和匯出 — 請您的助理從 Markdown 建立文件、從 URL 或本機檔案匯入，或匯出為 Word 或 PDF 等格式，使用
create_document、import_document、upload_document和export_document。 -
分享和管理文件 — 指示您的助理透過電子郵件邀請協作者，或將文件移至垃圾桶，使用
invite_collaborator和delete_document。
文件
Revise MCP 伺服器可將外部 AI 應用程式連接到您的 Revise 帳戶。Claude、ChatGPT 及其他 MCP 用戶端可以建立、讀取、編輯、留言、匯出及分享您的文件。代理的編輯會以建議的形式出現在代理名稱之下，而您可以在 Revise 編輯器 中接受或拒絕這些建議。
MCP 伺服器在所有方案中皆免費。它沒有依方案設定的上限，只有每小時的速率限制。您需要一個 Revise 帳戶，而 AI 應用程式使用自己的模型和訂閱。
伺服器 URL
https://mcp.revise.io/mcp
此伺服器使用可串流 HTTP 傳輸。將此 URL 新增至任何支援遠端伺服器的 MCP 用戶端。在您連接應用程式之前，設定中的外部代理下方會顯示相同的 URL。
連接 Claude
Revise 已列在 Claude 連接器目錄 中。
- 在 Claude 中開啟 Revise 的列表並連接它。
- 登入 Revise 並按一下允許。請參閱登入並允許存取。
- 要求 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 中的應用程式 使用。
- 在 ChatGPT 中開啟 Revise 應用程式並連接它。
- 登入 Revise 並按一下允許。
- 要求 ChatGPT 處理 Revise 文件。
文件會直接在您的對話視窗中開啟。請參閱在 ChatGPT 中編輯文件以了解如何使用 Revise 外掛程式。
連接其他 MCP 用戶端
Codex、Hermes、OpenClaw 及其他 MCP 用戶端可透過伺服器 URL 連接。用戶端必須支援 OAuth 登入。Revise 支援動態用戶端註冊和 PKCE，因此用戶端不需要預先設定的用戶端 ID。
用戶端註冊的名稱會成為 Revise 中代理的名稱。它會顯示在代理的建議、留言和游標上。沒有可用名稱的用戶端會顯示為 AI 代理。名稱 Revise 保留給內建代理，因此具有該名稱的外部用戶端會顯示為 Revise (外部)。
登入並允許存取
對伺服器的每個請求都需要憑證。當用戶端在沒有憑證的情況下連接時，伺服器會以 HTTP 401 回應，並將其導向 Revise 登入頁面。然後用戶端會在您的瀏覽器中開啟 Revise 同意頁面。
- 登入或建立帳戶。如果您已登出，頁面會開啟註冊表單。
- 檢閱應用程式將能執行的操作，然後按一下允許。拒絕會取消連接。
- 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 | 設定頁面大小、方向、邊界、欄數（一至三欄）、頁碼、間距、無分頁模式或 APA 7 預設。適用於整份文件或單一區段。 | 寫入 |
replace_document_content | 以新的 Markdown 取代整份文件。舊內容會保留在修訂歷史記錄中。 | 寫入 |
rename_document | 變更標題。 | 寫入 |
留言及建議
| 工具 | 功能 | 權限 |
|---|---|---|
leave_comment | 在段落上開始留言串，或回覆現有留言串。不會變更文字。 | 寫入 |
resolve_suggestions | 接受或拒絕代理自己的待處理建議，可套用於整份文件或特定區塊。 | 寫入 |
clean_document | 準備文件以供傳送。它可以移除留言或隱藏文字、接受或拒絕所有待處理建議（任何人的）、將作者重新命名為「作者」，並清除檔案屬性。此操作無法復原，因此代理會先詢問您。 | 寫入 |
建立、匯入及匯出
| 工具 | 功能 | 權限 |
|---|---|---|
create_document | 建立文件，可選擇從 Markdown 建立。 | 寫入 |
open_document | 在支援的應用程式（ChatGPT、claude.ai）中，以可編輯檢視在對話中顯示文件。 | 讀取 |
import_document | 從公開 URL 的檔案建立文件。 | 寫入 |
upload_document | 從代理電腦上的檔案建立文件。代理會執行 curl 命令，因此需要 shell 和網路存取權。 | 寫入 |
export_document | 匯出為 Markdown、純文字、HTML、Word (.docx) 或 PDF。 | 讀取 |
請參閱匯入及匯出以了解格式和限制。
分享及刪除
| 工具 | 功能 | 權限 |
|---|---|---|
invite_collaborator | 以檢視者、建議者或編輯者身分，透過電子郵件邀請人員。請參閱從代理分享。 | 分享 |
delete_document | 將文件移至垃圾桶。您可以還原它。 | 寫入 |
代理編輯的顯示方式
依預設，edit_document、style_blocks 和 insert_footnote 會將每個變更提議為建議：新增的文字以綠色顯示，移除的文字以紅色顯示。建議卡片會標示代理名稱。在有人接受之前，不會有任何變更。
建議的單字取代，卡片顯示 Claude、接受和拒絕，且 Claude 的游標位於段落結尾
- 在少於 20 個字的文件上，編輯會直接套用，因為沒有內容需要檢閱。
- 在較長的文件上，要求代理「直接套用編輯」以略過建議。已套用的編輯仍會以代理名稱顯示在修訂歷史記錄中。
- 代理的游標位於其最後編輯的區塊結尾。將滑鼠懸停在其上可查看代理的標誌。它會在代理最後一次操作後 5 分鐘消失。
- 當代理處於啟用狀態時，其標誌會顯示在文件標題旁的頁首中。
- 在 5 分鐘沒有活動後，頁首會顯示代理名稱及其最後編輯時間，例如 Claude 5 小時前啟用。
Claude 的標誌位於文件標題旁，工具提示顯示 Claude 正在此文件中工作
所有開啟文件的人都會看到相同的建議、游標和頁首指示器。代理的寫入會即時同步，因此您可以在其工作時繼續輸入。
檢閱代理的建議
- 按一下建議卡片上的接受或拒絕，或在檢閱分頁中逐一檢視。請參閱檢閱 AI 變更。
- 告訴代理「看起來不錯」或「撤回那些」。它會使用
resolve_suggestions接受或拒絕自己的建議。它無法解決您的建議、協作者的建議或其他代理的建議。
內建代理聊天中的全部接受和全部拒絕會略過外部代理的建議。
匯入及匯出
代理使用工具進行匯入和匯出。若要了解這與在編輯器中匯入的比較，請參閱使用外部代理匯入及匯出。
| 動作 | 格式 | 限制 |
|---|---|---|
| 從 URL 匯入 | .docx、.md、.markdown、.txt、.html、.htm、.rtf、.odt | 25 MB。URL 必須是公開的直接下載連結。分享頁面（例如 Google Drive 預覽）和儲存在 AI 應用程式內的檔案無法使用。 |
| 上傳本機檔案 | 與匯入相同 | 25 MB。上傳連結會在 10 分鐘後過期。 |
| 匯出 | Markdown、純文字、HTML、Word、PDF | Markdown 會在對話中回傳。其他格式會回傳下載連結，約在 24 小時後過期。 |
PDF 和圖片無法透過 MCP 匯入。如果代理無法存取您的檔案，它會將您導向 revise.io/docs/upload，讓您自行上傳並將文件連結貼回。大型匯出可能會回傳 Revise 連結；開啟它會在您的瀏覽器中下載檔案。
從代理分享
代理可以使用 invite_collaborator 邀請特定人員。角色與分享對話方塊相符（請參閱角色）：
| 代理要求的 | 角色 |
|---|---|
read | 檢視者 |
suggest | 建議者 |
write | 編輯者 |
擁有 Revise 帳戶的人會立即獲得存取權。其他人會收到電子郵件邀請。代理無法開啟公開存取或將文件設為公開。只有您可以從分享對話方塊中執行此操作。
管理及中斷連接已連接的應用程式
開啟設定並前往外部代理。每個已連接的應用程式都會顯示其連接時間和最後活動時間。
設定、外部代理區段，包含 Connect with ChatGPT 按鈕和已連接的 Claude 應用程式及中斷連接按鈕
- 按一下應用程式旁的中斷連接。
- 在中斷連接應用程式？中，按一下刪除。
應用程式將無法再更新其存取權。它已持有的權杖會持續運作直到過期，最長 24 小時。若要重新連接，請再次連接應用程式並登入。
速率限制及需求
| 項目 | 限制或要求 |
|---|---|
| 帳戶 | 必填。任何方案皆可，包括免費方案。 |
| 工具呼叫 | 每小時 1,500 次 |
| 變更文件或分享的呼叫 | 每小時 600 次，計入 1,500 次內 |
| 文件大小 | 5 MiB 的已儲存文件資料。較大的文件可在編輯器中開啟，但無法透過 MCP 使用。 |
| 匯入與上傳大小 | 每個檔案 25 MB |
| AI 使用量 | 不計入您的 Revise 使用限制。AI 應用程式自身的限制仍適用。 |
速率限制採用滾動式一小時視窗。同一帳戶上的所有 OAuth 應用程式共用相同的限制。如需更高的限制，請寄送電子郵件至 support@revise.io。
疑難排解
| 問題 | 修正方式 |
|---|---|
| 應用程式一直要求您登入 | 在應用程式中移除連線，重新加入，然後按一下 允許。 |
| 按一下允許後沒有任何反應 | 允許 revise.io 的彈出視窗，然後再次按一下 允許。 |
| 「超出速率限制」 | 等待一小時視窗結束，或寄送電子郵件至 support@revise.io。 |
| 「文件超過 MCP 大小限制 5 MiB」 | 在 Revise 網頁編輯器中開啟文件，並使用其內建的 AI 代理程式，該代理程式可處理長文件。重試沒有幫助。 |
| 代理程式無法匯入您附加的檔案 | 在 revise.io/docs/upload 上傳檔案，並提供代理程式文件連結。 |
| 代理程式的編輯未出現在文件文字中 | 這些是待處理的建議。請接受它們，或要求代理程式接受。 |
| 代理程式找不到您剛建立的文件 | 搜尋索引需要幾秒鐘。請改為要求它列出您的文件。 |
| 您已斷線的應用程式仍可運作 | 其目前的權杖將在 24 小時內過期。 |