parallel-mcp-setup

Parallel MCP をセットアップする

認証済みの Parallel MCP 接続を設定し、検証します。最初にサポートされるセットアップ方法は Bifrost 経由の Parallel Search MCP です。以下の手順はこの方法に適用されます。検索と取得の使い方は MCP サーバーが提供するツールの説明に従います。このスキルで扱うのは、インストールとゲートウェイの設定です。

1. デプロイ環境を確認する

対象の Bifrost インスタンスと、その設定元（ダッシュボードまたは config.json）、および接続先のエージェントまたは仮想キーを特定します。変更する前に既存の MCP クライアントを確認し、重複して追加するのではなく、該当する Parallel 接続を更新してください。関係のないクライアント、アクセスルール、ツールの承認設定は維持してください。

Bifrost の管理画面と Parallel アカウントの認証情報にアクセスできることを確認します。これらは接続先エージェントの Bifrost 認証情報とは別のものです。アクセス権またはシークレットが不足している場合は、設定を準備し、インストールが成功したと主張せずに必要なものを報告してください。シークレットはデプロイ環境のシークレットマネージャーまたは環境変数に保管し、スキルファイル、ソース管理、プロンプト、ツール引数には絶対に記載しないでください。

2. 認証済み接続を設定する

認証が必要な https://search.parallel.ai/mcp-oauth を使用します。共有の Parallel API キーには Headers 認証を選択するか、そのデプロイ環境で採用している認証方法として Bifrost の OAuth フローを使用します。認証エラーを、認証なしの接続に変更して解決しないでください。

共有キーを設定する場合は、Bifrost サーバー環境で PARALLEL_MCP_AUTHORIZATION に完全な値 Bearer <Parallel API key> を設定します。env. 参照はヘッダーの値全体を置換します。Bearer を先頭に付加するものではありません。

MCP Gateway → New MCP Server で HTTP、上記の URL、Headers 認証を選択します。UI の環境変数選択ツールを使って、Authorization に環境変数への参照を設定します。この接続では web_search と web_fetch を許可してください。

ファイルで管理するデプロイ環境では、既存の mcp.client_configs 配列に次のクライアントエントリをマージします。

{
  "name": "parallel-search",
  "connection_type": "http",
  "connection_string": "https://search.parallel.ai/mcp-oauth",
  "auth_type": "headers",
  "headers": {
    "Authorization": "env.PARALLEL_MCP_AUTHORIZATION"
  },
  "is_ping_available": false,
  "tools_to_execute": ["web_search", "web_fetch"]
}

OAuth の場合は、同じエンドポイントに対して Bifrost の OAuth 認証タイプを使用し、管理者による検証とサインインのフローを完了してください。各呼び出し元がそれぞれの Parallel アカウントを使う必要がある場合に限り、ユーザーごとの認証を使用します。選択したフローについては、Bifrost の認証を参照してください。

デプロイ環境で定められた再読み込み手順に従ってください。既存の接続 URL または認証タイプを変更するには、Bifrost ではこれらのフィールドが変更不可として扱われるため、クライアントの置き換えが必要になる場合があります。稼働中のクライアントを先に削除せずに置き換えられるよう計画してください。ファイル管理のエントリもファイル内で更新する必要があります。更新しない場合、再起動によって古い設定が再作成されることがあります。

3. ゲートウェイの制御とアクセスを設定する

検索設定ヘッダーや URL パラメーターを省略して、Parallel のデフォルト設定を維持してください。ユーザーが特定の検索モード、ソースポリシー、または応答予算を明示的に指定した場合は、ゲートウェイの検索制御を確認してください。これらは上流接続の設定として適用します。選択した認証情報と検索ポリシーはゲートウェイの管理下に置き、明示的に意図されていない限り、呼び出し元によるこれらのヘッダーの上書きを有効にしないでください。

Bifrost が両方のツールを検出し、対象の下流クライアントまたは仮想キーにそれらのツールへのアクセス権を付与していることを確認します。設定済みの下流認証を使って、エージェントをデプロイ環境の Bifrost MCP ゲートウェイに接続してください。実際に検出されたツール名を使用します。ツール名にはプレフィックスが付いている場合があります。このスキルをインストールしても、MCP ツールが登録または公開されるわけではありません。

4. Bifrost 経由で確認する

1. 上流接続が正常で認証済みであり、web_search と web_fetch が検出されていることを確認します。
2. 対象の下流エージェントが、Bifrost 経由で両方のツールを検出できることを確認します。
3. Python asyncio の公式ドキュメントを小規模に検索し、返されたドキュメントの URL を取得します。ツールの現在のスキーマと説明を使用します。結果が正常に返されることを確認し、URL ごとのエラーを調べます。
4. Bifrost のツール呼び出し記録を調べ、意図した接続が使用されたことを確認します。利用可能な上流リクエストのメタデータまたはアカウントログで、アカウントへの帰属と、設定されているモードまたはソースポリシーを検証します。結果の品質だけでは、使用されたモードを証明できません。
5. 検証できた内容と未テストの内容を正確に報告します。Parallel への直接リクエストでは、Bifrost のルーティング、認証、または下流の権限は証明できません。

401/403 が発生した場合は、Parallel の認証情報、アカウントアクセス、上流の認証設定を確認します。ハンドシェイクで 400 が発生した場合は、設定済みの検索オーバーライドを確認します。ツールが見つからない場合は、接続の状態とゲートウェイのフィルタリングを調べます。障害の診断中も、既存のアクセス制御を維持してください。

オプション：Bifrost 経由でこのセットアップスキルを配布する

Skills Repository → New Skill で、このファイルの名前と説明を「Details」にコピーし、Markdown 本文のみを SKILL.md エディターに貼り付けて、references/gateway-controls.md を添付します。既存のスキルの場合は、新しいバージョンを作成します。1.0.0 などの初期バージョンを公開し、Register as Marketplace とダッシュボードのインストールコマンドを使用します。プラグイン名は bifrost-parallel-mcp-setup です。

Bifrost では、新しく作成されたスキルがすぐに利用可能になり、マーケットプレイスおよびダウンロードのルートは公開されていると記載されています。デプロイ用の認証情報と非公開の設定は、公開するファイルに含めないでください。スキルの公開は、MCP 接続のセットアップとは別です。

参照元

• Parallel Search MCP
• Bifrost MCP connections
• Bifrost header authentication
• Bifrost Skills Repository