ワークスペース接続

ワークスペース接続を使うと、参加者がそれぞれ個人アカウントを接続しなくても、対応するチームタスクや @ChatGPT の利用環境で、会社が管理するアプリアカウントを使用できます。

詳しくは、プラグインの権限とデータ共有の仕組みを参照してください。

ワークスペース管理者は、対応するアプリのアカウントを承認し、保存済みの接続を管理します。また、誰に接続を表示し、利用を許可するかを設定します。各アカウントがアクセスできるデータと実行できる操作は、プロバイダー側の権限で決まります。

アカウントの承認についてはアプリアカウントの接続と管理を、定期的に行う作業についてはChatGPT でのチームタスクの作成と管理を参照してください。

接続の仕組み

会社が管理するアカウントを必要とする @ChatGPT やチームタスクで接続を使用します。管理者がアクセスを承認し、チームオーナーが権限の範囲内で利用可能な接続を選択します。同じ接続を複数の対応チームやワークフローで利用できます。

接続は、アプリが特定のアカウントを使って認証を受けるための仕組みです。

接続の設定

事前準備

対象のアプリと認証方法がワークスペースで利用できることを確認し、次の役割を割り当てます。

ワークスペース管理者： プラグインの管理権限を持つワークスペースのオーナーまたは管理者が、接続を作成して承認し、接続を表示、使用、管理できるユーザーを設定します。

プロバイダー側の管理者： アカウントを用意し、接続先のサービスへのアクセスを承認します。Notion と Linear では、プロバイダー側の管理者に協力を依頼してください。接続の認証に使うアカウントは、この管理者のアカウントとは限りません。

要件はプロバイダーによって異なります。Gmail では別のユーザーアカウントが必要になる場合があります。ドライブへのアクセスは Google 側で設定する必要があります。GitHub では、提供開始時点ではユーザーアカウントでサインインします。

接続用アカウント： 必要なリソースにのみアクセスできる、承認済みのアカウントまたはサービス ID を使用します。対応する認証方法を使い、従業員の個人アカウントに依存しないようにしてください。詳しくは、ChatGPT でのアプリアカウントの接続と管理を参照してください。

接続オーナー： 認可を維持し、権限の変更を調整します。アクセスできなくなった場合は復旧を担当します。共有する前に、対象リソースの範囲、読み取りと書き込みの権限、アクセスの取り消し方法を確認してください。

チームまたはワークフローのオーナー： 必要なリソースと操作について管理者と合意したうえで、タスクまたは @ChatGPT の利用環境で接続を選択してテストします。

ワークスペース接続の作成

1. 管理コンソールでワークスペースを選択し、「ワークスペース接続」>「+」の順に開きます。対象のアプリを選択します。

2. アプリの案内に従って、提示された認証方法で設定を進めます。求められた場合は、アプリへのリアルタイムアクセスを有効にします。

3. 指定のアカウントで認証するか、アプリのインストールを完了します。対象のアカウントまたはインストール先と、要求された権限を確認します。

4. 保存した接続に「プロジェクト報告：読み取り権限」など、アクセス範囲がわかるニックネームを付けます。

5. 承認済みのユーザー、チーム、またはサービスアカウントにアクセスを許可します。使用権限と管理権限を個別に確認し、チームまたはワークフローのオーナーに接続の選択とテストを引き継ぎます。

アプリごとの設定

対象のアプリで利用できる方法を使い、アクセスを設定して、実際に使用するワークフローでテストします。

Google ドライブ

アカウントの承認

必要なファイルまたは共有ドライブへのアクセス権を持つ、承認済みの Google アカウントを使用します。

1. Google でのログインを選び、接続するアカウントを選択します。要求されたアクセス権を確認してから承認します。

2. Google アカウントを確認し、ChatGPT で接続に名前を付けます。ワークフローでファイルを作成する場合は、保存先が正しいことと、受信者がファイルにアクセスできることをテストします。

サービスアカウントの使用

サービスアカウントによる直接認証が利用できる場合は、承認済みの Google Cloud サービスアカウントと JSON キーを用意します。この方法では、ドメイン全体の委任を使わず、サービスアカウント自体の権限でリソースにアクセスします。

1. 必要なファイル、フォルダ、または共有ドライブへのアクセス権を、サービスアカウントのメールアドレスに付与します。読み取り権限と書き込み権限は個別に確認します。

2. 保護された認証情報欄に JSON キーを省略せずに入力します。スクリーンショットやサポートへの問い合わせにキーを含めないでください。

3. 接続を保存し、サービスアカウントに共有したファイルを読み取れるか試します。

ファイルの作成先には共有ドライブを使用してください。 サービスアカウントには、その共有ドライブへの書き込み権限が必要です。個人のマイドライブでは、サービスアカウントはファイルを所有できません。

ファイルが見つからない場合は、サービスアカウントのメールアドレスにファイルが共有されているか、ChatGPT でアプリにどの操作が許可されているかを確認します。フォルダを共有しても、Google Workspace ドメイン全体へのアクセス権は付与されません。

