カスタムコネクタ

カスタムコネクタを使うと、組織の管理者が、組み込みカタログにないHTTPS API、または（有効な場合は）Streamable HTTP MCPサーバーを登録できます。ネットワーク境界と認証方式を定義します。エージェント向けの完全なAPIリファレンスを自動生成するわけではありません。

誰が何を設定するか

• 組織の管理者はコネクタ定義を作成・編集・削除します。
• メンバーは自分のシークレットを接続するか、コネクタのOAuthフローを完了します。
• エージェントの認可は、どのエージェントが接続済み認証情報を使えるか、どの名前付き権限を受け取るかを制御します。

定義は組織内で共有されます。メンバーの認証情報は、そのメンバーと組織に限定されます。

HTTP APIコネクタ

1. Connectors → Customを開き、New connectorを選びます。
2. HTTP APIを選び、表示名を入力します。
3. HTTPSのPrefixesを1行に1つ追加します。リクエストは、設定したプレフィックスに一致しないとコネクタが認可できません。
4. APIが認証を必要とする場合は追加します:
   • API authentication: ヘッダー名と、{{secret}}を含むヘッダーテンプレートを入力します（例: AuthorizationとBearer {{secret}}）。
   • OAuth 2.0: 認可URL、トークンURL、クライアントID、クライアントシークレット、スコープ、トークンエンドポイントの認証方式を入力します。フォームに表示される正確なリダイレクトURLをプロバイダーに登録します。
5. コネクタを作成します。必要な各メンバーはConnectを選び、シークレットを渡すかOAuthを完了します。
6. 必要なエージェントと権限を認可します。

既存のOAuth定義やクライアント認証情報を変更すると、現在のOAuth接続は切断されます。変更後にメンバーが再接続する必要があります。

MCPコネクタ

ワークスペースでコネクタタイプとしてMCPが表示される場合、HTTPSのStreamable HTTP MCPエンドポイントを入力し、同じフォームでAPIまたはOAuth認証を設定します。ピッカーにMCPが表示されない場合は、そのワークスペースでは有効になっていません。

エージェントにAPIの手順を教える

カスタムコネクタは安全なネットワークアクセスと認証情報の注入を提供します。作成フォームはOpenAPIドキュメントをアップロードしたり自動検出したりしません。リクエストでエンドポイント、メソッド、パラメーター、期待するレスポンスをエージェントに渡すか、その手順をAPIリファレンスをファイルとして添付したワークフローにまとめます。

新しいコネクタは、既知のエンドポイントへの狭い読み取り専用リクエストで検証します。多くのAPIは意味のあるルートエンドポイントを公開しないため、汎用的なTest connectionリクエストはありません。

セキュリティ境界

• 受け付けられるのはHTTPSプレフィックスとMCPエンドポイントのみです。
• ファイアウォールは、一致するリクエストにのみ保存済み認証情報を注入します。
• 保存されたシークレットは保存時に暗号化され、環境変数としてエージェントに公開されません。
• キー、トークン、クライアントシークレットをチャットメッセージ、ワークフローのインストラクション、添付ファイルに入れないでください。
• ワークフローが必要とする最小限の上流スコープを持つサービス認証情報を使います。

トラブルシューティング

次へ

• 繰り返しのカスタムコネクタ作業を残す方法はWorkflowsを参照。
• カスタムコネクタの認証情報の扱いはPermissionsを参照。
• 自作する前にCatalogを確認。あなたのサービスがすでにサポートされているかもしれません。