Cloady

@cloady/mcp

Cloady 用のローカル MCP サーバーです。AI アシスタントから Cloady API 全体をツールとして利用できます。ワークスペース、アプリ、デプロイ、環境変数、ドメイン、ボリューム、メンバー、インテグレーション、請求、サポートチケットに対応しています。

Cloady の OpenAPI コントラクトから生成されるため、各 REST 操作はその operation id（listVars、createVar、deployApp、execCommand）を名前とするツールになります。stdio 経由で動作し、API トークンを使って https://cloady.com を呼び出します。

セットアップ

OAuth ベースの Claude プラグインについては、Cloady for Claude をご覧ください。npm サーバーのインストールや API トークンのコピーをせずに、ホストされた MCP エンドポイントへ接続できます。

Gemini CLI 拡張機能

このリポジトリから拡張機能をインストールします。

gemini extensions install https://github.com/Cloady/cloady-mcp

Gemini CLI を開き、/mcp auth cloady を実行して、OAuth 経由で Cloady にサインインします。必要なアカウント認証を完了し、タスクに必要な最小限のスコープ（read、deploy、full）を選択してください。この拡張機能に API キーやローカル npm サーバーは不要です。

「Cloady のワークスペースと稼働中のアプリを一覧表示して」、「アプリのビルドログから最新のデプロイ失敗について説明して」、「何かを作成する前に、利用可能なデータベーステンプレートと料金を表示して」などと試してみてください。

この拡張機能はツールの引数を https://cloady.com/api/mcp に送信し、許可された結果を Gemini に返します。要求するツールに応じて、アカウントやワークスペースのメタデータ、アプリケーションの設定、コード、ログ、メトリクス、データベースの内容、サポートメッセージが含まれることがあります。Google は受け取った結果を独自のポリシーに基づいて取り扱います。Cloady による取り扱い、保持、削除については、プライバシーポリシーで説明しています。アカウントレベルの接続は、スコープとワークスペースのロールに応じて、そのアカウントが所属するすべてのワークスペースを対象にできます。今後のリクエストを停止するには、Cloady Account → API tokens でトークンを失効させてください。トークンを失効させても、ホストされたデータや Gemini がすでに受け取ったコピーは削除されません。

変更を承認する前に、対象のワークスペース、アプリ、環境、リージョン、および発生する料金を確認してください。書き込みツールはリソースを変更または削除できます。拡張機能は無料です。ホストされたリソースには Cloady の料金が適用されます。サポートおよび削除のご依頼先：[email protected]。

Gemini 拡張機能と Claude プラグインは、ローカル npm パッケージとは別にバージョン管理されています。

Qwen Code

Qwen Code は Gemini CLI 拡張機能に対応しており、インストール時にそのマニフェストを変換します。

qwen extensions install https://github.com/Cloady/cloady-mcp

クライアントで Cloady の OAuth 接続を使用してください。上記と同じアカウント権限、データの取り扱い、ホスティング料金が適用されます。Qwen Code の拡張機能ドキュメントをご覧ください。

ローカル stdio パッケージ

ダッシュボードの Account → API tokens で API トークンを作成します。

Claude Code

claude mcp add cloady -e BEARER_TOKEN_CLOADY=cldy_… -- npx -y @cloady/mcp

Claude Desktop / Cursor / 任意の MCP クライアント

{
  "mcpServers": {
    "cloady": {
      "command": "npx",
      "args": ["-y", "@cloady/mcp"],
      "env": { "BEARER_TOKEN_CLOADY": "cldy_…" }
    }
  }
}

API_BASE_URL を指定すると、Cloady を別の場所で実行している場合に接続先を変更できます。

ツール

API 操作ごとに 1 つのツールがあります。引数は、操作のパスパラメーター、クエリパラメーター、ボディフィールドを 1 つのオブジェクトにまとめたものです。そのため、createVar は workspaceSlug、appSlug、env、region、key、value、isSecret を受け取ります。

トークンのスコープ（read / deploy / full）とワークスペースのロールは、ダッシュボードや SDK と同様に、すべての呼び出しで API によって適用されます。

ドキュメント

詳しいリファレンスは cloady.com/docs をご覧ください。

配布

このリポジトリには、npm で @cloady/[email protected] として公開済みのソースとビルドに加え、ディレクトリパッケージも含まれています。npm install と npm start を実行してください。Cursor プラグインは固定された npm リリースを使用します。MCPB バンドルには本番用依存関係が含まれています。

プライバシーポリシー

このローカルサーバーは、設定した API トークンを使用して、ツールの引数を Cloady API に転送します。データの取り扱いと連絡先については、Cloady のプライバシーポリシーをご覧ください。必要最小限のスコープを持つトークンを使用してください。書き込みツールはリソースを変更または削除できます。

0.5.1 のデスクトップバンドルでは、0.5.0 の API 実装にツールのタイトルと、慎重な読み取り／書き込みのアノテーションが追加されています。Cursor の設定では、引き続き公開されている npm 0.5.0 リリースを使用します。