DataGate MCP について
DataGate で請求業務を行う MSP や通信リセラー向けのオープンソース CLI・MCP サーバーです。顧客、契約、請求書などを読み取り専用で検索でき、ローカル SQLite ミラーに同期して API 呼び出しの重複を抑えます。
主な機能
- 01顧客・ユーザー・契約の検索
- 02請求書とサービス項目の取得
- 03複数の DataGate リソース群に対応
- 04ローカル SQLite ミラーへの同期
- 05全文検索によるローカル検索
活用シーン
- 01顧客別の契約とサービス項目の確認
- 02期間を指定した請求書検索
- 03顧客・請求記録の繰り返し照会
- 04ローカルミラー内のリソース検索
MCP 対応
互換性のある AI クライアントが DataGate API 経由でデータを検索できる MCP サーバーです。読み取り専用で、繰り返しの検索にはローカル SQLite ミラーを利用します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
DataGate + AI — Claude、ChatGPT、Codex、Cursor、および MCP を話すあらゆるエージェント向け
非公式です。DataGate の通信料金請求 API 向けにコミュニティが構築した Claude Code スキルおよび MCP サーバーです。DataGate との提携、承認、スポンサー関係はありません。DataGate はそれぞれの所有者の商標です。
すでにお使いの AI に、DataGate の顧客、契約、請求書の照会機能を追加できます — Claude Code、Claude Desktop、ChatGPT(Plus/Pro+。このコネクターが再公開されるまで一時停止中です。mcp-install.md を参照してください)、Codex、Cursor、 Windsurf、Cline、Continue、Gemini、または GitHub Copilot。無料のオープン ソースで、ノート PC 上で動作します。ローカルの SQLite ミラーを使うため、繰り返しの照会でライブ API のページを手作業でめくる必要がなく、 DataGate のアカウントごとのレート制限も消費しません。DataGate 経由で請求を行う MSP および通信事業者向けに構築されています。コードは 不要です。
お使いのエージェントで利用できます
セキュリティに関する注意(このコネクターが再公開されるまで)。 HTTP モード (
--transport http)は、localhost 上であっても実行しないでください。このビルドではトークンを確認しますが、 修正リリースで導入されるリクエストサイズと時間の制限には対応していません。MCP ツールは お客様の認証情報を使って変更を加えることもできます。デフォルトの stdio トランスポートを使用してください。リモートエージェント用にトンネルを 設定した場合は、停止してください。修正版は近日公開予定です。
| お使いの AI エージェント | DataGate スキルのインストール方法 |
|---|---|
| Claude Desktop | インストーラーを実行し、Settings > Extensions から datagate-mcp を登録します(JSON の編集は不要です)。 |
| ChatGPT(有料プラン) | このコネクターが再公開されるまで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではトークンを確認するものの、リクエストサイズと時間の制限がまだありません。mcp-install.md のセキュリティに関する注意を参照してください。 |
| Claude Code | 以下のインストール用プロンプトを貼り付けます。 |
| Codex CLI | 以下のインストール用プロンプトを貼り付けます。 |
ChatGPT にはリモート HTTPS サーバーが必要です。つまり、このコネクターの HTTP モードが必要ですが、このビルドではトークンを確認するものの、リクエストサイズと時間の制限がまだないため、コネクターが再公開されるまで利用を一時停止しています。mcp-install.md のセキュリティに関する注意を参照してください。
以下でも利用できます Cursor、Windsurf、Cline、Continue.dev、Zed、GitHub Copilot、 Gemini CLI — さらに、MCP と設定済みのスキルの frontmatter を通じて、MCP に対応するあらゆるエージェントでも利用できます。 ツールごとの詳しい接続方法:docs/which-agent.md。
インストール
macOS / Linux:
bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/datagate/install.sh)
Windows(PowerShell):
iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/datagate/install.ps1 | iex
どちらのインストーラーも OS とアーキテクチャを検出し、このリポジトリの Releases から datagate-cli と
datagate-mcp のバイナリをダウンロードして、~/.local/bin
(macOS/Linux)または %LOCALAPPDATA%\Programs\msp-skills\(Windows)に書き込みます。macOS の
Gatekeeper による隔離を解除し、DRY_RUN=1 にも対応します。
認証
export DATAGATE_API_KEY="<your Bearer token>"
export DATAGATE_CLIENT_ID="<your ClientId GUID>"
datagate-cli doctor
どちらの値も、お客様自身の DataGate アカウントから取得できます — OAuth フローも、トークンの有効期限も、更新作業もありません。doctor を実行すると、両方が設定されていることと、API に
到達できることを確認できます。
ラッパーではなくローカルミラーを使う理由
DataGate の多くのシンプルなラッパーは、質問のたびにライブ API へプロキシします。顧客を 1 件照会するだけなら問題ありませんが、 大量の顧客リストを確認したり、請求書を繰り返し取得したりすると、リクエスト数が積み重なります — 呼び出しごとに DataGate のレート制限(アカウントごとに 毎分 60 リクエスト、1 日あたり 5,000 リクエスト)にカウントされるためです。このスキルは、顧客、契約、請求書を全文検索対応のローカル SQLite ミラーに同期するため、繰り返しの照会はローカルでの 1 回のクエリーで済みます。即座に実行でき、オフラインでも利用でき、追加の API 呼び出しもありません。
対応範囲
DataGate の各リソースグループ(顧客、顧客ユーザー、契約、サービス品目、割り当て、料金表、拠点、製品テンプレート、キットテンプレート、請求書、製品、配送方法、製品取引、アカウントマネージャー)を読み取り専用で操作します(一覧表示、取得、検索)。読み取り/書き込みの全体的な内訳についてはgovernance.mdを、すべてのコマンドについてはguide.mdを参照してください。
コマンド例
datagate-cli customers list --json
datagate-cli agreements list --select id,customerId,name,status --json
datagate-cli invoices --period-start 2026-08-01T00:00:00Z --period-end 2026-08-31T23:59:59Z --json
datagate-cli sync
datagate-cli search "<customer name or invoice number>"
既知の制限事項
このビルドは意図的に読み取り専用となっています。DataGate の CRUD 操作はドキュメント化されていますが、このコネクターでは作成/更新/削除を実装していません。一部のエンドポイントパス(拠点、製品、製品テンプレート、キットテンプレート、配送方法、製品取引、アカウントマネージャー)は、実稼働テナントで個別に確認せず、DataGate 独自の命名規則から導き出したものです。ご自身のアカウントで実行して問題が見つかった場合は、報告してください(CONTRIBUTING.mdの手順2を参照してください。実際のテナントで確認した証拠を含むバグ報告は、再現できない報告よりも役立ちます)。
ライセンス
Apache-2.0。cli/LICENSEおよびcli/NOTICEを参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。