Sherweb MCP

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

非公式です。Sherweb API向けの、コミュニティが開発したClaude Code SkillおよびMCPサーバーです。Sherweb Inc.とは提携しておらず、同社の推奨や支援を受けていません。

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

Sherweb Partner APIのあらゆる機能に加え、ローカルのSQLiteストア、オフライン分析、他のSherwebツールにはないマージン／ドリフト／孤立データの結合に対応しています。すでにお使いの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上であっても実行しないでください。 このビルドにはパスワードがなく、すべてのネットワークインターフェースで リッスンし、ブラウザーのリバインディング対策が実装される前のものです。 そのため、開いたWebページから接続できてしまいます。また、MCPツールは お使いの認証情報を使って変更を加えることもできます。デフォルトのstdio トランスポートを使用してください。リモートエージェント用にトンネルを設定した場合は、 停止してください。修正は準備中です。

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

お使いのAIエージェント	Sherwebスキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensionsからsherweb-mcpを登録します（JSONの編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再公開されるまで一時停止中です。ChatGPTにはHTTPモードが必要ですが、このビルドではこのモードにパスワードがなく、すべてのネットワークインターフェースでリッスンし、開いたWebページから接続できてしまいます。mcp-install.mdのセキュリティに関する注意をご覧ください。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、serversキーの下にあるmcp.jsonにsherweb-mcpを追加してから、Agentモードを選択します。

ChatGPTにはリモートのHTTPSサーバーが必要であり、そのためにこのコネクターのHTTPモードを使用します。このビルドではそのモードにパスワードがなく、すべてのネットワークインターフェースでリッスンし、開いたWebページから接続できてしまうため、コネクターが再公開されるまで利用を一時停止しています。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

Claude Desktop バンドル： .mcpb は macOS（Intel および Apple Silicon）、Windows x64、Linux x64 で起動します。すべてのツールは、付属の sherweb-cli をシェルから呼び出します。2026-09-18 以降にリリースされたバンドルには、この CLI が含まれています。それ以前のバンドルには MCP サーバーのみが含まれるため、付属の CLI がない場合は、先に以下の方法 A または方法 B のインストーラーを実行するか、SHERWEB_CLI_PATH に既存のバイナリへのパスを設定してください。詳細：＃331。

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

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

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

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

これを Claude Code、Codex CLI、または Claude Cowork にコピーします：

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

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

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

sherweb-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop の .mcpb を使っている場合：最新の .mcpb（このセクションの冒頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインを使っている場合：/plugin update sherweb@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 パネルから設定するのが最も簡単です。JSON を編集したいユーザー向けの MCP 設定ブロックは、mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から：

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

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

/skills install servosity/msp-skills/skills/sherweb --force

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

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使用できます）。

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

OpenClaw はまだ一般公開されていません。frontmatter の接続設定は事前に組み込まれており、OpenClaw のリリースと同時に有効になります。

認証する

CLI に必要な認証情報を設定します（Sherweb ポータルから取得してください）。

SHERWEB_CLIENT_ID=<value> SHERWEB_CLIENT_SECRET=<value> SHERWEB_OAUTH_SCOPE=<value> SHERWEB_SUBSCRIPTION_KEY=<value> sherweb-cli doctor

doctor は、データにアクセスする操作を実行する前に、認証情報が有効かどうかを確認します。認証情報が拒否された場合でも終了コード 0 を返すため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSP からよく寄せられる質問	コマンド
今月の顧客ごとの純利益率（売掛金から買掛金を差し引いた額）はいくらですか？	sherweb-cli margin --month 2026-04
顧客のアカウントが赤字になる前に、月ごとに利益率が低下しているのはどの顧客ですか？	sherweb-cli margin-trend --last 6
Sherweb への支払いは発生しているのに、顧客に請求していない有効なサブスクリプションはどれですか？	sherweb-cli orphans
顧客に再請求していない従量制の利用料金を、どこで負担していますか？	sherweb-cli usage-leak
実際の使用数を上回るライセンス数の料金を支払っているサブスクリプションはどれですか？	sherweb-cli right-size
前回の同期以降、買掛金の請求額にどのような変更がありましたか？	sherweb-cli drift
今月、顧客全体で追加、キャンセル、または数量変更されたものは何ですか？	sherweb-cli sub-changes --since 30d
すべての顧客を合わせると、各製品のライセンス数はいくつですか？	sherweb-cli fleet-subs --product "Microsoft 365"
変更を申請する前に、ライセンス数の変更にかかる費用を確認できますか？	sherweb-cli amend-preview --sub "SUB123" --qty 25

全コマンドのリファレンスは guide.md を参照してください。AI エージェントの運用契約（--agent、--dry-run、変更を実行する前に確認するタイミング）については、AGENTS.md を参照してください。

このスキルの特徴

多くの Sherweb 連携機能や MCP サーバーは、質問ごとにライブ API 呼び出しを行います。単一のレコードを確認するなら問題ありません。しかし、「今月、顧客 80 社全体の純利益率はいくらか」のような質問では、Distributor の請求エンドポイントと、顧客ごとの売掛金請求額、サブスクリプション、利用状況を一社ずつ結合する必要があり、データ量が増えると処理が成り立たなくなります。

このスキルは Sherweb のデータを、全文検索に対応したローカルの SQLite ミラーに同期します。集計に関する質問は、ローカルでの単一の SQL 結合で処理されるため、即座に、オフラインでも実行でき、AI には生データではなく回答が返されます。margin、orphans、usage-leak などの複合コマンドでは、買掛金の請求額、売掛金の請求額、サブスクリプション、従量制の利用状況を結合します。こうした処理は、ステートレスな API ラッパーでは実行できません。

このスキルで解決できる課題

