メインコンテンツまでスキップ

コネクターおよび資格情報

Connector は、サービスのツールをエージェントに利用できるようにします。 そのサービスは、そのサービスが要求する際の認証をクレデンシャルサプライズします。 Skill をインストールするか、タグを割り当てると、サービスが接続されません。

バッチ管理では、操作を適用する前に、選択したカウントを下部のアクション領域で確認します。 完了または失敗のフィードバックを読んで、その結果の項目を確認してください。 エントリーのみを選択すると、有効化、インストール、削除は行いません。

ビルトインConnectorを使う​

遺伝子発現プロジェクトのためのツールを探す​

Settings → Connectorsを開き、Omics アーカイブを検索し、詳細を開きます。 このビルトインファミリーには、GEO、ArrayExpress、MetaboLights、MGnify、PRIDEツールが含まれています。 選択する前にツールの行を拡大します。

GEOメタデータツールとその明示的なダウンロード境界

geo_get_series は、GEO シリーズのメタデータ、サンプル、プラットフォーム、および補足ファイル URL を返します。 返されたソースから必要なデータテーブルをダウンロードし、計算を要求する前にプロジェクトに添付してください。

トランスクリプトオミクス などのタグを Connector に割り当て、Settings → Tags で見つけます。 タグは、アクセスやツールの承認を変更することなくリソースを整理します。

状態それが確立するもの次の検証
ディレクトリにリストアプリは Connector 定義を知っています。実際のツールの説明を読む
Used byエージェントの可用性目的の代理店および機能結合を確認して下さい
選択された資格名前付きバインディングが存在します意図したサービスに対するテスト認証
ツールポリシーコールが許可されているか、要求されるか、または妨げられるかどうか記憶された許可の優先順位を点検して下さい
成功したツール結果特定のコールが完了しました返された識別子/データおよびソースの検証

内蔵Connector制御​

Search connectors を使用して、Directory の下で PubMed を検索します。 リストには、Featured と Custom のグループも含まれています。 マッチング結果が下に見える間、フィルタリングはグループごとに適用されますので、別のグループはコネクターがあなたの検索に一致しませんを言うことができます。

Filter connectors by group、Filter Connectors by agent、Filter by Tagを一緒に検索して使用してください。 Manage credentials は、共有の連絡先メール/認証設定を開きます。 Used by は空室状況を表示します。 Manage TagsはConnectorを整理します。 リソースのManage access制御を使用して、Mainエージェントとスペシャリストへのアクセスを1か所で確認し、調整します。

各エージェントへのアクセスの管理​

  1. Settings → ConnectorsでConnectorを見つけ、Manage accessコントロールを選択します。
  2. メインエージェントとリストされているスペシャリストのレビュー。 利用可能な場合、ロールリストを検索します。 目的の関連付けだけを変更します。 ロールエディタは、その機能リストを管理するための別の方法を残します。
  3. ポップアップを開き、Used byを確認してください。 結合は無効なSpecialistに割り当てることができます; そのロールを有効にしないと割り当てる。

Mainエージェントと個人スペシャリストのConnectorアクセス

このConnectorを除くFull accessのロールは、リソースごとの例外を作成します。 選択したアクセスを持つロールは、明示的なリストを使用します。 マーケットプレースのロールバインディングは、ここでのみ読み込みます。 犯罪者、サーバーの信頼性および操作の承認は、これらの協会とは別です。 Connector の割り当ては、これらの手順を完了しません。

複数のコネクタの有効または無効化​

Settings → Connectors を開き、リストをフィルタリングし、関連するグループで Select multiple を選択し、意図したコネクタを選択します。 選択されたカウントを有効または無効にする前に確認し、各返された状態を確認します。 作業に必要なサービスのみを有効にしてください。 バルク可用性の変更は、資格情報を提供していません。, パーツールの承認ポリシーを変更したり、Specialistアクセスを許可します。; それぞれ設定します。

PubMed: 可用性、ツール、および承認ポリシー​

  1. パブメッドを検索し、詳細を開きます。
  2. search_articles を拡張し、説明を読んでください。 PMIDsのカウントとページを返し、PubMedクエリタグ、Boolean演算子、日付、およびソートをサポートしています。
  3. Require approval、Block、Always allow を選択して、許可するアクセス権を取得します。 承認の表示 Ask when no Session, Project, or Global permission applies. を要求して下さい
  4. Manage access で PubMed の Main Agent を有効にし、Used by を確認します。同じポップアップで、利用させる各 Specialist の設定を個別に確認します。

PubMed ツールの説明と承認制御

