pnlcs-mcp

Model Context Protocol サーバーであり、 オープンソースの請求パネル PNLCS のためのものです。 Claude Code、Claude Desktop、Cursor、VS Code、その他の MCP クライアントを お使いの PNLCS インストールに接続し、平易な英語で操作できます:

「どの請求書が延滞していますか?」 — 「このクライアントのサービスと ドメインを表示して」 — 「今日、不正として保留されている注文はありますか?」 — 「ada@example.com の ドメイン更新についてチケットを開いて」

依存関係ゼロ。 このサーバーは、お使いの PNLCS 管理 API と通信する小さな Node プロセス 1つです。PNLCS 側には何もインストールされません。

• npm: pnlcs-mcp

• 要件: AI クライアントが動作するマシン上の Node 18+

• トランスポート: stdio(クライアントが起動 — ポート不要、ホスト不要)

1. PNLCS で API 認証情報を作成する

1. PNLCS インストールの管理エリアにログインします。

2. 設定 → API 認証情報 に移動します。

3. 作成 をクリックし、mcp のような名前を付けて、表示される2つの値をコピーします:

   • 識別子 — 認証情報のユーザー名

   • シークレット — 一度だけ表示されます。安全な場所に保管してください

このペアだけでサーバーは動作し、3つの環境変数で渡されます:

Related MCP server: WHMCS MCP Server

2. クライアントを接続する

Claude Code(CLI)

1つのコマンドで:

claude mcp add pnlcs \
  --env PNLCS_URL=https://billing.example.com \
  --env PNLCS_IDENTIFIER=your_identifier \
  --env PNLCS_SECRET=your_secret \
  -- npx -y pnlcs-mcp

書き込みツールも必要な場合は --env PNLCS_ALLOW_WRITES=1 を追加します。 --scope project を使用すると、.mcp.json を介してチームとエントリを共有できます (シークレットはコミットされたファイルではなく、シェル環境に置いてください)。 claude mcp list で確認し、claude mcp remove pnlcs で削除します。

Claude Desktop

claude_desktop_config.json を編集します (macOS: ~/Library/Application Support/Claude/、Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "pnlcs": {
      "command": "npx",
      "args": ["-y", "pnlcs-mcp"],
      "env": {
        "PNLCS_URL": "https://billing.example.com",
        "PNLCS_IDENTIFIER": "your_identifier",
        "PNLCS_SECRET": "your_secret"
      }
    }
  }
}

Claude Desktop を再起動すると、ハンマーアイコンの下にツールが表示されます。

Cursor

設定 → MCP → 新しいグローバル MCP サーバーを追加、またはプロジェクトに .cursor/mcp.json を作成します(上記の Claude Desktop と同じ JSON 形式)。

VS Code(Copilot エージェントモード)

.vscode/mcp.json を作成します:

{
  "servers": {
    "pnlcs": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pnlcs-mcp"],
      "env": {
        "PNLCS_URL": "https://billing.example.com",
        "PNLCS_IDENTIFIER": "your_identifier",
        "PNLCS_SECRET": "your_secret"
      }
    }
  }
}

その他(Windsurf、Cline、Zed など)

stdio サーバーを起動できるすべての MCP クライアントは、同じ3つの要素を使用します: コマンド npx、引数 ["-y", "pnlcs-mcp"]、および上記の環境変数です。 git チェックアウトからは、node mcp/server.js が同じように動作します。

3. ツール

読み取りツール — 常に利用可能

書き込みツール — PNLCS_ALLOW_WRITES=1 の場合のみ

フラグがない場合、書き込みツールは単に隠されるだけでなく、HTTP が発生する前に呼び出しが拒否されます。レポート用に設定されたアシスタントは、停止ボタンすら見ることができません。フラグを設定しないだけで、レポート用の設定を読み取り専用として運用できます。

4. セキュリティに関する注意事項

• シークレットは、AI クライアントが動作するマシンと PNLCS インストールの間を、管理画面が使用するのと同じ HTTPS API 経由でのみ移動します。モデルプロバイダーに送信されることは決してありません。モデルが参照するのはツールの結果です。

• MCP には専用の API 認証情報を使用することをお勧めします。単独で失効させることができます。

• PNLCS は API 認証情報をレート制限します(認証情報あたり毎分300リクエスト)。そのため、暴走したエージェントがインストールを攻撃することはできません。

• アシスタントに帳簿への操作を実際にさせたい場合以外は PNLCS_ALLOW_WRITES をオフに保ち、何かを作成または変更するツール呼び出しを承認する前に、その提案内容を読んでください。

5. トラブルシューティング

6. テスト

npm test はオフラインスイートを実行します: 実際のサーバープロセスを起動し、実際のプロトコルで通信し、ローカルスタブに対してすべてのツールの HTTP 形状をチェックします — さらに、書き込みゲートの両方向、古いプロトコルリビジョンからのバッチリクエスト、バージョン交渉、タイムアウト、シャットダウン時のドレインもチェックします。

node test/live.mjs は実際のインストールに対してすべてのツールを実行します — 本番の帳簿ではなくデモを対象にしてください。書き込みツール用に明確な名前の使い捨てデータを作成し、ツールごとに PASS/FAIL を1行ずつ出力します。

開発

このパッケージは PNLCS モノレポ 内の mcp/ で開発されています。このリポジトリはそのスタンドアロン配布ミラーであり、常に npm に公開されているバージョンと一致します。