コネクタ

• —コネクタは外部のアプリをアシスタントにつなぎ、アシスタントがそのアプリで情報を調べたり操作したりできるようにします。Slack、Notion、Google Drive、HubSpot をはじめ、ほかに約 1,000 のアプリを接続できます。「Drive で提案書を探して、料金について何と書いてあるか教えてください。」「この最新情報を営業チャンネルに投稿してください。」コネクタはサイドバーの「コネクタ」にあります。
• —アプリを接続するには、一覧からアプリを選び、誰のためのものかと、アシスタントができることを選んでから、アプリ自身のサインインページで手続きを済ませるか、そのページにアプリのキーを貼り付けます。パスワードやキーが OpenEmail のチャット、API、アシスタントを通ることはありません。手続きが済むまでコネクタは保留中で、済んだあとは有効になります。
• —コネクタは、自分だけのものか、ワークスペース全体のものかのどちらかです。アシスタントは、コネクタを通じて情報を調べることだけができるか、変更も加えられるかのどちらかです。これはあとで変更でき、コネクタの一時停止と再開もできます。接続を解除すると、外部のアプリ側のアクセスも取り消されます。アプリが接続を受け付けなくなると、コネクタは再接続を求めます。新しいリンクを使えば、同じコネクタのまま元に戻ります。
• —チャットでは、アシスタントは接続済みのものを確認し、アプリで適切なアクションを見つけて、すぐに読み取ります。メッセージの送信、レコードの作成や更新、削除など、アプリ内の何かを変更する操作については、あなたが直接頼んだ場合でも、まずあなたが承認するためのカードを表示します。情報を調べるだけのコネクタは変更を拒否します。アプリが返す内容は情報として扱い、指示として扱うことはありません。
• —タスクがコネクタを使うのは、タスクの「追加ツール」で「コネクタ」をオンにした場合だけです。使うのはワークスペース用に接続されたコネクタだけで、1 人の個人に属するコネクタは使いません。読み取りは自動で行います。アプリでの変更は、タスクがほかに何を自動で行えるかにかかわらず、すべて「承認待ち」で待機します。また、コネクタを使うタスクが自動でメールに返信することはありません。返信はすべて、あなたの承認を待ちます。
• —コネクタを通じた呼び出しはすべて、90 日間記録されます。記録されるのは、日時、どのアプリのどのアクションか、読み取りか変更か、成功したかどうか、そしてチャット、タスク、API、エージェントのどこから来たかです。アプリに送った内容とアプリから返ってきた内容を、OpenEmail が保存することはありません。
• —誰が何をできるかは、3 つの権限で決まります。コネクタと、そこで行われた操作を見る権限、アシスタントにコネクタを使わせる権限、そしてアプリを接続・一時停止・接続解除し、アシスタントができることを設定する権限です。オーナーと管理者は 3 つすべてを持ち、Member は最初の 2 つ、Viewer は最初の 1 つを持ちます。アプリを接続できる人は、自分用にもワークスペース用にも接続できます。
• —プランで持てるコネクタは、アカウントにつき Free で 2 件、Starter で 10 件、Business で 50 件で、ワークスペースにもそれと同じ数だけ持てます。Enterprise はプラン独自の上限を設けていませんが、どの場合も 200 件を超えることはありません。ワークスペースが下位のプランに移ると、上限を超えた分は新しいコネクタから一時停止されます。削除はされません。
• —接続は外部のプロバイダーが保持します。このプロバイダーは、アシスタントがアプリに送った内容とアプリからの応答の記録も、最長 1 年間保持します。このプロバイダーは、プライバシーポリシーのページに記載されています。
• —コネクタは、REST API では /connectors、/connector-apps、/connector-categories、/connector-calls、各 SDK では connectors、コマンドラインでは openemail connectors、そして MCP サーバーから利用できます。API 経由では、変更は誰にも確認せずにすぐ実行されるため、判断するのは呼び出し元です。3 つの Webhook イベントが、ワークスペースのコネクタが接続されたとき、接続が解除されたとき、再接続が必要になったときに、あなたのシステムへ知らせます。

接続は 1 分ほどで済み、サインインはアプリ自身のページで行います。

1. 1サイドバーの「コネクタ」を開き、「アプリを探す」で、名前またはカテゴリからアプリを見つけます。
2. 2コネクタが誰のためのものかを選びます。自分だけか、ワークスペース全体かです。
3. 3アシスタントがコネクタを通じてできることを選びます。情報を調べるだけか、変更も加えるかです。
4. 4アプリのサインインページで手続きを済ませるか、そのページにアプリのキーを貼り付けます。手続きが済むまでコネクタは保留中で、済んだあとは有効になります。

• —アプリのパスワードやキーが OpenEmail のチャット、API、アシスタントを通ることはありません。
• —アプリが接続を受け付けなくなると、コネクタに「再接続が必要」と表示されます。新しいリンクを使えば同じコネクタのまま元に戻るため、そのコネクタを使うタスクは引き続き動作します。
• —アシスタントに使わせないようにするには、コネクタを一時停止します。また使いたくなったら再開します。
• —接続を解除すると、コネクタが削除され、コネクタが外部のアプリ側で持っていたアクセスも取り消されます。
• —コネクタは、サービス全体で無効にされることがあります。その場合、コネクタのページは表示されません。

• —オーナーと管理者は 3 つすべてを持ちます。組み込みの Member ロールは connectors:read と connectors:use を、Viewer は connectors:read を持ちます。
• —同じ権限が、両方の種類のコネクタに適用されます。アプリを接続できる人は、自分用にもワークスペース用にも接続できます。

コネクタは、REST API では /connectors、/connector-apps、/connector-categories、/connector-calls の下、各 SDK と CLI では connectors の下にあり、MCP ツールにもあります。MCP ツールはアシスタントも使います。