Workoflow MCP服务器
MCP（模型上下文协议）服务器，动态地将您的Workoflow组织的工具作为原生MCP工具暴露给AI客户端（Claude Code、Cursor、Windsurf等）。
特性
- 本地MCP工具：您组织的工具直接作为MCP工具公开，具有完整的JSON模式，没有代理层
- 按用户动态工具：每个用户只能看到自己的工具，由其个人访问令牌决定
- 基于令牌的身份验证：使用您从Workoflow获得的个人访问令牌
- 双重运输：支持流式HTTP(
/mcp)苏格兰和南方能源公司(/sse) - OpenTetry跟踪：与Phoenix集成以实现可观测性
快速开始
1.获取您的令牌
- 登录Workoflow平台
- 首选
/profile/ - 生成或复制您的个人访问令牌
2.配置您的AI工具
添加到您的Claude Code MCP配置中(~/.claude.json 或通过 claude mcp add):
{
"mcpServers": {
"workoflow": {
"transport": "http",
"url": "http://localhost:9006/mcp",
"headers": {
"X-Prompt-Token": ""
}
}
}
}3.运行服务器
地方发展：
# Install dependencies
pip install -r requirements.txt
# Copy and configure environment
cp .env.example .env
# Edit .env with your settings
# Run the server
uvicorn workoflow_mcp.app:app --host 0.0.0.0 --port 9006Docker：
docker build -t workoflow-mcp .
docker run -p 9006:9000 --env-file .env workoflow-mcp运作原理
您的AI客户端连接到MCP服务器并调用 tools/list。服务器从中提取您的令牌 X-Prompt-Token 头，从Workiflow平台API获取可用工具，并将其作为带有完整参数模式的本地MCP工具返回。
当AI调用一个工具时，服务器会使用您的令牌将执行代理到平台API。该平台强制授权——每个用户只能执行他们有权访问的工具。
AI Tool (Claude Code/Cursor)
│
│ MCP Protocol (Streamable HTTP + SSE)
│ X-Prompt-Token header
▼
┌─────────────────────┐
│ Workoflow MCP │
│ Server │
│ Port 9006 │
└─────────────────────┘
│
│ HTTP API
│ X-Prompt-Token passthrough
▼
┌─────────────────────┐
│ Workoflow Platform │
│ /api/mcp/tools │
│ /api/mcp/execute │
└─────────────────────┘环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
WORKOFLOW_API_URL | 平台API基础URL | http://localhost:8000 |
TOOL_TYPES | 逗号分隔的工具类型筛选器 | （所有工具） |
OTEL_SERVICE_NAME | OpenTetry服务名称 | workoflow-mcp |
OTEL_EXPORTER_OTLP_ENDPOINT | 用于跟踪的OTLP端点 | （已禁用） |
Claude桌面扩展
预构建的桌面扩展(.mcpb 捆绑包）可用 desktop-extension/ 用于通过一键安装将Workoflow MCP集成分发给Claude Desktop用户。
运作原理
该扩展使用 mcp遥控器 将Claude Desktop的本地stdio传输桥接到远程Workoflow MCP服务器 https://workoflow-mcp.vcec.cloud/mcp安装时，系统会提示用户输入安全存储在操作系统密钥链中的Workoflow令牌。
构建扩展
cd desktop-extension
# Install dependencies
npm install --production
# Package the .mcpb bundle
npx @anthropic-ai/mcpb pack .这产生 workoflow-1.0.0.mcpb （插入版本 manifest.json 在重新打包新版本之前）。
分发给您的团队
作为Claude桌面团队/企业管理员：
- 打开克劳德桌面→ 设置→ 扩展→ 高级设置
- 点击 “安装扩展…” 并选择
.mcpb文件 - 团队成员将看到它可用于一键安装
或者直接分享： 发送 .mcpb 通过Slack、电子邮件或内部文件共享文件——用户双击或拖动到Claude Desktop进行安装。
延伸结构
| 文件 | 目的 |
|---|---|
manifest.json | 扩展元数据、服务器配置、用户配置 |
server/index.js | 委派给mcp-remote的瘦包装器 |
package.json | 具有mcp远程依赖的Node.js包 |
icon.png | 512×512 Workoflow标志 |
.mcpbignore | 从捆绑包中排除测试/文档 |
安全
- 按用户工具隔离：每个
tools/list调用只返回调用用户的工具 - 没有存储凭据：服务器不存储令牌——从HTTP标头中按请求提取
- 按请求验证：每次调用时传递给平台API的令牌；平台强制授权
- 零共享状态：无会话到令牌映射，无服务器端缓存，无全局工具注册表
- 组织范围：令牌决定您可以访问哪个组织的工具
许可证
专有-Workoflow平台