QuoteWerks MCP

QuoteWerks + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、およびMCPに対応するあらゆるエージェント向け

非公式です。QuoteWerks API向けにコミュニティが開発したClaude Code SkillおよびMCPサーバーです。Aspire Technologies, Inc.とは提携しておらず、同社からの推奨やスポンサー提供も受けていません。

_{▶ 30秒のデモを見る - デモデータはシミュレーションです。表示されているコマンドはすべて実際のCLIに存在します。}

QuoteWerks Web向けの型付き見積もりツールです。実際の列名を使用し、型付き書き込みを送信前にプレビューし、ローカルミラーから粗利、成約率、パイプラインに関する回答を提供します。すでにお使いのAIで利用できます - ChatGPT（Plus/Pro+、このコネクターの再公開まで一時停止中。詳細はmcp-install.mdを参照）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilot - さらに、リモート経由でMicrosoft 365 Copilot / Copilot StudioとGoogle Geminiにも対応します。無料のオープンソースで、ノートPC上で動作します。MSPのオーナー向けに作られています。コードは不要です。

エージェントで使う

セキュリティに関する注意（このコネクターの再公開まで）。 HTTPモード （--transport http）は、localhost上であっても実行しないでください。このビルドはトークンを確認しますが、 修正リリースより前のもので、リクエストサイズと時間の制限がありません。MCPツールは 認証情報を使って変更を加えることもできます。デフォルトのstdioトランスポートを使用してください。 リモートエージェント用にトンネルを設定している場合は、停止してください。修正は現在準備中です。

MSPのオーナーが実際に使っている6つのエージェント（セルフサービスで、現在利用できます）：

AI エージェント	QuoteWerksスキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensionsからquotewerks-mcpを登録します（JSONの編集は不要です）。
ChatGPT（有料プラン）	このコネクターの再公開まで一時停止中です。ChatGPTにはHTTPモードが必要ですが、このビルドではトークンを確認する一方、リクエストサイズと時間の制限がまだありません。mcp-install.mdのセキュリティに関する注意を参照してください。
Codex CLI	以下のインストールプロンプトを貼り付けます。
Claude Code	以下のインストールプロンプトを貼り付けます。
Claude Cowork	以下のインストールプロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.jsonのserversキーの下にquotewerks-mcpを追加してから、Agentモードを選択します。

ChatGPTにはリモートHTTPSサーバーが必要です。そのため、このコネクターのHTTPモードが必要になりますが、このコネクターの再公開まで一時停止中です。このビルドではトークンを確認する一方、リクエストサイズと時間の制限がまだありません。mcp-install.mdのセキュリティに関する注意を参照してください。

Microsoft と Google のスタックにも対応

大規模なインストールベースがありますが、率直にお伝えすると、これらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリを使う方法ではありません。

エージェント	必要な対応
Microsoft 365 Copilot / Copilot Studio	このコネクターを再リリースするまで一時停止しています。Copilot Studio では HTTP モードが必要ですが、このビルドではそのモードはトークンを確認するものの、リクエストサイズや時間の制限がまだありません。mcp-install.md のセキュリティに関する注意をご覧ください。
Google Gemini	Gemini CLI はローカルで動作します。Claude Code と同じです。Gemini アプリはリモートで動作し、ChatGPT と同じく一時停止中の HTTP モードが必要です。mcp-install.md をご覧ください。

スキルネイティブのエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。詳しくは以下のインストールセクションをご覧ください。MCP 経由で Cursor、Windsurf、Cline、Continue.dev、Zed でも動作します。ツールごとの完全な接続方法は、docs/which-agent.md をご覧ください。

複数のエージェントを使っていますか？ 1 つのコマンドで、サポート対象の 51 以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。続いて CLI／MCP バイナリ用のスキル別インストーラーを実行してください）。docs/which-agent.md をご覧ください。

60 秒でインストール

Claude Desktop への最速インストール — ワンクリック .mcpb

QuoteWerks MCP（.mcpb）をダウンロード してから、Claude Desktop > Settings > Extensions を開き、ファイルを選択します。ワンクリックで完了し、JSON もシェルも不要です。（QuoteWerks のすべてのリリースはリリースページで確認できます。）

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールします。ディレクトリの一覧表示は不要で、すぐに使えます：

/plugin marketplace add Servosity/msp-skills
/plugin install quotewerks@msp-skills

方法 A — AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください：

