Cork MCP

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

非公式です。Cork API 向けにコミュニティが開発した Claude Code Skill と MCP サーバーです。Cork とは提携しておらず、承認やスポンサー提供も受けていません。 Cork および Cork Vantage は Cork Protection, Inc. の商標です。

Cork API のすべての操作に加え、クライアントをまたいだリスクの特定、悪用可能性を優先した脆弱性のトリアージ、コンプライアンス期限超過の検出、古くなったコネクターの健全性チェックにも対応します。ステートレスな API ミラーでは、これらに単一の呼び出しで回答できません。すでにお使いの 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 オーナー向けに開発されており、コードは不要です。

お使いのエージェントで利用できます

セキュリティに関する注意（このコネクターが再公開されるまで）。 この コネクターを supergateway ブリッジや、その他の stdio から HTTP へのブリッジの背後に置かないでください。 localhost 上であっても同様です。ブリッジにはパスワードが設定されないため、そのポートにアクセスできる人なら誰でも、 お客様の認証情報を使って MCP ツールを利用できます。デフォルトの stdio トランスポートを使用してください。リモートエージェント向けにブリッジやトンネルを設定した場合は、停止してください。 修正を準備中です。

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

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

ChatGPT にはリモート HTTPS サーバーが必要です。このコネクターは stdio のみで通信するため、パスワードを追加しない stdio から HTTP へのブリッジが必要になります。この方法は、コネクターが再公開されるまで一時停止中です。mcp-install.md のセキュリティに関する注意を参照してください。

Microsoft および Google の環境でも利用できます

導入先は多くありますが、率直にお伝えすると、こちらはリモート／エンタープライズ向けの方法であり、インストールしたローカルバイナリを使う方法ではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再公開されるまで一時停止中です。Copilot Studio には HTTPS サーバーが必要ですが、この stdio 専用ビルドにはパスワードを追加しない stdio から HTTP へのブリッジが必要になります。mcp-install.md のセキュリティに関する注意を参照してください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同様です。Gemini アプリはリモートで動作し、ChatGPT と同じく一時停止中のリモート接続方法が必要です。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 Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールします。

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

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

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

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

このプロンプトは、シェルを実行できるどのエージェントでも使えます。

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

Windows（PowerShell）：

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

macOS / Linux：

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

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

確認：

cork-cli --version

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

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

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Code プラグインのユーザー：/plugin update cork@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/cork --force

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

/skills install servosity/msp-skills/skills/cork --force

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

OpenClaw にインストールする

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

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

OpenClaw はまだ一般公開されていません。frontmatter の接続設定はあらかじめ含まれており、OpenClaw のリリースと同時に有効になります。

認証する

CLI に必要な API キーを設定します（Cork ポータル > Settings > API Keys）。

export CORK_API_KEY=<your key>
cork-cli doctor

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

Cork キーについて、あらかじめ知っておくべき特徴があります。API キーには、そのキーを作成したユーザーの権限が引き継がれます。 ディストリビューターまたはインテグレーションのエンドポイントで 403 が発生した場合、通常はキーが間違っているのではなく、そのスコープを持たないオペレーターによってキーが作成されたことを意味します。この特徴は、最も有効な制御手段でもあります。読み取り専用の作業には、読み取り専用キーを作成してください。governance.md を参照してください。

質問する前に同期する

search、score regressions、およびその他いくつかのコマンド内のクライアント一覧参照は、ローカルミラーを読み取ります。最初に一度、データを取り込みます。

cork-cli sync

sync は Cork API に対して読み取り専用（GET リクエストのみ）で、ユーザー自身のアカウント配下の SQLite ファイルに書き込みます。より新しいデータが必要なときは、いつでも再実行してください。コマンドは、予期しないデータに基づいて回答するのではなく、ミラーが古くなっていることを知らせます。

このスキルでできること