ドライブでドメイン全体の委任が利用できる場合は、後述の委任の設定手順に従ってください。

Gmail

メールボックスの承認

OAuth が利用できる場合は、指定の Gmail メールボックスへのアクセスを承認します。ワークフロー専用のメールボックスが必要な場合は、IT 部門に別のユーザーアカウントを依頼してください。

1. Google でのログインを選び、対象のメールボックスを選択します。要求されたアクセス権を確認してから承認します。

2. 保存した接続を確認し、承認済みのテストメールを読み取ります。送信も必要な場合は、承認済みの宛先にテストメールを送り、送信者と届いたメールの内容を確認します。

Google グループはメールボックスではありません。グループを購読しているメールボックスを接続すると、グループのメールを受信できますが、ほかのメールも接続経由で閲覧できる場合があります。共有する前に、メールボックスの内容と許可されている操作を確認してください。

ドメイン全体の委任の設定

委任を利用するには、リクエスト元の従業員の本人確認が必要です。アクセスには、その従業員から委任された Google の権限が使われます。無人で実行する前に、利用環境でリクエスト元の従業員を確認できることを確かめてください。サービスアカウントでドライブに直接アクセスする場合は、仕組みが異なります。

委任は、この方法が提示された場合にのみ使用してください。Google Workspace の特権管理者による承認と、承認済みの Google Cloud サービスアカウントが必要です。そのアカウントの数値形式の OAuth クライアント ID と完全な JSON キーも用意してください。

1. 対象のアプリと操作を選択し、それぞれに必要なスコープを正確に特定して、Google Workspace 管理者に承認してもらいます。

2. Google 管理コンソールで、セキュリティ > アクセスとデータ管理 > API の制御 > ドメイン全体の委任を管理の順に開きます。数値形式のクライアント ID に承認済みのスコープを許可し、保存された設定を確認します。

3. JSON キーが他の人に見えないようにして ChatGPT に入力します。実際に接続を使用する環境で、本人確認済みの従業員をリクエスト元とし、その従業員がアクセスできるリソースを使ってテストします。

リクエストが拒否された場合は、リクエスト元の従業員、承認済みのスコープ、対象リソースへのアクセス権を確認してください。エラーを解消するためだけにスコープを広げないでください。

GitHub

ユーザーアカウントの承認

必要なリポジトリへのアクセス権を持つ、組織が承認した GitHub ユーザーアカウントを使用します。できれば、この接続専用のアカウントを用意してください。

提供開始時点では、GitHub App によるサインインは利用できません。

1. GitHub ユーザーアカウントでのサインインを選択し、指定のアカウントで認証します。

2. アカウントと要求されたアクセス権を確認してから、接続を承認します。

3. 接続を保存し、実際に使用するワークフローから、リポジトリ内の既知のリソースにアクセスできるかテストします。必要な書き込み操作は個別にテストします。

リポジトリが見つからない場合は、指定のアカウントが GitHub で持つアクセス権と、ChatGPT でアプリに許可されている操作を確認します。

Codex Security のクラウド環境では、個人の GitHub 接続を使用します。詳しくは、クラウドの設定を参照してください。

Notion

Notion 専用アカウントの準備

Notion 管理者に、承認済みの専用アカウントを用意し、必要なリソースへのアクセス権だけを付与するよう依頼します。そのアカウントが対象のワークスペースに参加していることを確認してください。接続には、このアカウントの権限が使われます。

ワークスペース接続の設定

「管理コンソール」>「ワークスペース接続」で Notion プラグインを追加します。Notion MCP を通じて指定のアカウントでサインインし、ワークスペースを選択します。ワークスペースとアカウントを識別できる名前を接続に付けます。

接続を保存し、実際に使用するタスクまたは利用環境から、既知の Notion ページにアクセスできるかテストします。必要な書き込み操作は個別にテストし、結果を確認します。

Linear

Linear 専用アカウントの準備

Linear 管理者に、指定のアカウントをゲストとして招待し、アクセスを必要なチームだけに限定するよう依頼します。

• 「Settings」→「Administration」→「Members」→「Invite」の順に開きます。

• 指定のアカウントのメールアドレスを入力します。

• 「Invite as…」で「Guest」を選択します。

• このアカウントにアクセスを許可する Linear チームだけを選択します。

• 招待を送信し、指定のアカウントで招待を承諾します。

詳しくは、Linear の招待手順を参照してください。

指定のアカウントがすでにメンバーの場合は、Linear 管理者にロールの変更を依頼します。

• 「Settings」→「Administration」→「Members」の順に開きます。

• 対象のアカウントを探し、「⋯」→「Change role…」→「Guest」の順にクリックします。

• 参加先を対象のチームだけに限定します。ゲストは、参加先のチーム内では通常のメンバーと同じ操作ができます。詳しくは、Linear のロールを参照してください。

ワークスペース接続の設定

1. 「管理コンソール」→「ワークスペース接続」で Linear プラグインを追加します。

2. 指定のアカウントでサインインし、ワークスペースを選択して権限を確認します。