このエージェントのワークスペースに、Servosity/msp-skills から QuoteWerks Skill と MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、Bash）を使う場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quotewerks/install.sh) を実行してください。Windows PowerShell を使う場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quotewerks/install.ps1 | iex を実行してください。その後、README に従って認証し、quotewerks-cli --help を実行して機能を確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使えます。

方法 B — インストーラーを自分で実行する

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quotewerks/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quotewerks/install.sh)

インストーラーは quotewerks-cli（CLI）と quotewerks-mcp（MCP サーバー）の両方を、ユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリの SKILL.md を通じてスキルを検出します。

確認：

quotewerks-cli --version

最新バージョンにアップグレード

インストーラーは常に最新リリースを取得します。アップグレードするには再実行してください：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quotewerks/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/quotewerks/install.ps1 | iex

Claude Desktop の .mcpb を使っている場合：最新の .mcpb（このセクションの先頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインを使っている場合：/plugin update quotewerks@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、または別の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法については mcp-install.md と docs/which-agent.md をご覧ください。各エージェントのセクションがあり、GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot／Copilot Studio の方法も掲載しています。最も簡単なのは Claude Desktop の Settings > Extensions パネルを使う方法です。MCP 設定ブロック（JSON を直接編集したい方向け）については、mcp-install.md に記載しています。

Hermes へのインストール

Hermes CLI から：

hermes skills install servosity/msp-skills/skills/quotewerks --force

Hermes のチャットセッション内で：

/skills install servosity/msp-skills/skills/quotewerks --force

Hermes は MCP をネイティブにサポートしているため、quotewerks-mcp サーバーも直接利用できます。インストール方法も環境変数も同じです。

OpenClaw へのインストール

OpenClaw エージェントに次の内容を伝えてください（コピーして貼り付けます）。

https://github.com/servosity/msp-skills/tree/main/skills/quotewerks から quotewerks スキルをインストールしてください。このスキルには、必須の CLI（quotewerks-cli）を openclaw: フロントマターブロック経由でインストールする方法が定義されています。

OpenClaw はまだ一般公開されていません。フロントマターの連携設定はあらかじめ含まれており、OpenClaw のリリースと同時に有効になります。

認証

QuoteWerks Web の Setup > Options > Zapier and API で API キーを作成します（API の利用には MasterRights を持つユーザーが必要です）。エージェントにドキュメントの作成や変更をさせる場合に限り、キーの Allow write access をオンにしてください。参照やレポートには読み取り専用キーで十分です。その後、次を実行します。

export QUOTEWERKS_API_KEY=<your-key>
quotewerks-cli doctor

doctor は設定とパスをチェックし、1 回の読み取り（GET /api/v1/qw/tables）でキーを検証します。キーが拒否された場合は ERROR rejected と表示されます。どちらの場合もデフォルトでは終了コード 0 で終了します。スクリプトでチェックに失敗したときにゼロ以外の終了コードにするには、--fail-on error を追加してください。

このスキルでできること

MSP でよく聞かれる質問	コマンド
Acme の見積もりはどのような状況ですか？	quotewerks-cli docs search --customer "Acme" --type QUOTE
見積もり 1042 の内容を、行ごとのマージンも含めて確認できますか？	quotewerks-cli docs get "1042"
この見積もりに原価割れ、または提出前にマージンが 10% 未満の項目はありますか？	quotewerks-cli docs lint "1042" --min-margin 10
これらのノートパソコンに 18% のマージンを設定すると、見積もりはどうなりますか？（プレビューのみ。書き込みは行いません）	quotewerks-cli items reprice "1042" --part 20UES0X100 --margin 18
昨年 3 月の注文を今日の価格でノートパソコン 12 台の新しい見積もりに複製できますか？（プレビュー）	quotewerks-cli requote "1042" --qty 20UES0X100=12
30 日以上経過した未完了の見積もりはどれですか？また、誰に連絡すればよいですか？	quotewerks-cli pipeline --older-than 30d
過去 90 日間の担当者別の成約率はどれくらいですか？	quotewerks-cli winrate --by rep --since 90d
開いている見積もりのうち、製品データベースの原価と一致しなくなったものはどれですか？	quotewerks-cli cost-drift --threshold 2

パイプライン、成約率、マージン、原価差異、変更の各レポートはローカルコピーを読み取ります。まず quotewerks-cli mirror を実行し、最新の数値を確認するたびにもう一度実行してください。書き込み（docs create、items add、items reprice、requote）は、--confirm を追加するまでプレビューのみです。

コマンドの詳細はガイドを参照してください。AI エージェント向けの運用規約（--agent、--dry-run、変更を適用する前に確認するタイミング）については、AGENTS.mdを参照してください。

