MCP 服务器：将 Claude 连接到你的技术栈
安装和配置 MCP 服务器，让 Claude 实时访问 Slack、Supabase、Notion 和 GitHub。无需任何胶水代码。
技能 是一个带有前置元数据的 Markdown 文件，位于 ~/.claude/skills/。Claude 通过读取其描述字段来发现技能；当你的请求匹配时，它会加载并遵循运行手册。一次编写指令，每次都获得相同的步骤。
---
name: translate-pi-jargon
description: 将 PI 法律术语翻译成通俗易懂的英语。当用户粘贴法律文本或提及 UM/UIM、要求函或留置权等术语时使用。
---
# 翻译 PI 法律术语
1. 用一句通俗易懂的话重述该术语。
2. 举一个一句话的例子，说明它何时重要。
3. 标记任何有时间压力的事项（法规、截止日期）。当你第三次将相同的“食谱”粘贴到 Claude 中时，就编写一个技能。
描述是发现机制。 Claude 读取描述并决定哪个技能（如果有的话）适用于你的请求。
差：“一个用于处理文档的技能。” Claude 无法判断何时适用。
好：“当用户粘贴合同或要求总结、修订或从 PDF 中提取条款时使用。”
公式：“当 [特定触发器] 发生时使用。适用于 [特定内容类型]。”
技能还是 CLAUDE.md 规则？ 技能是可重复的多步骤程序；CLAUDE.md 规则是始终开启的约束。一个 10 步的部署运行手册是一个技能。“未经备份，绝不对生产环境运行迁移”是一条规则。两者都属于系统。
MCP（模型上下文协议）服务器是一个适配器，它将外部工具暴露给 Claude。Slack、Supabase、Notion、GitHub：Claude 调用 MCP，MCP 调用 API，你无需编写任何胶水代码。Claude 不再复制粘贴数据到提示中，而是直接读取实时数据并采取行动。
数据库 MCP： “显示上周注册但尚未激活的用户”作为实时查询运行。
Slack MCP： “总结 #engineering 今天讨论了什么”拉取实时消息。
Notion MCP： “用今天的决策更新项目维基”直接写入。
GitHub MCP： “列出超过 7 天的开放 PR”查询实时仓库状态。
安装模式： 安装服务器 (npx 或 uvx)，将配置添加到 ~/.claude/settings.json：
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "@your-org/mcp-slack"],
"env": { "SLACK_BOT_TOKEN": "xoxb-your-token-here" }
}
}
}安全规则：
绝不将真实 token 粘贴到公共文件中；通过环境变量或秘密存储注入。
数据库 MCP 获取只读凭据，范围限定在 Claude 需要的表。服务角色密钥可以删除表。
在部署之前审查每个 MCP 暴露了哪些工具。
执行操作的 MCP 需要审批门控。
选择你的第一个 MCP，问自己：我目前从外部系统粘贴到 Claude 中的是什么？数据库查询结果指向 Supabase MCP；PR 列表指向 GitHub；频道摘要指向 Slack；笔记指向 Obsidian。一个已安装并积极使用的 MCP 胜过四个已配置但被忽略的 MCP。
测试它： 关闭并重新打开 Claude Code 以触发发现，然后询问：“你从 [MCP 名称] 获得了哪些可用工具？” 如果列表为空，请检查 settings.json 语法并确认 npx 或 uvx 在你的 PATH 中。
技能和 MCP 相互增强。 一个部署运行手册技能加上一个 GitHub MCP 加上一个 Slack MCP：Claude 遵循运行手册，读取实时 PR 状态，发布进度更新。一个 20 分钟的手动部署变成 2 分钟。每个技能的设置成本大约是 30 分钟，每个 MCP 10 分钟；前五次使用就能收回成本。
没有适用于你的工具的已发布 MCP？ 一个使用官方 Python SDK 的最小自定义服务器可以在大约 30-40 行代码中暴露一个工具：定义工具的名称、描述和输入 schema，然后处理调用。给工具描述与技能描述相同的具体性。为实时、频繁查询的数据构建自定义 MCP；对于静态参考数据，一个要求你粘贴它的技能就足够了。
团队设置的凭据管理。 共享 settings.json 中硬编码的 token 是一个等待发生的事件。两种更安全的模式：环境变量传递（"SLACK_TOKEN": "$SLACK_TOKEN"，真实值在你的 shell 配置文件中）或 MCP 服务器在启动时查询的秘密管理器（Vault，1Password CLI），这样敏感信息就不会留在磁盘上。
范围限定到最小： 用于 Supabase 的只读 Postgres 角色，限定到特定仓库的细粒度 GitHub token，限定到 Claude 应该看到的频道的 Slack bot token。
审计： 对于可以写入的 MCP，添加一个 PostToolUse 钩子，记录时间戳、工具名称、参数和结果状态。
技能是 Claude 通过描述发现的 Markdown 运行手册；当你第三次粘贴相同的指令时，就编写一个。MCP 无需胶水代码即可将 Claude 连接到外部 API；使用只读、最小权限的凭据。最好的第一个技能：你本周已经解释过两次的程序。最好的第一个 MCP：你复制粘贴最多的系统。