Source: https://aiprimetech.io/zh/claude-code/mcp/

[首页](/zh/) › [Claude Code](/claude-code/zh/) › MCP

[概览](/claude-code/zh/)[安装](/claude-code/zh/install/)[CLI 参考文档](/zh/claude-code/cli/)[定价与限制](/claude-code/zh/pricing/)[Agent SDK](/zh/claude-code/sdk/)[技能与插件](/zh/claude-code/skills/)[GitHub](/zh/claude-code/github/)[网页、桌面与 IDE](/zh/claude-code/web-and-desktop/)[模型](/zh/claude-code/models/)[错误](/zh/claude-code/errors/)[是否开源？](/zh/claude-code/open-source/)[教程](/claude-code/zh/tutorial/)[学生指南](/zh/claude-code/for-students/)[QA 自动化](/zh/claude-code/qa-automation/)[与 Cursor 对比](/zh/claude-code/vs-cursor/)[与 Codex 和 OpenCode 对比](/zh/claude-code/vs-codex/)[子智能体](/zh/claude-code/subagents/)[钩子](/zh/claude-code/hooks/)[MCP](/zh/claude-code/mcp/)[生态系统](/zh/claude-code/ecosystem/)[VS Code](/zh/claude-code/vscode/)[OpenRouter](/zh/claude-code/openrouter/)[速率限制](/zh/claude-code/rate-limits/)[中文指南](/claude-code/zh/)

最后更新：2026 年 11 月

# Claude Code MCP：连接服务器、作用域、远程 MCP 与实际示例

MCP，即模型上下文协议，是 Claude Code 访问代码仓库中文件以外内容的方式，例如数据库、浏览器、GitHub、分析数据和工单跟踪系统。服务器提供工具和资源；Claude Code 连接服务器后，智能体就能像使用内置工具一样使用它们。每个服务器只需一条命令即可完成配置。

## TLDR
- claude mcp add <name> -- <command> 用于本地（stdio）服务器； claude mcp add --transport http <name> <url> 用于远程服务器。
- 作用域：local（你自己，当前项目）、project（.mcp.json，随仓库共享）、user（你自己，所有项目）。
- /mcp 在会话中可显示状态、对 OAuth 服务器进行身份验证，并列出其工具。
- 资源可通过 @ 提及引用；服务器提示词会显示为斜杠命令。

## 添加服务器 

```
# local server over stdio (runs the command, talks over its stdin/stdout)
claude mcp add playwright -- npx @playwright/mcp@latest

# remote server over HTTP
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# with a header (API-key style auth)
claude mcp add --transport http posthog https://mcp.posthog.com/mcp \
  --header "Authorization: Bearer $POSTHOG_API_KEY"

claude mcp list      # what is configured
claude mcp remove playwright
```

Stdio 服务器是由 Claude Code 为你启动的程序，大多数社区服务器都是以这种方式运行的 npm 或 Python 包。远程服务器通过 URL 访问；它们使用 OAuth 进行身份验证（在会话中运行 /mcp 并按照浏览器中的流程操作），或使用添加时传入的请求头，如 PostHog 示例所示。请查阅各供应商的文档以获取当前 URL，因为远程端点可能会变更。 

