在 Warp Agent 中添加 DeepSeek Search:MCP 与 Profile 配置

重点摘要

通过 Warp Drive 或项目级 MCP 配置接入 DeepSeek Search,利用 Agent Profile 控制工具权限,并明确服务器的启动与来源验证流程。

想让 Warp Agent 帮你配置? 把本文交给它,请它创建项目级 MCP 配置、解释权限与启动设置,并把 API 密钥留给你在本机填写。不要在 Agent 对话中粘贴密钥。
text
Use this guide to add DeepSeek Search to Warp Agent for this project. Inspect
the existing Warp Drive and MCP settings first. Prefer a project-scoped
.warp/.mcp.json entry and do not change global servers. Keep the API key in a
private env file outside the repo. Show me the exact config and let me approve
starting the process. Create or select a research-oriented Agent Profile that
allows this MCP server, while leaving other profiles unchanged. Verify Search,
Fetch, and source citation. Do not make a billable request until I approve it.

Warp 提供了三种容易混淆的控制项:MCP 服务器的定义位置、Agent Profile 是否允许使用该服务器,以及项目级服务器是否已获准启动。应分别设置这三项。与简单的全局 MCP 列表不同,在 Warp 中,同一个 DeepSeek 桥接程序可以限定在项目内、仅在你信任该仓库时手动启动,并仅对研究专用 Profile 开放。

选择 Warp 管理服务器的方式

个人或团队共用的服务器,可以打开 Settings | Agents | MCP servers 或 Warp Drive | Personal | MCP Servers,点选 Add 并粘贴本机指令配置。Warp 也会读取文件形式的服务器定义:全局位置为 ~/.warp/.mcp.json,仓库根目录中的项目级位置为 .warp/.mcp.json。MCP 指南列出这两种路径,并说明项目级服务器必须经过明确批准才会启动。

项目级配置会让此接入与当前仓库放在一起。请将以下条目合并进现有的 mcpServers 对象:

json
{
  "mcpServers": {
    "deepseek-search": {
      "command": "node",
      "args": [
        "--env-file=/Users/you/.config/deepseek-search/.env",
        "/Users/you/tools/deepseek-search/server.mjs"
      ],
      "working_directory": "/Users/you/tools/deepseek-search"
    }
  }
}

私密环境文件应放在仓库之外,并包含 DEEPSEEK_API_KEY=...。Warp 的 CLI 服务器配置支持环境变量;Node 的 --env-file 选项也让密钥本身不必写入 JSON。请把示例路径替换为适用于本机的配置文件和适配器路径。若涉及相对路径,Warp 建议使用 working_directory 字段明确指定启动目录。

Warp 也能读取部分第三方 MCP 定义,包括 Claude Code 的 .mcp.json 和 Codex 的 .codex/config.toml。如果你已在 Claude Code 或 Codex 中配置 DeepSeek,可以为全局条目启用 Auto-spawn servers from third-party agents,让 Warp 复用该定义。项目级第三方服务器仍须在 MCP Servers 页面手动启用。请先检查源配置,只启动属于你信任的仓库的服务器。

Warp 将共享或项目级 MCP 配置与 Agent Profile 的工具权限结合起来。

项目级配置不代表服务器会自动启动。

用 Agent Profile 限制访问权限

打开 Settings | Agents | Profiles,并创建一个如 Web Research 的 Profile。在其 MCP 权限中允许 deepseek-search;如果希望 Warp 不确定时询问,也可以保持 Agent Decides。若不想让日常编码任务搜索网页,请勿将该服务器加入默认编码 Profile 的允许清单。Warp 在Profiles 与权限中说明了 MCP 允许清单、拒绝清单和 Agent Decides。

在 MCP Servers 页面启动项目服务器,并确认 Warp 显示了其中的工具。项目级服务器仅对当前会话有效:重启 Warp 后,若仍信任该项目,需要再次明确启动。这个额外步骤是有意设计的,避免仓库仅因被克隆就能静默启动本机程序。

Warp 验证流程分别检查启动批准、服务器状态、Profile 权限和来源引用。

已连接、已获准使用和已通过认证是不同状态。

验证来源检索,或选择不使用 MCP 的方案

在使用 Web Research Profile 的 Warp Agent 对话中,要求它从一份官方技术页面检索一个最新事实。明确要求 Agent 进行搜索、Fetch 一个选定 URL、依据抓取内容核对事实,并引用该页面。检查 MCP 活动记录,确认两种工具调用均已发生。如果 Warp 显示服务器已连接但从未调用它,请检查当前 Profile 的 MCP 规则和工具清单。

若只想在终端查询,可以在 Warp 终端运行 Claude Code DeepSeek 指南中的 Node 辅助程序。若要以程序方式运行 Warp Agent,Warp 的 oz agent run 支持用 --mcp 指定 MCP 配置文件,详见 Oz CLI MCP 参考。这两种方式都不需要修改全局 MCP 列表。也可以直接调用 API,但这会产生费用;请参阅 DeepSeek 的 Search 与 Fetch 指南,确认最新字段、计费方式与限额。

如果你使用 Warp 内建网页搜索进行广泛探索,可以针对同一问题比较它与 DeepSeek Search 的结果,再决定是否同时启用两者。日常任务可指定一个默认搜索来源,在需要特定结果格式或出处轨迹时再调用另一个。这样可以避免每项任务都出现重复的搜索工具,也更容易理解实际用量。

当指定 Profile 能使用 Search 和 Fetch、项目服务器仅在你批准后才启动,且回答引用的内容得到抓取页面支持,设置便完成。密钥留在本机;不要把从公开网页检索到的内容当成指示 Agent 的命令。

作者:Victor Lane,Auspia 300 多次 GEO 准备度审核的专家。Victor 撰写实用诊断与验证指南。

探索更多 DeepSeek Search 设置指南

浏览完整的 Agent 设置指南

相关平台指南:通过项目级 MCP 将 DeepSeek Search 接入 Roo Code · 将 DeepSeek Search 添加到 Windsurf Cascade

探索此主题

继续阅读同一增长脉络