メインコンテンツへスキップ

制限

制限はアカウント単位で、そのアカウントのすべての 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 は、そのツールを再び実行できるまでの秒数です:
達した制限が 1 分あたりのツール呼び出し枠の場合は、すべてのツールが待機します。それ以外の場合は、そのツールだけが待機します。待ち時間が終わる前に同じツールをもう一度呼び出すと TOOL_EXECUTION_FAILED が返されます。これはクライアントに停止を伝えるものです。数分待つか、ダッシュボードを使ってください。

エラー

HTTP エラー

これらはリクエストの HTTP ステータスとして、code を含む JSON ボディとともに返されます。

接続時

ツールの結果

これらはツールの結果の中で、クライアントが読む summary と並んで code として返されます。 キーで使えないツールや存在しないツールを呼び出すと、JSON-RPC エラー -32602 Unknown tool が返されます。キーのスコープを確認してください。その他のコードはツール自体から返され、summary で説明されます。