Claude Code MCP：2026 年 MCP Server 配置完整指南
用claude mcp add为Claude Code配置MCP服务器，检查配置、权限与连接状态，并排查工具故障。
如何为Claude Code添加MCP服务器？
在终端使用claude mcp add <name> -s user -- <command>添加服务器，再用claude mcp list验证。仓库、数据库和搜索能力由对应服务器提供。QVeris配置命令为claude mcp add qveris -s user -- npx @qverisai/mcp。 [来源2] [来源1]（claude mcp add github -- npx @modelcontextprotocol/server-github）
什么是模型上下文协议？
模型上下文协议（MCP）是Anthropic于2024年11月提出的开放标准，定义智能体连接外部工具、数据与服务的方式。兼容客户端可通过同一协议连接兼容服务器。 [来源3]
Claude、ChatGPT、Gemini和Copilot等产品已提供相关MCP支持。各客户端兼容情况、服务器数量与能力覆盖会变化，应核对官方文档和当前目录。 [来源3] [来源4]
MCP如何减少重复集成
没有统一协议时，五个助手对接二十个工具可能需要维护一百个集成关系。MCP通过统一连接方式减少重复工作，但仍需验证每个服务的权限与行为。 [来源3]
Claude Code可通过MCP访问GitHub仓库、查询数据库、搜索网页、读取文档和调用API。每台服务器提供相应类别的能力。 [来源2]
MCP与工具调用生态
MCP已形成跨平台生态。本文统计仅用于背景说明，生产决策应使用带来源和核对时间的最新数据。 [来源3]
- 每月MCP SDK下载量：原文引用2026年5月统计，使用前核对最新来源。
- 公开MCP服务器数量：原文引用超过10,000个，接入前核对当前目录。
- 兼容客户端：包括Claude Code、ChatGPT、Gemini、Cursor与VS Code；具体兼容范围以当前文档为准。
- MCP网关与管理项目：原文引用42个，核对统计口径与更新时间。
选择服务器时，应从具体任务、权限、可用工具与维护情况出发，而不是仅追求连接数量。
添加MCP服务器：配置步骤
使用claude mcp add管理服务器。下面介绍首次配置、验证与配置范围的选择。 [来源2]
接入条件
- Node.js：先运行
node --version检查版本，再按所选服务器的要求安装兼容版本。 [来源文档] - Claude Code：先确认CLI已安装，使用官方安装说明配置运行环境。（
npm install -g @anthropic-ai/claude-code） - 认证凭据：准备所需GitHub令牌、数据库凭据或API密钥，并限制访问范围。
步骤一：检查Node.js
node --version
# Should return v18.0.0 or higher没有Node.js时，从nodejs.org安装兼容的长期支持版本。确认npx可用，并核对服务器要求。 [来源文档]
步骤二：添加服务器（claude mcp add）
通过claude mcp add添加服务器，基本语法如下。 [来源2]
claude mcp add <name> -s <scope> -- <command>
# Example: Add the GitHub MCP server
claude mcp add github -- npx @modelcontextprotocol/server-github
# Example: Add a database server
claude mcp add postgres -s project -- npx @anthropic-ai/mcp-server-postgres把<name>换成明确名称。-s控制配置范围，--后面的命令用于启动服务器。
步骤三：验证服务器状态（claude mcp list）
claude mcp listclaude mcp list会列出已配置的MCP服务器、传输方式和当前状态。已连接的服务器会显示名称和开放的工具；启动失败时会显示错误状态。 [来源2]
传输方式：stdio、HTTP与SSE
Claude Code可使用以下三种MCP传输方式：
- stdio：服务器作为Claude Code子进程运行，适合本地工具与数据库，不需要远程HTTP连接。
- HTTP：使用
--transport http连接远程服务器，适合团队共享和云端服务。 - SSE：主要用于旧服务器。新的远程集成应优先核对Streamable HTTP支持。
传输方式影响延迟与部署。按服务器位置、安全边界和客户端支持情况选择。
配置范围：用户、项目与本地
-s参数控制配置的保存范围：
- 用户范围（
-s user）：保存到~/.claude.json，可在多个项目中使用，适合常用工具。 - 项目范围（
-s project）：保存到当前项目的.mcp.json，可通过版本控制与团队成员共享。 - 省略
-s：使用本地范围，适合个人实验，不用于团队共享。
也可直接编辑项目.mcp.json或用户~/.claude.json。批量配置时应验证JSON并保护凭据。
按任务选择MCP服务器
下面按开发任务分类介绍服务器。能力范围、维护状态与安装方式应逐项核对。 [来源4]
基础开发工具
GitHub MCP
GitHub：管理仓库、审查PR、创建问题和浏览代码，适合使用GitHub托管项目的团队。
Playwright MCP
浏览器自动化：导航、截图、填写表单与测试网页。按实际服务器核对本地或托管运行方式。 [来源4]
Context7 (Upstash)
文档检索：查阅npm或PyPI库的当前文档，减少错误引用API细节。
Brave Search MCP
网页搜索：寻找文档、排查错误和研究库，结果仍需核对来源。
数据库工具
Postgres MCP Pro
Postgres：查询数据库、检查结构并运行迁移；生产环境优先限制为只读权限。
MongoDB MCP
MongoDB：查询集合、运行聚合和检查文档结构，核对Atlas或自行托管支持。
Supabase MCP
Supabase：查询Postgres、管理认证、存储与Edge Functions；按任务限定项目权限。
SQLite MCP
SQLite：直接访问项目中的.db文件，无需单独部署数据库服务器。
协作与文档工具
Slack MCP
Slack：读取频道、检索历史与发送消息。发送部署通知前应确认授权。
Notion MCP
Notion：读取或修改页面、数据库与评论，适合项目文档工作流。
Google Drive MCP
Google Drive：检索和读取文档、表格与文件，按授权分析数据或查阅设计材料。
Jira MCP
Jira：创建、更新和查询任务，查看迭代看板，并把代码修改与任务关联。
QVeris统一能力连接
QVeris通过统一MCP连接提供跨类别能力发现与执行。安装前核对实际工具、数据来源和权限，不应默认覆盖所有专用服务器功能。 [来源1]（claude mcp add qveris）
需要多类别能力时可评估统一连接；若要求隔离凭据、本地执行或专用功能，也应保留专用服务器。
如何评估QVeris连接
传统服务器通常面向特定工具或数据源。QVeris增加能力发现层，帮助Claude Code按任务选择工具；实际目录与覆盖以当前文档为准。 [来源1]
统一连接与实际覆盖
逐个接入GitHub、Postgres和搜索服务器会增加配置及维护工作。应记录每个连接的权限、版本和故障处理方式。
可用claude mcp add qveris -s user -- npx @qverisai/mcp注册QVeris。实际金融、搜索、PDF及其他能力需检查当前目录。 [来源1]
统一连接可以减少部分配置工作，但不会消除工具验证、权限管理和运行监控责任。
自然语言发现、检查与调用
QVeris的基本流程为发现、检查和调用。 [来源1]
- 发现：用自然语言描述目标，例如寻找标普500数据，获取候选能力与元数据。
- 检查：调用前核对成本、延迟、历史成功情况与完整参数结构，不盲目执行。
- 调用：通过执行接口获取结构化结果，并保留会话与审计记录；计费以现行规则为准。
智能体先描述任务，检索候选能力，检查后再执行。不要猜测工具名称或端点。 [来源文档]
金融数据覆盖
金融场景可涉及量化交易、宏观与固定收益、风险合规、投资研究、数字资产和另类信号。按任务核对具体覆盖，不作未经验证的排他性比较。 [来源1]
金融分析任务可查询行情、历史价格、公司文件和电话会记录；数据时效、来源与许可须分别验证。 [来源文档]
调用前成本与性能检查
调用前检查预计积分成本、延迟和历史成功率，有助于提前发现不匹配的工具。 [来源1]
生产团队应把调用前检查作为成本与可靠性控制的一部分，仍须验证真实执行结果。
配置QVeris MCP服务器
claude mcp add qveris -s user -- npx @qverisai/mcp该命令会将QVeris注册为用户范围的MCP服务器，-s user使其可用于多个Claude Code项目。Cursor使用.cursor/mcp.json，Claude Desktop使用claude_desktop_config.json；这些配置使用相同的@qverisai/mcp软件包。 [来源2]
设置QVERIS_API_KEY环境变量：
claude mcp add qveris -s user -e QVERIS_API_KEY=sk-xxx -- npx @qverisai/mcp可在~/.zshrc或~/.bashrc设置export QVERIS_API_KEY=sk-xxx。按需求核对QVERIS_REGION与QVERIS_BASE_URL，不提交真实密钥。
可在Claude Code提出示例任务：查询标普500最近表现及当日主要涨跌股票。
发现候选金融能力，检查费用与延迟，执行后返回结构化数据；是否自动调用取决于实际客户端配置和授权。 [来源1]
其他示例：搜索最新AI新闻、解析并总结PDF、查询比特币价格。说明时间范围和预期输出。
统一连接与独立服务器比较
下面按配置、能力发现、金融覆盖和维护等维度比较统一连接与独立服务器。
| 维度 | QVeris MCP服务器 | 独立MCP服务器 |
|---|---|---|
| MCP配置数量 | 1 | N个（每个工具一份） |
| 能力覆盖 | 覆盖15类、超过10,000项能力[1] | 每台服务器一个工具 |
| 工具发现 | 自然语言发现（Discover API） | 需要预先配置，每个工具使用专门命令 |
| 调用前检查 | 预览成本、延迟与成功率 | 不提供 |
| 金融数据 | 深度覆盖6个领域[1] | 标准服务器不提供 |
| 网页搜索 | 内置 | 需要Brave Search MCP |
| PDF解析 | 内置 | 需要专用PDF MCP服务器 |
| 代码执行 | 沙箱执行 | 需要单独配置 |
| 维护 | 无需自行维护（由QVeris管理） | 每台服务器分别更新 |
| MCP工具搜索支持 | 内置 | 不提供 |
| CLI集成 | 无额外Token开销 | 因服务器而异 |
| 免费额度 | 额度以当前定价页为准 | 多数免费或开源 |
| Claude Code + Cursor + Desktop | 一份配置用于三个平台 | 每个平台单独配置 |
取舍：专用开源服务器便于控制单一工具，统一连接可减少部分集成工作。按覆盖、权限、成本与维护要求评估，不假设所有工具免费或可互相替代。 [来源1]
常见配置问题排查
配置过程可能出现JSON错误、启动失败、认证缺失或平台差异。以下是常见排查路径。 [来源2]
检查.mcp.json或claude_desktop_config.json语法，注意尾部逗号、键名引号和命令中的转义字符。
运行claude mcp list检查状态。断开时核对包是否安装、启动命令是否正确，并查看日志后重新配置。（claude mcp add <name> -s user -- <command>）
cmd /c包装命令
Windows上某些npx服务器需要cmd /c包装，例如claude mcp add <name> -- cmd /c npx @package/name。仅按服务器实际要求使用。
找不到密钥时，核对-e参数，例如claude mcp add <name> -s user -e API_KEY=xxx -- <command>；也可设置环境变量后重启终端。
npx出现EACCES时检查文件权限与Node.js安装方式，可评估nvm或fnm。若全局安装包，应确认权限、版本与启动路径。（npm install -g @package/name）
持续失败时，查看服务器仓库的问题记录，核对Node.js版本、操作系统与已知兼容问题。
Claude Code MCP常见问题
claude mcp add，例如claude mcp add qveris -s user -- npx @qverisai/mcp。也可编辑项目.mcp.json或用户~/.claude.json配置。discover）claude_desktop_config.json，Cursor使用其MCP配置入口；安装@qverisai/mcp前核对当前版本与兼容要求。总结：连接并验证外部工具
MCP扩展Claude Code的外部工具访问。添加服务器后用claude mcp list验证，并检查具体工具权限与结果。 [来源3]（claude mcp add）
需要广泛能力时可评估QVeris的发现与检查流程。免费额度和计费按当前定价页确认，避免沿用旧活动或每日奖励数值。 [来源1] [来源6]
建议先明确任务，再决定统一连接或专用GitHub、Postgres、Playwright服务器；按实际覆盖验证，不使用未经证实的覆盖百分比。