MCP 安装教程

修复 MCP 服务未显示的问题

排查在 Cursor、Claude、VS Code 或 Codex 中添加配置后 MCP 服务不显示的问题。

适合谁?

适合已粘贴 MCP 配置,但在 AI 客户端看不到工具的用户。

配置路径和示例

Client MCP config and logs

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./"]
    }
  }
}

安装步骤

1

Validate config syntax

Make sure JSON or TOML is valid and the server name is correctly quoted.

2

Confirm config path

Check you edited the config path used by the active client or project.

3

Test command manually

Run the command from terminal to confirm it can start.

4

Restart completely

Fully quit and reopen the client, not just the chat session.

5

Check logs

Client logs usually show command, permission, or token errors.

常见问题

Config saved in wrong file

Project-level and global config files are different.

Missing environment token

Some servers require API keys or app permissions.

FAQ

Does restarting matter?

Yes. MCP clients often load servers only on startup.

What is the fastest fix?

Validate config, run command in terminal, then restart the client.