[georgeatparallel]

描述

添加可显式启用的免费 Parallel Search MCP 配置示例，用户无需 Parallel API key 即可搜索网页和读取指定 URL。将示例保存为 parallel-search.mcp.json，通过 blade --mcp-config ./parallel-search.mcp.json 启用；使用现有 HTTP MCP 传输，保留已保存的配置和模型选择。同步提供中英文说明。匿名服务有速率限制。

变更类型

• 📝 文档更新

关联 Issue

无。

变更内容

在 MCP Session 隔离文档中加入配置、启用方式及匿名端点说明，并提供可复制的 JSON 文件。

测试

通过 Blade CLI 配置加载器及隔离的 MCP 注册表发现并执行 web_search、web_fetch，成功返回 TypeScript 文档相关内容；确认匿名请求的 URL 和请求头。

检查清单

• 我已阅读贡献指南
• 提交信息符合 Conventional Commits 规范
• 已同步更新中英文文档

截图/录屏

不涉及 UI 变更。

其他说明

I work at Parallel. 供参考：Artificial Analysis Search API benchmarks。

Summary by CodeRabbit

• Documentation
  • Added a Parallel Search MCP setup guide with configuration instructions, usage tips, and troubleshooting guidance.
  • Documented anonymous web search and URL content extraction, including rate limits and permission requirements.
  • Added an example configuration for enabling the service in the current session.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: b279fc68-fbbd-48ac-89f7-60e72e7a64ce

📥 Commits

Reviewing files that changed from the base of the PR and between 30f8684 and 19ec2d6.

📒 Files selected for processing (3)

• docs/en/reference/mcp-session-isolation.md
• docs/examples/parallel-search.mcp.json
• docs/reference/mcp-session-isolation.md

Included review availability: This review used your included allowance. Your plan provides up to 2 included reviews per hour; 1 remain after this review.

---

📝 Walkthrough

Walkthrough

The documentation adds a Parallel Search MCP example, a server configuration, and instructions for enabling it in the current Session. It also describes permission confirmation, the separate OAuth flow, and connection and rate-limit guidance.

Changes

Parallel Search MCP example

Layer / File(s)	Summary
Example configuration and Session instructions docs/examples/parallel-search.mcp.json, docs/en/reference/mcp-session-isolation.md, docs/reference/mcp-session-isolation.md	The example configures the HTTP endpoint and User-Agent header. The English and Chinese reference pages explain how to enable it with --mcp-config for the current Session and describe permissions, OAuth, and troubleshooting.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~8 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 19ec2

This documentation-only change provides a Session-scoped Parallel Search MCP example. Its configuration and guidance match the available provider and CLI contracts, with no actionable merge risk identified.

Architecture Summary

Architecture risk: 🔵 Low · up to 19ec2

The change affects 1 system.

Changed systems: docs

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

• observed — docs (service) was modified; 3 changed files map to changed impact.

Before / after behavior

• observed — Modified behavior in docs/en/reference/mcp-session-isolation.md: Added documentation for configuring and using Parallel Search MCP through an explicit per-Session CLI config, including the anonymous endpoint, required transport, permission behavior, OAuth distinction, and connection/rate-limit guidance.
• observed — Modified behavior in docs/examples/parallel-search.mcp.json: Adds the parallel-search MCP server configuration with the specified HTTP endpoint and User-Agent header.
• observed — Modified behavior in docs/reference/mcp-session-isolation.md: 新增 Parallel Search MCP 文档示例，包含服务能力与匿名端点说明、HTTP 服务器配置、当前 Session 的 CLI 启用命令，以及权限、模型配置和故障排查提示。

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check		Check skipped - CodeRabbit’s high-level summary is enabled.
Title check		The title clearly and concisely describes the main change: adding an optional Parallel Search MCP configuration example to the documentation.
Docstring Coverage		No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check		Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check		Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create a new PR

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[echoVic]

感谢 @georgeatparallel 的贡献与对 Blade 的关注 🙏

经过评估，这个 PR 暂时不计划合入，原因如下：

1. 文档策略：Blade 文档目前不单独收录某个第三方商业服务的推荐配置示例。一旦为单一厂商（Parallel Search）提供"官方示例"，就等于背书，后续也需要对其他同类服务（Tavily、Exa、Brave Search 等）保持对等。
2. 外部依赖风险：匿名/免 key 端点的可用性、速率限制与计费政策随时可能变化，固化在仓库里的示例容易过期并产生糟糕的用户体验。
3. 通用性：Blade 已经支持任意 HTTP MCP 配置，用户按通用方式即可接入 Parallel 或其他任何服务，不需要在主仓库文档里专门指引。

如果你有兴趣帮用户使用 Parallel + Blade，更合适的做法是：

• 在 Parallel 自己的文档中补一篇 "Use Parallel Search with Blade" 的集成指南；
• 或者改造此 PR 为一篇厂商中立的"如何接入第三方 HTTP MCP 搜索服务"通用教程，将 Parallel 与其他服务并列列为可选项，并清晰标注"第三方服务，使用前请阅读其 TOS 与限流条款"。

再次感谢，期待未来其他形式的合作。