## 作用域与 .mcp.json 
- local （默认）— 存储在你的用户设置中，仅适用于当前项目。用于个人私有服务器。
- project (--scope project）— 写入 .mcp.json ，该文件位于仓库根目录，并与所有克隆仓库的人共享。Claude Code 首次信任项目的服务器前会询问你。
- user (--scope user）— 可在你机器上的所有项目中使用。 

```
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
    }
  }
}
```

.mcp.json 支持环境变量展开，因此仓库可以包含服务器定义，而每位开发者分别提供自己的凭据。 

## 在会话中使用服务器 

连接后，服务器的工具即可使用，例如询问“PostHog 中过去 24 小时的错误”，Claude Code 就会调用工具。服务器提供的资源可通过 @ 提及引用（@github:issue://123），按需将其引入上下文。服务器定义的提示词会以斜杠命令的形式显示在 /mcp__<server>__<prompt>. /mcp 可显示连接状态，让你重新连接或进行身份验证，并列出所有工具及其说明。 

## 值得借鉴的示例 
- PostHog MCP — 在智能体中直接使用产品分析：“这段代码由哪个功能开关控制，目前的发布情况如何？”PostHog 提供远程 MCP 服务器；使用 --transport http 添加，并将你的个人 API 密钥放在 Bearer 请求头中。
- GitHub — 将议题和拉取请求作为上下文；搭配 GitHub 指南中的 Action，形成审查循环。
- Playwright — 使用真实浏览器进行端到端测试，并检查你刚修改的 UI；参见 QA 自动化指南。
- Postgres / SQLite — 了解数据库结构的查询与迁移；除非确实需要写入权限，否则请为其提供只读用户。
- 仓库外的文件系统 — --add-dir 用于访问额外目录更简单；MCP 用于访问文件以外的内容。 

## 费用与上下文 

MCP 服务器返回的每个工具结果都会进入对话，并在之后的每一轮中重新发送。返回 5,000 行数据的服务器会导致上下文暴增。优先使用可限制结果数量的工具，要求返回摘要，并在 /compact 大量查询之后使用。服务器在本地运行或直接访问供应商；它们不经过模型端点，因此 ANTHROPIC_BASE_URL=https://aiprimetech.io 不受影响，只有结果消耗的 token 会计费。

## 先免费试用

新账户可获得 $5 免费 API 额度 使用优惠码 CLAUDECODE — 足够用 Sonnet 运行 Claude Code 一晚，之后可获得面值 7.69231 倍的额度。

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[使用优惠码 CLAUDECODE 创建账户](/register?promo=CLAUDECODE)

## 常见问题

如何向 Claude Code 添加 MCP 服务器？

本地服务器使用 `claude mcp add <name> -- <command>`，远程服务器使用 `claude mcp add --transport http <name> <url>`；添加 `--scope project` 可通过 .mcp.json 共享。如何将 PostHog 连接到 Claude Code？

使用 `claude mcp add --transport http posthog <url> --header "Authorization: Bearer <api key>"` 添加 PostHog 的远程 MCP 服务器，URL 使用 PostHog MCP 文档中提供的地址，然后在会话中询问事件、功能开关或错误。MCP 能通过网关使用吗？

可以。MCP 服务器在本地运行或直接访问供应商，与模型端点相互独立；只有其结果消耗的 token 会通过网关计费。

## 通过网关运行 Claude Code

相同的模型，两个环境变量，面值 7.69231 倍的额度，或固定费率不限量方案。 新账户：使用优惠码 CLAUDECODE 可获得 $5 免费 API 额度。[获取 API 密钥](/register?promo=CLAUDECODE) [查看不限量方案](/zh/plans/)

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据，且经常发生变化；本页面的价格和模型列表读取自此网关的实时设置。

## 更多 Claude Code 指南

[Claude Code：完整指南](/claude-code/zh/)[如何安装 Claude Code](/claude-code/zh/install/)[Claude Code CLI 文档：命令与参数](/zh/claude-code/cli/)[Claude Code 定价与限制详解](/claude-code/zh/pricing/)[Claude Code SDK，现已更名为 Claude Agent SDK](/zh/claude-code/sdk/)[Claude Code 技能与插件](/zh/claude-code/skills/)[在 GitHub 中使用 Claude Code：App、Action 和 @claude](/zh/claude-code/github/)[Claude Code 有网页界面吗？网页、桌面与 IDE 版本详解](/zh/claude-code/web-and-desktop/)[Claude Code 使用哪个模型，以及如何更改](/zh/claude-code/models/)[Claude Code 错误及修复方法](/zh/claude-code/errors/)[Claude Code 开源吗？](/zh/claude-code/open-source/)[Claude Code 教程：您的首次实际会话](/claude-code/zh/tutorial/)[学生使用 Claude：Claude Code、API，以及教育优惠实际提供什么](/zh/claude-code/for-students/)[如何使用 Claude Code 实现 QA 自动化](/zh/claude-code/qa-automation/)[Claude Code 与 Cursor 对比：如何选择、何时使用，以及如何同时使用两者](/zh/claude-code/vs-cursor/)[Claude Code、Codex 与 OpenCode：终端智能体对比](/zh/claude-code/vs-codex/)[Claude Code 子智能体：工作原理、定义方法与智能体团队](/zh/claude-code/subagents/)[Claude Code 钩子：以确定性方式控制智能体的行为](/zh/claude-code/hooks/)[Claude Code 生态系统：路由器、框架、插件及收录它们的清单](/zh/claude-code/ecosystem/)[在 VS Code 中使用 Claude Code：扩展、终端方式与常见错误](/zh/claude-code/vscode/)[如何在 Claude Code 中使用 OpenRouter（以及何时不宜使用）](/zh/claude-code/openrouter/)[Claude 速率限制错误：“API error: rate limit reached”的含义与解决方法](/zh/claude-code/rate-limits/)[Claude Code 怎么用：从安装到日常使用](/claude-code/zh/)