Worksection MCP Server

MCP服务器工作区

](https://www.npmjs.com/package/worksection-mcp-server)  ](https://nodejs.org)

MCP（模型上下文协议）服务器 工作区 --乌克兰和东欧流行的项目管理平台。

让像Claude这样的人工智能助手通过自然语言与您的Worksection帐户进行交互：管理项目、任务、评论、成员和标签。

______________________________________________________________________

目录

• 快速开始
• 安装
• 配置
• 可用工具
• 认证
• 速率限制
• 安全
• 发展
• 项目结构
• 许可证

______________________________________________________________________

快速开始

# 1. Install
git clone https://github.com/novgorodskii/worksection-mcp-server.git
cd worksection-mcp-server
npm install && npm run build

# 2. Configure env vars
export WORKSECTION_URL=https://yourcompany.worksection.com
export WORKSECTION_API_KEY=your_api_key_here

# 3. Run
node dist/index.js

在工作区获取API密钥： 账户→ API → 显示API密钥 （只有帐户所有者有权访问）。

______________________________________________________________________

安装

先决条件

• Node.js 18或更高版本
• 具有管理员权限的工作分区帐户

来源

git clone https://github.com/novgorodskii/worksection-mcp-server.git
cd worksection-mcp-server
npm install
npm run build

环境变量

在shell中设置这些或创建 .env 文件（参见 .env.example):

______________________________________________________________________

配置

克劳德桌面

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "worksection": {
      "command": "node",
      "args": ["/path/to/worksection-mcp-server/dist/index.js"],
      "env": {
        "WORKSECTION_URL": "https://yourcompany.worksection.com",
        "WORKSECTION_API_KEY": "your_api_key_here"
      }
    }
  }
}

克劳德代码

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

确保 WORKSECTION_URL 和 WORKSECTION_API_KEY 在shell环境中设置。

直接执行

WORKSECTION_URL=https://yourcompany.worksection.com \
WORKSECTION_API_KEY=your_key \
node dist/index.js

______________________________________________________________________

可用工具

服务器暴露 21工具 横跨5个类别。

📁 Projects (7 tools)

✅ Tasks (8 tools)

💬 Comments (2 tools)

👥 Members (2 tools)

🏷️ Tags (2 tools)

______________________________________________________________________

认证

此服务器使用 管理员令牌 身份验证方法：

• 根据查询参数+API密钥生成MD5哈希
• 提供对所有帐户数据的完全访问权限
• 只有帐户所有者才能生成API密钥

有关每个用户的访问权限，请参阅 工作部分OAuth 2.0文档.

______________________________________________________________________

速率限制

工作部门强制执行 每秒1个请求 速率限制。此服务器会自动处理它——请求以最小1.1s的间隔排队，因此您不必担心达到限制。

______________________________________________________________________

安全

• 🔐 API密钥仅从环境变量中读取-从不进行硬编码
• ✅ 所有输入均已Zod模式验证
• 🖥️ 通过stdio传输在本地运行——无网络暴露
• 🛡️ API工作区本身不允许删除项目、任务、注释或成员（设计安全）

______________________________________________________________________

发展

npm run dev    # Watch mode (auto-recompile)
npm run build  # One-time build
npm start      # Run the server

______________________________________________________________________

项目结构

worksection-mcp-server/
├── src/
│   ├── index.ts              # Server entry point
│   ├── types.ts              # TypeScript type definitions
│   ├── constants.ts          # Shared constants
│   ├── services/
│   │   ├── client.ts         # Worksection API client (auth + rate limit)
│   │   └── formatters.ts     # Markdown formatting helpers
│   └── tools/
│       ├── projects.ts       # Project management tools
│       ├── tasks.ts          # Task management tools
│       ├── comments.ts       # Comment tools
│       ├── members.ts        # Member/team tools
│       └── tags.ts           # Tag/label tools
├── package.json
├── tsconfig.json
└── README.md

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

Made with ❤️ for the Worksection community