读取并整理任务
按日期、完成状态、分组、标签和关键词筛选任务，查看单个任务，并通过明确的工具创建、更新、批量调整或删除任务。
MCP 任务管理器
把 AI 助手连接到真实的周计划
在本地运行 weeklyplanner-mcp，让兼容 MCP 的 AI 客户端使用你在 WeeklyPlanner 中的同一套任务、分组、设置和计划数据。
19 个默认可用的核心工具4 个可选的 Planning V2 工具23 个清单内工具
真实计划，不是伪造集成界面
AI 助手通过受限连接操作你的计划
在 WeeklyPlanner 中创建可撤销密钥，连接兼容的 Agent，让工作流读取或更新你在应用中也能检查的同一份计划。
- 你的请求
- Task Planner Skill
- 受限 MCP 或 API
- WeeklyPlanner 计划
AI 客户端能做什么
MCP server 只暴露职责明确的工具，而不是把整个应用的无限制访问权交给 AI 助手。
安全管理循环任务
读取循环系列上下文，从指定日期停止后续实例，或通过专用操作删除整个系列，不直接改动隐藏模板。
使用分组、设置和个人上下文
当 API key 具备所需 scopes 时，读取或更新分组、计划偏好、语言、个人资料字段，并查看当前订阅信息。
回顾计划模式
默认可读取任务统计；当 MCP 进程和后端同时启用 Planning V2 后，还可获取每日回顾、计划上下文、任务模式聚合，并执行原子的异构批量修改。
支持的 MCP 客户端
该 package 使用标准本地 stdio transport。以下接入方式无需托管远程 MCP endpoint。
Claude Desktop
在桌面端 MCP 配置中启动这个 package，并通过 server environment 传入 API URL 和 API key。
Claude Code
用同一条 npx 命令注册 server，再通过 shell 或用户级 MCP 配置提供两个环境变量。
其他兼容 stdio 的客户端
任何能启动本地 stdio server 的 MCP 客户端都可以使用相同命令和环境变量，包括 Cursor 等客户端。
安装并连接
先在 WeeklyPlanner Settings 中创建 scopes 最小化的 API key。以下示例使用 npx，客户端无需单独全局安装即可运行已发布的 package。
运行 package
使用这条命令下载并通过 stdio 启动当前已发布的 MCP server。
npx -y weeklyplanner-mcp添加到 Claude Code
注册 server command，然后在启动 Claude Code 的环境中设置 WEEKLYPLANNER_API_URL 和 WEEKLYPLANNER_API_KEY。
claude mcp add weeklyplanner -- npx -y weeklyplanner-mcp配置 Claude Desktop
把下面的 server block 加入 Claude Desktop MCP 配置，并用在 Settings 中创建的 key 替换占位值。
{
"mcpServers": {
"weeklyplanner": {
"command": "npx",
"args": ["-y", "weeklyplanner-mcp"],
"env": {
"WEEKLYPLANNER_API_URL": "https://weeklyplanner.cc",
"WEEKLYPLANNER_API_KEY": "wp_your_api_key"
}
}
}
}验证连接
修改 MCP 配置后完整重启客户端；先确认工具发现正常，再让 AI 助手执行写操作。
- 1
确认工具已被发现
打开客户端的 MCP 或 tools 面板，确认能看到 list_tasks。正常的核心安装会暴露完整默认工具集，而不只是一个测试工具。
- 2
先运行只读提示词
询问：“列出我本周尚未完成的任务。”客户端应调用 list_tasks 并返回结构化任务数据，不应修改计划。
- 3
检查权限边界
如果 key 缺少所需 scope，API 应拒绝调用。只补充缺失的 scope，不要直接换成拥有宽泛权限的 key。
按类别查看 MCP 工具
下方名称与数量直接来自仓库 manifest，页面会与实际 server 实现保持一致。
任务与循环系列
读取、创建、更新、删除、排序和批量调整任务，并通过专用操作管理循环系列。
9 核心
list_tasksget_taskcreate_taskupdate_taskdelete_taskdelete_task_seriesget_seriesstop_task_series_frombatch_update_tasks分组
读取并维护在计划工具中组织任务的分组。
4 核心
list_groupscreate_groupupdate_groupdelete_group个人资料、设置与订阅
读取或更新个人计划上下文和偏好，并查看当前订阅。
5 核心
get_user_profileupdate_user_profileget_settingsupdate_settingsget_subscription统计与计划分析
读取当前统计数据，以及可选的 Planning V2 每日回顾、上下文、任务模式和原子批量修改能力。
1 核心4 Planning V2
get_statsbatch_patch_tasksget_day_reviewget_planning_contextget_task_patternsPlanning V2 工具是可选能力。只有 MCP 进程设置 PLANNING_V2_BACKEND_ENABLED=true，且连接的后端也启用相同能力时，这些工具才会出现。
使用最小 API scopes
API keys 可分别限制任务、分组、统计、设置和个人资料的读取或写入权限。为每个 AI 客户端创建独立 key，撤销某个连接时就不会影响其他集成。
tasks:readtasks:writegroups:readgroups:writestats:readsettings:readsettings:writeprofile:readprofile:write安全边界
把 key 留在客户端环境中
不要把 API key 粘贴到提示词、源码、截图或共享配置中。MCP 进程会从 WEEKLYPLANNER_API_KEY 读取它。
分离读写权限
摘要和回顾使用只读 key；只有客户端确实需要创建、移动、编辑或删除数据时，才添加写入 scopes。
把客户端审批视为另一层控制
server 会执行身份认证、scopes、参数校验和 rate limits。外部 MCP 调用是否弹出审批由 AI 客户端决定，因此启用写操作前应检查客户端的工具权限设置。
撤销不再使用的 keys
每个连接单独创建 key；设备、客户端或工作流停用后，从 Settings 撤销对应 key。
故障排查
MCP server 没有出现
确认客户端进程可以使用 Node.js 和 npx，校验 JSON 配置，并在保存后完整重启客户端。
调用返回 Unauthorized
在 Settings 中生成有效的 API key，去掉意外加入的引号或换行，并确认 WEEKLYPLANNER_API_URL 指向创建该 key 的同一个 WeeklyPlanner deployment。
调用被 Forbidden 拒绝
key 本身有效，但缺少所需 scope。只增加相关读取或写入 scope，或生成一把具备正确最小权限的新 key。
找不到计划分析工具
Planning V2 关闭时这是正常现象，核心工具仍可使用。只有连接的后端支持相应 endpoints 时才启用可选 flag。
请求触发 rate limit
等待当前 quota 窗口重置，或减少重复调用。避免用 retry loop 连续发送同一个计划请求。
继续查看相关页面
MCP 任务管理器常见问题
- 什么是 MCP 任务管理器？
- MCP 任务管理器通过 Model Context Protocol 向兼容的 AI 客户端提供结构化任务操作。AI 会调用职责明确的工具，而不是依赖粘贴的任务清单或直接访问数据库。
- MCP server 使用的是我真实的 WeeklyPlanner 任务吗？
- 是。它调用账号级集成所使用的同一套 scoped public API，因此修改会直接出现在计划工具中，而不是写入另一份副本。
- 必须付费才能试用吗？
- 不用。免费账号可以创建 API key，并使用套餐内包含的 API/MCP 请求额度；付费方案会提高可用额度。
- 所有 MCP 工具都会默认启用吗？
- 核心工具默认可用。Planning V2 会额外提供每日回顾、计划上下文、任务模式和异构任务批量修改工具。