Watchr

Watchr MCP サーバー

競合インテリジェンスとブランドモニタリングを AI アシスタントに取り込みましょう。Claude、Cursor、または MCP 互換クライアントに、今週競合が何をしたか尋ねられます。回答は Watchr ワークスペースから直接取得されます。

Watchr は、競合インテリジェンスとブランドモニタリングのプラットフォームです。競合他社のウェブサイト、広告、ソーシャル投稿、ニュースなどの情報源を監視し、定義したプロンプトに基づいて各シグナルを評価するため、目にするのはノイズではなく、関連性のある動向です。

このリポジトリでは、Watchr の公式 Model Context Protocol（MCP）サーバーについて説明します。アカウントに紐づくデータと、管理されたアカウントのワークフローを提供します。API キーでは読み取りが可能です。認証済みの OAuth 管理者は、ウォッチリストの設定、メンバーの管理、フィードバックの記録、アカウントタグの管理も行えます。

サーバーは Watchr によってホストされています。ローカルへのインストールも Docker も不要です。クライアントから https://mcp.watchr.ai/mcp に接続して認証するだけです。クライアントに応じて、次の 2 つの方法があります。

• Claude（Desktop / Code）、ChatGPT、Cursor、および Dynamic Client Registration に対応するその他のクライアント向けのワンクリック OAuth。ブラウザーが開いたら承認するだけです。
• エージェント型フレームワークや、MCP を独自の自動化スタックに組み込むカスタム統合向けの個人用 API キー（Watchr ワークスペースで生成）。

---

目次

• できること
• 使用例
• 利用可能なツール
• インサイト応答の仕様
• Watchr の利用開始
• 認証
  • 方法 A。ワンクリック OAuth
  • 方法 B。個人用 API キー
• 設定
  • OAuth クライアント
  • API キークライアント
• 結果を改善する
• サポート

---

できること

接続すると、AI アシスタントに次のようなことを尋ねられます。

• 「今週、競合他社は何をローンチしましたか？」
• 「今月の主要な競合インサイトを 5 件まとめた Slack メッセージを作成してください。」
• 「過去 30 日間に追跡対象ブランドのポジショニングがどう変化したか比較してください。」
• 「過去 1 か月分の HubSpot に関する 1 ページの競合ブリーフィングを、視覚的にわかりやすく作成してください。」
• 「今週の Watchr インサイトを使って、Notion のバトルカードと競合まとめページを自動更新してください。」

MCP サーバーはデータを提供し、アシスタントが推論、文章の作成、ワークフローの他の部分との統合を担います。

使用例

Watchr を通じて最新の HubSpot シグナルを取得する、Claude との短いやり取りです。

同じデータを使い、追加のプロンプトを 1 つ送るだけです。Claude は検証済みの Watchr インサイトから、デザインされた競合ブリーフィングの成果物を直接生成します。

これが基本的な流れです。Watchr が情報を収集して評価し、AI クライアントが推論して出力します。MCP サーバーはその連携を担います。

利用可能なツール

デフォルトのエンドポイントでは、読み取りと書き込みを含む 37 個のツールを利用できます。ChatGPT 専用プロファイルでは、個別に名前が付けられた設定のプレビュー／適用アクションを含む 62 個のツールを利用できます。引数、スキーマ、権限については、実行時の tools/list が正式な情報源です。

