garmonia-crm-mcp

CRM「ハルモニアホテル」を内部API経由でテストするためのMCPサーバー。 パスワードでログインし（セッションcookie）、注文・顧客・ブランド・カレンダー用のツールと、その他すべてのCRUDへの汎用アクセスを提供します。

クイックインストール（1コマンド、クローン不要）

必要なのはNode 18+のみ。リポジトリのインストールやクローンは不要 — npx がGitHubから直接サーバーを起動します。

1. 認証情報を含むローカルファイルを作成します（例: ~/garmonia-crm.json）:

   {
     "baseUrl": "https://адрес-crm",
     "login": "твой-логин",
     "password": "твой-пароль"
   }

2. 1コマンドでMCPを追加します（ファイルへのパスを自分のものに置き換えてください）:

   claude mcp add garmonia-crm \
     -e CRM_CONFIG="$HOME/garmonia-crm.json" \
     -- npx -y github:AlekseiKastsiuk/garmonia-crm-mcp

3. Claude Codeを再起動します。

認証情報はローカルファイルにのみ保存され、どこにも送信されません — npx はGitHubからサーバーのコードのみを取得します。

Related MCP server: MCP CRUD Tools

ソースからのインストール（代替）

git clone https://github.com/AlekseiKastsiuk/garmonia-crm-mcp
cd garmonia-crm-mcp
npm install
cp crm-config.example.json crm-config.json
# открой crm-config.json и впиши baseUrl, логин и пароль своей CRM

crm-config.json はCRMのアドレスとログイン/パスワードです。gitにはコミットしないでください （すでに .gitignore に含まれています）。

Claude Codeへの接続

~/.claude.json（または claude mcp add 経由）にサーバーを追加します:

{
  "mcpServers": {
    "garmonia-crm": {
      "command": "node",
      "args": ["/полный/путь/к/garmonia-crm-mcp/server.mjs"]
    }
  }
}

設定ファイルがサーバーの隣にない場合は、envでパスを指定します:

"env": { "CRM_CONFIG": "/полный/путь/к/crm-config.json" }

編集後 — Claude Codeを再起動します。

ツール

セキュリティ

• パスワードとCRMアドレスは crm-config.json に保持され、これは .gitignore に含まれるため — リポジトリには入りません。

• crm-config.example.json にはプレースホルダーのみで、実際のデータはありません。

• 最初のプッシュ前に確認すべきこと: git ls-files に crm-config.json が含まれていないこと、 また git grep -i password がコード内のフィールド名のみを返すこと。

注意事項

• 注文は公開エンドポイント POST /api/form-lead で作成されます — 認証は不要です。

• 注文の削除はRESTではなく、Next.jsのserver actionです（「閉じた」タブの「削除」ボタンと同じ）。 crm_order_delete はそれを自分で呼び出します。アクションIDはフロントのビルドに紐づいています。 CRMのデプロイ後に削除が機能しなくなった場合は、crm-config.json の bulkDeleteActionId を更新してください （JSバンドル内の bulkDelete で検索）。

• 商品/カテゴリはGET APIではなくサーバーレンダリングでリストを返します — 作成/編集/削除には crm_request（POST/PATCH/DELETE）を使用してください。