Kooga について
Koogaは、企業とそのAIアシスタント向けのホスト型マーケティングMCPサーバーです。店舗、検索、AI可視性、メールのデータを扱い、Kooga外への変更や取り消せない操作には事前確認を求めます。
主な機能
- 01店舗と売上のレポート
- 02検索順位とトラフィック分析
- 03AI可視性と競合の追跡
- 04メールキャンペーンとフローの管理
- 05外部・取り消し不能な操作の確認
活用シーン
- 01検索流入が減った記事の特定
- 02店舗、メール、AI可視性の成果比較
- 03キャンペーンや顧客フローの下書き
- 04Koogaエージェントの保留中操作の確認
MCP 対応
`https://mcp.kooga.io/mcp`でStreamable HTTP対応のホスト型MCPサーバーを提供し、OAuth 2.1またはアクセストークンで認証します。接続クライアントにマーケティングツール、4つのプロンプト、用語集リソースを公開します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.kooga.io/mcpclaude mcp add --transport http io-kooga-kooga https://mcp.kooga.io/mcp{"mcpServers":{"io-kooga-kooga":{"type":"http","url":"https://mcp.kooga.io/mcp"}}}Cursor で開く{"servers":{"io-kooga-kooga":{"type":"http","url":"https://mcp.kooga.io/mcp"}}}VS Code で開く{"mcpServers":{"io-kooga-kooga":{"type":"http","url":"https://mcp.kooga.io/mcp"}}}{"mcpServers":{"io-kooga-kooga":{"serverUrl":"https://mcp.kooga.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
Kooga
ビジネスのマーケティングを、AI アシスタントで。
ドキュメント · すべてのツール · 料金 · プライバシー
売上、Google の検索順位、AI での可視性、メールの状況について尋ねると、Kooga が記事の執筆やキャンペーンの下書きを行い、エージェントがあなたに残した内容に回答します。Kooga から外部に送信されるものは、すべて事前に確認を求めます。Kooga プラグインには、ホスト型 MCP 接続と、アシスタントが効果的に活用できるようにするワークフロースキルが含まれています。
- サーバー:
https://mcp.kooga.io/mcp、Streamable HTTP - サインイン: OAuth 2.1(動的クライアント登録、PKCE)、またはアクセストークン
- レジストリ名:
io.kooga/kooga
対応サービス
| サービス | Kooga ができること | |
|---|---|---|
| Shopify | 注文、商品、顧客、商品リスティングを読み取り、ストアのブログに記事を公開します | |
| WordPress と WooCommerce | WooCommerce の注文と商品を読み取り、サイトに記事を公開します | |
| Google Search Console | クリック数、表示回数、検索クエリを読み取ります。検索結果の1ページ目に届きそうなページや、流入が減っている記事を把握できます | |
| ChatGPT、Claude、Gemini、Perplexity、Google の AI Overviews | 購入者が尋ねる質問を投げかけ、あなたの名前が挙がる頻度、代わりに挙げられる相手、引用される情報源を追跡します |
メールは Kooga 自体から、お客様が所有し認証済みのドメインを使って送信されます。
プラグインをインストールする
Claude Code
/plugin marketplace add HushThrive/kooga-mcp
/plugin install kooga@kooga
新しいセッションを開始し、/mcp を使って Kooga にサインインします。ビジネスについて尋ねるか、/kooga:kooga-mcp を実行します。Claude Code プラグインのドキュメント
Codex
codex plugin marketplace add HushThrive/kooga-mcp
codex plugin add kooga@kooga
新しいセッションを開始し、表示されたら Kooga にサインインします。/skills または $ ピッカーから Kooga を選ぶか、何をすればよいか尋ねてください。Codex プラグインのドキュメント
Cursor
- Settings → Plugins を開きます。
- プラグイン検索ボックスに
https://github.com/HushThrive/kooga-mcpを貼り付けます。 - Kooga をインストールし、表示されたら MCP サーバーに接続してサインインします。
または、上の Cursor に追加 ボタンを使うと、接続のみを追加できます。
VS Code と GitHub Copilot
- 設定で
chat.plugins.enabledを有効にします。 - コマンドパレットから Chat: Install Plugin From Source を実行します。
https://github.com/HushThrive/kooga-mcpを入力し、Kooga をインストールします。- 新しいチャットを開始し、求められたら Kooga にサインインします。
または、上の Install in VS Code ボタンを使うか、接続のみの場合は code --add-mcp '{"name":"kooga","type":"http","url":"https://mcp.kooga.io/mcp"}' を実行します。
Claude と ChatGPT
- Claude(ウェブ版とデスクトップ版):Settings → Connectors → Add custom connector を選び、名前に Kooga を指定して
https://mcp.kooga.io/mcpを貼り付け、Connect をクリックします。 - ChatGPT:開発者モードを有効にし(有料プランが必要です。Business または Enterprise では管理者による許可が必要です)、アドレスに
https://mcp.kooga.io/mcp、サインイン方法に OAuth を指定してコネクターを追加します。
その他のアシスタント
Streamable HTTP 経由で、アドレス https://mcp.kooga.io/mcp のリモート MCP サーバーを追加します。サーバーは Kooga が稼働させるため、お使いの環境にインストールしたり実行したりするものはありません。MCP Inspector で試すには、npx @modelcontextprotocol/inspector を実行します。
お使いのアシスタントがスタンドアロンのスキルに対応している場合は、ワークフローのガイダンスを個別に追加できます。
npx skills add HushThrive/kooga-mcp --skill kooga-mcp
これは指示のみをインストールするため、接続は別途追加してください。ガイダンスが重複しないよう、プラグインとスタンドアロンのスキルのどちらか一方を選んでください。
アカウントを接続する
接続するワークスペースのオーナーまたは管理者として、Kooga アカウントが必要です。
- アシスタントがサーバーに初めて接続すると、Kooga のサインイン画面が開きます。
- アクセスを許可するワークスペースにチェックを入れ、Read only または Read and change を選択して、Allow をクリックします。
- どのワークスペースにアクセスできるかを確認してください。1 つの接続で複数のワークスペースにアクセスできるため、代理店に適しています。
n8n、Make、スクリプト、またはサインインページを開けないクライアントでは、Kooga の Settings → Connected apps → Access tokens でアクセストークンを作成します。トークンは kooga_pat_ で始まり、表示されるのは一度だけです。ベアラーヘッダーに指定します。
claude mcp add --transport http kooga https://mcp.kooga.io/mcp --header "Authorization: Bearer kooga_pat_..."
トークンは、チェックを入れたワークスペースでご本人として機能し、同じ確認と制限が適用されます。クライアントの認証情報設定に保管し、パスワードと同様に取り扱ってください。すべての接続は Settings → Connected apps に一覧表示され、切断できます。
試してみる
- 「Kooga で対応待ちになっていることは何ですか?」
- 「今週、ストアで何が変わりましたか?」
- 「トラフィックが減少している記事と、最初に更新すべき記事を教えてください。」
- 「AI の回答で、競合他社と並んで当社が言及される頻度はどれくらいですか?」
- 「カート放棄フローの下書きを作成してください。1 時間後にリマインダーを送り、翌日にもう一度送ります。」
- 「3 月と 2 月を比較してください。注文数、メールの成果、AI での認知度を確認します。」
ツール
| 領域 | 読み取り | 変更 |
|---|---|---|
| 接続 | readConnection, listWorkspaces | |
| エージェント | readWaitingItems, readRecentRuns, readStatus | approveItem, dismissItem, undoAction |
| ストア | readStoreOverview, readTopProducts, readProducts, readSalesTrend, readSalesChannels, readCustomerStats | updateListing |
| Google 検索 | readOpportunities, readDecaying, readRankings, readBacklinks, readSiteHealth, researchKeywords, readListings, readIdeas | generateArticle, refreshArticle, publishArticle, trackKeyword |
| AI の可視性 | readScorecard, readTopics, readCompetitors, readSources, readPerceptions, readAnswers, readShelf | addPrompt, addCompetitor, briefContentGap, proposeProbe |
| メール | readPerformance, readDeliverability, readCampaigns, readCampaign, readFlows, readSegments, previewSend, findContacts, readContact | draftCampaign, updateCampaign, scheduleCampaign, sendTestCampaign, resendCampaign, deleteCampaign, draftFlow, updateFlowStep, enableFlow, createSegment, updateContact, unsubscribeContacts, uploadImage, updateEmailBrand |
| ナレッジ | searchDocuments, readDocument, listDocuments, readOptions | |
| ストアのチャット(有効化した場合) | readCustomerInbox, readCustomerFeedback |
接続されたサーバーのツール一覧が正となります。読み取り専用の接続では読み取りツールのみを利用でき、ストアのチャットに購入者が書き込んだ内容を読み取るツールは、有効化した場合にのみ表示されます。各ツールの入力と出力については、ツールリファレンスおよびkooga.ioをご覧ください。
サーバーには、すぐに使える4つのプロンプト(アカウント監査、月曜日のレビュー、最も弱いトピックの改善、競合レーダー)と、Koogaの用語集がリソース kooga://glossary として用意されています。
実行前に確認する操作
Kooga内で完結する操作は、Koogaで操作した場合と同じように、そのまま実行されます。Koogaの外に影響する操作や、取り消せない操作については、Kooga独自の言葉で事前に確認を求められます。
flowchart LR
A[You ask for a change] --> B{Leaves Kooga, or cannot be undone?}
B -- No: a draft, a segment, a tracked keyword --> C[Done in Kooga]
B -- Yes: publish, send, change the live store --> D[Kooga asks you]
D -- Yes --> E[Done, once]
D -- No --> F[Nothing happens]
アシスタントが確認を表示できる場合はその場で表示し、できない場合はチャットで確認します。「はい」と答えると、操作が1つ実行されます。商品リスティングや公開済みの記事など、何かを置き換えた変更は、その後に変更が加えられていなければ元に戻せます。送信済みのメールは元に戻せません。Koogaは資金を移動したり、プランを変更したり、誰かを登録したりすることはありません。
トラブルシューティング
| 症状 | 次の手順 |
|---|---|
| 再度サインインするよう求められる | セッションが終了したか、アプリの接続が切れています。アシスタントから再接続してください |
| 「この接続は読み取り専用です」 | 再接続して、読み取りと変更を選択してください |
| 「この接続には複数のワークスペースが紐付けられています」 | 対象のワークスペースを指定してください。アシスタントで一覧を表示できます |
| 新しいツールまたはプロンプトが表示されない | アシスタントでコネクターのツールを更新するか、再接続してください |
| 「このワークスペースにはストアが接続されていません」 | 設定 → インテグレーションでShopifyまたはWooCommerceを接続してください |
| 「この接続では顧客メッセージがオフになっています」 | オーナーまたは管理者が設定 → 接続済みアプリで有効にしてください |
| 「1日の上限に達しました」 | アシスタントの1日あたりの上限に達しています。残りの操作はKoogaで行うか、時間をおくか、設定 → 接続済みアプリで上限を引き上げてください |
| 「リクエストが多すぎます」 | 1分ほど待つか、1つの質問に複数の依頼をまとめてください |
プライバシー
- アシスタントに送られる情報:アシスタントが検索する情報(店舗の数値、記事、連絡先、および有効にした場合に限り、買い物客が店舗のチャットに書き込んだ内容)は、そのアシスタントを運営する会社に送信されます。その会社の規約が適用されます。
- Kooga が保持する情報:各リクエストの記録(誰がリクエストしたか、どのアプリか、どのワークスペースか、どのツールか、正常に処理されたかどうか)を保持します。送信された内容や返された内容は保持しません。記録は Settings → Connected apps で確認でき、各項目は 180 日後に削除されます。
- アクセスできる人と情報:アシスタントはお客様のアカウント用に発行されたトークンでサインインし、パスワードを見ることはありません。ワークスペースへのアクセス権を失った人は、同時にそのワークスペースへのアシスタントのアクセス権も失います。
- 外部からのテキスト:買い物客、他のサイト、AI エンジンが書いた内容は、指示ではなく情報として明示されたうえでアシスタントに送られます。
ポリシー全文は kooga.io/privacy-policy にあります。
このリポジトリについて
サーバーは Kooga がホストしているため、このリポジトリにサーバーコードは含まれていません。アシスタントやディレクトリがインストールして掲載するために必要なものが含まれています。
| ファイル | 内容 |
|---|---|
plugin.json、mcp.json | ポータブルプラグインとその MCP 接続(streamable-http) |
.mcp.json | 同じ接続のネイティブ形式(http) |
.claude-plugin/、.codex-plugin/、.cursor-plugin/ | 各アシスタント専用のマニフェスト。.claude-plugin/marketplace.json と .agents/plugins/marketplace.json により、このリポジトリ自体をマーケットプレイスとして利用できます |
skills/kooga-mcp/ | ワークフロースキル、そのツールリファレンス、Kooga のロゴ |
server.json | .github/workflows/publish.yaml によって変更時に公開される MCP Registry のエントリー io.kooga/kooga |
lhm.plugin.json | LobeHub の掲載情報 |
ヘルプ
- セットアップと使い方:Kooga のドキュメント
- アカウントまたは接続について:[email protected]
- ここにある誤った指示やメタデータについて:issue を作成してください。トークンや顧客データは含めないでください。
- 脆弱性や漏えいしたトークンについては、SECURITY.md をご覧ください。
このリポジトリ内のファイルは MIT ライセンスのもとで公開されています。Kooga 自体は、利用規約に基づくホスト型サービスです。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。