0Pricing
MCP Academy · 课时

接入 Claude Desktop

编辑配置，让 Claude 加载您的服务器。

接入 Claude Desktop 是 CoddyKit 上的免费 MCP Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 MCP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 MCP Academy 课程共包含 4 节课。

从脚本连接到真实宿主

您的服务器已经运行，但还没有人和它通信。现在让我们将它连接到真实宿主：Claude 桌面版。🖥️

它会读取配置文件

Claude 桌面版会从一个名为claude_desktop_config.json的 JSON 文件中发现服务器。您可以在那里列出每个服务器，应用启动时会加载它们。

文件所在位置

在 macOS 上，该文件位于Application Support目录下；在 Windows 上，它位于 AppData 漫游文件夹中。请从应用设置中打开它。

~/Library/Application Support/Claude/claude_desktop_config.json

mcpServers 键

每个服务器都放在顶层的mcpServers对象中。每个键是您选择的名称，对应的值则描述如何启动该服务器。

{
  "mcpServers": {}
}

命令和参数

对于每个服务器，您需要提供一个要运行的命令和一个参数数组。两者共同决定宿主如何启动您的进程。

{
  "weather": {
    "command": "python",
    "args": ["/abs/path/server.py"]
  }
}

使用绝对路径

宿主会从自己的工作目录启动，因此相对路径会失效。请始终让参数指向脚本的绝对路径。

使用 uv 更简洁

如果您的项目使用 uv，请将命令设置为uv，让它在正确的环境中运行模块，无需全局安装。

{
  "command": "uv",
  "args": ["run", "server.py"]
}

传递环境变量

API 密钥等机密信息应放在可选的环境变量对象中。宿主启动服务器时会注入这些变量，因此它们无需写入代码。

"env": { "API_KEY": "sk-..." }

重启以应用更改

Claude 只会在启动时读取配置。每次编辑后，您都必须完全重启应用，才能让它加载新的服务器。

锤子图标

运行成功后，聊天界面中会出现一个小型工具指示器。点击它即可查看您的服务器现在向 Claude 提供的工具。🔨

谨慎命名

您在 mcpServers 下选择的键会成为服务器的名称。请保持名称简短且唯一，避免多个服务器在宿主中发生冲突。

快速检查

Claude 桌面版需要进行什么更改，才会加载新添加的服务器？

回顾

您已经通过命令、参数和环境变量将服务器添加到claude_desktop_config.json，使用了绝对路径并完成了重启。现在它已经在 Claude 中运行了！✅

常见问题解答

「接入 Claude Desktop」课时是免费的吗？

是的 — 「接入 Claude Desktop」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 MCP Academy 课程的其余内容，请升级到 CoddyKit PRO。 MCP Academy 课程共包含 4 节课。

「接入 Claude Desktop」这节课中我会学到什么？

编辑配置，让 Claude 加载您的服务器。 你通过在浏览器中直接运行的动手代码来练习 MCP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 MCP Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 MCP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。

「接入 Claude Desktop」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 MCP Academy 课中编写并运行代码吗？

能。每节 MCP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. stdio 传输的工作原理
  2. 接入 Claude Desktop
  3. 使用 MCP Inspector 探索
  4. 调试无法启动的服务器
← 返回 MCP Academy