search_articles、get_article_metadata、find_related_articles、lookup_article_by_citation、convert_article_ids、get_full_text_article、get_copyright_statusの詳しいリストです。 ツールごとにAlways allow、Require approval、Blockを選択してください。 Connector-ワイドSkip approvalsスイッチを別々に見直し、有効化します。 説明を開くだけで、ツールの指示が表示されます。

Directory のディレクトリは、Featured のバッジを表示している。 ディレクトリ配置とバッジは、アカウントの接続状況を示すものではありません。

小さなGEOメタデータルックアップを実行

小さなGEOメタデータルックアップを実行​

実践例 GEOでGSE60450サンプルメタデータを調べる

  1. 研究セッションに戻り、作業モデルとOmicsのアーカイブの可用性を確認します。
  2. お問い合わせ: Use Omics Archives geo_get_series to retrieve GSE60450 metadata. Report the title, organism, sample count and source-identified sample characteristics. Do not download count tables or run a new expression analysis.
  3. 要求されたConnector/methodと引数を調べて、許可します。 ツールは、accessions 配列を期待します。 推測された単数フィールドが間違っています。
  4. 実際の結果を確認します。 このアクセスについては、返されたGSE60450、ムスカルス、12サンプル、および「乳食対妊娠中の哺乳類の腹部および血管細胞サブポピーションのトランスクリプト分析」のタイトルを確認してください。
  5. 返されたGSM識別子を特性に保ちます。 行列の MCL1 列名を単独で囲む必要はありません。

Connectorで返された実際のGEOサンプル特性

返されたサンプル範囲は、Luminal/basalの人口と処女、18.5日妊娠および2日授乳段階をカバーしたGSM1480291-GSM1480302でした。 これらは、カウント合計から推論されるラベルではなく、メタデータを返します。 地理サンプルメタデータ.csvとして全12列応答テーブルをダウンロードしました。 これは、管理されたQCのアーティファクトから分離された会話テーブルのエクスポートです。

Connector 命令ファイルが見つからない場合は、EPERM エラーを保持し、有効な Connector と現在のセッションを確認します。 再試行の前に Connectorパラメータ の操作フィールドを確認します。 有効なメタデータクエリは構造化されたレコードを返します。 アンダーリーティングのソーステーブルをダウンロードしたり、解析を実行したりしません。

コネクターを追加します。: 共有アイデンティティ フィールド​

Add connectorはLocal command、Remote server、Import configurationを提供しています。 エディタをタイプセレクターで開く最初の2つは、Advanced settingsは追加のフィールドを公開します。 スクリーンショットは、イラストのエンドポイントを使用します。 実際に利用するサーバーを接続します。

フィールド業務内容
コネクタの種類ローカルプロセスとリモートエンドポイント間の切り替え。
表示名UIに表示されている名前。
上級 → Connector 名使用する呼称名 host.mcp, Specialist 結合, 生成された MCP Skill; 可能な表示名から生成される。
コネクタ ID可能であれば生成される任意安定したID。 作成前の編集可能、その後の不変。
説明提供されるデータ/アクションのオプションの説明。
このコネクタを信頼しますカスタムConnectorを加える前に必須の信頼の認識。 本サービスを検証したり、コードを安全にしたりすることはありません。
取消/コネクターに戻るフォームから送信してください。 ドラフトを保存しません。
コネクターを加えて下さい/加え、署名して下さい有効な設定を保存し、OAuth でサインインします。 必要なフィールド、バインディング、またはトラストが欠落している間、ボタンは無効です。

ローカルコマンド​

Commandはnpx — Node package、uvx — Python (uv)、node — script file、python3 — script file、docker — containerおよびOther…を提供します。 その他のCustom commandは、絶対実行可能なパスを明示します。

高度な入力操作
引数行ごとの1つの引数; スペースとブランクの線が保存されます。 すべての引数を削除するためにフィールドをクリアします。 スペース区切りのシェルコマンドは複数の引数にパースされます。
変数名環境変数の名前をつけて下さい、それから選択して下さい/クリデンシャルを創作して下さい。
変数の追加/変数の削除名前付き結合を追加または削除します。
フィールド/テキスト名前を構造化された行または 1 つとして入力して下さい KEY= ラインごとの; 秘密の値は、クレデンシャルに住んでいます。
コマンドプレビュー結合の後で示される進水器を点検して下さい。

ローカルコマンドエディタとクレデンシャル・バウンド環境変数

ランチャーエントリーだけでは、その実行可能またはサービスが運用されていることを証明しません。 インポートされたローカルコマンドをチェックするには、下の呼び出しを使用してください。

リモートサーバー​

サーバ事業者が供給する実際のServer URLを入力してください。 これらのスクリーンショットのhttps://example.org/mcpは、動作するMCPエンドポイントではなく、機能的な予約ドメインアドレスです。

