parallel-mcp-setup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Set up Parallel MCP

配置 Parallel MCP

Configure and verify authenticated Parallel MCP connections. The first supported setup path is Parallel Search MCP through Bifrost; the steps below apply to that path. Tool descriptions supplied by the MCP server govern search and fetch usage; this skill covers installation and gateway configuration.
配置并验证经过身份验证的 Parallel MCP 连接。首个受支持的设置路径是通过 Bifrost 使用 Parallel Search MCP;以下步骤适用于该路径。MCP server 提供的工具描述决定 search 和 fetch 的使用方式;本 skill 涵盖安装和网关配置。

1. Inspect the deployment

1. 检查部署

Identify the target Bifrost instance, its configuration source (dashboard or
config.json
), and the intended downstream agent or virtual key. Inspect existing MCP clients before changing anything; update the matching Parallel connection instead of adding duplicates. Preserve unrelated clients, access rules, and tool approval settings.
Confirm access to Bifrost management and a Parallel account credential. These are separate from the downstream agent's Bifrost credential. If access or a secret is missing, prepare the configuration and report what is needed without claiming installation succeeded. Keep secrets in the deployment's secret manager or environment; never put them in skill files, source control, prompts, or tool arguments.
确定目标 Bifrost 实例、其配置源(dashboard 或
config.json
),以及预期的下游 agent 或 virtual key。进行任何更改前,先检查现有 MCP 客户端;更新匹配的 Parallel 连接,而不是添加重复项。保留无关的客户端、访问规则和工具审批设置。
确认具备 Bifrost 管理权限并拥有 Parallel 账户凭据。这些凭据独立于下游 agent 的 Bifrost 凭据。如果缺少访问权限或 secret,请准备配置并说明所需内容,不要声称安装已经成功。将 secret 保存在部署的 secret manager 或 environment 中;切勿将其放入 skill 文件、source control、prompts 或 tool arguments。

2. Configure the authenticated connection

2. 配置经过身份验证的连接

