ClavueClavue
macOS AI 工作台

官方 MCP · 联网搜索

Clavue 将联网搜索做成托管官方 MCP 能力（不是自由对话模型）。imux Agent Chat、chat.clavue.com / playground「调研」、以及 OpenAI 兼容客户端共用同一后端与合规网关。

一句话：server = clavue · tool = web_search · 产品模型 = clavue-2.1-search · 输出 = clavue.search.v1（agent 工具 JSON）。

快速上手（3 分钟）

场景怎么用
imux Agent登录会员 → Agent 开启工具 → 说「用官方联网搜索查 …」或让模型调用 mcp__clavue__web_search
chat / playground打开 /playground 或 chat.clavue.com → 打开「调研」→ 发送查询
API / 脚本POST /v1/mcp/tools/call 名称 web_search；或 model=clavue-2.1-search

推荐提问示例

  • 「用官方 MCP 联网搜索：Clavue 2.1 发布说明，并列出可点击来源。」
  • 「调用 mcp__clavue__web_search，query 为 imux macOS Sparkle 更新，只根据 sources 回答。」
  • Playground：打开「调研」后直接输入「今天 clavue.com 有什么更新」。
这不是闲聊模型：结果是结构化证据（summary / findings / sources）。Agent 应引用 sources，不要编造链接。

概念

名称含义
clavue官方 MCP server 名（托管在 api.clavue.com）
web_search工具名
mcp__clavue__web_searchimux Agent 中的合格工具名（function calling）
clavue-2.1-searchOpenAI 兼容产品模型 ID（等价入口，非闲聊）
clavue.search.v1统一输出 schema：summary / findings / sources / results

鉴权

  • Web：登录 /account （Cookie imux_membership_session）
  • imux：Account 按钮登录官方会员；Agent 自动带 Bearer session
  • 脚本：设备码登录后 Authorization: Bearer <token>

在 imux Agent 中使用

  1. 打开 imux → 登录官方会员（imux Official / Account）。
  2. Agent Chat 开启工具；模型可选任意对话模型（auto / clavue-2.1…）。
  3. 让 agent 调用工具 mcp__clavue__web_search（参数 query）。也可说「用官方联网搜索…」。
  4. 工具结果为 clavue.search.v1 JSON；agent 据此写答案并引用 sources。
  5. 兼容：imux_web_search 在已登录时会优先走官方 MCP，失败再本地降级。
网络类工具默认为 confirm 级：Ask 模式会弹确认；Plan 模式只读不调用搜索。Automatic / Full 可自动批准。

在 chat.clavue.com / playground 使用

  1. 打开 /playground 或 chat.clavue.com 并登录。
  2. 打开「调研」按钮（Official MCP search）。
  3. 输入查询并发送：内部使用 model=clavue-2.1-search，结果渲染为摘要 + 来源。
  4. 关闭「调研」后恢复普通对话模型（auto / clavue-2.1*）。

API / 脚本

发现工具

curl -s https://api.clavue.com/v1/mcp \
  -H "Authorization: Bearer $TOKEN" | jq .

调用 web_search（推荐 MCP 形态）

curl -s https://api.clavue.com/v1/mcp/tools/call \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "web_search",
    "arguments": { "query": "Clavue 2.1 release notes" }
  }' | jq .

OpenAI 兼容等价

curl -s https://api.clavue.com/v1/chat/completions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "clavue-2.1-search",
    "stream": false,
    "messages": [{ "role": "user", "content": "Clavue 2.1 release notes" }]
  }' | jq -r '.choices[0].message.content' | jq .

同源路径同样可用：https://www.clavue.com/api/membership/v1/…

输出格式（agent 统一）

{
  "ok": true,
  "kind": "web_search",
  "schema": "clavue.search.v1",
  "productModel": "clavue-2.1-search",
  "query": "...",
  "asOf": "2026-07-25T00:00:00.000Z",
  "summary": "...",
  "findings": [
    { "claim": "...", "confidence": "high", "sourceIds": [0] }
  ],
  "results": [
    { "title": "...", "url": "https://...", "snippet": "..." }
  ],
  "sources": [
    { "id": 0, "title": "...", "url": "https://...", "snippet": "..." }
  ],
  "count": 1,
  "safety": { "status": "ok", "notes": [] },
  "agent": {
    "use": "tool_result",
    "confidence": "high",
    "instructions": "Treat as search evidence only..."
  }
}

兼容 imux_web_search：ok · query · results · count 始终存在。

合规与安全网关

  • 输入：拦截暴力犯罪、CSAM、欺诈/勒索等查询意图。
  • 输出：清洗无效 URL、过滤高风险文本；可能 status=filtered。
  • 禁止编造引用：agent 只能使用 sources 列表中的链接。
  • 失败与拦截带 requestId — 见 错误与问题反馈。

额度

搜索计入会员 premium 池（与 clavue-2.1 同类）。失败且未产出结果时会按网关规则退还当次额度。

另见