> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat/connected-services.md).

# 接続済みサービス

Agent が自分に代わってアクセスする外部サービスをユーザー自身で管理します。Agent マーケットプレイスと Web Chat の「接続済みサービス」で認可状況の確認、再認可、接続解除を行う方法と、管理者が事前に行う設定を説明します。

Agent が**あなた自身のアカウント**でカレンダーを確認したり、クラウドドライブのファイルを読んだり、外部システムを操作したりする場合は、まず会話の中で認可を求めます。認可したサービスはすべて <mark style="color:blue;">接続済みサービス</mark> ウィンドウにまとめて表示されます。認可状況や有効期限の確認、再認可ができ、いつでも接続を解除できます。ユーザー自身で管理できるため、管理者に依頼する必要はありません。

{% hint style="info" %}
このページでは、Agent マーケットプレイスと Web Chat のユーザーを対象に、Agent が自分に代わってサービスにアクセスするための認可を説明します。MaiGPT ユーザーが「＋」メニューから接続する Notion、Slack などのコネクタは別の入口を使用します。[MaiGPT コネクタ](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/connectors.md)をご覧ください。
{% endhint %}

## 開く場所 <a href="#where-to-open" id="where-to-open"></a>

| 利用場面                                                                            | 入口                                                                                                                                                                                                                               | 表示対象                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 管理画面 → <mark style="color:blue;">Agent マーケットプレイス</mark> → **公式の組み込み Agent** と会話 | 会話ページ上部の <mark style="color:blue;">接続済みサービス</mark> ボタン                                                                                                                                                                           | 公式の組み込み Agent と会話するすべてのメンバー（組織が独自に作成した Agent の会話ページには、このボタンは表示されません）                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Web サイト上の Web Chat（全画面ページまたは公開アクセス URL）                                         | タイトルバーのリンクアイコンです。カーソルを合わせると「接続済みサービス」と表示されます。チャットプラットフォームの[接続済みサービスを表示](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/function-settings.md#show-connected-services)を有効にする必要があります | 本人確認済みの訪問者：[ログイン](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat.md#login-config)済み、または Web サイトから [Source ID](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat/source-id-access.md) で本人の識別情報が渡されている訪問者です。[Pre-chat フォーム](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat.md#pre-chat-form)に入力しただけの訪問者は、本人確認済みとはみなされません（フォームのデータは本人認証を経ていないためです）。これらの訪問者と匿名の訪問者には表示されず、右下のフローティングウィンドウと MaiGPT ウィンドウモードでも表示されません |

## 初回の認可：会話内の認可カード <a href="#authorization-card" id="authorization-card"></a>

Agent が初めてサービスを必要とすると、会話に「{サービス}に接続」カードが表示されます。カードには <mark style="color:blue;">取得する権限</mark> が一覧表示され、認証情報はバックエンドで暗号化して保存され、ブラウザには保存されないことが説明されます。<mark style="color:blue;">認可に進む</mark>（管理画面では <mark style="color:blue;">接続を認可</mark>）をクリックすると、新しいウィンドウが開き、そのサービスにログインして同意できます（アカウント名やパスワードはサービスの公式ページにのみ入力し、MaiAgent が取り扱うことはありません）。完了するとカードが「{サービス}に接続済み」に変わり、Agent はあなたの認証情報を使ってデータの取得を続けられます。

{% hint style="warning" %}
「ブラウザが新しいウィンドウをブロックしました。ポップアップを許可してから再試行してください」と表示された場合は、ブラウザでこのサイトのポップアップを許可してから、もう一度認可ボタンをクリックしてください。
{% endhint %}

{% hint style="info" %}
認可ウィンドウを閉じた後、カードは十数秒間、認可結果の確認を続けます。通常はすぐに「{サービス}に接続済み」に変わります。待っても変化がない場合は、もう一度認可ボタンをクリックしてください。
{% endhint %}

## ウィンドウの内容 <a href="#window-layout" id="window-layout"></a>

<mark style="color:blue;">接続済みサービス</mark> を開くと、左側にサービス一覧、右側に選択したサービスの詳細が表示されます。

**左側の一覧**

* <mark style="color:blue;">サービスを検索…</mark> で名前による絞り込みができます。
* 各サービスには、<mark style="color:blue;">認可済み</mark>（利用可能）、<mark style="color:blue;">認可待ち</mark>（まだ認可していない）、<mark style="color:blue;">再接続が必要</mark>（認可が無効になっており、Agent が現在データを取得できない）のいずれかの状態が表示されます。
* 一覧が空の場合は「接続可能なサービスはまだありません」と表示されます。利用しているどの Agent にも、あなた個人の認可が必要なサービスがないことを意味します。

**右側の詳細**

| セクション                                              | 内容                                                                                                                                                                                                                                                                           |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 状態メッセージ                                            | 認可待ちの場合は「未認可」と <mark style="color:blue;">接続を認可</mark>、再接続が必要な場合は「接続が無効になりました。再認可が必要です」と <mark style="color:blue;">再認可</mark> が表示されます。再認可によって、そのサービス内のコンテンツに影響が及ぶことはありません                                                                                                     |
| <mark style="color:blue;">このサービスを使用するアシスタント</mark> | この認可を使ってデータにアクセスする Agent が表示されます                                                                                                                                                                                                                                             |
| <mark style="color:blue;">認可情報</mark>              | <mark style="color:blue;">認可アカウント</mark>（そのサービスにログインしたアカウント）、<mark style="color:blue;">認可方式</mark>（OAuth 2.0）、<mark style="color:blue;">認可日時</mark>、<mark style="color:blue;">認証情報の有効期限</mark>（例：「N 日後」）、<mark style="color:blue;">Token の保存方法</mark>（バックエンドで暗号化して保存）が表示されます |
| 認可スコープ                                             | 認可済みのサービスには <mark style="color:blue;">認可済みスコープ</mark>、未認可のサービスには <mark style="color:blue;">要求する認可スコープ</mark> が表示されます。認可する前に内容をよく確認してください                                                                                                                                     |
| <mark style="color:blue;">接続を解除</mark>             | 次のセクションをご覧ください                                                                                                                                                                                                                                                               |

## 接続の解除 <a href="#disconnect" id="disconnect"></a>

サービスの詳細で <mark style="color:blue;">接続を解除</mark> をクリックすると、確認ウィンドウに「次のアシスタントに影響します」と表示されます。確定すると、これらの Agent は直ちにあなたに代わってそのサービスにアクセスできなくなります。後で利用するには、再度認可する必要があります。

{% hint style="info" %}
接続の解除は、MaiAgent 側に保存されている認証情報を取り消す操作です。「プラットフォーム側の接続を解除しました。完全に削除するには、{サービス}のアカウント設定を確認してください」と表示される場合、そのサービス側では MaiAgent が認可済みアプリケーションとして残っている可能性があります。完全に削除するには、そのサービスのアカウント設定でも認可を取り消してください。
{% endhint %}

## よくある質問 <a href="#faq" id="faq"></a>

### サービスに「再接続が必要」と表示され、Agent がデータを取得できないと回答しますか？ <a href="#faq-reauthorize" id="faq-reauthorize"></a>

認可の認証情報が期限切れになっています。<mark style="color:blue;">接続済みサービス</mark> を開き、該当するサービスを選択して <mark style="color:blue;">再認可</mark> をクリックしてください。完了後、もう一度 Agent に質問してください。

### 「接続済みサービス」ボタンが見つかりませんか？ <a href="#faq-no-button" id="faq-no-button"></a>

* Web Chat：現在、匿名の訪問者として利用しているか、右下のフローティングウィンドウを使用しています。全画面ページで開き、先にフォームに入力するか、ログインしてください。
* Web Chat：Web サイトの管理者が、このチャットプラットフォームの[接続済みサービスを表示](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/function-settings.md#show-connected-services)を無効にしています（新規作成したプラットフォームではデフォルトで無効です）。Web サイトの管理者にお問い合わせください。
* 管理画面：このボタンは、公式の組み込み Agent の会話ページにのみ表示されます。

### 誰のアカウントを認可しますか？ほかの同僚にも使われますか？ <a href="#faq-whose-account" id="faq-whose-account"></a>

そのサービスにあなた自身がログインしたアカウントです。あなた自身と Agent の会話でのみ使用されます。ほかの人が同じサービスを使う場合は、それぞれで認可する必要があります。管理者が組織全体で 1 つのアカウントを共有したい場合は、ツールの作成時に認可対象を「組織で共有」に設定します。そのようなサービスは、このウィンドウには表示されません。

## 管理者向け：サービスをここに表示するには <a href="#for-admins" id="for-admins"></a>

Web Chat の訪問者に入口を表示するには、チャットプラットフォームの <mark style="color:blue;">機能設定</mark> → <mark style="color:blue;">接続済みサービスを表示</mark> を有効にする必要があります。新規作成したプラットフォームではデフォルトで無効です。[機能設定：接続済みサービスを表示](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/function-settings.md#show-connected-services)をご覧ください。

このウィンドウには、Agent に設定されている OAuth MCP ツールのうち、認可対象が「連絡先ごとの個別認可」のものが表示されます。設定方法は [MCP ツールの作成：OAuth コネクタと認可対象](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/mcp-setup.md#oauth-auth-subject)をご覧ください。管理者は、<mark style="color:blue;">連絡先</mark> の編集ウィンドウにある <mark style="color:blue;">Connector 認可</mark> タブで、特定の連絡先の認可を確認したり、取り消したりすることもできます。既存システムの認証情報を連絡先にあらかじめ設定する方法（OAuth を使用しない場合）は、[連絡先の MCP 認証情報設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/setup-contacts-mcp-credentials.md)をご覧ください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/web-chat/connected-services.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
