eyeot ERP

⚡ 60秒でインストール

pip install eyeot-mcp        # 1.  install the bridge
eyeot-mcp login              # 2.  authenticate via browser (OAuth Device Flow)

次に、Claude Desktop の設定に貼り付けます。

{
  "mcpServers": {
    "eyeot": {
      "command": "eyeot-mcp"
    }
  }
}

Claude Desktop を再起動すれば完了です。「直近の請求書を5件表示して」と尋ねてみましょう。

設定ファイルの場所 · macOS ~/Library/Application Support/Claude/claude_desktop_config.json · Windows %APPDATA%\Claude\claude_desktop_config.json

🧩 これは何ですか？

eyeot ERP は、CRM、営業、在庫、保守、人事、財務、ITサービス管理、GED、RGPD準拠に加え、6つのV2マーケットプレイスモジュール（POS、配送・ルート計画、採用、BPM、フィールドサービス、サプライチェーン）にわたる約600の業務アクションを、HTTPS経由のMCPツールとして公開します。

しかし、Claude Desktop、Cursor、およびほとんどのローカルエージェントが対応しているのは、stdio経由のMCPだけです。

eyeot-mcp は、その間をつなぐ不足していた要素です。

flowchart LR
    A["🤖 Claude Desktop<br/>Cursor / custom agent"] -- "JSON-RPC<br/>over stdio" --> B["📦 eyeot-mcp<br/>(this package)"]
    B -- "HTTPS POST<br/>Bearer token" --> C["🏢 eyeot ERP<br/>(your tenant)"]
    C -. "Auth · RBAC · audit<br/>multi-tenant isolation<br/>license guard" .-> C

    style A fill:#eef2ff,stroke:#6366f1,color:#1e293b
    style B fill:#f0fdf4,stroke:#10b981,color:#065f46
    style C fill:#fef3c7,stroke:#f59e0b,color:#78350f

このブリッジには業務ロジックが一切ありません。 認証、RBAC、監査ログ、ライセンス適用、マルチテナント分離、冪等性など、すべてサーバー側で処理されます。CLIはPython標準ライブラリのみを使った約290行のコードです。10分で監査できます。

🎯 エージェントで何ができますか？

インストールすると、MCP クライアントから次のようなアクションを利用できます。

…さらに約590のアクションを、OpenAPI仕様から自動生成して利用できます。

🔐 認証

2つのモードで、通信時には同じBearerヘッダーを使い、サーバー側では同じAuthorizationデコレーターを使います。

eyeot-mcp login

{
  "mcpServers": {
    "eyeot": {
      "command": "eyeot-mcp",
      "env": { "EYEOT_TOKEN": "eyk_xxx_xxx" }
    }
  }
}

🛡️ セキュリティモデル

ローカル認証情報はファイルモード 0600（POSIX）で ~/.eyeot-mcp/config.json に保存されます。Windows ではファイル ACL が適用されます。テレメトリーなし、外部への通信なし。

🏗️ セルフホスト

--base-url を指定して、ブリッジを任意の eyeot デプロイメントに接続できます。

eyeot-mcp --base-url https://erp.example.com login

{
  "mcpServers": {
    "eyeot": {
      "command": "eyeot-mcp",
      "args": ["--base-url", "https://erp.example.com"]
    }
  }
}

プロトコルも認証も同じで、インフラはご自身の環境を使用できます。

📚 コマンド

🔧 仕組み（内部処理）

1. Claude Desktop は eyeot-mcp を子プロセスとして起動し、stdin/stdout のパイプを介して JSON-RPC 2.0 をやり取りします。
2. stdin で受信した各行について、ブリッジは JSON を ${base_url}/api/v1/mcp に Authorization: Bearer <token> を付けて POST します。
3. HTTP レスポンスは加工せずに stdout へ書き込み、行区切りの JSON としてフレーム化されます。
4. サーバーは MCP 2024-11-05 を使用し、OpenAPI 仕様から約 600 個のツールを自動生成します。initialize、tools/list、tools/call はすべて、MCP クライアントが期待するとおりに動作します。

ブリッジに状態はありません。トランスポート以外のプロトコル変換もありません。予期しない動作もありません。

📖 リソース

• このパッケージ：セマンティック バージョニング。メジャーバージョンの更新では、CLI フラグやディスク上の設定スキーマが変更される場合があります。
• MCP プロトコル：2024-11-05（サーバー側でネゴシエーションされます）。
• ERP API：/api/v1（安定版）。破壊的変更は /api/v2 として提供されます。

📄 ライセンス

MIT — フォーク、パッケージ化、監査、拡張が自由にできます。

eyeot ERP バックエンドは、Eyeot Software の別個のプロプライエタリ製品です。このブリッジはオープンソースなので、誰でも監査、フォーク、ディストリビューション向けのパッケージ化、自分の MCP クライアントを構築する際の参考として利用できます。