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

# Remote MCP で AI エージェントを接続する

> Alter をリモート MCP サーバーとして使い、Mac 上の会議、保存済みアクション、会話にアクセスする

MCP Gateway を使うと、互換性のある AI エージェントが専用 HTTPS URL 経由で Alter のツールを呼び出せます。会議の検索、文字起こしの閲覧、許可された保存済みアクションの実行、Alter との会話の開始や続行ができます。

ツールは Mac 上の Alter が実行します。Alter のリレーが、実行中のアプリと AI エージェントを接続します。Mac のポートを公開したり、別のローカル MCP コマンドを実行したりする必要はありません。

> [!TIP]
>
> ChatGPT デスクトップ版を使う場合は、[ChatGPT で Alter を使う](/ja/apps-tools/gateways-chatgpt.md)のプラグイン設定手順を参照してください。このガイドでは、互換性のあるエージェント向けの Remote MCP 接続を説明します。

## 始める前に

* Mac で Alter にサインインします。
* **remote HTTPS MCP server URL**を追加できる AI エージェントを使います。ローカルコマンドのみ受け付けるクライアントでは、この URL を直接使用できません。
* 接続中は Mac をオンラインにし、Alter を起動したままにします。

> [!NOTE]
>
> ChatGPT は最初にテストされた連携です。他のクライアントは Alter の Remote MCP エンドポイントに対応している必要がありますが、互換性はまだエンドツーエンドで検証されていません。同じクライアントでも、ツールとイベント購読の対応状況は異なる場合があります。

## MCP Gateway を有効にする

**1. Alter で Gateways を開く**

**⌘,** を押して **Settings** を開き、**Integrations** の下にある **Gateways** を選択します。

**Add gateway → MCP Gateway** を選択するか、既存の MCP Gateway を開きます。

**2. アクセスを選んで保存する**

**Enabled** をオンにします。**Allowed access** で、エージェントに使わせる機能を有効にします。読み取り専用の会議テストでは **Read meeting transcripts** を有効にします。

**Save and restart** を選択し、接続の準備ができるまで待ちます。

![Enabled がオンになり接続コントロールが表示された Alter MCP Gateway 設定](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-connection.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=4b8b77cf9de2094d96a8b0b3cdfad0f9)

MCP Gateway を有効にして設定を保存してから、AI エージェントに追加します。

**3. 接続 URL をコピーする**

**Connection** セクションで **Copy connection URL** を選択します。

これが専用の Remote MCP エンドポイントです。末尾のキーを含む URL 全体を非公開にしてください。

## AI エージェントに Alter を追加する

エージェントの MCP または連携設定を開き、次の値でリモートサーバーを追加します。

| 項目 | 値 |
| - | - |
| 名前 | **Alter** |
| Server URL | **Copy connection URL** でコピーした URL 全体を貼り付けます。 |
| 認証 | **No authentication** またはクライアントの同等の選択肢。アクセス権は専用 URL に含まれています。 |

接続を保存し、ツールを更新または検出します。表示名はクライアントによって異なります。この接続には追加の API キーや OAuth サインインは必要ありません。

まず、読み取り専用のリクエストを試します。

> Alter の最近の会議を一覧表示して。

エージェントがツール呼び出しの承認を求める場合があります。会議が表示されない場合は、Alter に保存済み会議があり、文字起こしへのアクセスが有効か確認します。

## 許可するアクセスを選ぶ

![会議、アクション、チャット、履歴のスイッチが表示された Alter MCP Gateway の Allowed access](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-access.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=ed9df89e68ddf7d65d5debac27cbffec)

接続したエージェントに必要な機能だけを有効にします。