MSP からよく尋ねられる質問	コマンド
このクライアントのリスクスコアが変動した理由と、変動の原因となったコンポーネントは何ですか？	cork-cli score attribute <client-uuid> --since 30d
全クライアントの中で、今週最も状況が悪化したのはどのクライアントですか？	cork-cli score regressions --since 7d
実際に悪用されている状況を基準に、最初にパッチを適用すべきものは何ですか？	cork-cli vulnerabilities triage
アドバイザリで CVE が挙げられました。影響を受けているか、また影響箇所はどこですか？	cork-cli vulnerabilities exposure CVE-2023-21608
修復期限を過ぎたコンプライアンスイベントはどれですか？	cork-cli compliance overdue
正常と報告されているのに、同期が停止したコネクターはどれですか？	cork-cli integrations health
オンボーディング後、このクライアントは完全に監視されていますか？	cork-cli coverage gaps --client <client-uuid>
保証がないクライアントのうち、最もリスクを抱えているのはどれですか？	cork-cli warranties exposure
認証と接続は実際に機能していますか？	cork-cli doctor

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

このツールの特長

Cork 独自のツールは、ステートレスな REST API のミラーであり、現時点の単一クライアントについてのみ回答します。MSP が実際に尋ねる質問はすべて、クライアント横断、時系列、またはその両方に関するものです。Cork API にはクライアント横断の集計エンドポイントが一切ないため、こうした質問にリアルタイムで答えるには、全クライアントへのファンアウトが必要であり、比較用に保存された過去のデータもありません。

このスキルは Cork のデータをローカルの SQLite ミラーに同期し、ファンアウトとデータの結合を代わりに実行します。そのため、「リスクスコアが下がった」が「コンプライアンスの変動が原因でリスクスコアが下がりました。原因となった期限超過イベントはこちらです」という回答になります。手作業でクライアントごとに確認する代わりに、1 つのコマンドで確認できます。

ローカルミラーだけで回答するのは score regressions のみです。必要なレコードにミラー可能な ID がないため、残りの 7 つのコマンドは実行のたびに Cork API からデータを取得します。対象となるのは、脆弱性の検出結果、コンプライアンスイベント、コネクターの状態、スコア履歴です。これらのコマンドのうちいくつかは、クライアント一覧の取得にミラーを使用して、ライブの /clients ファンアウトを省略します。ミラーが空の場合は、ライブの一覧取得にフォールバックします。どのコマンドもスキャン範囲に上限を設けており、スキャンが途中で打ち切られた場合はその旨を表示するため、誤って問題なしと報告することはありません。

解決する課題

• QBR の間にスコアが 11 ポイント下がりました。Cork はタイムスタンプごとの 4 つのコンポーネントを返しますが、差分は計算しないため、担当者が 2 つのスナップショットを書き出して手作業で差し引いています。cork-cli score attribute は差分を計算し、原因を順位付けします。
• 「今週、状況が悪化したクライアントはどれですか？」に答えるエンドポイントはありません。cork-cli score regressions は、ローカルのクエリ 1 回で回答します。
• 脆弱性エンドポイントのサーバー側の sort_by で指定できるのは sw_vendor と sw_product のみなので、上流では悪用可能性による並べ替えができません。cork-cli vulnerabilities triage は、悪用が確認された脆弱性、EPSS、CVSS の順に順位付けし、影響範囲を示すデバイス数も表示します。
• cve_id は cves[] の中にネストされた形でしか存在せず、ページサイズにかかわらず、CVE フィルターを受け付けるエンドポイントはありません。cork-cli vulnerabilities exposure は、「この CVE の影響を受けていますか？」に直接回答します。
• コネクターは connection_status: ok と報告しているのに、last_synced_at は数日前のままです。両方のフィールドは同じペイロードで提供されますが、タイムスタンプを現在時刻と比較する仕組みはありません。cork-cli integrations health は、正常に見えて実際には停止しているコネクターを検出します。

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

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free ではまだ Developer Mode を利用できません）が接続できるのは、HTTPS 経由のリモート MCP サーバーのみです。Cork MCP サーバーは stdio のみで通信するため、前段に stdio から HTTP へのブリッジを置く必要がありますが、ブリッジにパスワードは追加されません。コネクターが再公開されるまでは、セットアップしたり、トンネルの背後に配置したりしないでください。その理由は mcp-install.md のセキュリティに関する注意事項で説明しています。それまでは、Claude Desktop、Claude Code、または Codex をお使いください。

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

