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

# コネクタ：GitHub、Gmail などのアプリ

> コネクタを使うと、クラウドのセッションがあなたとして GitHub や Gmail などのサービスにアクセスできます。このページでは、接続、Gmail のアクセスレベル、認可の期限切れと再接続、送信前の確認、アクセスの管理、接続解除について説明します。

**コネクタ**は、AIHubMix Cloud に使用を認可したサードパーティのアカウントです。接続すると、クラウドのセッションがあなたとしてこれらのサービスを読み書きできます。例として、GitHub リポジトリの取得や Gmail の検索があります。認可はブラウザで行い、トークンを入力する必要はありません。

コネクタが扱うのはアカウントのみです。Agent の機能拡張（プラグイン、MCP、Skills）は [プラグイン / MCP / Skills](https://docs.aihubmix.com/jp/cloud/integrations/plugins-mcp-skills.md) で管理します。

## 利用できる環境

デスクトップアプリ、Web アプリ、モバイル Web で利用できます。コネクタはクラウドのセッションでのみ使用され、デバイス上の設定は変更しません。各コネクタで接続できるアカウントは 1 つです。

## 場所

* **Settings › Integrations › Connectors**。
* GitHub を接続する前に **Import from GitHub** でプロジェクトを作成する場合は、**Connect GitHub** をクリックします。

## Connectors ページ

ページは **Code**（GitHub）、**Email**（Gmail）、**Connected apps**、**More apps** のグループに分かれています。各行には名前とステータスが表示されます。

| ステータス | できること |
| - | - |
| 未接続 | **Connect** をクリックします |
| **● Connected · account** | **Manage** をクリックして、アクセス権限の確認や接続解除を行います |
| **● Authorization expired · account** | **Reconnect** をクリックします。通常、サービス側で認可を取り消したことを意味します |

接続できるアプリは、ページに表示されているものです。

## アプリを接続する

1. アプリの行で **Connect** をクリックします（Gmail の場合は、先にアクセスレベルを選択します。下記を参照）。
2. ブラウザでサービスの認可ページが開きます。そこで認可を完了します。ページが表示されない場合は **Reopen browser** をクリックします。
3. 完了したら AIHubMix Cloud に戻ります。アプリが接続済みと表示されます。

認可が完了しなかった場合は、**Authorization not completed** と理由が表示されます。**Try again** または **Reconnect** をクリックして再試行します。別のアカウントがすでに接続されていると表示された場合は、アカウントを切り替えるために先に既存の接続を解除します。

## GitHub

GitHub を認可すると、リポジトリをプロジェクトとしてインポートし、クラウドサーバー上でコードを取得し、ブランチをプッシュして PR を作成できます。セッションでは Issue や PR の読み取り、コードの検索ができます。アクセスできるリポジトリと組織は GitHub 上で選択します。組織やリポジトリを追加するには、管理ページで **Manage on GitHub** をクリックします。

GitHub の接続を解除すると、既存のクラウド環境はコードの取得、ブランチのプッシュ、PR の作成ができなくなります。環境内のファイルは保持されます。

## Gmail

Gmail には 2 つのアクセスレベルがあり、Agent はメールを送信する前に**必ず**セッション内であなたの承認を求めます。各 AIHubMix アカウントで接続できる Google アカウントは 1 つのみです。

| レベル | Agent ができること |
| - | - |
| Read and send（デフォルト） | メールの検索と読み取り、あなたに代わってのメール送信 |
| Send only | あなたに代わってのメール送信のみ。メールの検索や読み取りはできません |

* **アクセスの変更**：Gmail の管理ページで **Change granted access** をクリックし、新しいレベルを選択して **Authorize with Google** をクリックします。
* **再接続**：認可の期限が切れている場合は **Reconnect** をクリックします。現在のレベルが維持されます。
* **Read and send** を選択したものの、Google の認可ページで読み取り権限を選択しなかった場合、Gmail の行には **Send only** と表示され、Agent はまだメールを読み取れません。**Change granted access** をクリックして再度認可し、読み取り権限を選択してください。

### 送信前の確認

Agent がメールを送信しようとすると、まずセッション内に **Confirm before sending** が表示され、送信者、宛先、件名、本文が示されます。**Send** または **Don't send** をクリックします。管理ページの権限スイッチでこの確認を省略することはできません。接続済みの Outlook アカウントでメールを送信する場合も確認が必要です。

## コネクタの管理とアクセス権限

接続済みのアプリで **Manage** をクリックすると **Manage connector** が開き、接続済みのアカウントとアクセス権限の確認、**Disconnect** ができます。

### アクセス権限

アクセス権限の一覧はアカウントがサービスから実際に付与されている権限に基づくため、項目はアプリやアカウントによって異なります。

* 付与済みの権限はスイッチでオフ / オンにできます。変更は保存が成功した後にのみ反映されます。権限をオフにすると、セッションがその機能を呼び出したときにブロックされます。
* グレー表示で切り替えられない項目は、このアカウントに付与されていない権限、編集できない権限、または再接続が必要な権限です。アクセスを広げるには、再度認可します。
* 付与されたアクセスの保存または読み込みに失敗した場合は、**Reload access** をクリックして再試行します。

### 接続を解除する

1. 管理ページで **Disconnect** をクリックします。
2. 確認ダイアログで **Disconnect** をクリックします。接続を解除すると、クラウドのタスクはこのアプリにアクセスできなくなります。いつでも再接続できます。

接続の解除に失敗した場合、接続は維持されます。**Reload access** をクリックして再試行します。

## 注意事項と制限

* 各コネクタで接続できるアカウントは 1 つのみです。アカウントを切り替えるには、先に接続を解除します。
* コネクタはクラウドのセッションにのみ適用され、デバイス上の設定は変更しません。
* 表示される権限と、それを変更できるかどうかは、サービスから実際に付与されている権限によって決まります。

## よくある質問

### GitHub のトークンを入力する必要はありますか？

いいえ。すべてのコネクタはブラウザでの認可を使用します。

### GitHub または Gmail に "Authorization expired" と表示された場合は？

通常、サービス側で認可が取り消されたことを意味します。行の **Reconnect** をクリックしてください。Gmail は以前のレベルを維持します。

### GitHub の接続を解除すると、プロジェクトは削除されますか？

いいえ。クラウド環境のファイルは保持されます。環境はコードの取得、ブランチのプッシュ、PR の作成ができなくなります。

### Agent は私の承認なしにメールを送信しますか？

いいえ。レベルや権限スイッチに関係なく、Agent は送信前にセッション内で確認を求めます。

## 関連ページ

* [プラグイン / MCP / Skills](https://docs.aihubmix.com/jp/cloud/integrations/plugins-mcp-skills.md)
* [ユーザーの介入](https://docs.aihubmix.com/jp/cloud/sessions/user-intervention.md)
* [プロジェクト](https://docs.aihubmix.com/jp/cloud/projects/projects.md)


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