視覚的なセットアップのウォークスルー

このチュートリアルは、顧客所有のインストールの許可された管理者を対象としています。 DigLab が接続を管理している場合は、まず、 顧客のクイックスタート 割り当てられたエンドポイントを使用します。共有管理コンソールにアクセスする必要はありません。

スクリーンショットは、2026 年 10 月 27 日にキャプチャされた実際のインターフェイスを示しています。メニューとテンプレートの数は、リリース、アドオン、権限の範囲によって異なる場合があります。スクリーンショットを選択すると、フルサイズで開きます。プライベートレコードと作業資格情報は除外されます。

ステップ 1 明確な名前のサーバーを作成する#

開く サーバー → サーバーの作成。サービスと組織を識別する名前を入力し、オプションの説明を使用して意図された目的を説明します。架空の例として、次を使用します。 レコード例 のような説明が付いている オンボーディング用に承認された読み取り専用テストレコード.

必須の「サーバー名」フィールドとオプションの「説明」フィールドは、最初のステップに属します。このエントリを作成しても、ビジネス アカウントに接続したり、ソフトウェアの権利を付与したり、ツールが機能することを証明したりすることはありません。生成されたスラッグと、結果として得られるサーバー設定での受信認証を確認します。不完全な構成は非アクティブのままにしておきます。

ステップ 2 ツールの追加方法を選択します#

適切に準備されたコネクタが存在する場合は、開きます テンプレート、検索またはカテゴリ フィルターを使用して、その目的と認証要件を調べます。以下に示すメールボックス、データベース、およびファイルサーバーのテンプレートには、それぞれ独自の承認されたサービス接続が必要です。

カスタム API の場合は、文書化されたインポート ルートを使用するか、個別のツールを構築します。定義を受け入れる前に、インポート プレビュー、入力スキーマ、リクエスト メソッド、およびレスポンス マッピングを確認してください。インポートされた例を共有する前に、認証情報と個人データを削除してください。定義をインストールするだけでは、サービスへのアクセスは検証されません。

続けて インポートとテンプレート, 内蔵コネクタ または ツールを構築する.

ステップ 3 2 つの認証層を確認します#

インバウンド認証は、AI クライアントが使用する MCP 接続を保護します。アウトバウンド認証は、ビジネス サービスへのリクエストを承認します。両方のレイヤーで、目的の組織、ワークスペース、アカウントを一致させます。プラットフォームでサポートされている暗号化設定とプロバイダーの同意フローを使用します。ライブキーを説明、スクリーンショット、または共有ガイドに貼り付けないでください。

プライベート統合には明示的な認証が必要です。を確認してください サーバーガイド そして OAuth接続 インストールでサポートされているルートの場合。

ステップ 4 結果をテストする#

インスペクターまたは同意された AI クライアントを使用して、期待されるツールを検出し、承認されたテスト レコードに対して無害な読み取りを 1 回実行します。返された識別子とアカウント コンテキストをソースと比較します。無効な入力と認証の欠落が拒否されることを確認します。許可された範囲内でのみ書き込み操作をテストし、結果のレコードを確認します。

結果内のアップストリーム エラーには、緑色のバッジまたは HTTP 成功コードが伴う場合があります。成功を記録する前に、返されたコンテンツとエラー フィールドを確認してください。使用する テストと遊び場 テストシーケンスと トラブルシューティング よくある失敗について。

ステップ 5 割り当てられた接続を引き継ぎます#

正確なエンドポイント、サポートされている AI クライアント、認証方法、承認されたワークフロー、既知の制限、サポート ルートを提供します。合意された安全なチャネルを通じて資格情報を配信します。顧客は、自分のクライアントで検出と合意された読み取り専用テストを完了します。

管理された接続の場合、ハンドオフにより合意されたツールへのアクセスが許可されます。共有管理者アクセスは許可されません。独立したインストールの場合は、所有権、メンテナンス、およびバックアップの責任を含めます。フォローしてください オンボーディング設定手順 そして ホスティングモデル ガイドします。

スクリーンショットは責任を持って使用してください#

これらの画像はナビゲーションとフィールドの目的を教えます。これらは、プライベート エンドポイントを示したり、特定の顧客アカウントが接続されていることを示すものではありません。サポートをリクエストする場合は、合意されたサポート チャネルを通じて、関連するエラーと機密情報を隠したスクリーンショットを送信してください。資格情報、個人記録、無関係な顧客情報はキャプチャから除外します。