> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiji.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 入门

> 给 Claude Code 和 Codex 安装 MCP 服务器，让 AI 能查文档、开浏览器、联网搜索。

**MCP**（Model Context Protocol）是给 AI 编程工具接入外部能力的标准接口。装一个 MCP 服务器，AI 就多一项能力，例如查询最新文档、操作浏览器、读取数据库。

Claude Code 和 Codex 都支持 MCP，同一个 MCP 服务器两边都能用。

## 安装 MCP 服务器

MCP 服务器分两种：在本地运行的（stdio），和远程托管的（HTTP）。

<Tabs>
  <Tab title="Claude Code">
    **本地服务器**：`--` 后面是启动服务器的命令

    ```bash theme={null}
    claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp
    ```

    **远程服务器**：

    ```bash theme={null}
    claude mcp add --scope user --transport http 服务器名 https://example.com/mcp
    ```

    `--scope` 决定配置保存在哪里：

    | 取值 | 作用范围 |
    | - | - |
    | `local`（默认） | 只对当前项目、只对你生效 |
    | `project` | 写入项目的 `.mcp.json`，团队共享 |
    | `user` | 对你的所有项目生效 |

    **查看和管理**：

    ```bash theme={null}
    claude mcp list          # 查看所有服务器及连接状态
    claude mcp remove 名字    # 删除服务器
    ```

    在会话中输入 `/mcp` 也可以查看状态。
  </Tab>

  <Tab title="Codex">
    **本地服务器**：

    ```bash theme={null}
    codex mcp add context7 -- npx -y @upstash/context7-mcp
    ```

    **远程服务器**：

    ```bash theme={null}
    codex mcp add 服务器名 --url https://example.com/mcp
    ```

    也可以直接编辑 `~/.codex/config.toml`：

    ```toml config.toml theme={null}
    [mcp_servers.context7]
    command = "npx"
    args = ["-y", "@upstash/context7-mcp"]
    ```

    在会话中输入 `/mcp` 查看已加载的服务器。
  </Tab>
</Tabs>

<Note>
  通过 `npx` 启动的 MCP 服务器需要 Node.js，见 [Node.js 环境配置](/environment/setup)。
</Note>

## 推荐的 MCP 服务器

| 服务器 | 能力 | 适合场景 |
| - | - | - |
| [Context7](https://github.com/upstash/context7) | 查询各类库和框架的最新文档 | 防止 AI 使用过时的 API 写代码 |
| [Playwright MCP](https://github.com/microsoft/playwright-mcp) | 让 AI 操作浏览器 | 改完前端后让 AI 自己打开页面验证 |
| [Chrome DevTools MCP](https://github.com/ChromeDevTools/chrome-devtools-mcp) | 读取控制台、网络请求、性能数据 | 调试网页问题 |

安装命令示例：

<CodeGroup>
  ```bash Claude Code theme={null}
  claude mcp add --scope user playwright -- npx -y @playwright/mcp@latest
  ```

  ```bash Codex theme={null}
  codex mcp add playwright -- npx -y @playwright/mcp@latest
  ```
</CodeGroup>

## 使用建议

* **按需安装**：每个 MCP 服务器的工具说明都会占用上下文，装得越多，每次请求消耗的 Token 越多
* **只装可信来源**：MCP 服务器可以在你的电脑上执行操作，只安装官方或知名开源项目
* **装完先验证**：用 `claude mcp list` 或 `/mcp` 确认状态为已连接，再开始使用


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.