| 設定 | 利用できるツールと動作 |
| - | - |
| **Read meeting transcripts** | `list_meetings`、`search_meetings`、`get_meeting_transcript` で保存済み会議を一覧・検索し、選択した文字起こしを読み取ります。 |
| **Run saved actions** | `list_actions` と `run_action` で、この Gateway に許可された保存済みアクションを検出して実行します。 |
| **Chat with Alter** | `create_conversation` と `send_message` で、許可されたアクションを使って会話を開始・続行します。 |
| **Read conversation history** | `list_conversations`、`search_conversations`、`get_conversation` で、この Gateway に許可されたアクションを含む会話を検索・閲覧します。 |
| **Notify when transcripts are ready** | 有効なイベント購読がある対応クライアントで、文字起こし完了イベントを有効にします。制限は[イベント対応](#イベント対応)を参照してください。 |

無効にした機能は利用可能なツールから除かれ、直接呼び出しても使えません。アクセス設定を変更したら、**Save and restart** を選択し、エージェントのツールを更新します。Gateway の再起動により、実行中の Gateway タスクはキャンセルされます。

### デフォルトアクションと保存済みアクション

**Behavior** で新しいチャットの **Default action** を選びます。通常は **Ask Anything** がデフォルトです。

別の保存済みアクションを使うには、**Action Editor → Gateways** を開き、**MCP Gateway** または **All** を有効にします。Gateway の **Available actions** に許可されたアクションが表示されます。エージェントがアクションを検出して実行するには、**Run saved actions** へのアクセスも必要です。

新しい **Ask Anything** の会話は、デフォルトの Alter workspace を使います。他のアクションは設定済みの workspace を使います。会話を続ける場合、その会話の workspace とアクション権限が維持されます。

## リクエスト例

| 目的 | リクエスト例 |
| - | - |
| トピックから会議を探す | 「Alter の会議から価格に関する議論を検索し、該当する内容を要約して。」 |
| 最近の会議を確認する | 「Alter の最近の会議を一覧表示し、最新の文字起こしを読んで。」 |
| 保存済みアクションを確認する | 「この接続経由で実行できる Alter アクションを教えて。」 |
| Alter とのチャットを開始する | 「現在の workspace にある最新ファイルを、変更せずに確認するよう Alter に依頼して。」 |
| 過去の会話を検索する | 「オンボーディングについて以前に行った Alter との会話を探して。」 |

会議検索は、インデックス化された会議内容の語句に一致します。会話検索は、インデックス化された会話のタイトルとメッセージに一致します。詳細が必要な場合は、一致した文字起こしや会話を読むようエージェントに依頼します。

### 質問と権限

Alter が処理している間、チャットやアクションはタスク ID を返すことがあります。エージェントは `get_task` で結果を取得し、実行中のタスクを止めるには `cancel_task` を使います。

Alter のタスクは質問をしたり、ファイルアクセスを求めたりして一時停止する場合があります。エージェントは質問と選択肢を表示し、回答を待ってから Alter に返して処理を続けます。

権限の選択肢には **Allow once**、**Always allow**、アクセス拒否などがあります。この接続はこれらのリクエストを自動承認しません。質問が表示されないままエージェントが待機する場合は、タスク内の未回答の質問を確認するよう指示し、回答後に利用可能な `answer_questions` ツールを使わせてください。

## イベント対応

リモートツールへのアクセスだけではイベント購読は作成されません。イベント対応状況は、AI エージェントと選択中のモードにも左右されます。

現在、Alter が受け付ける文字起こし完了 Webhook の送信先は ChatGPT/OpenAI ドメインのみです。他の MCP エージェントは対応ツールを使用できますが、任意のサードパーティーイベント送信先には対応していません。[ChatGPT の会議通知](/ja/apps-tools/gateways-chatgpt.md#新しい会議の通知を受け取る)で、対応する購読設定を確認してください。

## プライバシーと利用可能性

接続 URL は、この Gateway に有効化したアクセス権を付与します。パスワードと同様に扱い、信頼できるクライアントだけに保存してください。

ツールは Mac 上の Alter で動作します。リクエストと結果は Alter のリレーを通り、エージェントが要求した場合は文字起こしテキストも含まれます。保存済みの会議と会話は Alter に残り、接続先エージェントは許可されたツール呼び出しが返すデータを受け取ります。

Alter を起動したままにし、Mac をオンラインにしてください。Gateway を無効にするとアクセスが停止し、実行中のタスクはキャンセルされます。Gateway を削除して作り直すと新しい接続 URL が発行されるため、接続済みの各クライアントで古い URL を置き換えます。

## トラブルシューティング

| 状況 | 確認すること |
| - | - |
| クライアントにコマンドまたは実行ファイル欄しかない | Remote HTTPS MCP URL に対応したクライアントまたは接続タイプを選びます。 |
| サーバーに接続できない | Alter が起動しており、MCP Gateway が有効で接続済みか確認します。Alter の **Connection** セクションで **Reconnect** を試してから、クライアントを更新します。再接続で実行中の Gateway タスクはキャンセルされます。 |
| ツールが表示されない | 該当する **Allowed access** を有効にして保存し、エージェントのツール一覧を更新します。アクションの場合は **Action Editor → Gateways** も確認します。 |
| タスクが待機状態のまま | Alter が明示的な回答またはファイルアクセスの判断を求めていないか確認します。 |
| ツールは動くがイベントが届かない | クライアントとモードを確認します。現在、イベント送信先は ChatGPT/OpenAI ドメインに限られ、有効な購読が必要です。 |
| Alter のアカウント変更後、または Gateway 作り直し後にアクセスできない | 現在の接続 URL をコピーして、エージェント側の URL を置き換えます。 |

## 関連ページ

* [ChatGPT で Alter を使う](/ja/apps-tools/gateways-chatgpt.md)
* [Gateways の概要](/ja/apps-tools/gateways.md)
* [Alter Actions](/ja/workflows/alter-actions.md#8-gateways)
* [ローカルデータとプライバシー](/ja/references/local-data-and-privacy.md)


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