pfx

Forterro Proffix Px5 向け pfx MCP サーバー

🇩🇪 ドイツ語 | 🇬🇧 英語

Forterro Proffix Px5 ERP 向け Model Context Protocol サーバー

Proffix Px5 ERP と AI／KI を連携するためのユニバーサルインターフェースです。

標準化された MCP プロトコルを介して、AI アシスタント（Claude、ChatGPT、Gemini）を Proffix Px5 に接続できます。

JSON-RPC 2.0 トランスポート • パラメータベースの認証 • 整備済みの Proffix エンドポイント

🌟 Model Context Protocol（MCP）とは？

Model Context Protocol（MCP）は、安全な AI 連携を実現するための Anthropic によるオープンスタンダードです。AI アシスタントがシステムに直接アクセスできるため、データを手作業でコピーしたり、スクリーンショットを撮ったりする必要はありません。

MCP を使わない場合：「未払いの請求書をすべて見せて」→ Proffix を開き、データをエクスポートして、AI にコピーする必要があります。

MCP を使う場合：「未払いの請求書をすべて見せて」→ AI が Proffix に直接アクセスし、回答を提示します。

• リアルタイムアクセス： AI はシステムの最新データを使って作業します
• セキュリティ： AI にデータは保存されず、一時的にアクセスするだけです
• 自動化： AI は複数のシステムにまたがる複雑なタスクを実行できます
• 自然言語： SQL や API の知識は不要です
• 標準化： MCP 対応のすべての AI アシスタントで動作します

📋 pfx MCP とは？

pfx MCP は、Forterro Proffix Px5 向けの初の MCP サーバーです。Claude、ChatGPT、Gemini などの AI アシスタントを ERP に接続できます。自然言語を使って、データへのアクセス、レポートの作成、ワークフローの自動化を直接行えます。

• Proffix の機能を MCP ツール経由で直接利用
• JSON-RPC 2.0 トランスポートですべての MCP クライアントに対応
• 無料の API キー（ベータ版）
• Claude、ChatGPT、Gemini 対応

MCP Registry に公式掲載：

• 📦 パッケージ：ch.pfx/mcp-server
• 🔗 レジストリ：registry.modelcontextprotocol.io
• 💻 GitHub：github.com/pitwch/pfx-mcp-server
• ✅ ステータス：稼働中 • バージョン 1.0.0 • 公開日 2025-11-08

💡 実用的なユースケース

📊 インテリジェントなデータ照会

例：「未払いの請求書をすべて見せて」

AI が Proffix のデータに直接アクセスし、SQL や API の知識がなくても、構造化された結果を提示します。

🔍 複雑な検索

例：「名前に『Laptop』を含み、価格が 1000 CHF 未満の商品を検索して」

自然言語によるクエリは、自動的に正確な API 呼び出しに変換されます。

📈 レポートの自動作成

例：「売上高上位 10 社の顧客レポートを作成して」

AI がデータを集計して分析を行い、結果を見やすく整形します。

🔔 変更の追跡

例：「今週変更された住所はどれですか？」

時間範囲を指定したクエリや変更分析をリアルタイムで行えます。

💼 その他のユースケース

• 在庫管理：「在庫が 10 未満の商品をすべて見せて」
• 顧客分析：「顧客 1001 の売上推移を分析して」
• ワークフローの自動化：「会社 XY の新しい住所を作成して」
• エンドポイントの検出：「受注向けの API エンドポイントには何がありますか？」
• 複数システムへの照会：「Proffix のデータと当社 CRM を比較して」

🚀 クイックスタート

オプション 1：ワンクリックインストール（推奨） 🎯

Claude Desktop ユーザー向け — 最も簡単なインストール方法です！

最速の方法です。手動での設定は不要です！

1. API キーを取得する
   request-api-key.html にアクセスし、無料のキーを申請します（メールで届きます）

2. MCPB バンドルをダウンロードする
   pfx-mcp-server.mcpb をダウンロード

3. インストールする
   Claude Desktop で、「設定」→「拡張機能」→「詳細設定」（Extension Developer セクション）→「拡張機能をインストール…」の順に進み、.mcpb ファイルを選択して画面の指示に従います

4. 認証情報を入力する
   API キーと Proffix Px5 の認証情報（ユーザー名、パスワード、URL、ポート、データベース）を入力します

5. 完了です！
   Claude を再起動して、次のように試してみましょう：「Proffix Px5 からチューリッヒのすべての住所を表示して」

---

オプション 2：手動インストール（上級者向け） ⚙️

ほかの MCP クライアントや高度な設定向け

ほかの MCP クライアント（Cursor、Windsurf、Gemini CLI など）を使用する場合や、設定を自分で管理する場合：

1. API キーを申請する
   request-api-key.html

2. ブリッジスクリプトをダウンロードする
   mcp-http-bridge.txt をダウンロードし、mcp-http-bridge.js に名前を変更します

3. 設定ファイルを開く
   クライアントに応じて、次のファイルを開きます：

   • Claude：%APPDATA%\Claude\claude_desktop_config.json（Windows）または ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）
   • Cursor/Windsurf：AI Client Setup を参照してください

4. サーバーを追加する
   以下の設定例を参照してください：

