Productive MCP Server

Productive.io MCP服务器

MCP（模型上下文协议）服务器 产品.io 它使像Claude这样的人工智能助手能够与您的Productive.io工作区进行交互，管理项目、任务、时间条目、预算等。

支持两种运输方式：

• 标准 （默认）--Claude将其作为本地子进程启动
• 超文本传输协议 （与 --http flag）--作为Express web服务器运行，供远程/团队使用

先决条件

• Node.js 18+
• A. 产品.io 具有API访问权限的帐户
• API代币 --在Productive.io的“设置”下生成一个→ API集成
• 组织ID --在您的Productive.io帐户设置中找到

安装

git clone  productive-mcp-server
cd productive-mcp-server
npm install
cp .env.example .env
# Edit .env with your credentials
npm run build

配置

跑步

stdio模式（默认-本地使用）

# Development
npm run dev

# Production (after build)
npm start

HTTP模式（用于远程/团队使用）

# Development
npm run dev:http

# Production (after build)
npm run start:http

HTTP服务器公开：

• POST /mcp --MCP协议端点
• GET /health --健康检查

连接到克劳德桌面

将此添加到您的Claude Desktop配置中(~/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"
      }
    }
  }
}

连接到克劳德代码

stdio模式

claude mcp add productive -- node /absolute/path/to/productive-mcp-server/dist/index.js

在运行Claude Code之前设置环境变量，或将其添加到shell配置文件中：

export PRODUCTIVE_API_TOKEN=your_api_token_here
export PRODUCTIVE_ORG_ID=your_org_id_here

HTTP模式

先启动服务器：

cd /path/to/productive-mcp-server
PRODUCTIVE_API_TOKEN=your_token PRODUCTIVE_ORG_ID=your_org npm run start:http

然后连接克劳德代码：

claude mcp add productive --transport http http://localhost:3000/mcp

连接到VS代码

添加到您的VS Code用户设置JSON(.vscode/settings.json 或用户设置）：

stdio模式

{
  "mcp": {
    "servers": {
      "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"
        }
      }
    }
  }
}

HTTP模式

{
  "mcp": {
    "servers": {
      "productive": {
        "type": "http",
        "url": "http://localhost:3000/mcp"
      }
    }
  }
}

可用工具

发票工具（仅草稿）

所有发票工具创建和管理 仅发票草稿。最终确定（分配发票编号）必须始终在Productive.io UI中手动完成。

所有列表工具支持 page, page_size，以及 sort 参数。

MCP检验员测试

npx @modelcontextprotocol/inspector node dist/index.js

这将打开一个交互式UI来测试每个工具。

速率限制

Productive.io强制执行：

• 每10秒100个请求
• 每30分钟4000个请求

服务器实现了429个响应的指数回退自动重试（最多3次重试）。

许可证