はい。いずれも MCP に対応しています。各ツールでのインストールコマンドは上記の一覧に、詳しい説明は docs/which-agent.md にあります。

コードの知識は必要ですか？

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

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

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

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

一部は達する可能性があります。sync はローカルの SQLite ミラーを作成し、search と score regressions は API にアクセスせず、そのミラーから回答します。export は該当しません。ライブ API をページネーションしながら読み込むため、ここで最も負荷の高い処理の一つです。すべてを取得する意図がない場合は、--limit を指定してください。その他の 7 つの分析コマンドは、実行のたびにライブデータを取得します。そのうち 2 つは、coverage gaps がコネクターごとに、compliance overdue がクライアントごとに処理を展開するため、特に注意が必要です。各コマンドは独自のスキャン上限（--max-clients、--max-connectors、--max-scan-pages）を設けており、結果を途中で切り上げた場合は通知します。Cork はレート制限を公開していません。そのため、これらの上限を設けています。

一部のコマンドで Cork キーが 403 エラーになるのはなぜですか？

Cork API キーには、作成したユーザーの権限が引き継がれます。ディストリビューターやインテグレーションのエンドポイントで 403 が発生する場合、通常はキーが間違っているのではなく、必要な権限を持たないオペレーターがキーを作成したことを意味します。

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

いいえ。ポータルを補完するものです。インテグレーションの設定や個別のクライアントの確認には、引き続きポータルを使います。このスキルは、ポータルでは何度もクリックして確認する必要がある、スコアの帰属、回帰のランキング、悪用可能性のトリアージ、古いコネクター、カバレッジの不足といった複数クライアントにまたがる質問に、AI から回答します。

費用はかかりますか？

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

安全モデル

ティア	例	推奨されるエージェントポリシー
読み取り	score attribute、score regressions、vulnerabilities triage、vulnerabilities exposure、compliance overdue、integrations health、coverage gaps、warranties exposure、sync、search、export、以下のシークレットを返す読み取り処理を除くすべての list / get	許可
書き込み（定型）	integrations connect、integrations update、integrations resync integration	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
認証情報／セキュリティ	integrations credentials、integrations credentials get-integration（マスキングされず、そのまま出力されます）、integrations raw-data get-integration（追加の認証なしでコネクターの全生データをダウンロードする、署名付き URL を返します）、および integrations update の認証情報フィールド	必ず人間が介在し、すべての読み取りを一律に許可するポリシーでは決して許可しない
破壊的／エンドポイントに影響	integrations delete、software install（RMM 統合を通じて、実際の顧客デバイスにパッケージをインストールします）	必ず人間が介在し、明示的な確認を求める
管理者	distributor provision-partner	オペレーター専用。エージェントには許可しない
一括書き込み	import <resource> --input file.jsonl - 書き込みエンドポイントに対して1行ごとに POST を実行し、失敗しても続行します	必ず人間が介在し、明示的な確認を求める。無人では決して実行しない

このうち3つは Cork 自体の外部に影響します。software install は実際の顧客のマシンの状態を変更し、distributor provision-partner はパートナーアカウントを作成し、import はこれらのエンドポイントのいずれかを1行ごとに POST して一括実行します。手動での RMM プッシュや商用変更と同じものとして扱い、それらにすでに求めている承認を適用してください。

最も強力な制御手段は、Cork API キーに付与するスコープです。CLI で実行できるのは、キーを作成したユーザーに許可されている操作だけです。ロックダウンの方法を含む詳細は、governance.md を参照してください。

ステータス

ベータ版です。コマンド一式すべてを、本番環境の Cork テナントに対してライブで読み取り専用のテストを実施しました。認証と接続、完全な sync、クライアント横断の分析コマンド8つすべて、リソースが見つからない場合の型付き終了コード、MCP stdio ハンドシェイクを検証済みです。変更コマンドは --dry-run のみで実行しており、テナントに対する書き込み呼び出しは行っていません。毎週の 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-08-14。