mcp-omie

@codespar/mcp-omie

面向 Omie 的 MCP 服务——涵盖客户、产品、订单、发票和财务的 ERP

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "omie": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-omie"],
      "env": {
        "OMIE_APP_KEY": "your-app-key",
        "OMIE_APP_SECRET": "your-app-secret"
      }
    }
  }
}

Claude Code

claude mcp add omie -- npx @codespar/mcp-omie

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "omie": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-omie"],
      "env": {
        "OMIE_APP_KEY": "your-app-key",
        "OMIE_APP_SECRET": "your-app-secret"
      }
    }
  }
}

工具（30 个）

工具	用途
list_customers	列出 Omie ERP 中的客户
create_customer	在 Omie ERP 中创建客户
list_products	列出 Omie ERP 中的产品
create_product	在 Omie ERP 中创建产品
create_order	在 Omie ERP 中创建销售订单
list_orders	列出 Omie ERP 中的销售订单
list_invoices	列出 Omie ERP 中的发票（NF）
get_financial	列出 Omie ERP 中的应收账款
create_invoice	在 Omie ERP 中按 ID 查询特定 NF
get_company_info	列出在 Omie ERP 中注册的公司
create_service_order	在 Omie ERP 中创建服务订单（OS）
list_service_orders	列出 Omie ERP 中的服务订单（OS）
create_purchase_order	在 Omie ERP 中创建采购订单
list_purchase_orders	列出 Omie ERP 中的采购订单
get_bank_accounts	列出在 Omie ERP 中注册的银行账户
create_account_payable	在 Omie ERP 中创建应付账款（AP）条目
list_accounts_payable	列出 Omie ERP 中的应付账款（AP）单据
pay_account_payable	在 Omie ERP 中结清／记录 AP 单据的付款（baixa）
list_dre	列出 Omie ERP 中的 DRE（损益表）会计科目表
get_bank_statement	从 Omie ERP 获取指定期间的银行账户对账单（extrato）
list_categories	列出 Omie ERP 中的会计科目类别
list_departments	列出 Omie ERP 中的部门（成本中心）
list_projects	列出 Omie ERP 中的项目
create_cash_entry	在 Omie ERP 中创建银行账户分类账条目（lançamento de conta corrente）
list_financial_movements	列出 Omie ERP 中统一的财务流水（AP + AR + CC）
create_stock_adjustment	在 Omie ERP 中创建库存调整（入库／出库／余额）
get_stock_position	获取 Omie ERP 中当前的库存位置／余额
update_sales_order	修改 Omie ERP 中现有的销售订单
get_sales_order	在 Omie ERP 中按 ID 或集成代码查询特定销售订单
invoice_sales_order	根据 Omie ERP 中现有的销售订单生成发票（NF）

身份验证

Omie 使用 JSON-RPC 风格的请求，并在请求正文中传递 app_key 和 app_secret。

沙盒／测试

Omie 通过应用注册提供沙盒。创建应用即可获取测试凭据。

获取凭据

1. 前往 Omie Developer Portal
2. 创建账户
3. 注册应用以获取 app key 和 secret
4. 设置环境变量

环境变量

变量	必需	描述
OMIE_APP_KEY	是	Omie 应用密钥
OMIE_APP_SECRET	是	Omie 应用 secret

路线图

v0.3（计划中）

• create_production_order — 创建生产订单
• emit_nfe — 开具 NF-e（原生开具，不是导入）
• reconcile_bank_transaction — 银行对账匹配
• create_service_contract — 服务合同的增删改查
• create_custom_field — 商户自定义字段

想要贡献？提交 PR 或申请工具。

链接

• Omie 网站
• Omie API 文档
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 付款提供治理、预算限制和审计记录？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、付款路由和合规模板。

许可证

MIT