iSomor

让你的 Agent 接入 iSomor

选好 Agent,复制下面这段话,粘贴到对话里。让它接入 iSomor,帮你翻译 PDF、还原版式、获取双语文件。

复制给 Agent,接入交给它。

Agent 负责配置。需要登录和授权时,你按提示完成即可。

选择你用的 Agent

粘贴到 Agent 对话中,不是终端。复制不会自动连接账号。

手动配置与详细说明

客户端需支持远程 Streamable HTTP 和 OAuth(PKCE S256)。凭证由客户端保管,不粘贴到聊天中。在浏览器登录后返回授权页继续;新工具未加载时重新打开 Agent 会话。授权过期或切换账号时重新授权。撤销后停止后续访问,已提交的翻译仍会继续处理。

先检查现有 MCP 配置;相同地址的 isomor 连接可以复用,不要覆盖其他配置或同名的不同服务。

https://tryisomor.com/api/isomor/mcp

Codex

如果可以使用 Codex CLI,用下面的命令添加服务,再运行 codex mcp login isomor。没有 CLI 时,使用应用内 MCP 设置或告诉我最短的手动操作。

codex mcp add isomor --url https://tryisomor.com/api/isomor/mcp
codex mcp login isomor

客户端官方说明 · Codex

Claude Code

如果可以使用 Claude Code CLI,用下面的命令添加服务,再引导我在 Claude Code 中打开 /mcp,选择 isomor 完成授权。/mcp 不是终端命令。

claude mcp add --transport http --scope user isomor https://tryisomor.com/api/isomor/mcp

客户端官方说明 · Claude Code

Cursor

将下面的 JSON 合并到用户级 ~/.cursor/mcp.json,保留其他配置;再引导我在 Cursor 的 MCP 设置中为 iSomor 授权。

{
  "mcpServers": {
    "isomor": {
      "url": "https://tryisomor.com/api/isomor/mcp"
    }
  }
}

客户端官方说明 · Cursor

工具与调用参数

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 时,先处理错误再重试。

授权与连接管理

客户端需支持远程 Streamable HTTP 和 OAuth(PKCE S256)。凭证由客户端保管,不粘贴到聊天中。在浏览器登录后返回授权页继续;新工具未加载时重新打开 Agent 会话。授权过期或切换账号时重新授权。撤销后停止后续访问,已提交的翻译仍会继续处理。

已经登录网站了?

登录网站不会自动建立 Agent 连接。连接管理页显示你已授权的客户端,不是工具目录。

一个账号,一份额度

MCP 与网页翻译共用账号额度,无需 API Key,也不另发试用额度。Agent 应先估算消耗,经你确认后再翻译;额度不足时停止新任务。

支持文字 PDF

请先在 iSomor 上传 PDF。本地路径或聊天附件不等于已上传文件。支持译文与双语 PDF,尽量保留原文版式;暂不支持扫描件和 OCR。

隐私与结果核对

文档文字将发送至 Google Gemini 翻译。私有存储和限时链接不等于零留存;请对照原文核验人名、数字、表格和版式。

管理已授权的连接
让你的 Agent 接入 iSomor · iSomor