> ## 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. # AI クライアントを Square Cloud MCP サーバーに接続する > Claude と ChatGPT は OAuth で、Claude Code、VS Code、Cursor は API キーで Square Cloud MCP サーバーに接続する方法と、接続の有効期間を説明します。 すべてのクライアントが同じアドレス `https://mcp.squarecloud.app/mcp` を使います。サインインの方法はクライアントによって異なります: | クライアント | 接続方法 | | - | - | | [Claude](#claude)（claude.ai と Claude アプリ） | OAuth: アドレスを貼り付けて Square Cloud で認可します | | [ChatGPT](#chatgpt) | OAuth: アドレスを貼り付けて Square Cloud で認可します | | [Claude Code](#claude-code) | `Authorization` ヘッダーの [API キー](#api-キーを作成する) | | [VS Code](#vs-code) | `Authorization` ヘッダーの [API キー](#api-キーを作成する) | | [Cursor](#cursor) | `Authorization` ヘッダーの [API キー](#api-キーを作成する) | | [その他のクライアント](#その他のクライアント) | `Authorization` ヘッダーの [API キー](#api-キーを作成する) | どちらの場合も、アカウントには有効な[プラン](https://docs.squarecloud.app/ja/platform/plans.md)が必要です。 ## 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** をオンにします。 > [!NOTE] > > Square Cloud が受け付けるのは、Claude の公開 ID だけです。**Register automatically** と **Use your own OAuth client** では接続できません。 ## ChatGPT **1. カスタム MCP サーバーを追加する** [ChatGPT のプラグイン](https://chatgpt.com/plugins)を開き、**+**、続いて **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** を選びます。 > [!NOTE] > > ChatGPT のこれらのメニュー名はときどき変わります。表示が異なる場合は、[OpenAI の MCP サーバー接続ガイド](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt)に従ってください。 ## Claude Code Claude Code は OAuth ではなく、ヘッダーの [API キー](#api-キーを作成する)で接続します。キーを環境変数 `SQUARECLOUD_API_KEY` に保存して、次のコマンドを実行します: ```bash theme={"system"} claude mcp add --transport http squarecloud https://mcp.squarecloud.app/mcp \ --header "Authorization: Bearer $SQUARECLOUD_API_KEY" ``` コマンドを実行したときにシェルがキーを埋め込み、Claude Code はそれを自身の設定に保存します。キーを共有せずにプロジェクトでサーバーを共有するには、代わりにプロジェクトの `.mcp.json` に追加してください。Claude Code は起動するたびに環境変数を読み取ります: ```json .mcp.json theme={"system"} { "mcpServers": { "squarecloud": { "type": "http", "url": "https://mcp.squarecloud.app/mcp", "headers": { "Authorization": "Bearer ${SQUARECLOUD_API_KEY}" } } } } ``` 接続は `claude mcp list`、または Claude Code 内の `/mcp` で確認できます。 ## VS Code プロジェクトの `.vscode/mcp.json`、またはコマンドパレットの **MCP: Open User Configuration** で開くユーザー設定にサーバーを追加します: ```json .vscode/mcp.json theme={"system"} { "inputs": [ { "type": "promptString", "id": "squarecloud-api-key", "description": "Square Cloud API key", "password": true } ], "servers": { "squarecloud": { "type": "http", "url": "https://mcp.squarecloud.app/mcp", "headers": { "Authorization": "Bearer ${input:squarecloud-api-key}" } } } } ``` サーバーの起動時に VS Code が [API キー](#api-キーを作成する)の入力を求めるため、キーがファイルに残ることはありません。サーバーの起動、停止、再起動は **MCP: List Servers** から行います。 > [!TIP] > > これは、サイドバーからアプリケーションを管理する [VS Code 用 Square Cloud 拡張機能](https://docs.squarecloud.app/ja/vscode-extension/installation.md)とは別のものです。両方を併用できます。 ## Cursor プロジェクトの `.cursor/mcp.json`、またはすべてのプロジェクトで使う場合は `~/.cursor/mcp.json` にサーバーを追加します: ```json .cursor/mcp.json theme={"system"} { "mcpServers": { "squarecloud": { "url": "https://mcp.squarecloud.app/mcp", "headers": { "Authorization": "Bearer ${env:SQUARECLOUD_API_KEY}" } } } } ``` Cursor を開く前に、環境に `SQUARECLOUD_API_KEY` を設定してください。Cursor の **Customize** メニューでサーバーをオンにします。接続できない場合は、出力パネルの **MCP Logs** チャンネルに原因が表示されます。 ## その他のクライアント カスタムヘッダー付きの Streamable HTTP でリモート MCP サーバーに対応したクライアントなら、同じ方法で接続できます。アドレス `https://mcp.squarecloud.app/mcp` を使い、API キーを `Authorization` ヘッダーで送信してください。`Bearer ` プレフィックスは任意です。 ```http theme={"system"} Authorization: Bearer ``` ## API キーを作成する キーは[アカウントのセキュリティ設定](https://squarecloud.app/ja/account/security)で作成します: * **`mcp` スコープを付与し**、クライアントに使わせたいツールのスコープも追加します。フルアクセスのキーでも動作します。[スコープ](https://docs.squarecloud.app/ja/mcp/permissions-and-safety.md#スコープ)を参照してください。 * **読み取り専用のアクセスにするには**、`mcp`、`apps:read`、`files:read`、`envs:read`、`snapshots:read`、`databases:read` を選びます。 * **クライアントを一部のアプリケーションとデータベースに限定するには**、キーをそれらに制限します。[制限付きキー](https://docs.squarecloud.app/ja/mcp/permissions-and-safety.md#アプリケーションとデータベースに制限されたキー)を参照してください。 シークレットは一度しか表示されません。環境変数かクライアントのシークレットストレージに保管し、チャットやコミットするファイルには絶対に書かないでください。作成したキーに有効期限はないため、使わなくなったら失効させてください。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 接続は同じ[制限](https://docs.squarecloud.app/ja/mcp/limits-and-errors.md)を共有します。 ## 接続を解除する [アカウントのセキュリティ設定](https://squarecloud.app/ja/account/security)でキーを失効させます。OAuth 接続の場合は `Claude` または `ChatGPT` のキー、それ以外の場合は自分で作成したキーです。アクセスはクライアントの次のリクエストで終了します。クライアント側でコネクタやサーバーを削除すると呼び出しは止まりますが、キーを無効にできるのは Square Cloud でキーを失効させた場合だけです。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.