parallel-mcp-setup

设置 Parallel MCP

配置并验证经过身份验证的 Parallel MCP 连接。首个受支持的设置方式是通过 Bifrost 使用 Parallel Search MCP；以下步骤适用于此方式。MCP 服务提供的工具描述决定搜索和抓取的用法；本技能涵盖安装和网关配置。

1. 检查部署

确定目标 Bifrost 实例、其配置来源（控制面板或 config.json），以及预期的下游 Agent 或虚拟密钥。更改任何内容前，先检查现有 MCP 客户端；更新匹配的 Parallel 连接，而不是添加重复项。保留无关的客户端、访问规则和工具审批设置。

确认你可以访问 Bifrost 管理功能，并拥有 Parallel 账户凭据。这些凭据与下游 Agent 的 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. 配置网关控制项和访问权限

保留 Parallel 的默认设置，即不添加搜索设置标头和 URL 参数。只有当用户明确要求特定搜索模式、来源策略或响应预算时，才阅读网关搜索控制项。将这些设置应用为上游连接设置。所选凭据和搜索策略应由网关管理；除非明确需要，否则不要启用调用方提供的标头覆盖。

确认 Bifrost 能发现这两个工具，并已向预期的下游客户端或虚拟密钥授予访问权限。使用配置好的下游身份验证方式，将 Agent 连接到部署的 Bifrost MCP 网关。请使用实际发现的工具名称，这些名称可能带有前缀。安装此技能本身不会注册或公开 MCP 工具。

4. 通过 Bifrost 验证

1. 确认上游连接运行正常且已通过身份验证，并已发现 web_search 和 web_fetch。
2. 确认预期的下游 Agent 可以通过 Bifrost 发现这两个工具。
3. 搜索官方 Python asyncio 文档，然后获取返回的文档 URL。使用工具当前的架构和描述。确认结果成功，并检查各 URL 的错误。
4. 检查 Bifrost 的工具调用记录，确认使用了预期的连接。通过可用的上游请求元数据或账户日志，验证账户归属以及任何已配置的模式或来源策略；仅凭结果质量无法证明使用了哪种模式。
5. 准确报告已验证的内容以及仍未测试的内容。直接向 Parallel 发起请求并不能证明 Bifrost 路由、身份验证或下游权限正常。

遇到 401/403 错误时，请检查 Parallel 凭据、账户访问权限和上游身份验证配置。遇到握手 400 错误时，请检查已配置的搜索覆盖项。缺少工具时，请检查连接状态和网关过滤设置。诊断故障时，请保留现有访问控制。

可选：通过 Bifrost 分发此设置技能

在 技能仓库 → 新建技能 中，将此文件的名称和描述复制到「详细信息」，仅将 Markdown 正文粘贴到 SKILL.md 编辑器中，并附加 references/gateway-controls.md。对于现有技能，请创建新版本。发布初始版本，例如 1.0.0，然后使用 注册到市场 和仪表板中的安装命令；插件名称为 bifrost-parallel-mcp-setup。

Bifrost 会立即提供新创建的技能，并将市场/下载路由公开说明。请勿将部署凭据和私有配置放入已发布文件中。技能发布与 MCP 连接设置是分开的。

来源

• Parallel Search MCP
• Bifrost MCP 连接
• Bifrost 标头身份验证
• Bifrost 技能仓库