CWM API Gateway MCP

ConnectWise APIゲートウェイMCPサーバーは、簡素化されたAPI発見、実行、管理インターフェースを提供し、自然言語検索とよく使うクエリの高速記憶をサポートします。

開発者ツール顧客サポート #APIゲートウェイ #高速検索 #自然言語 #自動化 .Python

スコア : 2.5ポイント

ダウンロード数 : 11

更新時間 : 2025-04-28

ConnectWise APIゲートウェイとは？

これはConnectWise Manageシステム用に設計されたAPIインテリジェントゲートウェイで、自然言語処理技術を通じて複雑なAPI操作プロセスを簡素化します。ユーザーの要求を自動的にAPI呼び出しに変換し、技術的な敷居を大幅に下げます。

APIゲートウェイの使い方は？

簡単な自然言語命令または事前設定されたコマンドで操作でき、システムが自動的に最適なAPIエンドポイントを選択し、認証、パラメータ変換などの複雑なプロセスを処理します。

適用シーン

特に適しているのは： - 非技術者による複雑なAPI操作 - ConnectWiseとの統合の迅速な構築 - 高頻度の繰り返しAPIタスクの自動化 - ConnectWise API機能の探索

核心機能

インテリジェントAPI発見キーワードまたは自然言語の説明を通じて迅速にAPIエンドポイントを見つけることができ、複雑なパスを覚える必要がありません。

高速記憶システムよく使うAPIクエリを自動的に保存し、ワンクリックで過去の操作を呼び出すことができます。

インテリジェントエラー処理APIエラーを自動的に解析し、修正提案を提供し、デバッグの難易度を下げます。

適応型学習システムがあなたの使用習慣を記録し、よく使う機能を優先的に推薦します。

利点と制限

利点

API学習コストを90％削減する

典型的なAPI呼び出し時間を分単位から秒単位に短縮する

コードを書かずに複雑な統合を完了する

API認証資格情報を自動的に維持する

制限

ConnectWise Manageシステムのみをサポートする

一部のエッジ機能は依然として生のAPIを直接呼び出す必要がある

初回設定には技術的な支援が必要である

使用ガイド

環境準備

Node.js 16+またはPython 3.10+の実行環境がインストールされていることを確認してください。

サービスのインストール

NPMを使用したワンクリックインストールをおすすめします（管理者権限が必要です）。

認証の設定

環境変数を設定します（以下はサンプル値です。実際の値に置き換えてください）。

典型的なアプリケーションシーン

チケット管理サービスチケットの迅速な検索と処理

顧客レポート顧客活動レポートの自動生成

よくある質問と回答

使用するにはプログラミング経験が必要ですか？

API認証情報をどのように取得できますか？

システムは自動的に更新されますか？

学習リソース

公式APIドキュメント

ConnectWise公式APIリファレンスドキュメント

GitHubリポジトリ

プロジェクトのソースコードと問題追跡

ビデオチュートリアル

10分でのクイックスタートビデオ

インストール

以下のコマンドをクライアントにコピーして設定

{
  "mcpServers": {
    "CWM-API-Gateway-MCP": {
      "command": "npx",
      "args": [
        "-y",
        "@jasondsmith72/CWM-API-Gateway-MCP"
      ],
      "env": {
        "CONNECTWISE_API_URL": "https://na.myconnectwise.net/v4_6_release/apis/3.0",
        "CONNECTWISE_COMPANY_ID": "your_company_id",
        "CONNECTWISE_PUBLIC_KEY": "your_public_key",
        "CONNECTWISE_PRIVATE_KEY": "your_private_key",
        "CONNECTWISE_AUTH_PREFIX": "yourprefix+"
      }
    }
  }
}

{
  "mcpServers": {
    "CWM-API-Gateway-MCP": {
      "command": "node",
      "args": ["C:/path/to/CWM-API-Gateway-MCP/bin/server.js"],
      "env": {
        "CONNECTWISE_API_URL": "https://na.myconnectwise.net/v4_6_release/apis/3.0",
        "CONNECTWISE_COMPANY_ID": "your_company_id",
        "CONNECTWISE_PUBLIC_KEY": "your_public_key",
        "CONNECTWISE_PRIVATE_KEY": "your_private_key",
        "CONNECTWISE_AUTH_PREFIX": "yourprefix+"
      }
    }
  }
}

