Crescendo Lab ドキュメント
日本語
無料で始める

連携

リモート MCP サーバーをコネクタとして登録し、アカウントを接続してアシスタントに追加すると、アシスタントが会話の中で外部サービスを検索・操作できます。呼び出しには毎回人の承認が必要です。

最終更新

連携でできること#

連携は外部サービスの MCP サーバーをワークスペースにつなぎ、Agent Lab がほかのシステムにあるデータ(Notion のページや GitHub の issue など)を検索・操作できるようにします。コネクタとアカウントはワークスペース全体でまとめて管理します。コネクタをアシスタントに追加すると、アシスタントが会話の中でそのツールを呼び出せるようになります。

Agent Lab では、外部の MCP サーバーを コネクタ と呼びます。流れは 4 ステップです。

  1. コネクタを追加する サイドバーの「連携」で「人気のサービス」から選ぶか、MCP サーバーの URL を自分で入力します。
  2. テストする Agent Lab がそのサーバーにつながるかを確認し、提供されるツールを確認します。
  3. アカウントを接続する 認証が必要なサービスでは、トークンを渡すか、サインインして認可します。
  4. アシスタントに追加する アシスタントのページでこのコネクタを選び、アシスタントが呼び出せるツールを選びます。

アシスタントが会話の中でコネクタのツールを呼び出そうとすると、いったん止まり、誰かが承認してから実行します。詳しくは会話の中での認可と承認をご覧ください。

誰が何をできるか#

操作ワークスペースのオーナー、管理者一般メンバー
コネクタと状態を見る、「テスト」「ツールを確認」を選ぶ可可
コネクタを追加する(「カスタムコネクタを追加」)可不可
ツールを「読み取り専用として保証」する可不可
「自分のみ」の範囲で自分のアカウントを接続する可可
「ワークスペースで共有」の範囲でアカウントを接続する可不可
自分の接続を切断する可可
ワークスペースで共有の接続を切断する可不可
データを書き込む、またはまだ読み取り専用と保証されていないツールの呼び出しを承認する可不可
読み取り専用と保証済みのツールの呼び出しを承認する可可

一般メンバーが「カスタムコネクタを追加」を開くと、「ここを変更できるのはワークスペースのオーナーと管理者のみです。閲覧はできますので、変更が必要な場合は依頼してください。」と表示されます。オーナーか管理者に頼んでください。

コネクタをアシスタントに追加するには、そのアシスタントを編集する権限が必要です。公開済みでワークスペース全体に共有されたアシスタントには、それを公開できる人(オーナー、管理者、またはチームのアシスタントならチームのマネージャー)が追加します。権限の詳細はアシスタントをご覧ください。

コネクタを追加する#

「連携」の「コネクタ」タブを開きます。

ページ下部の「人気のサービス」には、よく使われるサービスの MCP サーバーが並んでいます。GitHub、Notion、Linear、Sentry、Atlassian(Jira と Confluence)、Asana、Figma、Intercom、Webflow、monday.com、Airtable、GitLab、Wix、Supabase、Vercel、Shopify Storefront、Stripe、PayPal、Zapier、Postman、Hugging Face、Cloudflare Docs、DeepWiki、Context7 などです。各カードにはそのサービスの認証方式が表示されています。

「使う」を選ぶと、Agent Lab が名前、URL、認証方式、説明を下の「カスタムコネクタを追加」フォームに入力します。カードは入力を手伝うだけで、この時点ではまだワークスペースに追加されていません。サービスの URL は変わることがあるので、送信する前にそのサービスの公式ドキュメントで確認してください。追加済みのサービスのカードには「追加済み」と表示されます。

Zapier

Zapier のカードは、Zapier で設定したアクションにつながり、アシスタントが Zapier 経由で数千のサービスを使えるようにします。認証は「サインイン(OAuth)」です。

Shopify Storefront の URL は、your-store を自分のストアのドメインに置き換えてください。

自分で入力する

HTTPS で提供されているリモート MCP サーバーなら、自分で運用しているものも含めて追加できます。「カスタムコネクタを追加」で次の項目を入力します。

項目説明
「名前」コンソールとアシスタントのページに表示される名前。
「サーバー URL(https)」MCP サーバーの完全な URL。https:// である必要があります。
「認証方式」このサーバーへの接続に使う認証方式。下の表をご覧ください。
「説明(任意)」このコネクタの用途。

「登録」を選ぶと完了です。追加したコネクタは「コネクタ」の一覧に表示されます。

「認証方式」は 4 種類あります。

認証方式向いている場合接続時に必要なもの
「なし(公開)」アカウント不要の公開サーバー接続は不要で、アシスタントに追加すればすぐ使えます
「API トークン」固定のトークンで認証するサーバー「Bearer トークン」
「OAuth クライアント資格情報」OAuth client credentials で認証するサーバー「クライアント ID」と「クライアントシークレット」
「サインイン(OAuth)」サービスのサイトでサインインして認可に同意するサービスのページでサインインします。Agent Lab にパスワードを入力する必要はありません

