Claude Code MCP 服务器 — claude mcp add、远程服务器、PostHog MCP、.mcp.json（2026）

添加服务器

# 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 创建账户

常见问题

如何向 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 密钥查看不限量方案

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

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

TLDR