MCP集成
Model Context Protocol (MCP)是一个用于将AI助手连接到外部工具和数据源的开放标准。Scavio运行一个MCP服务器, 为任何兼容的客户端提供11个工具的访问,覆盖Google Search、Amazon、Walmart、 YouTube和Reddit。配置不到2分钟。
前提条件
- 在 dashboard.scavio.dev 获取您的API密钥
- 将以下示例中的
YOUR_SCAVIO_API_KEY替换为您的实际密钥
Claude Code
在终端中运行此命令:
Bash
claude mcp add --transport http scavio https://mcp.scavio.dev/mcp \
--header "x-api-key: YOUR_SCAVIO_API_KEY"要添加到共享项目配置(纳入版本控制),使用 --scope project:
Bash
claude mcp add --transport http --scope project scavio https://mcp.scavio.dev/mcp \
--header "x-api-key: YOUR_SCAVIO_API_KEY"或者直接添加JSON配置:
Bash
claude mcp add-json scavio '{
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}'验证连接:
Bash
claude mcp listClaude Desktop
- 打开Claude Desktop
- 进入 Settings > Developer > Edit Config
- 将Scavio添加到
claude_desktop_config.json:
JSON
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}- 保存并重启Claude Desktop
配置文件位置:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Cursor
- 打开Cursor,进入 Settings > Tools & MCP
- 点击 + Add New MCP Server
- 选择类型 HTTP 并输入:
- Name:
scavio - URL��
https://mcp.scavio.dev/mcp - Headers:
x-api-key: YOUR_SCAVIO_API_KEY
- Name:
- 点击 Save
或手动编辑项目根目录中的 .cursor/mcp.json(或全局的 ~/.cursor/mcp.json):
JSON
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}Windsurf
- 打开Windsurf并点击Cascade中的 锤子图标
- 点击 Configure 打开MCP配置
- 将Scavio添加到
~/.codeium/windsurf/mcp_config.json:
JSON
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}- 保存文件并刷新Windsurf
VS Code(GitHub Copilot)
- 在项目根目录创建
.vscode/mcp.json:
JSON
{
"servers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}- 打开命令面板(
Ctrl+Shift+P/Cmd+Shift+P) - 运行 MCP: List Servers 验证连接
全局配置请在VS Code用户设置中的 mcp.servers 下添加相同配置。
ChatGPT
ChatGPT通过其Apps & Connectors功能支持远程MCP服务器:
- 进入 ChatGPT设置 > Apps & Connectors
- 点击 Add custom connector
- 输入MCP服务器URL:
https://mcp.scavio.dev/mcp - 使用您的API密钥配置认证
- 保存并开始在对话中使用Scavio工具
ChatGPT MCP支持需要Plus或Team计划,根据您的配置可能需要OAuth认证。
Cline(VS Code扩展)
- 打开安装了Cline的VS Code
- 点击Cline侧边栏中的 MCP Servers 图标
- 点击 Configure MCP Servers
- 将Scavio添加到配置中:
JSON
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}- 保存后Cline将自动检测新服务器
Zed编辑器
- 打开 Settings(
Cmd+,) - 导航到 Assistant 部分
- 在MCP servers下添加Scavio:
JSON
{
"assistant": {
"mcp_servers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
}任何MCP兼容客户端
Scavio可与任何支持Model Context Protocol的工具配合使用。通用配置���
JSON
{
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}| 详情 | 值 |
|---|---|
| 传输协议 | HTTP(Streamable HTTP) |
| URL | https://mcp.scavio.dev/mcp |
| 认证 | 通过 x-api-key 头传递API密钥 |
可用工具
连接后,您的AI助手可以使用以下11个工具:
| 工具 | 描述 |
|---|---|
search_google | 网页搜索,包含结构化结果、新闻、图片、地图和知识图谱 |
search_amazon | 搜索Amazon产品列表,支持价格和排序过滤 |
get_amazon_product | 按ASIN获取Amazon产品完整详情 |
search_walmart | 搜索Walmart产品列表,支持价格和配送过滤 |
get_walmart_product | 按产品ID获取Walmart产品完整详情 |
search_youtube | 搜索YouTube视频、频道和播放列表 |
get_youtube_metadata | 获取视频元数据(标题、播放量、点赞数、时长) |
search_reddit | 搜索Reddit帖子,支持排序和基于游标的分页 |
get_reddit_post | 按URL获取完整Reddit帖子及其线程评论 |
get_usage | 查看积分余额和计划详情 |
故障排除
服务器无法连接?
- 验证API密钥是否正确且处于活动状态
- 使用
get_usage或在 dashboard.scavio.dev 检查积分 - 确保URL完全是
https://mcp.scavio.dev/mcp(无尾部斜杠)
工具未显示?
- 添加配置后重启AI客户端
- 检查配置文件中的JSON语法错误
- 确认MCP服务器在客户端的MCP设置中显示为"已连接"
后续步骤
- Google Search API -- 完整端点参考
- Amazon API -- 产品搜索和详情
- YouTube API -- 搜索和元数据
- Walmart API -- 产品搜索和详情
- Reddit API -- 帖子搜索和线程评论
- 速率限制 -- 各计划限制和响应头