翼鸥 OA 数据台账 MCP

通过翼鸥公共 API Key 查询当前员工有权访问的 OA 数据台账。模型、字段、记录和附件权限均由 OA 服务端校验。

工具

| 工具编码 | 中文名称 | 类型 | | --- | --- | --- | | list_ledger_models | 获取权限内数据模型 | 只读 | | query_ledger_page | 数据分页查询 | 只读 | | get_ledger_record | 查询单条数据 | 只读 | | query_departments | 部门信息查询 | 只读 | | query_employees | 员工信息查询 | 只读 | | query_dictionary | 数据词典查询 | 只读 | | download_attachment | 附件下载 | 本地写入 | | upload_attachment | 附件上传 | OA 写入 |

使用约定

模型编码和查询字段已知时，直接进行分页查询，不必重复获取权限内数据模型。只有模型未知、字段不确定，或直接查询提示模型/字段不可用时，才进行模型发现。分页接口使用 keywords 条件数组和 cursor 游标；后续分页必须传入上次返回的 nextCursor。获得唯一 uid 后再查询完整单条数据。分页结果不是全量，统计时必须根据 hasMore 完整翻页。不得尝试访问服务端未返回的模型、字段、记录或附件。

环境变量

API_KEY=<翼鸥公共 API Key>
OA_BASE_URL=<OA 环境地址>

可选：

OA_REQUEST_TIMEOUT_MS=30000

配置示例

{
  "mcpServers": {
    "翼鸥OA数据台账": {
      "timeout": 60,
      "command": "npx",
      "args": ["-y", "eeo-oa-data-ledger-mcp@latest"],
      "env": {
        "API_KEY": "你的 API Key",
        "OA_BASE_URL": "你的 OA 环境地址"
      }
    }
  }
}