現在、追加したコネクタをコンソールで削除したり無効にしたりすることはできません。使わなくなったら接続を切断し、アシスタントから外してください。

テストとツールの確認#

「コネクタ」一覧の各行には 3 つの操作があります。

  • 「テスト」:Agent Lab がサーバーに接続してツールの一覧を読み取り、見つかったツールの数と、そのうちサーバーが読み取り専用と表示しているものの数を知らせます。Agent Lab はバックグラウンドでも定期的に自動テストします。
  • 「ツールを確認」:このコネクタのすべてのツールと、それぞれのリスク表示を一覧にします。
  • 「接続」:アカウントを接続するフォームを開きます。アカウントを接続するをご覧ください。認証方式が「なし(公開)」のコネクタにはこのボタンはありません。

「状態」列には「利用可能」「利用不可」「未テスト」のいずれかが表示されます。オーナーと管理者には、前回失敗した理由もその下に表示されます。1 つのサーバーで扱えるツールは最大 200 個で、超えた分は状態の下に注記されます。

ツールを読み取り専用として保証する

「ツールを確認」では、各ツールの横に 2 つのラベルがあります。

  • サーバー自身の申告:「サーバーの表示:読み取り専用」「サーバーの表示:データを変更」「サーバーの表示なし」。これは参考情報で、どのルールも変えません。
  • ワークスペースの判断:「確認済み:読み取り専用」または「未確認」。

ツールがデータを読み取るだけだと確認するまで、Agent Lab はそれをデータを変更する可能性があるツールとして扱い、アシスタントが呼び出したときに承認できるのはオーナーと管理者だけです。オーナーか管理者が、ツールが本当にデータを読み取るだけだと確認したら、「読み取り専用として保証」を選べます。以後は一般メンバーも呼び出しを承認できます。取り消すには「取り消す」を選びます。

アカウントを接続する#

認証が必要なコネクタは、先にアカウントを接続しないとアシスタントが使えません。「コネクタ」一覧で「接続」を選びます。

  1. 「範囲」を選びます(この選択肢が表示されるのはオーナーと管理者だけで、一般メンバーは常に「自分のみ」です)。 - 「ワークスペースで共有」:ワークスペースが資格情報を 1 つ保管します。アシスタントは質問した人ではなく、この資格情報の ID で動作します。このアシスタントを使う人は誰でも、この資格情報がアクセスできるものすべてにアクセスできます。 - 「自分のみ」:あなた自身の資格情報です。アシスタントはあなたが質問したときだけこれを使い、見えるのはあなたが見られる範囲です。
  2. 共有の範囲では「識別名(任意)」を入力できます。例:「読み取り専用クエリ」。同じサービスの複数の共有資格情報(読み取り専用と読み書きを 1 つずつなど)を区別するために使います。
  3. 認証方式に応じて資格情報を渡します。 - 「API トークン」:「Bearer トークン」を入力し、「資格情報を送信」を選びます。 - 「OAuth クライアント資格情報」:「クライアント ID」と「クライアントシークレット」を入力し、「資格情報を送信」を選びます。 - 「サインイン(OAuth)」:「認可へ進む」を選び、サービスのサイトでサインインして同意すると、Agent Lab に戻ります。

サービスがデバイスコードに対応している場合は、「デバイスコードで接続」も選べます。画面にコードが表示されるので、「プロバイダーのページを開く」を選んでコードを入力し、認可が終わったら戻って「認可しました — 確認」を選びます。

資格情報は暗号化して保管され、ツールが実際に実行されるときだけ取り出されます。

接続が終わると、アカウントは「接続済みアカウント」の欄に表示され、コネクタ、「範囲」、状態が一覧になります。範囲の下には、その接続の権限が説明されます。

  • 「各メンバーとして、期限付きの認証情報で動作します。」または「各メンバー自身のキーで動作します。キーに期限はありません。」:各メンバーは自分のアカウントで読めるデータだけを読みます。
  • 「質問した人ではなく、ワークスペースとして動作します。使う人は誰でも、これがアクセスできるものすべてにアクセスできます。」:権限の区別はサービス側で設定する必要があります。

アシスタントにコネクタを使わせる#

コネクタをワークスペースに追加したら、さらにアシスタントに追加すると、アシスタントがそれを使うようになります。

アシスタントのページを開き、「アクション(詳細)」のステップで「接続済みのシステム」(プライベートアシスタントは「あなたのコネクタ」)を探します。

  1. コネクタを選ぶ 「コネクタを選択」メニューでコネクタを 1 つ選びます。
  2. ツールを選ぶ 「このアシスタントが呼び出せるツール」で使わせるツールを選びます。少なくとも 1 つ必要です。アシスタントが本当に必要とするツールだけを許可してください。
  3. 使う ID を選ぶ 認証が必要なコネクタでは「使用する ID」メニューが追加されます。下の説明をご覧ください。
  4. 追加する 「このアシスタントに追加」を選びます。

「使用する ID」は、アシスタントが誰の資格情報を使うかを決めます。

  • 「各メンバー自身の資格情報」(固定しない):質問した人が「自分のみ」で接続したアカウントを、アシスタントがその人の質問で使います。まだ接続していない人が質問すると、アシスタントはこのコネクタのツールを使えず、会話の中で自分のアカウントを接続するよう案内されます(会話の中での認可と承認を参照)。
  • 共有 ID を固定する:「ワークスペースで共有」の資格情報を 1 つ選び、アシスタントは誰に対してもこの同じ ID を使います。アシスタントがワークスペースの共有資格情報を使うのは、固定したときだけです。プライベートアシスタントで共有 ID を固定できるのは、オーナーと管理者だけです。

追加済みのコネクタには、その ID のモード(「各メンバー自身のアカウント」や「共有 ID を固定」など)、権限の説明、許可したツールが表示されます。外すときは「削除」を選びます。

選べるコネクタが一覧にない場合は、「追加できるコネクタがありません。「連携」ページで登録してから、ここに追加してください。」と表示されます。アシスタントのほかの設定はアシスタントをご覧ください。

会話の中での認可と承認#

自分のアカウントがまだ接続されていない

アシスタントがあなたの未接続のサービスを使おうとすると、会話に「このアシスタントは、あなたが未接続のサービスに接続できます」と表示されます。接続するまで、アシスタントはこれらのツールを使わずに答えます。接続の方法は、サービスの認証方式によって異なります。

  • トークンで接続するサービス:「自分のアカウントを接続」を選び、「あなたのアクセストークン」にトークンを貼り付けて「承認」を選ぶと、会話がツール付きで続きます。
  • ほかのサービス(「サインイン(OAuth)」など):トークンの入力欄はなく、「「連携」で接続」が表示されます。選ぶと「連携」ページが開き、このコネクタの接続フォームが開いた状態になっていて、範囲は既定で「自分のみ」です。接続したらこの会話に戻り、メッセージをもう一度送ります。

こうしたサービスは「連携」からしか接続できず、プラットフォームが代わりにトークンを直接保存することはありません。

ツールの呼び出しを承認する

アシスタントがコネクタのツールを呼び出そうとするたびに、いったん止まって「アシスタントがアクションを実行しようとしています」と表示し、送信しようとしている内容とリスク表示を示します。

表示意味承認できる人
「読み取り専用」ワークスペースがこのツールを読み取り専用と保証していますワークスペースのどのメンバーでも
「外部システムに書き込みます」このツールはデータを変更しますオーナー、管理者
「リスク未申告のため破壊的として扱います」ワークスペースがまだ保証しておらず、Agent Lab はデータを変更する可能性があるものとして扱いますオーナー、管理者

内容を確認したら、「承認して実行」か「拒否」を選びます。承認の権限がないメンバーには「拒否」だけが表示され、カードに「この操作を承認できるのはワークスペースのオーナーか管理者だけです。ここで承認してもらうか、拒否してください。」と書かれています。コネクタのツールが自動で実行されることはなく、毎回人の承認が必要です。会話のほかの操作は会話をご覧ください。

接続を切断する#

「接続済みアカウント」でその行を探し、「切断」を選びます。一般メンバーが切断できるのは自分の「自分のみ」の接続だけで、ワークスペースで共有の接続はオーナーか管理者が切断します。切断すると状態が「切断済み」になり、アシスタントはこの資格情報を使えなくなります。

状態が「再ログインが必要」の場合は、認可が無効になっています。「コネクタ」一覧でもう一度「接続」を選んでください。

特定のアシスタントだけがあるコネクタを使わないようにしたい場合は、アシスタントのページの「接続済みのシステム」で「削除」を選べば十分で、ワークスペース全体の接続を切断する必要はありません。

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

  • 「コネクタを追加できませんでした。名前と https の URL を確認してください。」:名前と URL の両方が必要で、URL は https:// で始まる必要があります。
  • テストに失敗する:サーバーにつながらないか、資格情報の権限が足りない可能性があります。オーナーと管理者は、「状態」の下にサーバーが返した理由を確認できます。
  • サインインでの認可に失敗する:「サインイン(OAuth)」には、サーバーが OAuth の動的クライアント登録に対応している必要があります。対応していない場合は、「API トークン」または「OAuth クライアント資格情報」でコネクタを追加し直してください。
  • 「デバイスフローを開始できませんでした。プロバイダーが対応していない可能性があります。」:「認可へ進む」を使ってください。
  • アシスタントがコネクタのツールを使わない:コネクタがこのアシスタントに追加され、必要なツールが選ばれているかを確認します。固定していない場合は、質問する人が先に「自分のみ」で自分のアカウントを接続する必要があります。
  • 「このコネクタのツールはまだ判明していません。まず「連携」ページで状態を確認してください。」:先に「連携」で「テスト」を選び、ツールが読み取れてから追加し直します。