Claude Code - 配置Tavily MCP实现联网搜索教程（免费API Key、MCP接入）

2026-06-24 发布：hangge 阅读：211

Claude Code 是 Anthropic 推出的官方命令行 AI 编程助手，功能极为强大。但由于国内网络原因，其内置的 WebSearch、WebFetch 两个工具都处于不可用状态，导致联网搜索功能失效。而 Tavily 是一个专为 AI Agent 设计的搜索引擎，通过 MCP（Model Context Protocol）协议即可无缝接入 Claude Code，赋予其实时联网搜索、网页内容提取、深度研究等能力。本文将详细演示 Claude Code 配置 Tavily MCP 服务的全过程。

提示：MCP（Model Context Protocol）是 Anthropic 推出的开放标准协议，它定义了 AI 模型与外部工具/数据源之间的通信方式。可以把它理解为 AI 应用世界的"USB-C 接口"——统一标准、即插即用。更多 MCP 基础知识可参考 MCP 官方文档。

一、基本介绍

1，Tavily 是什么

Tavily 是一个专为 AI Agent 和大型语言模型（LLM）打造的搜索引擎。与传统搜索引擎（如 Google、Bing）不同，Tavily 的核心特点是：

结果纯净：自动过滤广告、无关 HTML 标签和低质量内容，直接返回结构化的有用信息
高速响应：专为 AI 调用场景优化，API 响应极快
深度研究：支持 "Research" 模式，可同时从 20+ 个网页源获取信息并进行交叉验证
多维度工具：提供搜索（Search）、内容提取（Extract）、网站地图（Map）和网页爬取（Crawl）四种核心能力
免费额度：每月提供 1000 次免费 API 调用，无需绑定信用卡

2，为什么要为 Claude Code 接入 Tavily

（1）Claude Code 在代码编写、项目架构和逻辑分析方面表现卓越，但它默认只能基于训练截止日期之前的静态知识进行回答。当我们需要查询最新技术文档、排查热乎的报错信息、或需要对比多个在线资料时，就暴露出明显的短板。并且官方内置 Fetch/WebSearch 在国内完全失效。

（2）接入 Tavily MCP 后，Claude Code 将获得以下新能力：

实时联网搜索：查询最新的技术文档、API 变更、版本发布信息
多源信息验证：自动从多个权威网站获取信息并交叉比对
网页内容提取：指定 URL 后直接提取页面正文，无需手动复制粘贴
网站结构分析：快速了解一个网站有哪些页面和子目录
深度研究报告：围绕一个主题自动搜集资料并整理成结构化报告

二、准备工作

1，环境要求

在开始配置之前，请确保我们的环境满足以下条件：

Claude Code：已安装并可正常使用（通过 npm install -g @anthropic-ai/claude-code 安装最新版本）
Node.js：v20 或更高版本（运行 node --version 检查）
操作系统：Windows、macOS、Linux 均可

注意：如果你使用的是 Claude Desktop（桌面版）而非 CLI 命令行版，配置文件路径会有所不同。本文以 Claude Code CLI 为主进行讲解，桌面版的差异处会特别标注。

2，注册获取 Tavily API Key

（1）首先我们访问 Tavily 的官网地址，然后使用 GitHub / Google 一键登录（无需绑卡、免费）。

官网地址：https://app.tavily.com/

（2）登录后我们就可以拿到以 tvly- 开头的 API Key（新用户每月 1000 次免费调用），我们将其复制一下，后面进行配置时需要使用。

提示：Tavily 免费计划每月提供 1000 次 API 调用额度，对于个人开发者和学习用途完全够用。如果需要更多调用次数或高级功能（如图片搜索、更深度的研究模式），可在 Dashboard 中升级到付费计划。

三、配置 Tavily MCP 服务

将 Tavily 接入 Claude Code 有两种主流方式：一种是使用 Claude Code 自带的 claude mcp add 命令（推荐新手），另一种是直接编辑配置文件（适合需要精细控制的用户）。下面我们逐一介绍。

注意：如果同时使用了 claude mcp add 命令和手动编辑的方式，可能会产生配置冲突。建议二选一，不要混合使用。推荐优先使用 claude mcp add 命令，它会自动处理配置文件的位置和格式。

1，方法一：使用 claude mcp add 命令（推荐）

（1）打开终端（Windows 下建议使用 PowerShell 或 Git Bash），执行以下命令。如果你想让 Tavily 在所有项目中全局可用（而非仅当前项目），可以加上 --scope user 参数：

claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp?api_key=tvly-你的API密钥

（2）执行命令后，终端会提示配置成功。由于上面命令是让 Tavily 在所有项目中全局可用，打开 ~/.claude.json（用户主目录下），可以看到相关配置已经添加成功。