{
  "mcpServers": {
    "CWM-API-Gateway-MCP": {
      "command": "python",
      "args": ["C:/path/to/CWM-API-Gateway-MCP/api_gateway_server.py"],
      "env": {
        "CONNECTWISE_API_URL": "https://na.myconnectwise.net/v4_6_release/apis/3.0",
        "CONNECTWISE_COMPANY_ID": "your_company_id",
        "CONNECTWISE_PUBLIC_KEY": "your_public_key",
        "CONNECTWISE_PRIVATE_KEY": "your_private_key",
        "CONNECTWISE_AUTH_PREFIX": "yourprefix+"
      }
    }
  }
}

{
  "mcpServers": {
    "CWM-API-Gateway-MCP": {
      "command": "python3",
      "args": ["/path/to/CWM-API-Gateway-MCP/api_gateway_server.py"],
      "env": {
        "CONNECTWISE_API_URL": "https://na.myconnectwise.net/v4_6_release/apis/3.0",
        "CONNECTWISE_COMPANY_ID": "your_company_id",
        "CONNECTWISE_PUBLIC_KEY": "your_public_key",
        "CONNECTWISE_PRIVATE_KEY": "your_private_key",
        "CONNECTWISE_AUTH_PREFIX": "yourprefix+"
      }
    }
  }
}

注意：あなたのキーは機密情報です。誰とも共有しないでください。

🚀 このコネクタの概要

このコネクタは、ConnectWiseプラットフォームとの統合を可能にし、自動データ同期やクエリ最適化などの機能を提供します。

🚀 クイックスタート

このコネクタをConnectWiseプラットフォームと統合するには、以下の手順に従ってください。

📦 インストール

必要なソフトウェアパッケージをダウンロードしてインストールします。

Python 3.xバージョンがインストールされていることを確認してください。
以下のコマンドを実行して、必要な依存関係をインストールします。

pip install requests jsonschema

🔧 環境変数の設定

システム環境に以下の変数を設定してください。

CONNECTWISE_COMPANY_ID=your_company_id
CONNECTWISE_PUBLIC_KEY=your_public_key
CONNECTWISE_PRIVATE_KEY=your_private_key
CONNECTWISE_AUTH_PREFIX=your_auth_prefix

🗃️ データベース接続の設定

api_gateway.dbファイルがプロジェクトディレクトリに存在することを確認してください。
ファイルが存在しない場合は、以下のコマンドを実行して初期データベースを生成します。

python build_database.py

▶️ サービスの起動

ターミナルまたはコマンドプロンプトで、以下のコマンドを実行してコネクタを起動します。

python api_gateway.py

🌐 インターフェースへのアクセス

ブラウザを開き、http://localhost:8080にアクセスします。
ConnectWiseの認証情報を使用してログインします。

✨ 主な機能

自動データ同期

リアルタイム更新：システムは自動的にConnectWiseの最新データを検出して同期します。
バッチ処理操作：大量のデータを効率的に処理し、API呼び出し回数を減らします。
エラー回復：ブレークポイントからの再開機能を備え、データ転送の完全性を確保します。

スマートクエリ最適化

適応型フィルター：過去のクエリ履歴に基づいて検索条件を動的に調整します。
フィールド選択：関連するフィールドのみを要求し、応答速度を向上させ、帯域幅の使用を削減します。
結果のページング：大容量のデータセットを効率的に処理し、pageとpageSizeパラメータで返されるデータ量を制御します。

迅速なトラブルシューティング

データベース接続問題

sqlite3.OperationalError: unable to open database file

解決策：

api_gateway.dbファイルが正しい位置にあることを確認してください。
ファイルの権限を確認し、サービスに読み書き権限があることを確認してください。

認証失敗

Unauthorized Error 401

解決策：

すべての環境変数が正しく設定されていることを検証してください。
- CONNECTWISE_COMPANY_ID、CONNECTWISE_PUBLIC_KEY、CONNECTWISE_PRIVATE_KEY。
APIキーが正しい権限を持っていることを確認してください。
CONNECTWISE_AUTH_PREFIXが有効なプレフィックスであることを確認してください。