生产力。io远程MCP服务器

一、 远程MCP服务器 用于 Productive.io 上运行的 Cloudflare工人． 连接克劳德桌面，克劳德代码和其他mcp兼容的客户端到您的生产力。io工作空间-没有本地安装，客户端机器上没有API密钥。

突出了

• Remote-first -运行在Cloudflare Workers上，客户端通过URL连接
• 微软Entra ID - OAuth 2.1与您组织的身份提供者（SSO + MFA）
• 每用户授权（BYOT） -每个呼叫使用用户自己的生产性令牌，在休息时加密；没有共享管理令牌(细节）
• 自动用户分辨率 -将Entra电子邮件自动映射到生产性用户ID
• 名称解析 -人员、公司、项目、任务和交易按名称显示，而不是原始ID
• 70 +工具 -项目，任务，时间跟踪，发票，评论，页面等
• 零客户端设置 -只需添加一个URL到克劳德桌面或克劳德代码

快速入门

如果您的组织中有人已经部署了此服务器，您只需要配置您的MCP客户端：

克劳德桌面

将......添加到...... ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "productive": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://<your-worker>.<your-subdomain>.workers.dev/mcp"]
    }
  }
}

重新启动Claude Desktop。浏览器窗口打开Entra ID登录在第一次连接。会话持续-您只登录一次。

克劳德代码

claude mcp add productive -- npx -y mcp-remote https://<your-worker>.<your-subdomain>.workers.dev/mcp

部署你自己的

先决条件

• Cloudflare帐户 有工人（免费层作品）
• 微软Entra ID 具有App注册权限的租户
• Node.js 18+和npm

1. 克隆并安装

git clone https://github.com/MonadsAG/monads-mcp-productive.git
cd monads-mcp-productive
npm install

2. 创建Cloudflare KV命名空间

npx wrangler login
npx wrangler kv namespace create "OAUTH_KV"
npx wrangler kv namespace create "USER_MAPPING_KV"
npx wrangler kv namespace create "USER_PAT_KV"

将命名空间id复制到 wrangler.jsonc． （USER_PAT_KV 存储每个用户的 加密的生产性令牌-参见 用户令牌.）

3. 注册Entra ID应用程序

# Login to your Entra tenant
az login --tenant <your-tenant-id> --allow-no-subscriptions

# Create the app registration (single tenant).
# Register BOTH redirect URIs: /callback (MCP login) and /settings/callback (token settings page).
az ad app create \
  --display-name "Productive MCP" \
  --sign-in-audience "AzureADMyOrg" \
  --web-redirect-uris \
    "https://<your-worker>.<your-subdomain>.workers.dev/callback" \
    "https://<your-worker>.<your-subdomain>.workers.dev/settings/callback"

# Note the appId from the output, then add API permissions
az ad app permission add \
  --id <app-id> \
  --api 00000003-0000-0000-c000-000000000000 \
  --api-permissions \
    37f7f235-527c-4136-accd-4a02d197296e=Scope \
    14dad69e-099b-42c9-810b-d002981feec1=Scope \
    64a6cdd6-aab1-4aaf-94b8-3cc8405e90d0=Scope \
    e1fe6dd8-ba31-4d61-89e7-88639da4683d=Scope

# Grant admin consent
az ad app permission admin-consent --id <app-id>

# Generate a client secret (2-year expiry)
az ad app credential reset \
  --id <app-id> \
  --append \
  --display-name "Cloudflare Worker" \
  --years 2

权限id对应： openid， profile， email， User.Read (委托)。

4. 设置Cloudflare机密

npx wrangler secret put PRODUCTIVE_ORG_ID         # your org ID with slug (e.g. 12345-company-name)
npx wrangler secret put PRODUCTIVE_API_BASE_URL   # https://api.productive.io/api/v2/ (or sandbox URL)
npx wrangler secret put PRODUCTIVE_TOOLSETS       # optional, comma-separated toolset names (default: all tools)
npx wrangler secret put ENTRA_CLIENT_ID           # app (client) ID from step 3
npx wrangler secret put ENTRA_CLIENT_SECRET       # client secret from step 3
npx wrangler secret put ENTRA_TENANT_ID           # your Entra directory (tenant) ID
openssl rand -hex 32 | npx wrangler secret put COOKIE_ENCRYPTION_KEY   # signs session/CSRF cookies
openssl rand -hex 32 | npx wrangler secret put PAT_ENC_KEY             # encrypts per-user PATs at rest (AES-256-GCM)

没有共享的生产性令牌。 每个用户通过提供自己的生产性PAT /settings 页面(参见 用户令牌),所以 PRODUCTIVE_API_TOKEN 是 不 工人所需要的。它只适用于传统的本地工作室入口点 （放进去） .env（而不是作为Worker的秘密）。在那里, PRODUCTIVE_API_TOKEN 和 PRODUCTIVE_ORG_ID 就足够了：“我”后面的人ID从令牌处解析为 创业公司,所以 PRODUCTIVE_USER_ID 只需要重写它。

