メインコンテンツへスキップ
すべてのクライアントが同じアドレス https://mcp.squarecloud.app/mcp を使います。サインインの方法はクライアントによって異なります: どちらの場合も、アカウントには有効なプランが必要です。

Claude

1

カスタムコネクタを追加する

Claude で Customize > Connectors を開き、+ Add、続いて Add custom connector をクリックします。Team プランと Enterprise プランでは、まずオーナーが Organization settings > Connectors(Add > Custom > Web)でコネクタを追加し、その後各メンバーが Customize > Connectors から接続します。
2

アドレスを入力する

名前を Square Cloud にし、https://mcp.squarecloud.app/mcp を入力して Continue をクリックします。
3

Claude 自身の ID のままにする

サインインのオプション(Sign in now または Sign in when needed)を選んだままにし、OAuth クライアントとして Use Claude’s published identity (Recommended) を選択します。Request headers は空のままにして Add をクリックします。
4

Square Cloud で認可する

Claude が Square Cloud のページを開きます。必要に応じてサインインし、Claude が求める権限を確認して、クリックで認可します。権限のチェックを外して、Claude に与えるアクセスを減らすこともできます。mcp は接続そのものに必要なため、常に残ります。
5

チャットで使う

Claude に戻り、チャット欄の + をクリックして Connectors を開き、Square Cloud をオンにします。
Square Cloud が受け付けるのは、Claude の公開 ID だけです。Register automatically と Use your own OAuth client では接続できません。

ChatGPT

1

カスタム MCP サーバーを追加する

ChatGPT のプラグインを開き、+、続いて Add custom MCP server を選択します。ChatGPT のプランによっては、先にワークスペースの管理者がカスタム MCP サーバーを許可する必要があります。
2

アドレスを入力する

名前を Square Cloud にし、接続方式として公開エンドポイントを選んで https://mcp.squarecloud.app/mcp を入力します。認証には OAuth を選びます。
3

作成する

警告を確認し、I understand and want to continue、続いて Create as a plugin を選択します。
4

Square Cloud で認可する

ChatGPT がサインインを求めると、Square Cloud のページが開きます。必要に応じてサインインし、権限を確認して、クリックで認可します。権限のチェックを外すこともできますが、mcp は常に残ります。
5

チャットで使う

新しい会話を始めて @ を入力し、Square Cloud を選びます。
ChatGPT のこれらのメニュー名はときどき変わります。表示が異なる場合は、OpenAI の MCP サーバー接続ガイドに従ってください。

Claude Code

Claude Code は OAuth ではなく、ヘッダーの API キーで接続します。キーを環境変数 SQUARECLOUD_API_KEY に保存して、次のコマンドを実行します:
コマンドを実行したときにシェルがキーを埋め込み、Claude Code はそれを自身の設定に保存します。キーを共有せずにプロジェクトでサーバーを共有するには、代わりにプロジェクトの .mcp.json に追加してください。Claude Code は起動するたびに環境変数を読み取ります:
.mcp.json
接続は claude mcp list、または Claude Code 内の /mcp で確認できます。

VS Code

プロジェクトの .vscode/mcp.json、またはコマンドパレットの MCP: Open User Configuration で開くユーザー設定にサーバーを追加します:
.vscode/mcp.json
サーバーの起動時に VS Code が API キーの入力を求めるため、キーがファイルに残ることはありません。サーバーの起動、停止、再起動は MCP: List Servers から行います。
これは、サイドバーからアプリケーションを管理する VS Code 用 Square Cloud 拡張機能とは別のものです。両方を併用できます。

Cursor

プロジェクトの .cursor/mcp.json、またはすべてのプロジェクトで使う場合は ~/.cursor/mcp.json にサーバーを追加します:
.cursor/mcp.json
Cursor を開く前に、環境に SQUARECLOUD_API_KEY を設定してください。Cursor の Customize メニューでサーバーをオンにします。接続できない場合は、出力パネルの MCP Logs チャンネルに原因が表示されます。

その他のクライアント

カスタムヘッダー付きの Streamable HTTP でリモート MCP サーバーに対応したクライアントなら、同じ方法で接続できます。アドレス https://mcp.squarecloud.app/mcp を使い、API キーを Authorization ヘッダーで送信してください。Bearer プレフィックスは任意です。

API キーを作成する

キーはアカウントのセキュリティ設定で作成します:
  • mcp スコープを付与し、クライアントに使わせたいツールのスコープも追加します。フルアクセスのキーでも動作します。スコープを参照してください。
  • 読み取り専用のアクセスにするには、mcp、apps:read、files:read、envs:read、snapshots:read、databases:read を選びます。
  • クライアントを一部のアプリケーションとデータベースに限定するには、キーをそれらに制限します。制限付きキーを参照してください。
シークレットは一度しか表示されません。環境変数かクライアントのシークレットストレージに保管し、チャットやコミットするファイルには絶対に書かないでください。作成したキーに有効期限はないため、使わなくなったら失効させてください。1 つのアカウントで保持できるキーは最大 10 個です。

接続の有効期間

Claude と ChatGPT(OAuth)。 認可すると、そのクライアント用の API キーがクライアント名(Claude または ChatGPT)で作成されます:
  • 有効期間は 90 日で、リフレッシュトークンはありません。期限が切れると、クライアントから再度サインインと認可を求められます。
  • MCP サーバーでのみ機能します。REST API では 403 MISSING_SCOPE が返されます。
  • 同じクライアントを再接続すると、以前のキーは失効します。 各アカウントが保持できる接続は Claude と ChatGPT でそれぞれ 1 つなので、2 つ目の Claude アカウントを接続すると 1 つ目は切断されます。
複数の接続を同時に維持するには、追加する接続ごとに専用の API キーを用意してください。Claude では、カスタムコネクタから API キーを送ることもできます。Authentication で No sign in を選び、Request headers に Authorization ヘッダーを追加します。Team プランと Enterprise プランでは、そのコネクタを使う全員がキーのアクセス権を共有します。 自分で作成した API キーには有効期限がありません。どの方法で接続しても、アカウントのすべての MCP 接続は同じ制限を共有します。

接続を解除する

アカウントのセキュリティ設定でキーを失効させます。OAuth 接続の場合は Claude または ChatGPT のキー、それ以外の場合は自分で作成したキーです。アクセスはクライアントの次のリクエストで終了します。クライアント側でコネクタやサーバーを削除すると呼び出しは止まりますが、キーを無効にできるのは Square Cloud でキーを失効させた場合だけです。