Use
https://search.parallel.ai/mcp-oauth
, which requires authentication. Choose Headers auth for a shared Parallel API key, or Bifrost's OAuth flow when that is the deployment's chosen authentication method. Do not change an authentication failure into an unauthenticated connection.
For shared-key configuration, provision
PARALLEL_MCP_AUTHORIZATION
in the Bifrost server environment with the complete value
Bearer <Parallel API key>
. The
env.
reference substitutes the whole header value; it does not prepend
Bearer
.
In MCP Gateway → New MCP Server, choose HTTP, the URL above, and Headers auth. Set
Authorization
to the environment-variable reference using the UI's env-var picker. Allow
web_search
and
web_fetch
for this connection.
For a file-managed deployment, merge this client entry into the existing
mcp.client_configs
array:
json
{
  "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"]
}
For OAuth, use the same endpoint with Bifrost's OAuth auth type and complete its admin verification/sign-in flow. Use per-user authentication only when each caller should use their own Parallel account. See Bifrost authentication for the chosen flow.
Respect the deployment's reload procedure. Existing connection URL/auth-type changes may require replacing the client because Bifrost treats those fields as immutable; plan that replacement without deleting a working client first. File-managed entries must be updated in the file as well, or a restart can recreate the old configuration.
使用需要身份验证的
https://search.parallel.ai/mcp-oauth
。对于共享的 Parallel API key,选择 Headers auth;对于部署所选的认证方式,选择 Bifrost 的 OAuth flow。不要将身份验证失败改为未认证连接。
对于 shared-key 配置,在 Bifrost server environment 中配置
PARALLEL_MCP_AUTHORIZATION
,其完整值为
Bearer <Parallel API key>
。
env.
引用会替换整个 header 值;它不会自动添加
Bearer
前缀。
在 MCP Gateway → New MCP Server 中,选择 HTTP、上述 URL 和 Headers auth。使用 UI 的 env-var picker,将
Authorization
设置为 environment-variable reference。为该连接启用
web_search
和
web_fetch
。
对于 file-managed 部署,将此客户端条目合并到现有的
mcp.client_configs
数组中:
json
{
  "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,使用相同的 endpoint 和 Bifrost 的 OAuth auth type,并完成其管理员验证/登录流程。只有在每位调用者都应使用自己的 Parallel 账户时,才使用 per-user authentication。有关所选流程,请参阅 Bifrost authentication。
遵循部署的 reload procedure。对现有连接 URL 或 auth type 的更改可能需要替换客户端,因为 Bifrost 会将这些字段视为不可变;不要先删除一个正常工作的客户端,而应提前规划替换方案。File-managed 条目也必须在文件中更新,否则 restart 可能会重新创建旧配置。

3. Configure gateway controls and access

3. 配置网关控制和访问权限

Keep Parallel’s defaults by omitting search-setting headers and URL parameters. When the user explicitly requests a particular search mode, source policy, or response budget, read gateway search controls. Apply these as upstream connection settings. Keep the chosen credential and search policy under gateway administration; do not enable caller-supplied overrides of these headers unless explicitly intended.
Confirm Bifrost discovers both tools and grants the intended downstream client or virtual key access to them. Connect the agent to the deployment's Bifrost MCP gateway with its configured downstream authentication. Use the actual discovered tool names, which may be prefixed. Installing this skill does not itself register or expose the MCP tools.
通过省略 search-setting headers 和 URL parameters 来保留 Parallel 默认设置。当用户明确要求特定的 search mode、source policy 或 response budget 时,读取 gateway search controls。将这些设置应用为 upstream connection settings。将所选 credential 和 search policy 置于 gateway administration 管理之下;除非明确有意,否则不要启用调用方对这些 headers 的覆盖。
确认 Bifrost 已发现两个工具,并已向目标下游 client 或 virtual key 授予相应访问权限。使用已配置的下游 authentication,将 agent 连接到部署的 Bifrost MCP gateway。使用实际发现的 tool 名称,这些名称可能带有前缀。安装此 skill 本身不会注册或暴露 MCP tools。

4. Verify through Bifrost

4. 通过 Bifrost 验证

  1. Confirm the upstream connection is healthy and authenticated, with
    web_search
    and
    web_fetch
    discovered.
  2. Confirm the intended downstream agent can discover both tools through Bifrost.
  3. Run a small search for official Python asyncio documentation, then fetch a returned documentation URL. Use the tools' current schemas and descriptions. Confirm successful results and inspect per-URL errors.
  4. Inspect Bifrost's tool-call records to confirm the intended connection was used. Verify account attribution and any configured mode or source policy in available upstream request metadata or account logs; result quality alone does not prove the mode used.
  5. Report exactly what was verified and what remains untested. A direct request to Parallel does not prove Bifrost routing, authentication, or downstream permissions.
On a 401/403, check the Parallel credential, account access, and upstream auth configuration. On a handshake 400, check the configured search overrides. For missing tools, inspect connection health and gateway filtering. Keep existing access controls while diagnosing failures.
  1. 确认 upstream connection 健康且已完成身份验证,并已发现
    web_search
    和
    web_fetch
    。
  2. 确认目标下游 agent 可以通过 Bifrost 发现这两个工具。
  3. 针对 Python asyncio 官方文档执行一次小规模 search,然后 fetch 返回的文档 URL。使用 tools 当前的 schemas 和 descriptions。确认结果成功,并检查每个 URL 的错误。
  4. 检查 Bifrost 的 tool-call records,确认使用的是预期连接。在可用的 upstream request metadata 或 account logs 中验证 account attribution,以及已配置的 mode 或 source policy;仅凭结果质量无法证明所使用的 mode。
  5. 准确报告已验证的内容和尚未测试的内容。直接向 Parallel 发出的请求不能证明 Bifrost routing、authentication 或下游 permissions。
遇到 401/403 时,检查 Parallel credential、账户访问权限和 upstream auth configuration。遇到 handshake 400 时,检查配置的 search overrides。对于 tools 缺失,检查 connection health 和 gateway filtering。诊断故障时保留现有 access controls。

Optional: distribute this setup skill through Bifrost

可选:通过 Bifrost 分发此设置 skill

In Skills Repository → New Skill, copy this file's name and description into Details, paste only the Markdown body into the SKILL.md editor, and attach
references/gateway-controls.md
. For an existing skill, create a new version. Publish an initial version such as
1.0.0
, then use Register as Marketplace and the dashboard's installation commands; the plugin name is
bifrost-parallel-mcp-setup
.
Bifrost serves newly created skills immediately and documents marketplace/download routes as public. Keep deployment credentials and private configuration out of published files. Skill publication is separate from MCP connection setup.
在 Skills Repository → New Skill 中,将此文件的 name 和 description 复制到 Details 中,只将 Markdown 正文粘贴到 SKILL.md editor,并附加
references/gateway-controls.md
。对于现有 skill,请创建一个新版本。发布初始版本,例如
1.0.0
,然后使用 Register as Marketplace 和 dashboard 的安装命令;plugin 名称为
bifrost-parallel-mcp-setup
。
Bifrost 会立即提供新建的 skills,并在文档中将 marketplace/download routes 标记为公开。请将 deployment credentials 和 private configuration 排除在 published files 之外。Skill publication 与 MCP connection setup 是相互独立的。

Sources

来源