CalendarSync

日程管理

加载日程...

Webhook

管理事件回调通知

加载 Webhook...

用户管理

管理系统中的所有用户

加载用户列表...

设置

账户与 API 配置

API Key

用于程序调用的身份凭证，请妥善保管。重新生成后旧 Key 将立即失效。

-

修改密码

更新您的登录密码

MCP 对接文档

使用 Model Context Protocol 集成 AI 助手

快速开始

端点地址

POST /mcp

认证方式

所有 MCP 请求需要通过 X-API-Key 请求头进行认证：

X-API-Key: <your_api_key>

API Key 可在设置页获取。MCP 仅支持 API Key 认证，不支持 JWT Token。

基本请求格式

MCP 使用 JSON-RPC 2.0 协议：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "<工具名称>",
    "arguments": { ... }
  }
}

可用工具

1. create_event — 创建日程

创建一个新的日历日程事件。

参数： title（必填）、description、location、start_time（必填）、end_time（必填）、recurrence_rule、recurrence_until、reminder_minutes、tags

时间格式：RFC3339（如 2026-05-01T10:00:00+08:00）

2. list_events — 查询日程列表

根据条件查询日程列表，所有参数均为可选。

参数： from（开始日期）、to（结束日期）、status（active/expired/all）、keyword（关键词搜索）

3. get_event — 获取日程详情

根据 ID 获取单个日程的详细信息。

参数： id（日程 ID，必填）

4. update_event — 更新日程

更新现有日程，仅需传入要修改的字段。

参数： id（必填）、title、description、location、start_time、end_time、status、recurrence_rule、recurrence_until、reminder_minutes、tags

5. delete_event — 删除日程

删除指定日程（软删除，状态变为 cancelled）。

参数： id（日程 ID，必填）

错误处理

错误响应格式：

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params: 日程标题不能为空"
  }
}

常见错误码：

  • -32602 — 参数验证失败
  • -32001 — 日程不存在
  • -32603 — 服务器内部错误
  • HTTP 401 — API Key 无效

Claude Desktop 配置示例

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "calendar": {
      "url": "https://ics.xiuyuan.xin/mcp",
      "headers": {
        "X-API-Key": "your_api_key"
      }
    }
  }
}

权限说明

  • 每个请求通过 API Key 关联到具体用户
  • 普通用户只能操作自己创建的日程
  • 管理员用户拥有完整访问权限
  • 每个请求独立认证，无会话状态

Webhook 集成

MCP 操作与 REST API 共享相同的 webhook 通知机制：

  • 创建日程 → event.created
  • 更新日程 → event.updated
  • 删除日程 → event.deleted

Webhook 通知为异步发送，不影响 MCP 响应速度。