首页

星辰记 MCP 接入指南

让 AI 助手读写你的日记、目标和随记数据

2026年6月28日 星辰记团队

什么是 MCP?

MCP(Model Context Protocol)是一个开放协议,让 AI 助手能够安全地访问你的个人数据和应用。简单来说:

  • 在星辰记中记录日记、设定目标、管理随记
  • AI 助手通过 MCP 协议读取这些数据,帮你总结、分析、提醒
  • 所有操作都需要你的 API Key 授权,数据安全可控

第一步:获取 API Key

  1. 打开星辰记 App(app.startraceai.com
  2. 进入「我的」→「API Key 管理」
  3. 点击「创建」,输入一个名称(如「我的 MCP」)
  4. 复制生成的 API Key(格式:st_sk_xxxxx

⚠️ API Key 仅显示一次,请立即复制并妥善保存。不要泄露给他人。

第二步:复制配置

以下配置适用于所有支持 Streamable HTTP 传输的 MCP 客户端。将 YOUR_API_KEY 替换为你在第一步获取的 API Key。

{
  "mcpServers": {
    "startrace": {
      "url": "https://api.startraceai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

第三步:配置到客户端

选择你使用的 AI 客户端,按照以下步骤配置:

🦞 OpenClaw / ClawX 桌面客户端

  1. 打开 ClawX 桌面客户端
  2. 进入「设置」→「MCP 服务器」
  3. 点击「添加远程 MCP 服务器」
  4. 将上面的 JSON 配置粘贴进去,保存
  5. 重启 ClawX 即可生效

自托管 OpenClaw 用户:将配置添加到 ~/.openclaw/mcp.json 或 gateway 配置文件的 mcpServers 节点。

🦞 QClaw 腾讯电脑管家

  1. 打开腾讯电脑管家,进入 QClaw 面板
  2. 点击「设置」→「MCP 服务」
  3. 选择「添加 HTTP MCP 服务器」
  4. 将 JSON 配置粘贴进去,保存

💼 WorkBuddy 腾讯云

  1. 打开 WorkBuddy 桌面客户端
  2. 进入「设置」→「MCP 集成」
  3. 点击「添加远程 MCP 服务」
  4. 将 JSON 配置粘贴进去,保存

🤖 Claude Desktop Anthropic

  1. 打开 Claude Desktop,进入 Settings → Developer → Edit Config
  2. mcpServers 对象中添加 startrace 配置
  3. 保存文件,完全退出并重启 Claude Desktop

配置文件路径:macOS ~/Library/Application Support/Claude/claude_desktop_config.json,Windows %APPDATA%\Claude\claude_desktop_config.json

💻 Cursor IDE

  1. 打开 Cursor 设置(Cmd/Ctrl + ,)
  2. 搜索「MCP」,进入 MCP 设置
  3. 添加新的 MCP Server,选择 Streamable HTTP 传输
  4. 填入 URL 和 Authorization header,保存

🔌 其他 MCP 客户端

所有支持 Streamable HTTP 传输的 MCP 客户端均可使用上述 JSON 配置。在客户端的 MCP 设置或配置文件中添加对应的 mcpServers.startrace 节点即可。

可用的 MCP 工具(19 个)

接入成功后,AI 助手可以调用以下工具:

📔 日记工具(8个)

diary_list、diary_get、diary_create、diary_update、diary_delete、diary_search、diary_today、diary_heatmap

🎯 目标工具(7个)

goal_list、goal_get、goal_create、goal_update、goal_delete、goal_complete、key_result_update

📝 随记工具(2个)

note_list、note_create

🏷️ 其他工具(2个)

tag_list、user_stats

使用示例

配置完成后,你可以这样和 AI 助手对话:

你:帮我看看最近的日记
AI:[调用 diary_list] 你最近有3篇日记...

你:我今天写了日记吗?
AI:[调用 diary_today] 今天还没有日记,需要我帮你记录吗?

你:我的目标进度怎么样?
AI:[调用 goal_list] 你有2个活跃目标...

你:帮我记录今天的心情
AI:[调用 diary_create] 日记已创建!

常见问题

连接失败怎么办?

  • 检查 API Key 是否正确(格式:st_sk_xxxxx
  • 确认网络连接正常,可以访问 api.startraceai.com
  • API Key 是否已过期或被撤销(可在 App 中重新创建)

AI 看不到我的数据?

  • 确认 MCP 服务器已正确连接(客户端通常有连接状态指示器)
  • 检查 API Key 对应的账号是否有数据

安全吗?

  • API Key 仅能访问你本人的数据,无法访问其他用户
  • 所有传输通过 HTTPS 加密
  • 可随时在 App 中撤销 API Key
  • 建议定期更换 API Key

还没有星辰记账号?

下载星辰记 App,开启 AI 智能日记体验

开始使用
MCP AI助手 教程 OpenClaw QClaw WorkBuddy Claude Desktop