ツール	目的
list_monitoring_groups	アクセスできるすべてのモニタリンググループ（ウォッチリスト）を一覧表示します。各グループには、追跡対象のブランドが1つ以上と、関連性の基準を定めるカスタムの判定プロンプトが含まれます。
list_brands	モニタリンググループ内で追跡している競合ブランドを一覧表示します。検索前にブランド名を確認するために使用します。
search_insights	フィルター（ブランド、日付範囲、ソースの種類、フリーテキスト）を使って、検証済みのインサイトを検索します。どのインサイトを開くか判断するための、簡潔な一覧を返します。
get_insight	IDで指定した単一のインサイトの全文を取得します。ソース URL、元のコンテンツ、スクリーンショット、関連性の判断理由、日付、利用可能な場合は関連項目が含まれます。
list_reports	モニタリンググループから送信されたレポートを一覧表示します。
get_report	単一のレポートの全文を取得します。概要、含まれるインサイト、宛先、送信日が含まれます。
get_workspace_context	役割、認証情報のスコープ、実効権限、アカウントの上限を読み取ります。
list_watchr_documentation	製品ガイドとサポートされている機能を確認します。
get_watchr_guide	選択した製品ガイドを読み取ります。
get_monitoring_configuration	ブランド、ソース、目標、関連性、レポートの設定を読み取ります。
diagnose_monitoring	設定の診断情報と、利用可能な場合は記録済みのレポートカウンターを読み取ります。
preview_monitoring_changes	設定変更を適用せず、範囲を限定したプレビューを保存します。
apply_monitoring_changes	権限と利用資格を再確認したうえで、承認済みのプレビューをそのまま適用します。
get_operation_status	操作の進行状況、保留中の確認、部分的な失敗を読み取ります。
set_report_email_delivery	レポート生成とメール配信を組み合わせた設定をプレビューします。
list_workspace_members	アカウントメンバーと保留中の招待を読み取ります。
invite_workspace_member	明示的に承認された役割でメンバーを招待します。
revoke_workspace_invitation	明示的に指定された保留中の招待を取り消します。
update_workspace_member_role	最後の管理者がいなくならないよう保護しながら、メンバーの役割を変更します。
remove_workspace_member	メンバーのアクセス権を削除し、対応する接続を取り消します。
list_insight_tags	アカウントのタグカタログ、定義、バージョンを読み取ります。
check_insight_tag	提案されたタグを検証し、保存せずに重複に関する警告を表示します。
save_insight_tag	アカウントタグを作成、編集、アーカイブ、または再有効化します。
update_insight_tags	範囲を限定したインサイトの一括処理で、タグを追加、削除、または置き換えます。
get_insight_tags	選択したインサイトのタグ、手動除外、分類状態を読み取ります。
get_insight_tag_history	範囲を限定したタグ修正および分類の監査履歴を読み取ります。
create_insight_tag_job	IDと予算上限を指定して、明示的な分類ジョブを準備します。
run_insight_tag_job	ジョブの制限内で、外部モデルの呼び出しを最大1回行い、ジョブを進めます。
get_insight_tag_job	ジョブを実行せずに、進行状況と確保済みの予算を読み取ります。
list_watchr_skills	パッケージ化されたメソッドとそのリソースファイルを確認します。
get_watchr_skill	パッケージ化されたスキルファイルを読み取ります。
search_signals	ウォッチリストの範囲内でトピックを検索し、その変更を同期します。
get_signal	ページ分割されたソースおよびレポートの参照情報とともに、トピックを読み取ります。
search_rejected_insights	保持されている個別の却下済みソースとその理由を検索します。
get_rejected_insight	アクセス可能な保持済みの却下項目を、元の証拠とともに読み取ります。
record_insight_feedback	ソースを非表示にせず、関連性、同名異義語、重複に関する明示的な判定を記録します。
list_insight_feedback	記録済みの判定とその出所を読み取ります。
コレクションでは、ドキュメントに記載されたページネーションとフィルターがサポートされています。設定は、永続的なプレビューを行った後、明示的に承認して適用します。読み取りには mcp:read が必要です。設定とタグの書き込みには追加で mcp:configure が必要です。メンバーの管理には mcp:members:manage が必要です。現在のロールと権限はサーバー側で確認されます。API キーは引き続き読み取り専用です。

プレビューでは、コレクションの開始、メールの送信、変更の適用は行われません。一部の適用操作では、外部での探索やコレクションが開始されます。タグの定義によって過去の分類が変更されることはありません。分類ジョブは明示的に指定され、範囲と予算が設定されており、デフォルトでは手動修正が保持されます。記録された関連性フィードバックによって適格性が変わることも、再実行が行われることもありません。

MCP で新たに作成されたウォッチリストでは、レポートの準備とメール配信はデフォルトで無効です。この2つの効果は1つの設定を共有しています。この設定を無効にしても、コレクションは停止しません。既存のレポート設定は保持されます。

インサイトのレスポンス仕様

