Agent を iSomor に接続する

手動設定と詳細

リモート Streamable HTTP と OAuth（PKCE S256）対応のクライアントが必要です。認証情報はクライアントに管理させ、チャットには貼り付けません。ブラウザーでログイン後、認可ページに戻って続行します。ツールが表示されない場合は Agent の会話を開き直してください。期限切れやアカウント変更時は再認可が必要です。許可の取り消しは今後のアクセスを止めますが、送信済み翻訳は継続します。

まず既存の MCP 設定を確認し、同じ URL の isomor 接続は再利用してください。他の設定や、同名でも別のサービスは上書きしないでください。

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

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

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

{
  "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 ページ 1 クレジット、1 ファイル最大 10 MiB・20 ページ。estimate_translation 後に利用者の確認を得て、confirmed: true で create_translation を実行します。再試行では同じ idempotency_key と引数を使用します。進捗と結果には job_id が必要です。確認間隔は 5 秒以上、リンクは 15 分間有効。1 アカウントにつき毎分 30 回まで。isError の原因を解消してから再試行してください。

認可と接続管理

リモート Streamable HTTP と OAuth（PKCE S256）対応のクライアントが必要です。認証情報はクライアントに管理させ、チャットには貼り付けません。ブラウザーでログイン後、認可ページに戻って続行します。ツールが表示されない場合は Agent の会話を開き直してください。期限切れやアカウント変更時は再認可が必要です。許可の取り消しは今後のアクセスを止めますが、送信済み翻訳は継続します。