滴答清单MCP安装记录

安装日期：2026年2月28日

概述

本文档记录在Windows环境下安装滴答清单(Dida365/TickTick) MCP服务器的完整过程，包括遇到的问题和解决方案。

环境

• 操作系统：Windows
• MCP工具：mcporter
• 代码位置：E:\Gitee\Dida-MCP-main\Dida-MCP-main

安装步骤

1. 准备工作

从Gitee克隆或下载滴答清单MCP代码：

E:\Gitee\Dida-MCP-main\Dida-MCP-main

安装Python依赖：

pip install -r requirements.txt

2. 获取API凭据

1. 访问 https://developer.dida365.com/
2. 创建OAuth应用，获取：
   • Client ID
   • Client Secret
3. 添加重定向URI：http://127.0.0.1:8080/callback

3. 配置认证

创建 .env 文件：

DIDA365_CLIENT_ID=你的Client_ID
DIDA365_CLIENT_SECRET=你的Client_Secret
DIDA365_REDIRECT_URI=http://127.0.0.1:8080/callback
DIDA365_BASE_URL=https://api.dida365.com/open/v1
DIDA365_OAUTH_AUTHORIZE_URL=https://dida365.com/oauth/authorize
DIDA365_OAUTH_TOKEN_URL=https://dida365.com/oauth/token
TOKEN_FILE=.token-oauth

4. 获取授权码

1. 运行认证脚本或手动获取授权URL
2. 浏览器打开授权页面
3. 登录滴答账号并授权
4. 获取授权码（code参数）

# 获取授权URL
python -c "
import os
os.environ['DIDA365_CLIENT_ID'] = '你的Client_ID'
os.environ['DIDA365_CLIENT_SECRET'] = '你的Client_Secret'
os.chdir(r'E:\Gitee\Dida-MCP-main\Dida-MCP-main')
from src.auth import OAuth2Client
auth = OAuth2Client()
print(auth.get_authorization_url())
"

5. 用授权码换取Token：

import asyncio
from src.auth import OAuth2Client

async def get_token():
    auth = OAuth2Client()
    token_data = await auth.get_access_token('你的授权码')
    print('Token saved!')

asyncio.run(get_token())

5. 配置mcporter

在 config/mcporter.json 中添加：

{
  "mcpServers": {
    "dida": {
      "command": "cmd",
      "args": [
        "/c",
        "cd /d E:\\Gitee\\Dida-MCP-main\\Dida-MCP-main && python -m src.server"
      ]
    }
  }
}

6. 验证

mcporter list

应显示 dida (11 tools, 1.xs) ✅

---

遇到的问题及解决方案

问题1：Chocolatey安装Everything失败

错误：无法获取锁文件访问权限

解决：手动下载Everything portable版本：

Invoke-WebRequest -Uri 'https://www.voidtools.com/Everything-1.4.1.1032.x64.zip' -OutFile 'C:\Temp\Everything.zip'
Expand-Archive -Path 'C:\Temp\Everything.zip' -DestinationPath 'C:\Tools\Everything'

问题2：滴答清单OAuth invalid_client

错误：error="invalid_client", error_description="Bad client credentials"

原因：初始提供的凭据不正确

解决：使用正确的Client ID和Secret（在developer.dida365.com获取）

问题3：重定向URI未注册

错误：error="invalid_request", error_description="At least one redirect_uri must be registered with the client."

解决：在滴答开放平台应用设置中添加重定向URI：

http://127.0.0.1:8080/callback

问题4：MCP服务器启动失败

错误：未找到有效的认证 token

原因：工作目录和Token文件路径问题

解决：使用cmd包装启动，确保工作目录正确：

"command": "cmd",
"args": ["/c", "cd /d E:\\Gitee\\Dida-MCP-main\\Dida-MCP-main && python -m src.server"]

---

最终配置

mcporter.json

{
  "mcpServers": {
    "synthpilot": {
      "command": "C:/Users/liuni/.local/bin/synthpilot.exe"
    },
    "outlook": {
      "command": "npx",
      "args": ["@littlebearapps/outlook-mcp"]
    },
    "minimax": {
      "command": "python -m minimax_mcp.server",
      "env": {
        "MINIMAX_API_KEY": "your_api_key",
        "MINIMAX_API_HOST": "https://api.minimaxi.com"
      }
    },
    "everything-search": {
      "command": "npx",
      "args": ["everything-search-mcp"]
    },
    "dida": {
      "command": "cmd",
      "args": [
        "/c",
        "cd /d E:\\Gitee\\Dida-MCP-main\\Dida-MCP-main && python -m src.server"
      ]
    }
  }
}

---

可用工具

滴答清单MCP提供11个工具：

工具	功能
get_projects	获取所有项目
get_project	获取单个项目详情
create_project	创建项目
get_tasks	获取任务列表
get_task	获取任务详情
create_task	创建任务
update_task	更新任务
complete_task	完成任务
delete_task	删除任务
get_task_comments	获取任务评论
add_task_comment	添加评论

---

参考链接

• 滴答开放平台：https://developer.dida365.com/
• MCP代码：https://gitee.com/Dida-MCP/
• Everything下载：https://www.voidtools.com/downloads/

---

文档生成时间：2026年2月28日