讓你的 Agent 接入 iSomor
選好 Agent，複製下方訊息，貼到對話中。讓它接入 iSomor，翻譯 PDF、保留版面並取得雙語檔案。
複製給 Agent，讓它完成設定。
Agent 負責設定。需要登入與授權時，由你依提示完成。
請貼到 Agent 對話中，而非終端機。複製不會自動連接帳號。
手動設定與詳細說明
用戶端須支援遠端 Streamable HTTP 與 OAuth（PKCE S256）。憑證由用戶端保管，不貼到聊天中。在瀏覽器登入後返回授權頁繼續；工具尚未載入時重新開啟 Agent 對話。授權到期或切換帳號須重新授權。撤銷後停止後續存取，已提交的翻譯仍會繼續。
先檢查現有 MCP 設定；可沿用相同位址的 isomor 連接，不要覆蓋其他設定或同名的不同服務。
https://tryisomor.com/api/isomor/mcpCodex
若可使用 Codex CLI，以下列命令加入服務，再執行 codex mcp login isomor。沒有 CLI 時，使用應用程式的 MCP 設定或告訴我最短的手動步驟。
codex mcp add isomor --url https://tryisomor.com/api/isomor/mcp
codex mcp login isomorClaude Code
若可使用 Claude Code CLI，以下列命令加入服務，再引導我在 Claude Code 開啟 /mcp，選取 isomor 完成授權。/mcp 不是終端機命令。
claude mcp add --transport http --scope user isomor https://tryisomor.com/api/isomor/mcpCursor
將下列 JSON 合併至使用者層級的 ~/.cursor/mcp.json，保留其他設定；再引導我在 Cursor 的 MCP 設定中為 iSomor 授權。
{
"mcpServers": {
"isomor": {
"url": "https://tryisomor.com/api/isomor/mcp"
}
}
}工具與呼叫參數
Agent 透過 tools/list 讀取實際參數定義。documents:read 用於唯讀操作；提交翻譯另需 translations:write 權限。
get_capabilities- 查詢語言、格式與限制
list_files- 查詢本人最近 20 個可見 PDF 與檔案 ID
get_quota- 查詢帳號剩餘額度
estimate_translation- 預估頁數用量，不預扣額度
create_translation- 使用者確認後提交翻譯並預扣額度
get_translation- 查詢同一工作的處理狀態
get_translation_results- 取得譯文與雙語 PDF 的限時連結
翻譯參數說明
file_id 取自 list_files。target_language：en / zh；source_language：auto（預設）、en / zh。pages 從 1 起算，例如 1-3,5；省略即全文。output_formats：translated / bilingual，預設兩者。每頁 1 個額度，每份檔案最多 10 MiB、20 頁。先呼叫 estimate_translation，取得使用者確認後才以 confirmed: true 提交 create_translation。重試沿用 idempotency_key 與原參數；查詢工作與結果需 job_id。輪詢間隔至少 5 秒，下載連結有效 15 分鐘；每帳號每分鐘最多 30 次 MCP 請求。遇到 isError 時先處理錯誤再重試。