{
  "mcpServers": {
    "pfx-mcp": {
      "command": "node",
      "args": ["C:\\mcp\\mcp-http-bridge.js", "https://mcp.pfx.ch/api/server"],
      "env": {
        "HTTP_AUTHORIZATION": "Bearer DEIN_API_KEY",
        "PROFFIX_USERNAME": "dein-username",
        "PROFFIX_PASSWORD": "dein-passwort",
        "PROFFIX_URL": "https://dein-proffix.com",
        "PROFFIX_PORT": "11011",
        "PROFFIX_DATABASE": "deine-db",
        "RESPONSE_FORMAT": "json"
      }
    }
  }
}

5. クライアントを再起動してテストする
   AI アシスタントに次のように尋ねます：「Proffix からすべての住所を表示して」

📚 ドキュメント

すべての AI クライアント向けの完全なセットアップ手順：

• メインドキュメント
• AI クライアントのセットアップ（Claude、ChatGPT、Gemini、Cursor、Windsurf、Continue.dev）
• テストとデバッグ

🔧 対応 MCP クライアント

• ✅ Claude Desktop
• ✅ Cursor IDE
• ✅ Windsurf IDE
• ✅ Continue.dev（VS Code/JetBrains）
• ✅ Gemini CLI
• ⚡ ChatGPT（実験的）
• ✅ カスタムクライアント（MCP SDK 経由）

🔒 セキュリティ

認証

• アクセス制御用の API キー（ベータ期間中は無料）
• Proffix の認証情報を HTTP ヘッダーとして送信（暗号化して送信）
• MCP サーバー上にデータは保存されません
• セッションを使用しないパラメーター方式の認証
• 認証情報はリクエストごとに送信され、保存されません

ベストプラクティス

• 通信には必ず HTTPS を使用してください
• 認証情報をクライアントコードに保存しないでください
• クライアント側でレート制限を実装してください
• API アクセスを定期的に監視してください
• Proffix API ユーザーには強力なパスワードを使用してください

サーバーのセキュリティ

• 包括的な .htaccess セキュリティルール
• 機密ファイルと設定の保護
• HTTPS 暗号化の使用を推奨

🌐 リモートサーバー

pfx MCP サーバーは、以下の ホステッドサービスとして稼働しています：

https://mcp.pfx.ch/api/server

トランスポート： HTTP 経由の JSON-RPC 2.0
ステータス： https://mcp.pfx.ch/api/version

🔌 Model Context Protocol API

pfx MCP サーバーは、標準化された Model Context Protocol を JSON-RPC 2.0 経由で実装しています：

MCP メソッド

• initialize — クライアントとサーバー間のハンドシェイクです。ケイパビリティとプロトコルバージョンを交換します。
• tools/list — 利用可能なすべての Proffix 操作を一覧表示します。認証が必要です。
• tools/call — Proffix の操作を実行します。パラメーターは arguments で渡します。

利用可能な Proffix ツール

• proffix_search_endpoints - 120 以上のエンドポイントを対象としたファジー検索
• proffix_call_endpoint - エンドポイントを直接呼び出します
• proffix_describe_endpoint - エンドポイントのドキュメント
• Proffix API の各エンドポイント（住所、商品、注文など）

レスポンス形式

サーバーは 2 種類のレスポンス形式に対応しています。

• JSON（デフォルト） - Proffix API からの構造化された JSON レスポンス
• TOON（AI 向けに最適化） - 自然言語による説明を加え、AI による処理に最適化したレスポンス

形式の有効化：

1. グローバル（推奨） - すべての呼び出しに適用されます。

{
  "name": "proffix_call_endpoint",
  "arguments": {
    "endpointId": 9,
    "format": "toon",
    "params": {
      "limit": 10
    }
  }
}

2. 呼び出しごと - グローバル設定を上書きします。

{
  "name": "proffix_call_endpoint",
  "arguments": {
    "endpointId": 9,
    "params": {
      "limit": 10,
      "format": "toon"
    }
  }
}

優先順位： params.format > arguments.format > "json"（デフォルト）

サーバー URL： https://mcp.pfx.ch/api/server

🔧 テスト例とデバッグ

💡 質問の例

一般的な質問

"Zeige mir alle offenen Rechnungen"
"Suche Artikel mit 'Laptop' im Namen"
"Welche Adressen haben sich diese Woche geändert?"
"Erstelle einen Bericht über Umsätze nach Kunde"

部門別の例

• 経理：「30 日以上前の未払い請求書をすべて表示して」
• 営業：「2024 年第 4 四半期のステータスが『オープン』の見積もりをすべて一覧表示して」
• 購買：「期限を過ぎている注文はどれ？」
• 管理会計：「商品グループ別の売上概要を作成して」
• サポート：「顧客 XY のサービス案件をすべて検索して」
• 開発：「利用可能な Proffix のエンドポイントをすべてドキュメント化して」

🔗 リンク

• ウェブサイト： https://mcp.pfx.ch
• API キー： https://mcp.pfx.ch/request-api-key.html
• ステータス： https://mcp.pfx.ch/api/version

📄 ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください。

🆘 サポート

ご質問はこちら：https://mcp.pfx.ch/#kontakt

---

注意： Forterro Proffix Px5 REST API へのアクセスが必要です。