search_insights は、簡潔な探索用ペイロードを返します。各アイテムには、id、タイトル、事実に基づく要約、ソースとブランドのメタデータ、および effective_date が含まれます。付随する date_type は、この実効日付がソースの公開日（published）なのか、Watchr の検出日（detected）なのかを示します。そのため、Web サイトの変更は公開日がない場合でも、安全に日付を特定できます。

検索レスポンスでは、元の description、qualification_analysis、未加工の日付、related_items は意図的に省略されています。これにより、AI クライアントが、使うかどうかわからないソーステキストにコンテキストウィンドウを消費せずに、結果ページを順位付けして候補を絞り込めるようにしています。

アイテムのタイトルや要約だけでは内容が不明瞭な場合は、回答する前に、返された id を insight_id として指定して get_insight を呼び出してください。get_insight は、ソースの説明、適格性の判断理由、公開日と検出日、関連する検証済みインサイトを返します。利用者は、簡潔な要約だけから欠けている詳細を推測しないでください。

search_signals と get_signal は、ウォッチリストの範囲に限定されたトピック、ソースとの関連、記録されたレポートへの掲載情報を公開します。competitive_signal_id は従来の共有グループ化用のヒントであり、正式なトピック識別子ではありません。構造が記録されていない場合、過去のレポートへの掲載情報を取得できないことがあります。保存されたスナップショットのタイムスタンプは、実際のスクリーンショット撮影時刻を証明するものではありません。

Watchr を始める

MCP サーバーから有用な情報を取得するには、Watchr のワークスペースを設定しておく必要があります。手順は次のとおりです。

1. watchr.ai/signup でアカウントを作成します。無料プランを利用できます。
2. watchr.ai/app/settings で設定を完了します。
   • 追跡するブランドと競合他社を追加します
   • 監視する市場を指定します（関連性の判定に使用されます）
   • 取り込むニュースレターとプレスフィードを登録します
   • Watchr に変更を監視させるページ（料金、変更履歴、採用情報など）を追加します
   • スクレイピングするソーシャルメディアのプロフィール（LinkedIn、Facebook、Instagram）を追加します
3. 最初のインサイトが収集されるまで待ちます。レポートの準備と配信はウォッチリストの設定によって異なります。チャットの要約をリクエストしても、定期レポートは有効になりません。
4. MCP サーバーに接続し（認証と設定を参照）、任意の AI クライアントからインサイトのクエリを開始します。

認証

デフォルトのエンドポイントは https://mcp.watchr.ai/mcp です。専用の ChatGPT プロファイルでは https://mcp.watchr.ai/mcp/chatgpt を使用します。クライアントに応じて、2つの認証方法があります。

オプション A．ワンクリック OAuth

Dynamic Client Registration（RFC 7591）と PKCE を使用する標準的な OAuth 2.1 です。クライアントが自動で登録し、ブラウザーウィンドウを開き、Watchr へのアクセスを許可すると、トークンはクライアントによって自動的に保存されます。コピー＆ペーストや手動でのローテーションは不要です。

OAuth クライアントでは、上記の認証フローを使用できます。

• Claude Desktop
• Claude Code
• ChatGPT（専用エンドポイントと、アカウントで利用できるコネクター／プラグインのセットアップを使用）
• Cursor（最近のバージョン）

お使いのクライアントがこのリストにある場合は、OAuth クライアントに進んでください。キーの生成は不要です。

オプション B．個人用 API キー

エージェント型フレームワーク、カスタム統合、スクリプト、Windsurf、VS Code 拡張機能、または OAuth に対応していないクライアント向けに、Watchr は wat_mcp_ で始まる有効期間の長い API キーを発行します。

キーを生成するには：

1. watchr.ai にサインインします
2. ワークスペースで Integrations → MCP に移動します
3. Create API key をクリックします
4. わかりやすい名前（例：「My LangGraph agent」、「Windsurf, work laptop」）を付け、有効期限を必要に応じて設定します
5. キーをすぐにコピーします。Watchr が完全なキーを表示するのは一度だけです。ダッシュボードにはプレフィックスとハッシュが保存されるため、キーを紛失しても復元できません（取り消して再生成してください）。

すべてのリクエストで、キーを Bearer トークンとして渡してください。

Authorization: Bearer wat_mcp_<your-key>

ほとんどの MCP クライアントでは、設定の headers フィールドでこれを指定できます。API キー対応クライアントの例をご覧ください。

セキュリティに関する注意事項：

• キーはパスワードと同じように扱ってください。読み取り専用だからといってリスクが低いわけではありません。すべての競合インテリジェンスを閲覧できます。
• デバイスまたは統合ごとにキーを 1 つ用意し、わかりやすい名前を付けてください。ノート PC を紛失した場合は、Integrations → MCP からキーを取り消して再発行してください。
• CI 環境や共有環境で使用するキーには、有効期限を設定してください。
• キーにはアカウントのアクセス権が引き継がれます。アカウント内で有効なすべてのモニタリンググループが対象になります。

まだ Watchr アカウントをお持ちでない場合は、無料で作成してください。

設定

OAuth クライアント

以下のすべてのクライアントで、サーバー URL は https://mcp.watchr.ai/mcp です。初回接続時に認証が自動的に開始されます。

Claude Desktop

claude_desktop_config.json を編集します（Settings → Developer → Edit Config）。

{
  "mcpServers": {
    "watchr": { "url": "https://mcp.watchr.ai/mcp" }
  }
}

Claude Desktop を再起動します。Watchr がコネクターパネルに表示されます。クリックして OAuth を完了してください。

Claude Code

claude mcp add --transport http watchr https://mcp.watchr.ai/mcp

その後、Claude Code 内で /mcp を実行し、Watchr の横にある Authenticate をクリックします。

ChatGPT

Settings → Connectors → Add custom connector：

• MCP サーバー URL：https://mcp.watchr.ai/mcp
• 認証：OAuth

ChatGPT は初回使用時に OAuth フローを開始します。

Cursor

Settings → MCP → Add new MCP server：

{
  "watchr": { "url": "https://mcp.watchr.ai/mcp" }
}

API キー対応クライアント

まずAPI キーを生成し、クライアント設定で Bearer トークンとして渡してください。

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "watchr": {
      "serverUrl": "https://mcp.watchr.ai/mcp",
      "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
    }
  }
}

VS Code

.vscode/mcp.json（またはユーザー設定）に追加します。

{
  "servers": {
    "watchr": {
      "type": "http",
      "url": "https://mcp.watchr.ai/mcp",
      "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
    }
  }
}

Cursor（OAuth を使用しない場合）

OAuth 版と同じ JSON 形式に headers ブロックを追加します。

{
  "watchr": {
    "url": "https://mcp.watchr.ai/mcp",
    "headers": { "Authorization": "Bearer wat_mcp_<your-key>" }
  }
}

カスタムのエージェント型フレームワーク

LangGraph、CrewAI、Mastra、n8n、カスタムの Python または TypeScript エージェントなど。ストリーミング可能な HTTP 経由で https://mcp.watchr.ai/mcp に接続し、すべてのリクエストに Authorization: Bearer wat_mcp_<your-key> ヘッダーを付加してください。MCP 互換の SDK であれば、どれでも使用できます。

結果を改善する

アシスタントが「関連するインサイトはありません」と答えたり、結果が乏しかったりする場合、データは Watchr ワークスペースにあります。Watchr をより賢くすれば、MCP もより賢くなります。

• 監視対象のページを追加します（競合他社の価格ページ、変更履歴、採用情報、製品ページなど）。
• 追跡する各ブランドの LinkedIn、Facebook、Instagram のハンドルを追加して、ソーシャルプロフィールを完成させます。
• 監視グループ単位で、関連性を判定するプロンプトを調整します。何を「関連性がある」と見なすかを決めるものです。現在の結果に応じて、より具体的なテーマを指定して絞り込むか、より多くの情報を拾えるように範囲を広げます。
• ニュースや報道のソースを追加します。ソースが多いほど、シグナル密度が高まります。

すべて watchr.ai/app/settings で設定できます。

サポート

• バグ報告と機能リクエスト：このリポジトリで issue を作成してください。
• 一般的な質問やフィードバック：[email protected] までお問い合わせください。
• ステータスと稼働状況：MCP エンドポイントは、Watchr のメインプラットフォームとステータスを共有しています。

---

Watchr チームが開発しました。MIT ライセンスです。