このスキルの特徴

Zapier アプリを含む一般的な QuoteWerks 連携では、レコードごとにライブ API を 1 回呼び出します。1 件のレコードなら問題ありません。しかし、「前四半期のすべての注文で、担当者ごとのマージンはいくらだったか。また、販売代理店の原価引き上げで採算が悪化した未完了の見積もりはどれか」といった質問では、大規模になると処理できなくなります。

このスキルは、QuoteWerks のドキュメント、明細行、製品データベースをローカルの SQLite ミラー（quotewerks-cli mirror）にコピーします。集計に関する質問はローカルのクエリ 1 回で済み、即座にオフラインで結果が得られます。また、AI に生データではなく回答を提示できます。cost-drift は未完了の見積もりの全明細行を製品データベースと結合します。また、margin --by manufacturer と winrate は、ミラーに含まれるすべてのドキュメントを対象にヘッダーと明細行を集計します。これは、ステートレスな API ラッパーではできない処理です。レコードごとに処理する生の REST API や Zapier QuoteWerks アプリと比べて、実際の QuoteWerks の列名を使用する型付き見積もりコマンドも追加されています。また、型付きの書き込みはすべて、送信前にプレビューされます。

この課題を解決します

ある MSP のアカウントマネージャーが QuoteWerks に公式 MCP サーバーをリクエストし、日々の業務時間を奪っている 4 つの作業を挙げました。

• メールから見積もりを作成する。 「3 月に送ってもらったものと同じノート PC をあと 12 台、それとドックも」という依頼では、3 月のドキュメントを探し出し、見積もりに各項目を手入力する必要があります。
• 見積もりのステータスを確認する。 「Acme の見積もりはどうなっていますか？」と聞かれると、作業を中断して Document Lookup を実行する必要があります。
• 価格を再設定する。 販売代理店の原価が変わると、各ドキュメントを開いてすべての明細を更新する必要があります。
• QBR の数値を出す。 粗利率や受注率を確認するには、質問ごとにスクリプトやレポートが必要です。

同じ投稿では、ベータ版 REST API だけでは解決しない理由も説明されています。汎用的なテーブルアクセスであるため、AI がスキーマを推測する必要があり、推測が間違っていても気付かないまま不適切な見積もりが作られてしまいます。このスキルなら、各作業を 1 つのコマンドで処理できます。

• quotewerks-cli requote "1042" --qty 20UES0X100=12 - 3 月の注文を新しい見積もりにコピーし、新しい数量と本日の製品データベースの価格を適用します。作成前にプレビューできます。
• quotewerks-cli docs search --customer "Acme" --type QUOTE - いま作業しているウィンドウから、見積もりのステータスを確認できます。
• quotewerks-cli cost-drift --threshold 2、続けて items reprice - 原価が変動したオープン見積もりの明細をすべて、変更前後の原価での粗利率とともに表示します。価格を変更する前に、変更前後の差分を確認できます。
• quotewerks-cli margin --by rep --since 90d と winrate --by rep - ローカルミラーから QBR の回答を取得できます。

詳しい説明は pain-point.md をご覧ください。

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode を利用できません）が接続できるのは、HTTPS 経由のリモート MCP サーバーだけです。そのため、QuoteWerks MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードはトークンを確認しますが、リクエストサイズや実行時間の制限がまだありません。コネクターを再配布するまでは実行したり、トンネルの背後に配置したりしないでください。その理由は mcp-install.md のセキュリティに関する注記で説明しています。それまでは Claude Desktop、Claude Code、または Codex をご利用ください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini でも使えますか？

はい。いずれも MCP に対応しています。ほかのツールへのインストールコマンドは、上記の一覧表と docs/which-agent.md の詳しい説明をご覧ください。

コーディングの知識は必要ですか？

いいえ。推奨されるインストール方法は、Claude Code または Codex に 1 文を貼り付けることです。エージェントが SKILL.md を読み込み、インストールを実行します。別の方法として、OS ごとに 1 行のインストーラー（bash または PowerShell）もあります。どちらの方法でも、コードを書く必要はありません。QuoteWerks の認証情報を一度入力するだけです。

QuoteWerks のデータは安全ですか？

データはお使いのマシン内に保持されます。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーはユーザーアカウント内のディレクトリに保存されます。AI エージェントに見えるのは CLI が返すデータだけで、通常はクエリ結果であり、生の一括データではありません。API キーは環境変数、エージェントの設定、または quotewerks-cli auth set-token で保存した場合は CLI の認証情報ファイル（モード 0600）から読み込まれます。MSP Skills によってこのリポジトリに含められたり、外部に送信されたりすることはありません。

