PowerOffice MCP for Codex

用于 Codex 安全访问 PowerOffice Go API v2 的本地 MCP 服务器，支持只读和明确确认的写入操作。服务器使用 DEMO API，采用 OAuth 2.0 Client Credentials，并提供小型、明确受限的工具，而非通用 HTTP 代理。

已有功能

• poweroffice_configuration_status — 检查配置是否存在，不泄露密钥值。

• poweroffice_connection_info — 检查连接并返回可用的集成/权限。

• poweroffice_search_customers — 使用过滤器和分页搜索客户。

• poweroffice_get_customer — 按数字 ID 获取单个客户。

• poweroffice_list_general_ledger_accounts — 读取会计科目表。

• poweroffice_list_account_transactions — 读取指定日期范围内的会计分录。

• poweroffice_create_customer — 在 confirm=true 后创建客户。

• poweroffice_update_customer — 在 confirm=true 后对客户应用允许的 JSON Patch。

• poweroffice_create_general_ledger_account — 在 confirm=true 后创建科目。

• poweroffice_update_general_ledger_account — 在 confirm=true 后对科目应用允许的 JSON Patch。

读取工具保持只读。写入工具仅在显式 confirm=true 时修改数据；删除、过账和发送文档的操作不包含在本阶段中。

Related MCP server: SceneBoard MCP for Codex

要求

• Node.js 22 或更高版本

• pnpm 11

• PowerOffice application key、client key 和 subscription key

• 所调用 endpoint 所需的访问角色

安装

pnpm install
cp .env.example .env.local
pnpm build
pnpm test

在本地填写 .env.local：

PO_ENV=demo
PO_APPLICATION_KEY=...
PO_CLIENT_KEY=...
PO_SUBSCRIPTION_KEY=...
PO_USER_AGENT=poweroffice-mcp/0.1 your-email@example.com

.env.local 已从 Git 中排除。请勿将密钥发送到聊天中，也不要将其添加到 .codex/config.toml。

连接到 Codex

项目文件 .codex/config.toml 已通过 STDIO 运行构建后的 dist/index.js。如果文件存在，它会读取 .env.local，也可以从 Codex 进程的环境中获取所列变量。

执行 pnpm build 后，重新启动此项目的 Codex 任务。首先调用 poweroffice_configuration_status，然后调用 poweroffice_connection_info。

本地开发

pnpm dev
pnpm typecheck
pnpm test
pnpm build
pnpm smoke

服务器仅向 stdout 写入 MCP 消息；启动错误输出到 stderr。令牌在过期前会提前缓存，遇到 401 时执行一次令牌刷新，遇到 429 时对读取请求最多重试两次，延迟至少一秒。写入请求不会自动重试，以避免产生重复数据。总请求频率受 PO_MAX_REQUESTS_PER_SECOND 限制，且不能超过 10。

环境变量

对于生产环境，请将 PO_ENV=production；令牌和 API 的 URL 由代码选择，而非用户输入。

MVP 边界

• 仅支持 PowerOffice API v2 和 STDIO 传输。

• 不支持 webhook、自动遍历所有页面、删除、过账和发送文档的操作。

• 写入工具仅限于 Customers 和 GeneralLedgerAccounts，并要求 confirm=true。

• Fields 字段可以覆盖，但默认情况下服务器请求紧凑的数据集。

• 下一页始终通过 pageNumber 显式请求；X-Pagination 头元数据与结果一起返回。

文档：PowerOffice Developer Portal、Codex 中的 MCP。