ファイルアップロードの注意

最終更新: 2026-08-16

フラクソンのMCPツールでは、許可された範囲でkintoneの添付ファイルを追加できます。ただし、MCPの基本的なツール呼び出しはJSON-RPCメッセージで行われ、ツール入力もJSON Schemaで定義されるため、ブラウザのフォームアップロードのように任意のバイナリファイルをそのままツール引数へ流し込む方式ではありません。

推奨環境

MCP仕様上の制約

MCPは、生成AIクライアントとMCPサーバーの間でJSON-RPCメッセージをやり取りする仕様です。MCPツールは、名前、説明、入力スキーマを持ち、実行時には tools/call の arguments としてJSONオブジェクトを受け取ります。

そのため、ツール入力として扱えるのは基本的にJSONで表現できる値です。PDF、画像、Excelファイルのようなバイナリ本文をそのままツール引数に入れることはできず、入れる場合はBase64のような文字列へ変換する必要があります。

なお、MCPコミュニティではファイル入力を標準的に扱うための検討が進んでいますが、現時点ではクライアントごとの対応差があります。フラクソンでは、可能な環境では短命のアップロード先を発行し、ファイル本文を *.gusuku.io へ直接送信する方式を優先します。

Base64チャンク送信で起きること

推奨環境を使えない場合、ファイル本文はBase64文字列に変換され、さらに小さなチャンクに分割して複数回のMCPツール呼び出しで送信されることがあります。この方式は互換性のための代替手段ですが、次の負荷があります。

• データ量が増えます。 Base64化により、元ファイルより文字列サイズが約33%増えます。
• トークン使用量が増えます。 Base64は自然文ではないため、生成AIクライアント側で多くのトークンを消費しやすくなります。
• 送信に時間がかかります。 チャンクごとにMCPツール呼び出しが必要になり、ファイルサイズが大きいほど往復回数が増えます。
• 途中失敗の影響を受けやすくなります。 ネットワーク切断、クライアントのタイムアウト、会話の中断があると、最初からやり直しになる場合があります。
• 会話全体が重くなります。 チャンク送信が続くと、生成AIクライアント側の処理量が増え、通常の検索や集計より待ち時間が長くなります。

利用者向けの判断基準

管理者・情シス向け確認

• Claude Web版で利用する場合、必要に応じて *.gusuku.io への外部接続を許可してください。
• 社内プロキシ、DLP、CASB、ブラウザ拡張などが生成AIクライアントからのアップロード通信を遮断していないか確認してください。
• ファイル操作を許可するユーザー、アプリ、添付フィールドを限定し、監査ログで利用状況を確認してください。
• 大容量ファイルの常用が必要な業務では、ファイルの圧縮、分割、kintone側の運用ルールも含めて設計してください。

生成AIへの依頼例

添付ファイルを追加したいです。
対象アプリ、対象レコード、添付先フィールドを確認してください。
ファイルアップロードは推奨経路を使ってください。
Base64チャンク送信が必要になりそうな場合は、実行前に時間とトークン使用量が増えることを知らせてください。

関連ページ

• MCPツール一覧とプロンプトサンプル
• 制限値・上限まとめ
• 変更系操作を許可する前に
• セキュリティ概要

参考

• MCP公式仕様: Overview
• MCP公式仕様: Tools
• MCP公式仕様: Transports
• MCP File Uploads Working Group Charter