Productivemcp

Productive.io MCP服务器

A. 模型上下文协议 （MCP）服务器，使Claude（和其他兼容MCP的AI客户端）可以完全访问您的 产品.io 账户

让克劳德通过自然对话创建任务、搜索项目、管理预算等。

特性

• 任务管理 -创建、搜索、更新和批量创建任务
• 任务列表管理 -完整CRUD：创建、重命名、存档、还原、删除、重新定位、移动、复制
• 项目发现 -列出和搜索项目、董事会和团队成员
• 预算管理 -列出、更新、审计、关闭预算；标记为已交付
• 收入分配 -创建、更新、扩展和报告收入分配
• 服务管理 -管理服务（预算项目）和服务类型
• 任务相关性 -创建阻塞、等待和相关依赖关系
• 页面和评论 -创建和管理文档页面和任务注释
• 附件 -上传并列出任务的文件附件
• 清单 -创建和管理任务中的待办事项
• 速率限制 -自动处理Production.io的API费率限制
• 灵活的输出 -Markdown和JSON响应格式

快速开始

先决条件

• Node.js 18+
• 具有API访问权限的Productive.io帐户

1.安装

npm install

2.添加您的凭据

cp .env.example .env

编辑 .env 并填写两个值：

• API代币 -来自Productive.io→ 设置→ 集成→ API → 生成令牌
• 组织ID -生产URL中的数字： https://app.productive.io/{ORG_ID}/...

3.运行自动设置

npm run setup

这将连接到您的生产帐户，发现您的自定义字段和工作流状态，并写入 productive.config.json 文件。不需要手动调用API或编辑源代码。

4.建造

npm run build

连接到克劳德桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "productive": {
      "command": "node",
      "args": ["/absolute/path/to/productive-mcp-server/dist/index.js"],
      "env": {
        "PRODUCTIVE_API_TOKEN": "your_api_token_here",
        "PRODUCTIVE_ORG_ID": "your_org_id_here"
      }
    }
  }
}

连接到克劳德代码

通过CLI（推荐）

全局添加服务器，使其在所有项目中都可用：

claude mcp add --scope user productive -t stdio \
  -e PRODUCTIVE_API_TOKEN=your_api_token_here \
  -e PRODUCTIVE_ORG_ID=your_org_id_here \
  -- node /absolute/path/to/productive-mcp-server/dist/index.js

通过配置文件

或者，添加到 .claude/settings.json 或 ~/.claude.json:

{
  "mcpServers": {
    "productive": {
      "command": "node",
      "args": ["/absolute/path/to/productive-mcp-server/dist/index.js"],
      "env": {
        "PRODUCTIVE_API_TOKEN": "your_api_token_here",
        "PRODUCTIVE_ORG_ID": "your_org_id_here"
      }
    }
  }
}

验证

重启Claude并问：“在Productive中列出我的项目”

自定义字段配置

Productive.io为任务类型、优先级和估计值使用自定义字段。这些字段ID对每个组织都是唯一的。

建议的方法是 npm run setup 自动发现一切。生成的 productive.config.json 文件在运行时加载-安装后不需要编辑或重建源代码。

如果自动检测找不到您的字段（它们的名称可能不同），您可以编辑 productive.config.json 手动。安装脚本将列出帐户中所有可用的自定义字段，以帮助您识别正确的字段。

服务器无需自定义字段配置即可工作，您将无法通过Claude设置任务类型、优先级或工作流状态。

可用工具

任务管理

项目与组织

任务列表

预算

收入分配

服务

依赖项

页面、评论和附件

发展

npm run dev      # Watch mode with auto-reload
npm run build    # Compile TypeScript
npm start        # Run compiled server
npm run clean    # Remove build artifacts

许可证

麻省理工学院