Projects 与 MCP 入门教程

编辑部发布 2026-06-23 更新 2026-06-27 12 分钟阅读 2,192 字

如果你刚接触 Projects 和 MCP，或听过它们却不清楚如何协同工作，本文将手把手带你从零搭建高效的 Claude 工作流。核心思路是：用 Projects 管理上下文和文件，用 MCP 扩展外部能力，解决 Claude 对话中“记不住预设”和“无法调用工具”两大常见问题。 下文将提供具体步骤、验证方法和避坑指南。

Quick answer

Projects 是你在 Claude 中的“专属工作区”——你可以在每个 Project 内设置 Instructions（相当于系统提示词），上传相关文件（代码库、文档、数据样本），让 Claude 每次对话都基于这些固定背景知识作答。MCP（Model Context Protocol）是让 Claude 调用外部工具的协议，例如读取本地文件、查询数据库或调用 API。简而言之：Projects 给 Claude 提供“记忆”和上下文，MCP 给它“手脚”来获取外部信息或执行操作。两者结合，你可以将 Claude 从一个“一次性聊天”升级为“可复用的、具备工具能力的项目助手”。

开始前的准备

动手前，请确认以下前提条件，否则容易卡住：

拥有 Claude 订阅：Projects 功能只对 Claude Pro、Team 或 Enterprise 用户开放。免费版用户无法创建 Project。
使用正确的 Claude 版本：MCP 支持需要 Claude Desktop 应用（网页版不行）。请从 claude.ai/download 下载安装最新版。
熟悉基本概念：建议先阅读 [Projects 与 MCP 概述文章](ilink:Projects 与 MCP)，能帮你更快进入状态。
准备好目标工具：如果涉及文件系统操作，确保有本地文件夹权限；如果涉及数据库，准备好连接字符串。

最容易翻车的地方：网页版用户想用 MCP（做不到），或者 Pro 用户在团队/企业环境下可能需要申请权限。还有一个常见误区是跳过准备工作，直接复制网上的配置代码——结果往往报错，通常只是因为版本号或路径不一致。

步骤详解

第一步：创建一个 Project

在 Claude 左侧导航栏点击 Projects（图标像个文件夹）。
点击右上角的 Create Project。
给你的 Project 取名（比如“Python 代码审查助手”），然后在 Instructions 框里写清楚你对 Claude 的行为要求或背景知识。这一步很关键：Instructions 是所有对话的默认系统提示词，相当于每次对话前 Claude 都会“记住”的内容。
- 举例：“你是一位资深 Python 开发者，代码审查时重点检查安全漏洞和性能问题。请用列表格式输出发现的问题，每条包含严重等级（高/中/低）和改进建议。”
你还可以上传文件到 Project——比如项目代码、API 文档或数据字典。Claude 会把它们作为答题依据。

第二步：写出好用的 Instructions

很多人把 Instructions 写得太空（像“帮我写代码”），效果不稳定。下面给两个实用建议，更多技巧可以看 [Claude 提示词工程完全指南](ilink:Claude 提示词工程完全指南)：

说清角色和输出格式：别只写“帮忙分析数据”，改成“你是一名数据分析师。我会上传 CSV 文件，你要输出一段 200 字以内的摘要，以及包含均值、中位数、缺失率的关键指标表格。”
给出约束和例外情况：例如“如果数据量超过 1000 行，只随机抽 100 行分析”。提前定好边界，能省后面很多手动调整。

第三步：配置 MCP（模型上下文协议）

前提：你正在用 Claude Desktop 应用，而且已经建好了一个 Project。

打开 Claude Desktop 应用。
点菜单栏（macOS 在左上角，Windows 在右上角）→ Settings → Developer 标签页。
点 Edit Config 按钮，会打开（或新建）claude_desktop_config.json 文件。这就是 MCP 的配置文件。
在 JSON 文件里定义要连接的 MCP 服务器。每个 MCP 服务器是一个提供特定功能的程序。一个典型配置：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourusername/Desktop/workspace"
      ]
    }
  }
}

