読み取りアクセスから開始
カタログ、ロケーション、ステータスの確認は、限られた初期ツールセットとして構成できます。クライアントは、リソースの作成・キャンセル・資金供給の権限を得る前に、何がサポートされているかを把握できるべきです。
付随するアクションを分離する
サーバーのキャンセル、再インストール、支払いの操作には、明示的なスコープと理解しやすい確認が必要です。ツールの説明にはその効果を記載し、サーバーはクライアントの適切な動作を信頼するのではなく、認可を強制しなければなりません。
不確実な結果への対処
操作識別子と読みやすいエラーを返してください。再試行が追加のリソースや支払いを生む可能性がある場合は、冪等性を使用します。ツールの応答やログにシークレットを含めずに結果を記録します。
リリース情報は事実でなければなりません
ローンチには、検証済みのエンドポイント、認証手順、サポートされるプロトコルバージョン、文書化された制限が必要です。借用したエンドポイント、偽のSDKリリース、ダウンロードリンクはここでは提供しません。
ツールの説明と実行権限を分離する
MCP サーバーはカタログと管理ツールを記述できますが、クライアントが実行できる呼び出しは認証済みアカウントが決定します。create_server というツールにはサーバー権限と有効な注文判断が必要です。read_catalogue ツールには、キャンセルや請求の権限を持つ認証情報を要求すべきではありません。
インフラストラクチャエージェント向けの便利なツールグループ
想定される設計は、プランや画像の閲覧、注文や操作の確認、SSH公開鍵の管理、サーバー状態の監視を対象としています。サービスの作成や解約、支払いの開始は結果を伴う操作であり、適切な権限が必要です。クライアントが推測しなければならない文章ではなく、構造化された識別子と明確な終了状態を返します。
通信と認証は文書化する必要があります
将来のリモートエンドポイントにはHTTPS、サポートされるトランスポート、および明示的なトークン機構が必要です。認証情報は承認された認証チャネルに置くべきであり、公開設定例に含めるべきではありません。OAuth登録、プロトコルバージョン、ダウンロード可能なstdioパッケージ、互換性バッジは、KoalaVPSがそれらを実装し検証した後にのみ公開してください。
再試行は同じ操作に戻らなければなりません
サーバーがリクエストを受け入れた後に、エージェントが接続を失うことがあります。有料アクションを再試行する前に、操作または冪等性の識別子を永続化してください。不確実な応答の後はステータスを再読み取りしてください。タイムアウトやメッセージの欠落は、元のアクションが失敗したことを証明するものではありません。
ホスト型KoalaVPS MCPエンドポイントはここに接続されていません
このページは計画中の統合について説明しています。エージェントの登録、サーバーパッケージのインストール、認証情報の提供、稼働中の管理ツールへの接続は行いません。導入ガイドでは、お客様がVPS上で独自のMCPアプリケーションをホストする方法を説明しています。これらのアプリケーションはKoalaVPSコントロールプレーンサービスとは別のものです。
もう少し明確に。
このページ自体はMCPプロトコルのエンドポイントですか？
いいえ。これは説明用のWebページです。将来のマシンエンドポイントは、別途実装・文書化・認証される必要があります。
AIエージェントは接続するだけで支出の許可を得ますか？
いいえ。ツールの検出と認証は、要求されたアクションに対するアカウントスコープ、請求確認、承認ルールの代わりにはなりません。