MCP 配置向导
MCP（Model Context Protocol）是 2024 年 11 月 Anthropic 开源的智能体调用标准。配置后，Claude Desktop、Cursor、Cline 等支持 MCP 的客户端可以直接调用你的网站功能。
1. 什么是 MCP
MCP 定义了智能体（Client）和工具提供方（Server）之间的标准通信协议。和 OpenAPI 不同的是，MCP 更关注「智能体如何发现和调用工具」，而不是单纯的接口描述。
配置 MCP 端点后，你的站点从一个「被爬取的内容源」升级为一个「智能体可以直接调用的服务」。
2026 前沿赛道：全网配置 MCP 端点的站点不足 15 个。提前布局有先发优势。
2. 部署 /.well-known/mcp.json
在站点根目录创建 .well-known/mcp.json 文件。这是 MCP 声明的标准位置。
{
"name": "你的站点名",
"version": "1.0.0",
"description": "站点简介，智能体用它理解你能提供什么",
"homepage": "https://你的域名/",
"documentation": "https://你的域名/llms.txt",
"openapi": "https://你的域名/.well-known/openapi.json",
"transport": {
"type": "http",
"endpoint": "https://你的域名/api/tools/{slug}",
"method": "POST"
},
"tools": [
{
"name": "your_tool_name",
"description": "工具功能描述，越具体越好",
"inputSchema": {
"type": "object",
"properties": {
"input": { "type": "string", "description": "参数说明" }
},
"required": ["input"]
}
}
]
}
字段说明：tools 数组里列出的每一个工具，都会被智能体识别为可调用能力。inputSchema 用 JSON Schema 描述参数。
3. Nginx 配置
让 Nginx 正确处理 .well-known/ 目录下的请求，返回正确的 Content-Type。
location ~ ^/\.well-known/ {
root /www/wwwroot/你的站点/public;
try_files $uri =404;
default_type application/json;
add_header Cache-Control "public, max-age=3600" always;
add_header Access-Control-Allow-Origin "*" always;
}
配置后 nginx -t && nginx -s reload。验证：curl https://你的域名/.well-known/mcp.json 应返回 200 且 Content-Type 为 application/json。
4. 在 Claude Desktop 里配置
编辑 Claude Desktop 配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json），加入 HTTP MCP server：
{
"mcpServers": {
"your-site": {
"url": "https://你的域名/.well-known/mcp.json"
}
}
}
重启 Claude Desktop。之后在对话中输入 /mcp 可以看到已加载的工具列表。
5. 完整检查清单
- ✅
/.well-known/mcp.json可访问，返回 application/json - ✅ JSON 结构合法
- ✅ tools 数组至少声明 1 个工具
- ✅ 每个工具都有 name / description / inputSchema
- ✅ transport.endpoint 指向真实可调用的接口
- ✅ 在 llms.txt 里引用 mcp.json 的 URL
- ✅ 用站擎「智能体就绪度诊断」跑一遍，MCP 端点应显示 pass 100