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