数智办公平台 MCP Server

山钢资本数智办公平台 AI 接入工具，支持所有主流 AI Agent 一键安装。

⚠️ 重要：架构说明（部署前必读）

本工具连接山钢资本数智办公平台（OA 系统），需要以下运行环境：

架构图

AI Agent (Claude Code / Cursor / ...)
    ↓ MCP Protocol
MCP Server (Node.js)
    ↓ HTTP POST (localhost:10086)
Kimi WebBridge 守护进程
    ↓ CDP Protocol
浏览器（已登录 OA 系统）
    ↓ HTTP + Cookie
数智办公平台 (oatest.sgscf.cn)

为什么不直接 HTTP 请求？

OA 系统认证基于浏览器 Session Cookie，不支持 API Key / Token 直接调用。Cookie 有效期约 30 分钟，且绑定浏览器指纹，终端直接发送无效。

当前方案是通过 WebBridge 复用浏览器的登录态，这是唯一可行的方式。

Related MCP server: DiSH MCP Server

🚀 安装

前置要求

• Node.js >= 18.0

• Kimi WebBridge 已安装并运行（http://127.0.0.1:10086）

• 浏览器已登录 OA 系统（https://oatest.sgscf.cn）

安装命令

# 全局安装
npm install -g sgs-oa-mcp-server

# 或 npx 直接运行
npx sgs-oa-mcp-server

🔧 配置

环境变量（可选）

创建 .env 文件：

# MCP Server 配置
MCP_API_KEYS=dev-key-001,prod-key-002
PORT=3000

注：OA 系统地址和认证通过 WebBridge 自动处理，无需手动配置。

📋 可用工具

📖 使用示例

安装后，在 AI Agent 中直接输入：

帮我查一下济南的办公场所

或 API 直接调用：

curl -X POST http://localhost:3000/api/v1/tools/search_office \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dev-key-001" \
  -d '{"officenm": "济南"}'

🐛 常见问题

Q: 提示 "WebBridge session has no tab"？

确保 WebBridge 守护进程已启动，且浏览器已打开 OA 系统页面。

运行以下命令检查 WebBridge 状态：

curl http://127.0.0.1:10086/health

Q: 提示 "Failed to fetch"？

浏览器中的 OA 登录态可能已过期。在浏览器中重新访问 https://oatest.sgscf.cn 并登录。

Q: 为什么不能脱离浏览器使用？

OA 系统当前不支持 API Key / Token 认证，必须通过浏览器 Session 访问。如需纯 API 方式，需要 OA 系统开发团队开放 Token 认证接口。

Q: 安全性如何？

• WebBridge 守护进程仅监听 localhost，不暴露到外网

• MCP Server 支持 API Key 认证

• 所有操作记录审计日志（logs/audit.log）

📝 License

MIT © 2026 山钢资本金融科技服务中心

🔗 链接

• 操作手册（飞书）

• npm 包

• GitHub