使用说明
@aid-app/mcp
官方AiDD MCP Web连接器 -可从Claude网络、移动和桌面访问ADHD优化的生产力平台。
🌐 通用访问
克劳德工作的地方都有:
- ✅ Claude.ai (桌面浏览器)
- ✅ 克劳德移动应用 (iOS/安卓)
- ✅ 克劳德桌面版 (所有平台)
- ✅ ChatGPT应用程序 (具有丰富的UI小部件)
只需通过URL连接,无需本地安装。
特性
📝 票据管理
- 列出、阅读、创建, 更新,以及 删除 AiDD帐户中的笔记
- 全文搜索和分页
- 分类(工作/个人)和标签
- 批量删除支持
✅ 行动项目(AI驱动)
- AI提取:使用Google Gemini从笔记或文本中提取动作项
- 列表、阅读、, 更新,以及 删除 具有优先级/截止日期的行动项目
- 每个提取项目的置信度评分
- 批量删除支持
🎯 ADHD优化任务
- AI任务分解:将操作项转换为可管理的子任务
- 自动时间估算
- 能量水平要求
- 依赖追踪
- 任务类型分类
- AI优先级:智能任务评分
- 紧迫性×重要性×能量×ADHD兼容性
- 时间优化
- 个性化推荐
- 完整CRUD:创建、阅读、, 更新,以及 删除 任务
- 批量删除支持
🚀 异步AI处理
- 默认情况下,人工智能操作在后台运行,以获得更好的用户体验
- 大型数据集没有超时问题
- 新:
check_ai_jobs实时监控作业进度的工具 - 检查结果
list_tasks或list_action_items - 可选的
waitForCompletion小批量参数
⚡ 自动AI评分(v4.3.22中的新功能)
对于 付费用户(专业版/高级版),任务转换后自动触发AI评分:
- 主控程序:转换后始终自动评分
- 网络/iOS:转换超过1个动作项时自动评分
这意味着你的任务会立即被优先处理,而不需要单独的评分步骤!
🖼️ ChatGPT UI小部件(v4.4.0中的新功能)
用于ChatGPT应用程序集成的丰富交互式小部件:
| 小部件 | 描述 |
|---|---|
| 任务仪表板 | 使用AI分数进行视觉任务优先级排序 |
| 行动项目 | AI提取了具有置信度得分的项目 |
| 能量选择器 | 按能量水平选择任务 |
| 快速捕获 | 快速任务创建表单 |
| 依赖图 | 可视化任务依赖关系 |
| 聚焦模式 | 番茄钟式计时器 |
| AI评分 | 分数分布和见解 |
小部件作为MCP资源使用 text/html+skybridge 用于原生ChatGPT集成的MIME类型。
🔐 认证
- 基于浏览器的OAuth(谷歌、微软、苹果)
- 电子邮件/密码登录
- 自动令牌刷新
- 安全的云存储
📱 集成
- 工作表
- 微软要做
- Trello、Todoist、Notion
- TickTick,Evernote
快速开始
生产URL: https://mcp.aidd.app/mcp
- 打开 claude.ai → 设置
- 导航到“连接器”或“MCP”
- 点击“添加连接器”
- 输入URL:
https://mcp.aidd.app/mcp - 保存
就是这样!现在使用它:
You: connect
Claude: [opens browser for authentication]
You: list my tasks
Claude: [shows your AiDD tasks]
You: score my tasks and tell me what to work on next
Claude: [AI analyzes and prioritizes your tasks]
📚 实际使用示例
示例1:利用能量水平进行晨间任务规划
场景:你想根据你目前的能量水平来计划你的工作日。
You: "I just woke up and have high energy. What should I work on this morning?"
Claude: [Uses score_tasks with timeOfDay="morning", considerCurrentEnergy=true]
Response:
🎯 Tasks Scored & Prioritized
Top Priority Tasks (Next 2 Hours):
1. Complete quarterly performance reviews (Score: 95/100)
• Urgency: 9/10
• Importance: 9/10
• Energy Match: High ✓
📝 Best tackled now while your focus is sharp
2. Draft project proposal for Q2 (Score: 89/100)
• Urgency: 7/10
• Importance: 9/10
• Time: 45 min
📝 Complex task - ideal for morning energy
🌅 Morning Schedule (High Energy):
• Complete quarterly performance reviews
• Draft project proposal for Q2
• Review architecture decisions
示例2:行动项目会议记录
场景:你刚刚完成了一个团队会议,有原始笔记要处理。
You: "I just finished a team meeting. Here are my notes:
- John will send the budget report by Friday
- Need to schedule client demo for next week
- Sarah mentioned the API is having issues, investigate
- Book conference room for quarterly planning
- Follow up with marketing on campaign results"
Claude: [Uses extract_action_items with source="text"]
Response:
🔍 Action Items Extracted
Summary:
• Source: provided text
• Extraction mode: adhd-optimized
• Action items found: 5
Extracted Action Items:
1. Follow up on budget report from John
• Priority: high
• Category: work
• Confidence: 92%
• Due: Friday
2. Schedule client demo
• Priority: high
• Category: work
• Confidence: 95%
• Due: Next week
3. Investigate API issues
• Priority: high
• Category: work
• Confidence: 88%
• Tags: technical, bug
4. Book conference room for quarterly planning
• Priority: medium
• Category: work
• Confidence: 90%
5. Follow up with marketing on campaign results
• Priority: medium
• Category: work
• Confidence: 87%
Action items have been saved to your AiDD account.
示例3:将动作项转换为对ADHD友好的任务
场景:你有行动项目,但需要将其分解为可管理的步骤。
You: "Convert my action items to tasks with ADHD-optimized breakdown"
Claude: [Uses convert_to_tasks with breakdownMode="adhd-optimized"]
Response:
🚀 AI Conversion Started
Converting 5 action items to ADHD-optimized tasks in the background.
What's happening:
• AI is breaking down action items into manageable tasks
• Tasks are being optimized for ADHD-friendly execution
• Each action item may generate multiple subtasks
✨ Auto AI Scoring: Enabled (PRO subscription detected)
• Your tasks will be automatically prioritized after conversion
Check your results:
⏱️ Check back in 2-3 minutes - use the `list_tasks` tool to see your converted tasks.
💡 Or use `check_ai_jobs` to monitor progress in real-time.
示例4:监控AI作业进度
场景:您启动了一个大型转换,并希望检查进度。
You: "Check the status of my AI jobs"
Claude: [Uses check_ai_jobs]
Response:
📊 AI Jobs (2 active)
⏳ **🔄 Task Conversion**
• ID: `job_abc123`
• Status: processing (75%)
✅ **🎯 Task Scoring**
• ID: `job_def456`
• Status: completed
💡 Tip: Use `check_ai_jobs` with a specific `jobId` to get detailed status.
示例5:更新和删除项目
场景:您需要修改或清理任务列表。
You: "Mark task abc123 as completed and delete the old action items I'm done with"
Claude: [Uses update_task to mark complete, then delete_action_items]
Response:
✅ Task Updated
Updated task: Complete quarterly report
• ID: abc123
• Status: ✅ Completed
• Updated: 12/02/2025, 5:30 PM
🗑️ Action Items Deleted
Successfully deleted 3 action items.
🔗 Also deleted 5 derived tasks.
示例6:每周回顾和计划
场景:周末回顾,查看成绩并提前计划。
You: "Help me do a weekly review. Show me what I accomplished and what's pending for next week."
Claude: [Uses list_tasks, list_action_items, then score_tasks]
Response:
📊 Weekly Review
✅ Completed This Week:
• 12 tasks completed
• 8 action items resolved
• Highlights:
- Finished quarterly report (Score: 95)
- Deployed API fix (Score: 88)
- Client presentation delivered (Score: 92)
📋 Pending Action Items (7):
• High Priority: 2
• Medium Priority: 4
• Low Priority: 1
🎯 Next Week's Top Priorities:
1. Prepare board presentation (Score: 94/100)
• Due: Tuesday
• Energy: High required
• Time: 2 hours
2. Complete performance reviews (Score: 91/100)
• Due: Friday
• Energy: Medium
• Time: 45 min each
3. Follow up on vendor contracts (Score: 85/100)
• Due: Wednesday
• Energy: Low
• Time: 30 min
💡 Recommendation: Block Tuesday morning for the board
presentation while your energy is highest.
可用工具
注释(5个工具)
| 工具 | 描述 | 类型 |
|---|---|---|
list_notes |
浏览笔记(排序方式:createdAt/updatedAt/title) | 阅读 |
read_note |
按ID读取特定注释 | 读取 |
create_note |
创建带有标题、内容、标签、类别的新笔记 | 编写 |
update_note |
更新现有注释(标题、内容、标签、类别) | 编写 |
delete_notes |
按ID删除一个或多个笔记 | 破坏性 |
行动项目(5个工具)
| 工具 | 描述 | 类型 |
|---|---|---|
list_action_items |
使用排序浏览操作项 | 阅读 |
read_action_item |
按ID读取特定操作项 | 读取 |
extract_action_items |
人工智能从笔记或文本中提取 | 写作 |
update_action_item |
更新现有行动项(标题、优先级、截止日期等) | 编写 |
delete_action_items |
删除操作项及其派生任务 | 破坏性 |
任务(7个工具)
| 工具 | 描述 | 类型 |
|---|---|---|
list_tasks |
浏览具有AI分数的任务 | 阅读 |
read_task |
按ID读取特定任务 | 读取 |
create_task |
手动创建新任务 | 写入 |
convert_to_tasks |
将动作项转换为ADHD优化任务(异步) | 写入 |
score_tasks |
AI驱动的任务优先级排序(异步) | 写入 |
update_task |
更新现有任务(标题、精力、时间、完成情况等) | 写 |
delete_tasks |
按ID删除一个或多个任务 | 破坏性 |
人工智能工作(1个工具)
| 工具 | 描述 | 类型 |
|---|---|---|
check_ai_jobs |
监控AI作业进度(提取、转换、评分) | 阅读 |
身份验证(1个工具)
| 工具 | 描述 | 类型 |
|---|---|---|
status |
检查身份验证状态和帐户信息 | 读取 |
总计:18个工具(9个只读,6个写入,3个破坏性)
建筑
┌─────────────────┐
│ Claude │ (web/mobile/desktop)
│ User │
└────────┬────────┘
│ HTTPS/SSE
↓
┌─────────────────┐
│ AiDD MCP │ Cloud Run (auto-scale 1-10)
│ Web Connector │ Node.js 20, Express, CORS
└────────┬────────┘
│ REST API
↓
┌─────────────────┐
│ AiDD Backend │ Cloud Run (production HA)
│ - Firestore │ - Notes, Tasks, Action Items
│ - Redis │ - Sessions, Cache
│ - Gemini AI │ - Extraction, Conversion, Scoring
└─────────────────┘
ChatGPT应用程序集成
ChatGPT App
└── Connects to MCP Server: https://mcp.aidd.app
├── Discovers tools (list_tasks, score_tasks, etc.)
│ └── Each tool has _meta.ui_template linking to widget
└── Discovers resources
├── aidd://notes (JSON data)
├── aidd://tasks (JSON data)
└── aidd://widgets/* (text/html+skybridge)
└── ChatGPT loads in iframe + injects window.openai
| 小部件资源 | 工具映射 |
|---|---|
aidd://widgets/task-dashboard |
list_tasks |
aidd://widgets/action-items |
extract_action_items, convert_to_tasks |
aidd://widgets/ai-scoring |
score_tasks, check_ai_jobs |
aidd://widgets/quick-capture |
create_task |
技术栈
- 运行时:Node.js 20
- 框架:Express.js
- 协议:基于HTTP/SSE的MCP(流式HTTP传输)
- 运输:服务器发送的事件
- 认证:使用PKCE的OAuth 2.0(S256)
- 人工智能:谷歌双子座2.5 Pro和2.5 Flash
测试连接器
您可以验证连接器是否正在运行:
# Health check
curl https://mcp.aidd.app/health
# MCP endpoint info
curl https://mcp.aidd.app/mcp
# OAuth discovery
curl https://mcp.aidd.app/.well-known/oauth-authorization-server
订阅级别
| 层级 | 人工智能评分 | 人工智能提取 | 任务转换 | 自动评分 | 冷却 |
|---|---|---|---|---|---|
| 自由 | 每月1次 | 每周3次 | 每周1次 | ❌ | 5分钟 |
| 专业版 | 10天 | 200周 | 200周 | ✅ | 没有 |
PRO计划:4.99美元/月或49.99美元/年(节省10美元)
升级地点: https://aidd.app/upgrade
安全与隐私
身份验证和数据保护
| 功能 | 实现 |
|---|---|
| OAuth 2.0 | 使用PKCE的授权代码流(S256) |
| 令牌安全 | JWT,30天到期,自动刷新 |
| 传输 | HTTPS/TLS 1.3适用于所有通信 |
| CORS | 仅限于 claude.ai, *.claude.ai, *.anthropic.com |
| 静态数据 | AES-256加密(谷歌云) |
| 速率限制 | 每个订阅层的令牌桶算法 |
| 请求签名 | API调用的HMAC验证 |
合规
| 标准 | 状态 |
|---|---|
| GDPR 数据保护 | ✅ 完全合规(欧盟数据保护) |
| 云室照相分析 | ✅ 完全合规(加利福尼亚州隐私) |
| SOC 2 II型 | ✅ 经过认证的基础设施(谷歌云) |
隐私政策
AiDD处理您的笔记、任务和行动项,以提供人工智能驱动的生产力功能。我们认真对待您的隐私:
我们收集什么
- 账户信息:电子邮件地址、身份验证令牌
- 内容数据:注释、操作项、创建或导入的任务
- 使用数据:改进服务的功能使用(匿名)
我们如何使用您的数据
- 人工智能处理:备注→ 行动项→ 任务(仅按需)
- 存储:加密在您的个人帐户中
- 分析:匿名使用模式(可选择退出)
我们不做什么
- ❌ 无人工智能培训您的数据从未被用于训练AI模型(包括Google Gemini)
- ❌ 禁止出售:您的数据永远不会出售给第三方
- ❌ 没有广告:没有基于您的内容的定向广告
- ❌ 无保留:人工智能处理是短暂的,不会存储在人工智能系统中
您的权利
- 访问:随时导出所有数据
- 删除:请求完全删除数据(GDPR第17条)
- 可移植性:以标准格式下载数据
- 修正:更新或更正您的信息
- 异议:选择退出非必要处理
数据处理详细信息
| 数据类型 | 处理 | 保留 | 人工智能参与 |
|---|---|---|---|
| 备注 | 加密存储 | 直到删除 | 仅提取(不存储在AI中) |
| 动作项 | 由AI生成 | 直到删除 | 由Gemini创建,存储在您的帐户中 |
| 任务 | 人工智能评分 | 直到删除 | 按需计算评分 |
| 身份验证令牌 | OAuth 2.0 | 30天 | 无 |
| 密码 | 未存储 | 不适用 | 无(仅限OAuth) |
安全措施
- 🔐 敏感数据的端到端加密
- 🔒 通过谷歌秘密管理器进行秘密管理
- 🛡️ 通过Cloud Armor提供DDoS保护
- 📝 审计日志记录,保留30天
- 🔍 定期安全审计和渗透测试
📋 完整隐私政策: https://aidd.app/privacy 📜 服务条款: https://aidd.app/terms
面向人类学评论家
测试帐户
Anthropic MCP有一个专门的测试帐户可供审查:
| 字段 | 值 |
|---|---|
| 电子邮件 | [TEST_EMAIL_REDACTED] |
| 密码 | [REDACTED] |
| 订阅 | 高级(无限制) |
| 状态 | ✅ 活动 |
完整的测试说明: 测试_默认.md
预加载测试数据
- 16注释 -各种类别和标签
- 13个行动项目 -优先级与置信度得分混合
- 13任务 -所有这些都有人工智能评分(相关性、影响、紧迫性)
审核期间的支持
- 电子邮件:marc@aidd.app
- 主题:“人类MCP审查-[问题]”
- 响应时间:<2小时(太平洋标准时间上午9点至下午6点)
故障排除
“连接失败”
- 检查健康状况:
curl https://mcp.aidd.app/health - 验证URL:
https://mcp.aidd.app/mcp - 尝试删除并重新添加连接器
“身份验证错误”
- 浏览器弹出窗口被阻止了吗?允许claude.ai弹出窗口
- 尝试隐身模式(清除Cookie)
- 检查测试帐户凭据是否正确
“超出费率限制”
- 检查配额
status工具 - 升级至 https://aidd.app/upgrade
为什么选择Web连接器?
vs桌面扩展:
| 功能 | 桌面 | Web连接器 |
|---|---|---|
| 平台 | 仅限macOS/Windows/Linux | 所有平台 |
| 安装 | 需要本地安装 | 只需添加URL |
| 更新 | 手动 | 自动 |
| 手机 | ❌ | ✅ |
与单独的MCP相比:
- 将AiDD与其他MCP连接器结合使用
- 示例:与一起使用 苹果笔记MCP 适用于macOS
- Claude在多个MCP之间自动协调
支持
- 🌐 网站: 帮助.app
- 📧 电子邮件:support@aidd.app
- 🐛 问题: GitHub
- 📚 文件: docs.aidd.app文件
贡献
欢迎投稿!看 贡献.md
许可证
麻省理工学院©AiDD团队
更新日志
v4.4.0(2025-12-19)
- 🖼️ 新:ChatGPT UI小部件-ChatGPT应用程序的丰富交互式组件
- 带有AI分数的任务优先级仪表板
- 充满信心的动作项提取预览
- 基于能量的任务选择器
- 快速捕获表单
- 依赖关系图可视化
- 聚焦模式定时器
- AI评分结果卡
- 📦 新:用于UI小部件的MCP资源(
aidd://widgets/*)- 内嵌CSS/JS的自包含HTML
text/html+skybridge用于ChatGPT集成的MIME类型- 工具到小部件链接通过
_meta.ui_template
- 🔧 建筑:UI直接捆绑到MCP服务器中
- 无需单独托管
- ChatGPT应用程序自动发现
- 📊 工具总数:18(不变)+8个小部件资源
v4.3.22(2025年12月2日)
- 🔍 新刀具:
check_ai_jobs-实时监控AI作业进度- 按ID检查特定作业或列出所有活动作业
- 显示作业类型、状态、进度百分比和时间戳
- 根据作业状态提供有用的后续步骤
- ⚡ 自动AI评分:付费用户(PRO/PREMIUM)现在转换后可以自动获得任务评分
- MCP:任务转换后始终自动评分
- Web/iOS:转换超过1个动作项时自动评分
- 不需要单独的评分步骤-任务会自动优先排序
- 📊 工具总数: 17 → 18
v4.3.18(2025-11-30)
- 🔗 级联删除:
delete_action_items现在自动删除从这些操作项派生的所有任务- 在清理动作项时防止孤立任务
- 响应显示已删除操作项和派生任务的计数
v4.3.7(2025-11-28)
- 🔒 安全:为所有20个工具添加了MCP安全注释
readOnlyHint: true用于只读操作(列表_,阅读_,状态)destructiveHint: true用于删除操作(delete_notes、delete_action_items、delete_tasks)readOnlyHint: false, destructiveHint: false用于写入操作
- 🔐 OAuth:向allowlist添加了Claude回调URL(本地主机:6274,Claude.ai,Claude.com)
- 🌐 头:为OAuth端点添加了HEAD请求处理程序
v4.1.1(2025-11-25)
- ✏️ 新:
update_note-更新现有笔记(标题、内容、标签、类别) - 🗑️ 新:
delete_notes-删除一个或多个注释(批量支持) - ✏️ 新:
update_action_item-更新行动项(标题、优先级、截止日期、完成状态) - 🗑️ 新:
delete_action_items-删除一个或多个操作项(批量支持) - ✏️ 新:
update_task-更新任务(标题、精力、时间、类型、完成状态) - 🗑️ 新:
delete_tasks-删除一个或多个任务(批处理支持) - 📊 工具总数: 11 → 17
v4.1.0(2025-11-24)
- 🚀 新:AI操作的异步模式(默认)
- ⚡ 改进的:
convert_to_tasks在后台运行,没有超时问题 - ⚡ 改进的:
score_tasks在后台运行,处理大型任务列表 - 🔧 新:
waitForCompletion同步模式参数 - 📝 改进的:更好的响应信息,并提供“2-3分钟后检查”指导
v4.0.2(2025-11-24)
- 📚 文档:为Anthropic审查添加了5个现实的使用示例
- 🔒 隐私:增强的隐私政策部分,其中包含完整的详细信息
- 🐛 修复:AI分数显示(相关性、影响、紧迫性)
- 🐛 修复:任务评分设备ID要求
v4.0.0(2025-01-22)-网络连接器版
- 🌐 霹雳舞:从stdio转换到HTTP/SSE传输
- 📱 新:通用访问(网络、移动、桌面)
- ☁️ 新:具有自动扩展功能的托管服务
- 🔒 增强:克劳德域名的CORS
- ❌ 移除:Apple Notes集成(使用单独的MCP)
- ⚡ 改进的:云原生可观察性
v3.0.0(2025-01-15)
- 基于CRUD的体系结构
- 11个综合工具
- 直接后端集成
- 增强的AI功能
v2.0.0(2025-01-10)
- 基于浏览器的OAuth
- 多提供商登录
v1.0.0(2025-01-05)
- 初始版本
由...制作❤️ 由ADHD社区的AiDD团队提供
随时随地,在任何设备上将笔记转换为可操作的任务。
