mindmap
  root((AI 能力))
    文件操作
      读取 Read
      编辑 Edit
      创建 Write
    代码搜索
      内容搜索 Grep
      文件查找 Glob
    终端操作
      运行命令 Bash
    代码智能
      LSP
      类型检查
      跳转定义
    项目理解
      自动分析结构
      理解依赖关系
    网络能力
      Web Reader 读取网页
      Web Search 网络搜索
      ZRead GitHub 仓库
    任务管理
      TodoWrite 进度追踪
      Task 通用子代理调度
    交互能力
      AskUserQuestion 询问决策

按类型分类的工具表

1. 文件操作工具 - 读写代码的基础

2. 搜索工具 - 找到需要的东西

3. 终端工具 - 执行命令

4. 代码智能 - 通过插件额外支持

LSP（语言服务器）能力不是内置，需要通过插件额外安装：

# 打开插件管理界面
/plugin

搜索 typescript-lsp 或 pyright-lsp 并安装

支持的语言包括：TypeScript、JavaScript、Python、Rust、Go、C/C++、C#、PHP、Java、Ruby、Swift 等。

5. 项目理解 - 自动分析

6. 网络能力 - 需要配置 MCP/插件

AI 能读取的：

• ✅ 公开的网页链接（通过 MCP/插件）
• ✅ GitHub 仓库文件（通过 ZRead MCP）
• ✅ 文档站点（通过 Web Reader MCP）

AI 不能读取的：

• ❌ 需要登录的页面
• ❌ 本地文件路径（非项目目录）
• ❌ 被防火墙阻挡的网站

7. 任务管理 - AI 自动使用，你只需看到效果

8. 交互能力 - AI 自动使用，你只需回答

判断标准：内置够用还是需要扩展？

# ✅ 不需要扩展的场景（内置足够）
"读取文件并分析"      → 用 Read 工具
"运行命令并处理结果"   → 用 Bash 工具
"实现某个功能"        → 直接描述任务，AI 自动规划

❌ 需要扩展的场景

"查询 PostgreSQL 数据库" → 需要 MCP/插件
"读取 Google Drive 文档" → 需要 MCP/插件
"调用 Slack API 发送消息" → 需要 MCP/插件

何时使用扩展：

LSP 语言服务器（代码智能）

开发工作流

代码质量与安全

开发工具包

输出风格

示例与模板

安装方式：输入 /plugin 后搜索并安装所需插件。

插件是一个包含以下组件的 npm 包：

my-plugin/
├── .claude-plugin/
│   ├── plugin.json          # 插件元数据
│   └── marketplace.json     # 市场清单（可选）
├── commands/                 # 自定义斜杠命令（可选）
│   └── hello.md
├── agents/                   # 自定义代理（可选）
│   └── helper.md
├── skills/                   # 代理技能（可选）
│   └── my-skill/
│       └── SKILL.md
├── hooks/                    # 事件处理程序（可选）
│   └── hooks.json
└── .mcp.json                # MCP 服务器配置（可选）

组件说明：

• plugin.json：插件元数据（名称、描述、版本、作者）
• commands/：自定义斜杠命令（Markdown 文件）
• agents/：子代理定义
• skills/：代理技能（SKILL.md 文件）
• hooks/：事件处理程序（hooks.json）
• .mcp.json：MCP 服务器配置

# 查看已安装的插件
/plugin

启用已禁用的插件

/plugin enable plugin-name@marketplace-name

禁用而不卸载

/plugin disable plugin-name@marketplace-name

卸载插件

/plugin uninstall plugin-name@marketplace-name

在存储库级别配置插件以确保整个团队的工具一致。

设置团队插件：

1. 将市场和插件配置添加到您的存储库的 .claude/settings.json
2. 团队成员信任存储库文件夹
3. 为所有团队成员自动安装插件

配置示例（.claude/settings.json）：

{
  "pluginMarketplaces": [
    {
      "source": "your-org/claude-plugins"
    }
  ],
  "plugins": [
    {
      "name": "formatter",
      "marketplace": "your-org"
    }
  ]
}

如果您有 MCP 服务器的 JSON 配置，可以直接添加：

# 基本语法
claude mcp add-json <name> '<json>'

示例：添加带有 JSON 配置的 HTTP 服务器

claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

示例：添加带有 JSON 配置的 stdio 服务器

claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

三种安装方式

选项 1：添加远程 HTTP 服务器（推荐）

HTTP 服务器是连接到远程 MCP 服务器的推荐选项。这是云服务最广泛支持的传输方式。

# 基本语法
claude mcp add --transport http <name> <url>

真实示例：连接到 Notion

claude mcp add --transport http notion https://mcp.notion.com/mcp

带有 Bearer 令牌的示例

claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"

选项 2：添加本地 stdio 服务器

Stdio 服务器作为本地进程在您的计算机上运行。它们非常适合需要直接系统访问或自定义脚本的工具。

# 基本语法
claude mcp add --transport stdio <name> <command> [args...]

真实示例：添加 Airtable 服务器

claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY \
-- npx -y airtable-mcp-server

tip 理解 "--" 参数

--（双破折号）将 CLI 工具的标志与传递给 MCP 服务器的命令和参数分开。-- 之前的所有内容都是工具的选项（如 --env、--scope），-- 之后的所有内容都是运行 MCP 服务器的实际命令。

例如：

• claude mcp add --transport stdio myserver -- npx server → 运行 npx server
• claude mcp add --transport stdio myserver --env KEY=value -- python server.py --port 8080 → 运行 python server.py --port 8080，环境中设置 KEY=value

这可以防止工具的标志与服务器标志之间的冲突。

Windows 用户

在本机 Windows（不是 WSL）上，使用 npx 的本地 MCP 服务器需要 cmd /c 包装器以确保正确执行。

# 这创建了 Windows 可以执行的 command="cmd"
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

没有 cmd /c 包装器，您会遇到"连接已关闭"错误，因为 Windows 无法直接执行 npx。

许多基于云的 MCP 服务器需要身份验证。Claude Code 支持 OAuth 2.0 以实现安全连接。

# 1. 添加需要身份验证的服务器
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

2. 在 Claude Code 中使用 /mcp 命令

> /mcp

3. 按照浏览器中的步骤登录

您可以使用 @ 提及来引用 MCP 资源，类似于引用文件的方式。

引用格式：@server:protocol://resource/path

# 引用特定资源
> "您能分析 @github:issue://123 并建议修复吗？"
> "请查看 @docs:file://api/authentication 处的 API 文档"

多个资源引用

> "比较 @postgres:schema://users 和 @docs:file://database/user-model"

• 引用时会自动获取资源并将其作为附件
• 资源路径在 @ 提及自动完成中可进行模糊搜索
• 当服务器支持时，Claude Code 会自动提供工具来列出和读取 MCP 资源

MCP 服务器可以暴露提示，这些提示在 Claude Code 中作为斜杠命令可用。

命令格式：/mcp__servername__promptname

# 执行不带参数的提示
> /mcp__github__list_prs

执行带参数的提示

> /mcpgithubpr_review 456
> /mcpjiracreate_issue "登录流中的错误" high