> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Square Cloud MCP サーバー

> リモート MCP サーバーで Claude、ChatGPT、Claude Code、VS Code、Cursor を Square Cloud アカウントに接続し、チャットからアプリケーションとデータベースを管理します。

Square Cloud MCP サーバーを使うと、AI クライアントが [Model Context Protocol](https://modelcontextprotocol.io) を通じてあなたのアカウントを操作できます。普段の言葉で頼むだけで、クライアントが代わりに[ツール](https://docs.squarecloud.app/ja/mcp/tools.md)を呼び出します。ステータス、ログ、メトリクス、エッジのトラフィックの確認、ファイルの読み取りと編集、環境変数の管理、アプリケーションの起動と再起動、アプリケーション、データベース、スナップショットの作成などができます。

* **リモートなのでインストール不要:** すべてのクライアントで同じ HTTPS アドレスを使います。
* **2 つの接続方法:** Claude と ChatGPT は、Square Cloud の同意ページで OAuth によりサインインします。Claude Code、VS Code、Cursor などのクライアントは API キーを送信します。
* **権限はあなたが決める:** 接続から見えるのは、そのスコープがカバーするツールだけです。一部のアプリケーションとデータベースに制限したキーは、それらにしかアクセスできません。
* **確認はクライアントが、データは安全に:** どの変更を実行するかは、クライアントの許可確認が決めます。アプリケーションやデータベースの削除、スナップショットの復元では、先に安全用スナップショットが作成されます。

## エンドポイント

```text theme={"system"}
https://mcp.squarecloud.app/mcp
```

MCP サーバーのアドレスはこれだけです。`api.squarecloud.app` などほかの Square Cloud のアドレスに MCP リクエストを送ると、正しいアドレスを添えて `421 WRONG_HOST` が返されます。逆に、`mcp.squarecloud.app` が提供するのは MCP サーバーだけで、REST API は提供しません。

## 要件

* **有効な[プラン](https://docs.squarecloud.app/ja/platform/plans.md)。** MCP サーバーは、Hobby 以上のすべての Square Cloud プランに含まれています。有効なプランがない場合、すべてのリクエストに `403 UPGRADE_REQUIRED` が返されます。プランの期限が切れても接続は保持され、プランを更新するとすぐにまた使えるようになります。
* **Streamable HTTP でリモートサーバーに対応した MCP クライアント。** Claude、ChatGPT、Claude Code、VS Code、Cursor などです。[クライアントを接続する](https://docs.squarecloud.app/ja/mcp/connect.md)を参照してください。

## プロトコル

| 項目 | 詳細 |
| - | - |
| トランスポート | Streamable HTTP、`POST` のみです。サーバーはセッションを保持せず、`GET` には `405` が返されます。 |
| プロトコルバージョン | `2026-07-28`、`2025-11-25`、`2025-06-18`、`2025-03-26`。`2026-07-28` リビジョンのクライアントはハンドシェイクなしで呼び出し、それより古いクライアントは `initialize` から始めます。`MCP-Protocol-Version` のないリクエストは `2025-03-26` として扱われ、対応していないバージョンには対応バージョンの一覧とともに `400` が返されます。 |
| 機能 | ツールのみです。リソースやプロンプトはありません。 |
| 結果 | 各ツールは 1 つの JSON オブジェクトをテキストブロックとして返します。`ok` と `summary` を含み、失敗したときやあなたの対応が必要なときは `code` も含みます。 |
| 長時間の呼び出し | 数秒以上かかる呼び出しは、キープアライブ付きのストリーム（SSE）で返されます。接続を閉じると呼び出しはキャンセルされ、3 分を超えて実行される呼び出しはありません。 |

## MCP の対象外のもの

* **1 MB を超えるプロジェクト。** クライアントは、自分のコンピューター上のプロジェクトを最大 1 MB の zip として送れます。新しいアプリケーションには `upload_application`、新しいバージョンには `commit_application` を使い、テキストファイルは `create_application` と `commit_application` で送れます。より大きなプロジェクトには、[CLI](https://docs.squarecloud.app/ja/cli-reference/deploy.md)、[VS Code 拡張機能](https://docs.squarecloud.app/ja/vscode-extension/features.md)、[GitHub からのデプロイ](https://docs.squarecloud.app/ja/cli-reference/github-deploys.md)を使ってください。
* **スナップショットとデータベース証明書のダウンロード。** 署名付きのダウンロードリンクが会話の中に、そして AI モデルのプロバイダーに渡ってしまうためです。ダッシュボードからダウンロードしてください。
* **アカウントのアクティビティ。** アカウントの IP アドレスやデバイスが表示されるため、ダッシュボードでのみ確認できます。
* **シークレットの値。** 環境変数の値、`.env` ファイル、秘密鍵が AI クライアントに渡ることはありません。[シークレット](https://docs.squarecloud.app/ja/mcp/permissions-and-safety.md#シークレット)を参照してください。
* **アカウント設定、請求、API キー、ワークスペースのメンバー。** これらはダッシュボードで管理します。

## 次のステップ

> [card] [クライアントを接続する](https://docs.squarecloud.app/ja/mcp/connect.md)
>
> Claude、ChatGPT、Claude Code、VS Code、Cursor を設定します。

> [card] [権限と安全性](https://docs.squarecloud.app/ja/mcp/permissions-and-safety.md)
>
> スコープ、制限付きキー、安全用スナップショット。

> [card] [ツール](https://docs.squarecloud.app/ja/mcp/tools.md)
>
> すべてのツールと必要なスコープ。

> [card] [制限とエラー](https://docs.squarecloud.app/ja/mcp/limits-and-errors.md)
>
> リクエストとツールの制限、各エラーの意味。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.