制限
制限はアカウント単位で、そのアカウントのすべての MCP 接続で共有されます。- MCP サーバーへのリクエスト: 1 分あたり 60 回まで。プランの API レート制限のほうが低い場合は、その値までです。API 呼び出しとは別にカウントされるため、活発なエージェントが CLI、SDK、ボットをブロックすることはありません。超えた場合や、アカウントが API の制限を超えている間は、MCP サーバーが
429 RATE_LIMITEDを返します。 - ツールの呼び出し: プランに応じて増える 1 分あたりの呼び出し枠があります。
- アプリケーションの中やエッジネットワークで動作するツール(ファイル、ログ、メトリクス、ネットワーク分析、スナップショット、データベース、削除)には、さらに個別の、より厳しい制限があります。
- すべてのツール呼び出しがカウントされます。 リソースや、引数によって決まるスコープ(
set_env_varsのrestartなど)で拒否された呼び出しも含みます。 - コミットには、API、CLI、ダッシュボードと共通の、アカウントごととアプリケーションごとのペースがあります。早すぎるコミットには
RATE_LIMITEDが返されます。
TOOL_RATE_LIMITED を返します。
zip とファイル
- zip:
upload_applicationとcommit_applicationは、base64 で送る最大 1 MB の zip を受け付けます。展開後のサイズは最大 100 MB です。ダッシュボードと CLI は最大 100 MB の zip を受け付けるので、より大きなプロジェクトにはそちらを使ってください。 - ファイル:
commit_applicationは最大 50 個のテキストファイルを受け付けます。1 ファイルあたり最大 128 KB、合計で最大 512 KB です。隠しファイル、.envファイル、秘密鍵、設定ファイルは送れません。設定ファイルはedit_config_fileで変更します。
TOOL_RATE_LIMITED
制限を超えたツールは実行されません。返されるのは HTTP エラーではなくisError: true が付いた通常のツール結果なので、接続はそのまま使えます。retry_after_seconds は、そのツールを再び実行できるまでの秒数です:
TOOL_EXECUTION_FAILED が返されます。これはクライアントに停止を伝えるものです。数分待つか、ダッシュボードを使ってください。
エラー
HTTP エラー
これらはリクエストの HTTP ステータスとして、code を含む JSON ボディとともに返されます。
接続時
ツールの結果
これらはツールの結果の中で、クライアントが読むsummary と並んで code として返されます。
キーで使えないツールや存在しないツールを呼び出すと、JSON-RPC エラー
-32602 Unknown tool が返されます。キーのスコープを確認してください。その他のコードはツール自体から返され、summary で説明されます。