QuoteWerks Desktop でも使えますか？

QuoteWerks がベータ版と位置付けている qwwapi.quotewerks.com の QuoteWerks Web REST API を通じて、QuoteWerks Web で利用できます。QuoteWerks Desktop のデータベースを開いたり、デスクトップ COM API を使ったりすることはありません。

必要な API キーは何ですか？ AI は見積書を変更できますか？

QuoteWerks Web の Setup > Options > Zapier and API でキーを作成してください。API の利用には MasterRights を持つユーザーが必要です。Allow write access を有効にしていないキーでは読み取りはできますが、変更はできません（QuoteWerks は書き込みに対して 403 を返します）。書き込みを有効にしたキーでも、docs create、items add、items reprice、requote は --confirm を追加するまでプレビューのみです。tables insert、tables update、tables delete の生のコマンドは即時に送信されるため、書き込みが必要でない限り、キーは読み取り専用にしてください。

QuoteWerks API に過剰な負荷がかかりませんか？

いいえ。margin、winrate、pipeline、cost-drift、changes は、quotewerks-cli mirror が作成するローカルコピーを読み取るため、追加の API 呼び出しを行わずに、好きなだけ質問できます。mirror はリクエストごとに 1,000 行を読み取り、デフォルトではサーバーのレート制限ヘッダーに合わせてリクエストの間隔が調整されます。

QuoteWerks Web 独自の AI エージェントとはどう違いますか？

QuoteWerks Web には独自の AI エージェントがあり、このスキルからそれに質問することもできます（quotewerks-cli agent ask）。このスキルが追加するのは、普段お使いの AI から利用できる機能です。プレビュー付きの見積書作成と価格再設定、見積書を送付する前の明細ごとの監査、ミラーリングされたすべてのドキュメントにわたる分析を提供します。QuoteWerks Web を補完するものであり、置き換えるものではありません。

費用はいくらですか？

無料です。Apache-2.0 ライセンスです。費用がかかるのは、お使いの AI エージェント（Claude、ChatGPT、Codex など）の利用料のみで、請求は当社ではなく AI プロバイダーから行われます。

安全性モデル

レベル	例	推奨されるエージェントのポリシー
読み取り	docs search、docs get、docs lint、items list、products search、tables の読み取りコマンド（list、rows、row、query、schema、values）、cloud-settings の読み取りコマンド、reports run、identity userinfo、agent ask（および CLI 専用の import agent。同じ AI エージェントに質問を記載した JSONL ファイルを送信します）、ミラーレポート（margin、pipeline、cost-drift、winrate、changes）。mirror と sync が書き込むのはローカルコピーのみです	許可する
プレビュー付きの書き込み	docs create、items add、items reprice、requote：いずれもデフォルトではプレビューのみで、--confirm と書き込みが有効なキーを使った場合にのみ書き込みます	エージェントによるプレビューを許可し、--confirm を付けて再実行する前に人間が承認します
生の書き込み	任意のテーブルに対し、キーに書き込み権限があれば即時に送信する tables insert と tables update（CLI 専用で、MCP ツールではありません）	--dry-run でプレビューしてから、レビュー済みの書き込みを行います
破壊的操作／認証情報	tables delete（CLI 専用。ドキュメントを含む任意のテーブルの行を削除します）、auth set-token、auth logout	必ず人間が介在します

最も強力な制御策は、作成するキーです。Allow write access をオフのままにしておけば、エージェントが実行するコマンドによって見積書が変更されることはありません。CLI が実行できるのは、キーに許可された操作だけです。制限方法を含む詳細については、governance.md をご覧ください。

ステータス

ベータ版です。また、このツールが呼び出す QuoteWerks Web REST API もベータ版です。ベンダーが公開している API 仕様とドキュメントに基づいて構築し、API のローカル代替環境に対してテスト済みです。実際の QuoteWerks Web テナントではまだ実行されていません。毎週の Build Sessions で、MSP が自社の本番テナントに対して実行する検証を進めています。compoundingteams.com/build-sessions から参加登録してください。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025 年 12 月。40 以上のエージェント）に準拠しています。MCP に対応しており、Hermes を含む、MCP 対応エージェントで動作します。OpenClaw に対応済みです（frontmatter は事前設定済みで、OpenClaw のローンチを待っています）。

Servosity が保守しています。Apache-2.0 ライセンスです。CLI Printing Press を使用して構築されています。最終更新日：2026-10-14。