Cloud MCP ファイル継続読み取りリファレンス

正しいオフセットと保存済みファイルのバージョンを使用して、ファイルをチャンクで読み取ります。

顧客向け Cloud MCP は保存済みファイルをチャンクで返します。

継続読み取りのフィールド

フィールド	意味
`encoding`	既定は `utf-8` です。`base64` を明示的に指定することもできます。
`content`	このチャンクのテキストまたは base64 エンコードされたバイトです。
`offset`	このチャンクの開始位置です。
`nextOffset`	次のリクエストの `offset` です。`null` は完了を示します。
`version`	保存済みファイル全体のバイト列の SHA-256 です。
`byteLength`	保存済みファイル全体のサイズです。単位はバイトです。
`manifestVersion`	ワークスペースの世代を含む、保存済みファイルのマニフェストバージョンです。

エンコーディングとオフセット

エンコーディング	チャンクと継続読み取りの単位
`utf-8`	チャンクあたり最大 16384 UTF-16 コード単位です。オフセットは UTF-16 コード単位で数えます。テキストチャンクを順番に結合してください。
`base64`	チャンクあたり最大 16384 元バイトです。オフセットはデコード後のバイトで数えます。各チャンクをデコードし、バイト列を順番に結合してください。

offset: 0 から開始し、同じプロジェクト、パス、エンコーディングを維持してください。null になるまで nextOffset に従ってください。version と manifestVersion を最初の応答と比較してください。いずれかが変わった場合は、読み取り中にファイルが変更された場合に従ってください。

保存済みファイルのサイズ

ファイルとエンコーディング	受け付けられるファイル全体のサイズ
通常のファイル、すべての `utf-8` 読み取り	最大 1 MiB。
`base64`: `alcad/documents/fab-scene/<name>.alcad-fab-scene.json`	最大 4 MiB。
`base64`: `.gds` および `.gdsii` ファイル	最大 4 MiB。
`base64`: `rtl/schematic/results/<sha256>.json`	最大 2 MiB。
`base64`: `evolve/analysis/results/<sha256>.json`, `alcad/circuit/rlc/results/<sha256>.json`, `alcad/circuit/digital/results/<sha256>.json`	最大 8 MiB。

altifigence.workspace.files.list が返すパスを使用してください。ツールがファイルにはバイナリエンコーディングが必要だと伝えた場合は、encoding: "base64" を指定して offset: 0 からファイルの読み取りを再開してください。

セットアップについては、MCP への接続を参照してください。