2，方法二：手动编辑配置文件

（1）如果我们希望更精确地控制 MCP 服务器配置，或需要同时管理多个 MCP 服务，可以直接编辑 Claude Code 的配置文件。Claude Code 的配置文件位于以下路径（二选一）：

全局配置：~/.claude.json（用户主目录下，对所有项目生效，windows 系统为 C:\Users\用户名\.claude.json）
项目配置：.claude/settings.local.json（仅对当前项目生效）

（2）打开配置文件，在 mcpServers 字段中添加 Tavily 配置（如果该字段不存在则新建）：

{
  "mcpServers": {
    "tavily": {
      "type": "http",
      "url": "https://mcp.tavily.com/mcp?api_key=tvly-你的API密钥"
    }
  }
}

3，验证配置是否成功

（1）重启 Claude Code（关闭终端后重新执行 claude 命令），在 Claude Code 交互界面中输入如下命令，打开 MCP 管理面板：

/mcp

（2）如果看到 tavily 出现在列表中且状态为已连接（Connected），说明配置成功。

（3）我们也可以直接在对话中测试：输入“帮我搜索一下今天的科技新闻”，如果 Claude Code 调用了 tavily_search 工具并返回了实时结果，即表示一切正常。

四、Tavily 工具使用示例

1，基础网页搜索（tavily_search）

（1）最常用的功能就是让 Claude Code 帮我们搜索互联网上的最新信息。无需手动指定工具，直接用自然语言描述需求即可：

帮我搜索一下 Spring Boot 3.4 版本的新特性
搜索 React 19 中关于 Server Components 的最新变化，只保留官方文档来源

（2）如果我们需要在同一问题上获得不同角度的信息，可以使用深度搜索模式（search_depth: "advanced"），Claude Code 会自动从更多来源获取信息：

请用深度搜索模式，帮我调研一下 LangChain 和 LlamaIndex 在 2026 年的发展现状和社区活跃度对比

2，网页内容提取（tavily_extract）

当我们已经有了目标 URL，希望 Claude 帮我们阅读并分析页面内容时，可以直接丢给它链接：

帮我看看这个 GitHub Issue 在讨论什么：https://github.com/spring-projects/spring-boot/issues/xxxxx
阅读这篇技术博文 https://example.com/blog/xxx，帮我总结其中关于性能优化的三个核心观点

提示：tavily_extract 支持 advanced 提取深度，对于 LinkedIn 文章、受保护页面或包含复杂表格的内容，可以使用 advanced 模式获得更完整的提取结果。只需在对话中说"用高级提取模式"即可。

3，网站结构分析（tavily_map）与深度爬取（tavily_crawl）

当我们需要了解一个网站的整体结构，或围绕某个主题从多个页面收集信息时，可以使用 Map 和 Crawl 工具：

帮我列出 React 官方文档中所有与 Hooks 相关的页面
从 Spring 官方文档爬取关于 Spring Security 的所有配置指南，帮我整理成一份速查表

附：常见问题与进阶配置

1，配置默认搜索参数

（1）我们可以为 Tavily 设置全局默认参数，让所有搜索结果都包含图片、使用高级深度等，避免每次对话都要重复指定。具体方法是在配置文件中添加 DEFAULT_PARAMETERS 环境变量。例如在 settings.local.json 或 ~/.claude.json 中：

{
  "mcpServers": {
    "tavily": {
      "type": "http",
      "url": "https://mcp.tavily.com/mcp?api_key=tvly-你的API密钥",
      "headers": {
        "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 10, \"search_depth\": \"advanced\"}"
      }
    }
  }
}

（2）常用默认参数说明：

include_images：是否在搜索结果中包含图片（true/false）
max_results：每次搜索返回的最大结果数（1~20，默认 5）
search_depth：搜索深度，"basic" 速度更快，"advanced" 更全面
include_favicon：是否返回网站图标 URL（true/false）
include_raw_content：是否返回原始 HTML 内容（true/false）

2，权限管理与安全

（1）在使用 Tavily MCP 时，有几个安全和隐私方面的事项需要注意。首先是 API Key 安全，不要将包含真实 API Key 的配置文件提交到 Git 仓库中。建议使用环境变量或使用 OAuth 方式进行认证

（2）在 settings.local.json 中可以通过 permissions 字段控制哪些 MCP 工具可以自动执行、哪些需要用户确认。例如：

注意：将搜索类工具加入 allow 列表后，Claude Code 将自动执行搜索而不再每次都弹出确认框，这能显著提升使用体验。但建议仅对只读类工具（如搜索、提取）开放自动执行，写操作类工具仍应保留手动确认。

{
  "permissions": {
    "allow": [
      "mcp__tavily__tavily_search",
      "mcp__tavily__tavily_extract"
    ]
  }
}