Advanced → Transport デフォルトは Streamable HTTP です。 AuthenticationはNone、OAuth (browser sign-in)、Static headersを提供しています。

静的ヘッダー​

現在のエディタは、認証情報にバインドします。 単なる秘密値のテキスト領域ではありません。

  1. Static headers を選択します。
  2. AuthorizationなどのHeader nameを入力してください。
  3. 対応するCredentialを選択または作成します。 ヘッダーが名前を持っているまでセレクターは無効です。
  4. Add header は、別の行または Remove header で行を破棄します。
  5. フィールド/テキスト は、名前の入力を変更します。 テキスト モードは、Name: として 1 行につき 1 つのヘッダー名を期待します。 クレデンシャル値が別途管理されます。

静的ヘッダー名とクレデンシャルセレクター

OAuthバインディング​

リソースURL、トランスポート、登録に一致するOAuth credentialを選択します。 New credential は クレデンシャルエディタ を開きます。 この空のプロファイルでは、フォームはNo OAuth credential matches this Connector's resource URL, transport, and registration.を報告しました。最終的なアクションはAdd and sign inに変わります。

OAuth 認証マッチング

インポート、エクスポート、接続テスト​

Add connector → Import configuration を選択し、JSON ファイルを 256 KB まで選択します。 輸入業者は受け入れます Open-Science Connector 設定または設定 MCP クライアントファイルを含む mcpServers. . . .

  1. マルチサーバファイルの場合は、MCP server のエントリーを選択します。 1つのサーバーを一度に見直し、追加します。 エントリを切り替えた後、名前、ID、転送、コマンド引数をチェックします。
  2. 診断を読んで下さい。 別のコンピュータで絶対パスを変更する必要があるかもしれません。 輸入からクレデンシャル値が除外されます。
  3. Use configuration を選択して、プレフィルドエディタを開きます。 すべてのフィールドを見直し、必要なローカル資格情報を結合し、I trust this connectorを選択します。
  4. Add connectorを選択し、リスト内の接続状態を調べ、小さな読み取り専用ツールを呼び出します。

サーバーを選択し、必要な資格情報を確認する

インポートされたサーバが QC_EXAMPLE_TOKEN などの環境変数を参照する場合、このデバイスに保存されているクレデンシャルにその名前をバインドします。 Addは、必要なバインディングが完了するまでは利用できません。 追加後、Connected を確認し、意図したツールを実行します。 保存された結合は、リモート認証を検証しません。

get_dataset_summary を呼び出すと、返されたフルサンプル ID を get_sample_qc に渡します。 QCのベースライン との応答を比較します。 このサーバーは保存されたサマリー値を返します。 元の行列を返さない。 カスタムツールを作成する でサーバの実装がカバーされます。

輸出入・輸出入​

行のActions → Exportを選択し、Open Science ConnectorまたはMCP client configを選択し、プレビューを調べ、Save configurationを選択します。

認証名を保持し、ローカルパスを報告するエクスポート

実際のエクスポートされたファイルは、required_secrets.environment の変数名を保持しました。 デモのクレデンシャル値、ローカルの信頼、または許可は含まれていません。 Reimport はローカルの資格選択を要求し、再度信頼します。

同一のIDが既に存在する場合、プレビューはIDでカスタムConnector ...既にインストールされています、Use configurationは利用できません。 既存の接続を変更するには、Edit を使用します。 インポートは上書き操作ではありません。

既存のIDブロックの重複インポート

エクスポートされた接続を復元するときは、プレフィルドフィールドを調べて、再び必須の認証情報を結合します。 完全な信頼と研究でそれを使用する前に境界された呼出しをテストして下さい。 インポートは、同じIDで既存のConnectorを上書きしません。

犯罪者:サービスおよび再利用可能な秘密​

サービス資格情報 で秘密を作成し、管理し、環境、ヘッダ、OAuth のバインディングで名前を選択します。 新しいデバイスで、これらのバインディングを復元し、接続をテストする前にサービスのサインインを完了します。 エクスポートには、構成の参照、使用可能な秘密やローカルの信頼が含まれていません。

HTTPエラールックアップ​

400、401、403、404、429、または5xx応答については、HTTPトラブルシューティングテーブルを使用してください。 応答サービスおよびステータスコードの詳細なメッセージを保持します。

OAuth 認証情報のエラー後に再接続する​

カスタム OAuth Connector の認証情報が拒否された場合は、設定で認可フローをやり直してください。認証情報は発行元の認可サーバーに結び付いており、サーバーアドレスを変えて別の発行元のトークンを再利用することはできません。フォームの変更を保持して保存完了を待ち、接続をテストしてから目的のクエリを再試行します。接続テストの成功は、クエリでデータを取得できたことを意味しません。