filesystem：这个 MCP 服务器的名字，你可以随便取。
command 和 args：指定怎么启动服务器。上面例子用 npx 直接运行社区提供的 filesystem 服务器，最后一个参数是允许 Claude 访问的目录路径。

保存文件后，完全重启 Claude Desktop 应用。光关窗口不够：macOS 用户用 Cmd+Q 退出，Windows 用户右键系统托盘图标退出后再打开。
重启后，在对话界面里，回形针图标旁边会多一个“工具箱”符号。点它就能看到所有配置好的 MCP 服务器和它们提供的工具。

常见错误：很多人直接复制网上的配置，但忘了改路径。路径错了 MCP 服务器就启动失败，Claude 界面上也不会出现工具箱图标。一个很管用的检查方法：打开终端（macOS/Linux）或命令提示符（Windows），手动运行你配置的 command 和 args（例如 npx -y @modelcontextprotocol/server-filesystem /你的路径），看有没有报错。只有当这个命令成功运行，配置才可能生效。

第四步：测试 MCP 是否生效

在对话里输入：“请列出当前工作目录下的文件。”如果配置成功，Claude 会提示调用 list_directory 工具，然后列出你设定路径下的文件。这时，你可以在 Project 的 Instructions 里加上一句：“需要读取文件时，优先用 MCP 提供的文件系统工具。”这样两者就串联起来了。

验证清单

全部完成后，用这张表检查：

检查项	预期结果	搞不定怎么办
Project 能正常创建和保存	左侧列表出现项目名，点进去能看到 Instructions 和文件	检查网络，试着重刷页面
Instructions 在对话中生效	新对话里 Claude 自动遵守你写的规则	确认 Instructions 已保存，重新开一个对话
MCP 工具箱图标可见	对话输入框下方出现扳手或工具箱图标	完全重启桌面应用；检查 `claude_desktop_config.json` 的 JSON 格式对不对
MCP 工具能被调用	Claude 在回复中请求用工具（比如读取文件）	手动在终端运行一次 `command`，确认没报错
MCP 工具执行正确	工具返回正确结果（如文件列表）	检查路径权限，确认路径是绝对路径且存在

常见问题排查

1. 重启后还是看不到 MCP 工具箱图标

最可能的原因：配置文件 JSON 格式有错。打开 claude_desktop_config.json，用 JSONLint 验证一下。常见错误包括多余逗号（{,}）或双引号没配对。
验证方法：手动在终端执行 command 里的内容。如果显示“command not found”，说明依赖没装。比如 npx 需要 Node.js，先确认 node --version 和 npx --version 能正常输出。

2. Instructions 写了很多，Claude 却不照做

检查顺序：Project 的 Instructions 优先级低于对话里的即时指令。如果你在对话里说“忽略之前的设定”，那个指令会覆盖 Instructions。另外，不同 Project 的 Instructions 互不干扰，确认你进对了 Project 的对话。
建议：把最核心的规则放在 Instructions 开头。长的 Instructions 会占用 Token 预算，尽量简洁。

3. MCP 工具能用，但返回结果不对

对比预期：比如让 Claude 读 CSV 文件，但返回内容不全。先在终端里自己用命令读同一文件，确认文件本身没问题。如果是数据库 MCP，检查连接串和表名是否正确。

4. 我想用 MCP 访问不同目录，怎么做？

可以在同一个配置文件里定义多个 MCP 服务器，但 filesystem 服务器一次只能绑定一个根目录。要访问多个目录，可以配置多个不同的 filesystem 服务器实例，每个绑一个目录，并取不同名字（比如 docs-fs、code-fs）。更好的办法是在本地创建软链接或统一工作目录，把所有需要的文件放到同一个根目录下。

常见问题

Projects 和 MCP 的关系是什么？

Projects 提供“记忆”（上下文和文件），MCP 提供“能力”（调用外部工具）。两者独立工作，但可以互补：你可以在 Project 的 Instructions 里引导 Claude 优先用 MCP 工具，让整个工作流更流畅。

免费版用户能用吗？

免费版可以访问 Projects（看别人建的），但不能创建自己的 Project。MCP 功能