Sherweb Partner APIでは、請求情報が2つのAPIに分かれています。Distributor APIは支払対象の料金（Sherwebに支払う金額）を返し、Service Provider APIは請求対象の料金とサブスクリプション（顧客に請求する金額）を返します。両方をまとめて表示するポータル画面がないため、毎月の締め処理では、顧客ごとの純利益率をスプレッドシートで手作業で再計算することになります。MSPでよくある「ライセンスの増えすぎ」のケースでは、顧客がライセンス数を減らしてもSherweb側のサブスクリプションは有効なままで、顧客に請求できないライセンスの料金を払い続けてしまいます。このスキルは、同期済みのミラーから次のようにこのギャップを埋めます。

• sherweb-cli margin - 顧客ごとの純利益率（請求対象額から支払対象額を差し引いた額）を、利益率の低い順に表示します。
• sherweb-cli orphans - 請求対象の料金が0の有効なサブスクリプションを表示します。料金を支払っているのに請求していないライセンスです。
• sherweb-cli usage-leak - 対応する請求対象の料金がない従量課金の利用分を表示します。コストを自社で負担している利用分です。
• sherweb-cli right-size - 購入済みのライセンス数と、計測された利用数が異なるサブスクリプションを表示します。
• sherweb-cli margin-trend --last 6 - 最近の締め処理における顧客ごとの利益率を、低下幅が大きい順に表示します。

詳しい説明は痛点の解説をご覧ください。

よくある質問

ChatGPTで使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Educationプラン。FreeではまだDeveloper Modeを利用できません）は、HTTPS経由のリモートMCP サーバーにのみ接続します。そのため、Sherweb MCP サーバーをHTTPモードで実行する必要があります。このビルドのHTTPモードはパスワードを要求せず、すべてのネットワークインターフェイスでリッスンし、開いたWebページからアクセスできるため、コネクターを再配布するまでは実行したり、トンネルの背後に配置したりしないでください。その理由は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）もあります。どちらの方法でもコードを書く必要はありません。Sherwebの認証情報を一度入力するだけです。

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

データはお使いのマシンに保存されます。CLIとMCP サーバーはローカルバイナリです。SQLiteミラーはユーザーアカウント内のディレクトリに保存されます。AI エージェントに見えるのはCLIが返すデータだけで、通常は生の一括データではなくクエリ結果です。認証情報は環境変数またはエージェントの設定から読み込まれます。このリポジトリに含まれたり、MSP Skillsによってどこかに送信されたりすることはありません。

Sherwebのパートナーである必要がありますか？また、どの認証情報を使用しますか？

はい。ご自身のパートナー認証情報を使い、組み合わせ認証でSherweb Partner APIにアクセスします。ベアラートークン用に、OAuth2のクライアント認証情報であるClient IDとSecret（スコープ付き）が必要です。さらに、すべての呼び出しに付与するAPIMゲートウェイのサブスクリプションキーも必要です。OAuth2アプリケーションを作成し、cumulus.sherweb.comのSecurity > APIsからサブスクリプションキーをコピーして、SHERWEB_CLIENT_ID、SHERWEB_CLIENT_SECRET、SHERWEB_OAUTH_SCOPE、SHERWEB_SUBSCRIPTION_KEYを設定します。実際の境界となるのは認証情報自体に付与された権限です。AIがアクセスできる範囲に合わせてスコープを設定してください。

Sherweb APIのレート制限に達しますか？

deep-syncの実行後、分析コマンド（margin、margin-trend、orphans、usage-leak、right-size、drift、sub-changes、fleet-subs、amend-preview）はローカルのSQLiteミラーに対して実行されるため、API呼び出しは0回です。ライブ呼び出しでは--rate-limitによるスロットリングが適用されます。また、syncは再開可能な増分同期で、前回のチェックポイント以降に変更されたデータだけを取得します。

Sherweb ポータルの代わりになりますか？

いいえ。プロビジョニング、注文、サブスクリプション管理は引き続きポータルで行います。このスキルは、ポータルでは一か所にまとめて確認できない、エンティティを横断したマージンや請求に関する質問（純利益率、孤立したサブスクリプション、使用量の漏れ、シート数の適正化）に、ターミナルまたはエージェントから答えます。

費用はいくらですか？

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

安全性モデル

ティア	例	推奨されるエージェントのポリシー
読み取り	margin、margin-trend、orphans、usage-leak、right-size、drift、sub-changes、fleet-subs、amend-preview、distributor、および service-provider list-* / get-* / validate-order クエリ	許可
書き込み（定型）	service-provider amend-subscriptions（シート数の変更）、service-provider place-order（マーケットプレイスでの注文）、import（各レコードを POST）— 書き込みは即時に送信されます。--dry-run は任意で実行するプレビューであり、デフォルトではありません	--dry-run でプレビューしてから、内容を確認したうえで書き込む
破壊的操作／認証情報	service-provider cancel-subscriptions（顧客のサブスクリプションをキャンセル）、auth login / auth logout / auth set-token（認証情報の変更）	必ず人間が介在する

最も強力な制御手段は、Sherweb の認証情報に付与するスコープです。CLI で実行できるのは、認証情報で許可されている操作だけです。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。Sherweb API の仕様に対して検証済みであり、毎週の Build Sessions では、MSP が自身の本番テナントに対して実際に運用しながら検証を進めています。compoundingteams.com/build-sessions で参加をお申し込みください。

---

標準規格。 オープンな Agent Skills 仕様（Anthropic、2025 年 12 月、40 以上のエージェント）に準拠しています。MCP 互換で、Hermes を含む、MCP 対応のあらゆるエージェントで動作します。OpenClaw に対応済みです（frontmatter は事前設定済みで、OpenClaw の公開待ちです）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press を使用して構築されています。最終更新：2026-06-06。