接続には、そのアカウントの Linear アクセス権が使われます。実際に接続を使用するタスクまたは利用環境から、対象チームの課題を読み取れることを確認します。必要な書き込み操作は個別にテストします。

Slack

ワークスペース接続の設定

対象の Slack ワークスペースとチャンネルを確認し、必要なアプリがインストールされ、管理者の承認が得られていることを確かめます。Slack 上の ChatGPT 用の共有接続を使用します。個人の Slack 接続や、dot の「Slack に追加」で設定する接続は別の接続です。

承認済みのチャンネルにテスト投稿し、投稿先のワークスペースと送信者を確認します。投稿に成功しても、読み取りや検索ができるかどうかはわからないため、それぞれ個別にテストしてください。

チームとワークフローのオーナー向け

接続の選択とテスト

アクセスの設定と接続の選択

ワークスペース管理者： ロールごとのアクセス権と、接続を表示する対象を設定します。使用権限と管理権限は個別に確認してください。接続のニックネーム、接続用アカウント、承認済みのリソースと操作、接続オーナーの連絡先をワークフローのオーナーに伝えます。

チームまたはワークフローのオーナー： 権限の範囲内で利用可能な接続を選択して保存し、実際に使用するワークフローでテストします。接続が表示されない場合は、ワークスペース管理者にアクセス権と表示対象の設定を確認してもらいます。

各設定の役割

ある接続で Slack または Microsoft Teams の @ChatGPT を有効にすると、その接続ではチームとサービスアカウントからのアクセスを許可するオプションも有効になります。その接続で @ChatGPT が有効な間は、これらのオプションを個別に無効にすることはできません。

チームとワークフローの接続

チームの接続の確認

プラグインごとに、接続のニックネーム、接続用アカウント、アクセスできるリソースを接続オーナーと確認します。

ワークフローで使用する接続の選択

@ChatGPT の場合は、利用環境のプラグイン設定を開いて接続を選択します。保存後に設定を開き直し、選択内容を確認します。

チームタスクの場合は、アプリごとに選択されている接続を確認します。タスクを実行するのはチームのサービスアカウントですが、外部サービスで使用するアカウントは各アプリの認証方法で決まります。その認証方法がタスクの実行方式に対応していることを確認してください。特に、従業員の本人確認が必要な認証方法では、この確認が重要です。

ワークフローでの接続テスト

1. 実際に使用するワークフローから、既知のデータソースを読み取ります。使用されたアカウントとアクセス先のリソースを確認します。

2. 承認済みの保存先または宛先で書き込みや送信をテストし、作成されたファイルやレコード、送信されたメッセージを開きます。

3. 承認済みのユーザーは接続を使用でき、権限のないユーザーは使用できないことを確認します。生成されたファイルに受信者がアクセスできることも確認します。

接続の利用者向け

ワークスペース接続の使用

接続されたアカウントの権限

操作には接続されたアカウントの権限が使われます。この権限でアクセスできる範囲は、個人のアクセス範囲より広い場合があります。OAuth では承認されたアカウントの権限が、サービスアカウントによる直接アクセスではそのサービスアカウントの権限が使われます。リクエスト元の本人確認が必要な方法もあります。詳しくは、Google Workspace のドメイン全体の委任を参照してください。

利用可能なワークスペース接続の使用

1. 接続を選択できる場合は、指定の接続を選びます。管理対象の @ChatGPT 環境やチームタスクでは、どの接続が選択されているかをオーナーに確認します。

使用するたびに、指定のアカウントの認証情報を入力し直す必要はありません。サインインを求められた場合は、承認しようとしている接続とアカウントを確認してください。

ワークスペース接続では、自分では開けないデータソースを読み取れる場合があります。ソースへのリンクがあっても、アクセス権は付与されません。生成されたファイルは接続されたアカウントでしか開けない場合があるため、共有する前に受信者のアクセス権を確認してください。

接続オーナーと利用者向け

管理とトラブルシューティング

設定変更の管理とアクセス権の削除

接続のニックネーム、表示対象、ロールを確認します。

接続の認可やプロバイダー側の権限が変わった場合は、接続オーナーにアクセスの復旧を、ワークフローのオーナーに再テストを依頼します。接続名を変更しても、外部サービスの権限は変わりません。

接続を無効にする前に、影響を受けるワークフローを各オーナーと確認します。接続を削除したら、対象のユーザーとワークフローがその接続を使用できなくなったことを確認します。

プロバイダー側の認可は別途取り消してください。ChatGPT 側で接続を無効にするだけでは、プロバイダー側の認可は取り消されません。

アクセスのトラブルシューティング

接続が見つからない場合は、まずワークスペースを確認します。ロールごとのアクセス権や表示対象の設定については、アクセスのトラブルシューティング表で確認を依頼する相手を特定してください。

失敗した書き込みや送信を再試行する前に、保存先や送信先を確認してください。エラーが表示されても操作自体は完了している場合があり、再試行すると重複が生じるおそれがあります。

関連ガイド

• プラグインの管理設定

• ChatGPT Work のクラウドセキュリティ