5. 部署

npm run worker:deploy

6. 连接

配置Claude Desktop或Claude Code，如 快速入门，将占位符URL替换为您的Worker URL。

每用户令牌（BYOT）

每个生产性API调用都使用 请求用户自己的个人访问令牌 （Bring Your Own Token），所以Productive强制每个用户的真实权限——没有 共享管理令牌。身份仍然来自微软的Entra ID；只有上游 凭证现在是针对每个用户的。

连接MCP后，每个用户打开一次设置页面来存储他们的令牌：

https://<your-worker>.<your-subdomain>.workers.dev/settings

该页面使用Entra ID登录用户，然后允许他们登录 设置、旋转或删除 他们的 生产PAT -不需要MCP重新连接。令牌是针对生产性进行验证的， 用AES-256-GCM加密(PAT_ENC_KEY)，然后再写信给他 USER_PAT_KV (键控 用户的稳定Entra对象ID)，并且从未显示、记录或通过模型发送。

在用户存储令牌之前，他们的工具调用返回一个链接到的友好消息 /settings 而不是任何数据。

显示设置页面和登录对话框 自动德语或英语，基于… 浏览器的 Accept-Language (默认英文);附加 ?lang=de / ?lang=en 强迫一个。

体系结构

┌─────────────────┐    Streamable HTTP    ┌──────────────────────────────┐
│  Claude Desktop  │ ◄──────────────────► │  Cloudflare Worker           │
│  / Claude Code   │                      │                              │
│  (via mcp-remote)│                      │  OAuthProvider (OAuth 2.1)   │
└─────────────────┘                       │       ↓                      │
                                          │  Entra ID (OIDC login)       │
       Browser ←── login redirect ───────→│       ↓                      │
                                          │  McpAgent (Durable Object)   │
                                          │       ↓                      │
                                          │  ProductiveAPIClient         │
                                          └──────────────┬───────────────┘
                                                         ↓
                                                  Productive.io API

可用的工具

公司及项目

文件夹（板）和任务列表

Productive的UI将此资源称为“文件夹”；API将其建模为一个“板”（任务和任务列表通过a引用它们的父节点） board/board_id 关系)。一个工具集涵盖了它——没有单独的“板”工具。

任务

评论和待办事项

页面和文档

时间跟踪

发票

活动&工作流程

常见的工作流

时间输入

按照顺序：项目→交易/预算→服务→时间入账。

list_projects → list_project_deals → list_deal_services → create_time_entry

任务状态更新

按名称更新-不需要查找ID：

{ "task_id": "123", "status_name": "In Progress" }

发票

list_companies → list_company_budgets → create_invoice → generate_line_items → finalize_invoice → mark_invoice_paid

预算

直接创建:

list_companies → create_budget → update_budget (optional)

派生自现有的交易/合同（交易必须处于“赢”状态）：

list_project_deals → create_budget_from_deal

预算服务

将服务（行项目）附加到预算中：

create_budget → create_budget_service → update_budget_service (optional)

{ "budget_id": "123", "name": "Consulting Hours", "price": 150, "quantity": 20 }

unit_id （1=小时，2=片，3=天）默认为 1； billing_type_id （1=固定，2=实际，3=无，4=百分比）默认为 2.

要对预算的服务进行分组，例如按项目阶段对其进行分组，请使用 create_budget_section 并通过 section_id 来 create_budget_service 或者 update_budget_service. list_budget_sections 显示每个部分及其服务； delete_budget_section 只删除 空的部分。

npm package / MCP hub

工作室入口点也被发布到npm @monadsag/productive-mcp，为主机 将MCP服务器作为本地进程启动（例如Monads MCP hub）。每一次推到 main 从CI发布一个新版本，其来源为npm：主要和次要来自 package.json， 补丁是CI运行号。没有手动释放步骤。每个版本都包含一个 npm-shrinkwrap.json，因此每次安装都会得到经过CI测试的依赖树。

npx -y @monadsag/productive-mcp@latest

服务器在标准输出上使用MCP，并只记录标准输出日志。注意，没有作用域 productive-mcp 在NPM上是berwickgeek的上游版本，而不是这个分支。

npm run build && npm run package:smoke 打包，从当地的一次性食品中取出 注册表并开始 npx 通过演播室，和集线器一样。

开发

npm run worker:dev     # local dev on port 8788 (requires .dev.vars with secrets)
npm run worker:deploy  # deploy to Cloudflare
npm run build          # compile TypeScript (for local stdio fallback)
npm run format         # prettier

创建一个 .dev.vars 使用与Cloudflare本地开发秘密相同的变量(包括 PAT_ENC_KEY (64位十六进制字符串，例如： openssl rand -hex 32）。 wrangler dev 自动提供本地KV命名空间。

许可证

Apache 2.0

最初基于 productive-mcp 由 jayat3dn (ISC)。看到 请注意 查看归属详细信息。

维护的 单体AG)