SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场parallel-mcp-setup

parallel-mcp-setup

智能体与模型

查看项目

更新于 10-15 12:51

技能介绍

用途

该技能用于在 Bifrost 中安装、配置或排查一个经过身份验证的 Parallel Search MCP 连接，包括网关级别的搜索设置。首个受支持的设置路径是通过 Bifrost 接入 Parallel Search MCP，工具的描述由 MCP 服务器提供，负责搜索与抓取的用法；本技能聚焦于安装与网关配置。

主要能力

  • 检查部署环境：确定目标 Bifrost 实例、其配置来源（仪表盘或 config.json）以及预期的下游代理或虚拟密钥。
  • 在修改前检查现有 MCP 客户端，更新匹配的 Parallel 连接而不是新增重复项。
  • 配置经过身份验证的连接，端点使用 https://search.parallel.ai/mcp-oauth（需要认证）。
  • 支持共享 Parallel API Key 的 Headers 认证，或 Bifrost 的 OAuth 流程。
  • 设置网关控制与访问权限，并验证连接健康状态、工具发现与下游访问。

使用方式

  1. 检查部署：确认访问 Bifrost 管理端和 Parallel 账户凭据；两者与下游代理的 Bifrost 凭据是分开的。如果缺少访问权限或密钥，应准备配置并报告所需内容，不要声称安装成功。密钥应保存在部署的密钥管理器或环境变量中，切勿放入技能文件、源码控制、提示词或工具参数。
  2. 配置认证连接：使用 https://search.parallel.ai/mcp-oauth。共享密钥配置时，在 Bifrost 服务器环境中提供 PARALLEL_MCP_AUTHORIZATION，完整值为 Bearer <Parallel API key>；env. 引用会替换整个头部值，不会自动添加 Bearer。在 MCP Gateway → New MCP Server 中选择 HTTP、上述 URL 和 Headers 认证，将 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 账户时才使用按用户认证。

注意：现有连接的 URL/认证类型变更可能需要替换客户端，因为 Bifrost 将这些字段视为不可变；规划替换时不要先删除正在工作的客户端。文件管理的条目也必须在文件中更新，否则重启可能重建旧配置。 3. 配置网关控制与访问：默认省略搜索设置头部和 URL 参数，以沿用 Parallel 的默认值。仅当用户明确要求特定搜索模式、来源策略或响应预算时，才读取网关搜索控制并将其作为上游连接设置应用。保持凭据和搜索策略由网关管理，除非明确意图，不要启用调用方对这些头部的覆盖。 4. 通过 Bifrost 验证：确认上游连接健康且已认证，web_search 与 web_fetch 均被发现；确认预期的下游代理可通过 Bifrost 发现这两个工具；运行一个小搜索（例如官方 Python asyncio 文档），然后抓取返回的文档 URL，使用工具当前的 schema 与描述，确认成功结果并检查每个 URL 的错误。检查 Bifrost 的工具调用记录以确认使用了预期连接，并验证账户归属及配置的模式或来源策略。报告实际验证了什么、什么仍未测试；直接请求 Parallel 不能证明 Bifrost 路由、认证或下游权限。

适用场景

  • 在 Bifrost 中首次接入 Parallel Search MCP。
  • 排查 Parallel MCP 连接的认证、工具发现或访问权限问题。
  • 需要为下游代理或虚拟密钥授予 web_search、web_fetch 访问权限。

限制

  • 安装该技能本身不会注册或暴露 MCP 工具。
  • 需要使用实际发现的工具名称，可能带前缀。
  • 缺失的凭据或权限必须先补齐，不能假设安装成功。

故障排查

  • 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 连接设置是分开的。