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 は、リクエスト本文に app_key と app_secret を含める JSON-RPC 形式のリクエストを使用します。

サンドボックス／テスト

Omie はアプリ登録を通じてサンドボックスを提供しています。アプリを作成してテスト用認証情報を取得してください。

認証情報の取得

1. Omie Developer Portal にアクセスします
2. アカウントを作成します
3. アプリケーションを登録し、app key と secret を取得します
4. 環境変数を設定します

環境変数

変数	必須	説明
OMIE_APP_KEY	はい	Omie アプリキー
OMIE_APP_SECRET	はい	Omie アプリシークレット

ロードマップ

v0.3（予定）

• create_production_order — 製造指示を作成
• emit_nfe — NF-e を発行（インポートではなく、ネイティブ発行）
• reconcile_bank_transaction — 銀行取引の照合
• create_service_contract — サービス契約の CRUD
• create_custom_field — 販売事業者のカスタムフィールド

貢献したい場合は、PR を作成するか、ツールをリクエストしてください。

リンク

• Omie のウェブサイト
• Omie API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントの決済にガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT