AyeWatch

AyeWatch MCP

AyeWatchにAI アシスタントを接続します。AyeWatchはトピックやウェブページを監視し、変更があったときや関心のある内容に一致したときに通知します。このリポジトリには、AyeWatch MCP サーバーの接続情報とリスティングファイルが含まれています。サーバー自体はAyeWatchがホストしています。

• エンドポイント： https://ayewatch.ai/api/mcp
• トランスポート： ストリーミング可能なHTTP、ステートレス、セッションIDなし
• ドキュメント全文： https://ayewatch.ai/documentation/mcp

できること

ツール	説明
list_topics	アクティブ状態、間隔、作成日で絞り込んで、モニターを一覧表示します
get_topic	IDでモニターを取得します
create_topic	トピック、1つ以上のウェブページURL、またはテンプレートからモニターを作成します
update_topic	一時停止や再開を含め、モニターのフィールドを変更します
delete_topic	モニターとそのスケジュールを完全に削除します
get_webhook	webhook URLと配信の有効・無効を取得します
set_webhook	webhookを作成し、URLを変更するか、配信を一時停止または再開します
rotate_webhook_secret	webhook署名シークレットを置き換えます

このツールは、お客様自身のアカウントのモニターとwebhookを管理します。アラート履歴は返しません。webhookはすべてのアラートを受け取り、そのシークレットで署名するため、webhookツールを利用できるのはAPIキーで接続した場合のみで、OAuthでは利用できません。

プロンプトの例：

• 「AyeWatchのモニターを一覧表示して、一時停止中のものを教えて。」
• 「全固体電池に関するニュースを毎日確認するAyeWatchモニターを作成して。」
• 「iPhoneの発売に関するAyeWatchモニターを一時停止して。」
• 「AyeWatchのアラートを https://example.com/hooks/ayewatch に送って。」

アラートとwebhook

アラートはMCP経由では返されません。AyeWatchの通知またはwebhookで届きます。モニターが新しいコンテンツを検出すると、AyeWatchはお客様が運用するHTTPSエンドポイントに、JSON本文（トピックID、見出し、更新内容）を含むPOSTリクエストを送信します。

エンドポイントは、set_webhookツール、REST API（PUT https://ayewatch.ai/api/v1/webhook）、または通知設定で設定します。AyeWatchは各配信にシークレットで署名し、X-AyeWatch-Signatureヘッダーで送信します。MCPツールがこのシークレットを返すことはないため、AIとの会話に含まれることはありません。通知設定またはGET https://ayewatch.ai/api/v1/webhookで確認してください。AyeWatchはwebhook URLの設定時または変更時にもメールで通知します。変更していない場合は、APIキーを失効させてシークレットをローテーションしてください。ペイロードのフィールド、タイムアウト、再試行の動作については、webhookのドキュメントをご覧ください。URLはお客様自身のもので、AyeWatchのものではないため、MCP接続ファイルには含まれません。

要件

• 有料プランのAyeWatchアカウントが必要です。APIおよびMCPへのアクセスは、すべての有料プランに含まれています。
• アクティブなモニターは、チェックの実行時にプランのクレジットを消費します。
• リクエスト数は、デフォルトでAPIキーごとに1分あたり120件に制限されています。

接続

Claude Code

このリポジトリからプラグインをインストールします。プラグインを有効にすると、Claude CodeからAPIキーの入力を求められ、システムの安全な認証情報ストアに保存されます。

claude plugin marketplace add SRX9/ayewatch-mcp
claude plugin install ayewatch@ayewatch

または、プラグインを使わずにサーバーを追加します。

claude mcp add --transport http ayewatch https://ayewatch.ai/api/mcp \
  --header "Authorization: Bearer aw_live_YOUR_API_KEY"

Cursor

Cursor MarketplaceからAyeWatchプラグインをインストールする場合は、Cursorからプラグインの設定を求められたときにAYEWATCH_API_KEYを設定します。そうでない場合は、MCP設定（~/.cursor/mcp.json）に以下を追加します。

{
  "mcpServers": {
    "ayewatch": {
      "url": "https://ayewatch.ai/api/mcp",
      "headers": { "Authorization": "Bearer aw_live_YOUR_API_KEY" }
    }
  }
}

VS Code

.vscode/mcp.jsonに以下を追加します。サーバーの起動時にVS Codeからキーの入力を求められ、ファイルには保存されません。

{
  "inputs": [
    { "type": "promptString", "id": "ayewatch-key", "description": "AyeWatch API key", "password": true }
  ],
  "servers": {
    "ayewatch": {
      "type": "http",
      "url": "https://ayewatch.ai/api/mcp",
      "headers": { "Authorization": "Bearer ${input:ayewatch-key}" }
    }
  }
}

Codex

~/.codex/config.tomlに以下を追加します。

[mcp_servers.ayewatch]
url = "https://ayewatch.ai/api/mcp"
http_headers = { "Authorization" = "Bearer aw_live_YOUR_API_KEY" }

その他のMCPクライアント

上記のエンドポイントをストリーミング可能なHTTPトランスポートで使用し、各リクエストにAuthorization: Bearer aw_live_YOUR_API_KEYを指定してください。

APIアクセス設定でAPIキーを作成します。キーは非公開にし、リポジトリにコミットしないでください。

OAuth でサインインする

登録済みアプリでは、API キーの代わりに AyeWatch でサインインできます。「アクセスを許可」を選択する前に、要求されたアクセス権（読み取り、または読み取りと書き込み）を確認できます。アクセス権は30日後に期限切れになります。接続を解除した場合は、それより早く期限切れになります。OAuth トークンは MCP エンドポイントでのみ機能します。

アプリのアクセスを終了するには、接続済みアプリを開き、「接続を解除」を選択します。既存のモニターはスケジュールを維持し、アプリがすでに保存したコピーも削除されません。

このリポジトリの内容

パス	用途
server.json	公式の MCP Registry へのエントリー
.claude-plugin/plugin.json、.mcp.json	API キーを使ってホストされたサーバーに接続する Claude Code プラグイン
.claude-plugin/marketplace.json	Claude Code でこのリポジトリからプラグインをインストールできるようにします
.cursor-plugin/plugin.json、mcp.json	Cursor で設定した AYEWATCH_API_KEY を使ってホストされたサーバーに接続する Cursor プラグイン
glama.json	このリポジトリの Glama 掲載情報を申請します
SUBMISSIONS.md	AyeWatch の掲載先と、各ディレクトリへの登録申請方法
assets/	アイコンとロゴ

このリポジトリ内のものは、どれもお使いのマシン上でコードを実行しません。プラグインファイルは、クライアントに https://ayewatch.ai/api/mcp へ接続し、Authorization ヘッダーで API キーを送信するよう指示するだけです。AyeWatch が受け取るのは、アシスタントが行うツール呼び出し（モニターのトピック、URL、スケジュールなど）だけで、お使いのマシンからそれ以外の情報を受け取ることはありません。

サポートとポリシー

• サポート：https://ayewatch.ai/contact
• プライバシーポリシー：https://ayewatch.ai/privacy
• 利用規約：https://ayewatch.ai/terms

ライセンス

MIT。このライセンスの対象はこのリポジトリ内のファイルであり、AyeWatch サービスは含まれません。