ReplyNodes

@replynodes/mcp

ReplyNodes MCP

1 つのリモート MCP エンドポイントを通じて、AI エージェントを ReplyNodes の公開コンテキストツールに接続します。以下の用途に使用できます。

• Web → Markdown への抽出、ウェブ検索、同一オリジンのクロール、URL マップ
• 公開ブランドプロフィール、検索、スタイルガイド、フォントなどの ブランドインテリジェンス
• Reddit、YouTube、App Store、Google Play、Hacker News の調査

正式なリモートエンドポイントは次のとおりです。

https://mcp.replynodes.com/mcp

稼働中の tools/list レスポンスが正式な情報源です。現在は調査ツールに加え、認証が必要なモニターツールも含まれています。この README からツールの全容を推測しないでください。クライアントがリモート MCP に直接対応している場合は、このパッケージをインストールするのではなく、エンドポイントとクライアント標準の認証フローを使用してください。

認証

インタラクティブなリモートクライアントでは、Better Auth MCP OAuth を標準で使用します。 https://mcp.replynodes.com/mcp に接続してください。OAuth 発行者は https://auth.replynodes.com で、必要なスコープは mcp:read です。

ヘッドレスクライアントと手動設定のクライアントでは、rn_test_* または rn_live_* プレフィックスを持つ ReplyNodes API キーを使用します。組織へのアクセス権限は、認証済みの ID またはキーから解決されます。クライアントから組織 ID を送信する必要はありません。

このパッケージの stdio ブリッジは API キーを使用します。起動時に REPLYNODES_API_KEY を読み取り、Authorization ヘッダーとして送信します。ブラウザー OAuth は実行せず、キーを表示したり永続化したりすることもありません。

セットアップ

Claude Desktop、Claude Code、Cursor、または Windsurf — 標準のリモート MCP

正式な URL を使って、各クライアントのリモート MCP 設定を使用してください。

https://mcp.replynodes.com/mcp

プロンプトが表示されたら、発行者 https://auth.replynodes.com、スコープ mcp:read を指定して、標準の Better Auth MCP OAuth を完了してください。組織 ID は追加しないでください。正確な UI または設定形式については、正式な MCP エンドポイント とクライアントの MCP 設定ヘルプを参照してください。

Claude Desktop、Claude Code、Cursor、または Windsurf — stdio/API キー

以下をクライアントの MCP 設定に追加してください。

{
  "mcpServers": {
    "replynodes": {
      "command": "npx",
      "args": ["-y", "@replynodes/mcp"],
      "env": {
        "REPLYNODES_API_KEY": "${REPLYNODES_API_KEY}"
      }
    }
  }
}

Codex CLI、OpenClaw、またはその他のヘッドレス／手動設定クライアント

クライアントが標準のリモート MCP とインタラクティブなサインインに対応している場合は、上記の正式な URL と OAuth の詳細を使用してください。無人実行または stdio を使用する場合は、クライアントのシークレット／環境変数のサポートを使って rn_test_* または rn_live_* キーを設定してください。

同じコマンドをクライアントの MCP 設定で設定するか、次を実行してください。

REPLYNODES_API_KEY="${REPLYNODES_API_KEY:?Set REPLYNODES_API_KEY}" npx -y @replynodes/mcp

例では、環境変数を参照するプレースホルダー REPLYNODES_API_KEY を使用しています。実際のキーをシェルの履歴、ソースファイル、コマンドライン引数、コミット対象の設定に記載しないでください。

ツールの動作

リモートサーバーは、MCP の tools/list を通じて、稼働中の ReplyNodes ツール群を公開します。大半の探索ツールと公開データツールは読み取り中心ですが、現在のエンドポイントには monitor_create や monitor_update など、認証が必要なモニター操作も含まれています。ツール名とスキーマは変更される場合があります。接続後に tools/list で確認してください。

この npm パッケージはトランスポートブリッジであり、ツールを追加したり、ソーシャルチャネルに投稿したりするものではありません。信頼できないエンドポイントから返されたツール名や説明を、操作を実行する許可とみなさないでください。

環境変数

変数	必須	説明
REPLYNODES_API_KEY	はい	ヘッドレス／手動で使用するための rn_test_* または rn_live_* API キーです。環境変数からのみ読み取られます。
REPLYNODES_MCP_URL	いいえ	信頼できる HTTPS エンドポイントの上書き設定です。デフォルトは https://mcp.replynodes.com/mcp です。

エンドポイントの上書きは、互換性のある HTTPS デプロイメントまたはテストを目的としています。 有効な HTTPS URL でない場合は拒否されます。上書き URL に認証情報を含めないでください。 デフォルトのエンドポイントは、サポート対象の公開読み取り専用サービスです。

追加のコマンドライン引数は mcp-remote に転送されます（例： --debug）。デバッグログには接続の詳細が含まれる場合があるため、必要な場合にのみ使用し、 認証情報を含むログは決して共有しないでください。

ネイティブのリモート MCP（インストール不要）

ネイティブのリモート MCP に対応するクライアントは、次の場所に直接接続できます。

URL: https://mcp.replynodes.com/mcp

発行者 https://auth.replynodes.com、スコープ mcp:read を指定して、ネイティブの Better Auth MCP OAuth を使用してください。 認証情報を URL やコマンドライン引数に含めないでください。ヘッドレス／手動クライアントの場合は、代わりに rn_test_* または rn_live_* API キーを Bearer 認証情報として送信してください。

ライブツールの提供内容

接続後、tools/list を使って現在のツールを確認してください。検証済みの 機能カテゴリには、次のものがあります。

• web — 検索、クリーンな Markdown 抽出、同一オリジンのクロール、URL マッピング、ブランド抽出
• brand — 公開ブランドの検索、取得、スタイルガイド、フォント
• Reddit — 公開投稿、サブレディット、ユーザーの調査
• YouTube — 検索、動画、チャンネル、コメント、プレイリスト、関連コンテンツ、文字起こしの調査
• App Store — 公開アプリ、開発者、レビュー、評価、プライバシー、類似アプリ、検索データ
• Google Play — 公開アプリ、カテゴリ、開発者、レビュー、権限、安全性、提供状況、類似アプリ、検索データ
• Hacker News — 公開ストーリー、アイテム、検索、ユーザーの調査
• monitor — 認証済みモニターの一覧表示、作成、確認、更新、変更、実行

正確なツールセットとスキーマは、実行時に取得できる情報が正式なものです。 https://mcp.replynodes.com/mcp からライブの tools/list を取得して返されない ツールや機能を紹介しないでください。

Cursor およびその他の IDE エコシステム

ReplyNodes は、ネイティブのリモート MCP サーバーと、同じリモート MCP サーバーを同梱する Cursor プラグインの両方として提供されています。

ヘッドレス／手動のリモート MCP（API キー）

ヘッドレス／手動で Cursor を使用する場合は、正規 URL と環境変数から取得する Bearer キーを使って、 mcp.json にリモート MCP サーバーを設定します。ReplyNodes を .cursor/mcp.json（プロジェクト用）または ~/.cursor/mcp.json（グローバル用）に追加してください。

{
  "mcpServers": {
    "replynodes": {
      "url": "https://mcp.replynodes.com/mcp",
      "headers": {
        "Authorization": "Bearer ${REPLYNODES_API_KEY}"
      }
    }
  }
}

ヘッドレス／手動で使用する場合は、環境変数に REPLYNODES_API_KEY を設定してください。 対話型の Cursor セッションでは、発行者 https://auth.replynodes.com、スコープ mcp:read を指定して、 ネイティブの Better Auth MCP OAuth を使用してください。Cursor の MCP ドキュメント https://cursor.com/docs/mcp と、手動インストールのヘルプ https://cursor.com/help/customization/mcp を参照してください。

Cursor プラグイン（ワンクリック＋ディープリンク＋マーケットプレイス対応）

同じリモート MCP サーバーをラップする Cursor プラグインは、このリポジトリの .cursor-plugin/ にあります。

• プラグインマニフェスト：https://github.com/replynodes/replynodes-mcp/blob/master/.cursor-plugin/plugin.json
• ロゴ：https://github.com/replynodes/replynodes-mcp/blob/master/assets/logo.svg

このプラグインは、正規の本番エンドポイント https://mcp.replynodes.com/mcp を使用し、Bearer REPLYNODES_API_KEY ヘッダーで認証します。キーはプラグイン変数として 宣言されているため、Cursor のプラグイン設定 UI で入力を求められます。

Cursor のディープリンクを使ってインストールする

Cursor は、次の形式の MCP インストール用ディープリンクに対応しています。

cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIG

ReplyNodes のディープリンク（リモート HTTP MCP、Bearer API キー）は次のとおりです。

cursor://anysphere.cursor-deeplink/mcp/install?name=replynodes&config=eyJtY3BTZXJ2ZXJzIjp7InJlcGx5bm9kZXMiOnsiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UkVQTFlOT0RFU19BUElfS0VZfSJ9LCJ1cmwiOiJodHRwczovL21jcC5yZXBseW5vZGVzLmNvbS9tY3AifX19

Cursor のドキュメント https://cursor.com/docs/mcp/install-links を参照して、 独自のディープリンクを再計算し、テストしてください。

Cursor Marketplace に提出する

このプラグインは提出できる状態です。公開 Cursor Marketplace に掲載するには、次の手順に従ってください。

1. プラグインが https://github.com/replynodes/replynodes-mcp の公開 Git ブランチにあることを確認します。
2. https://cursor.com/marketplace/publish にサインインします。
3. リポジトリの URL を提出します。

提出チェックリスト（https://cursor.com/docs/reference/plugins より）：有効な .cursor-plugin/plugin.json マニフェスト、一意の小文字ケバブケースの名前、明確な 説明、有効なコンポーネントファイル、相対パスでコミットされ参照されているロゴ、 使用方法と設定を記載した README、マニフェストの variables スキーマで宣言された ${VAR}、相対パスかつ有効なパス、ローカルでのテスト。すべての Marketplace プラグインはオープンソースである必要があり、掲載前に手動で審査されます （https://cursor.com/help/security-and-privacy/marketplace-security）。

配布状況

チャネル	状態	URL
Official MCP Registry	掲載中	https://registry.modelcontextprotocol.io/v0.1/servers/com.replynodes%2Fmcp/versions/latest
Smithery	既存の掲載あり。ただし、公開中のメタデータは古い状態です（プロキシエンドポイント、auth.md、クエリの apiKey）。更新は外部からの操作が必要で、所有者のみが実行できます	https://smithery.ai/servers/replynodes/mcp
Cursor プラグイン（このリポジトリ内）	提出可能な状態	https://github.com/replynodes/replynodes-mcp/tree/master/.cursor-plugin
Cursor ディープリンク	インストールパスを検証済み	cursor://anysphere.cursor-deeplink/mcp/install?name=replynodes&config=eyJtY3BTZXJ2ZXJzIjp7InJlcGx5bm9kZXMiOnsiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UkVQTFlOT0RFU19BUElfS0VZfSJ9LCJ1cmwiOiJodHRwczovL21jcC5yZXBseW5vZGVzLmNvbS9tY3AifX19
Cursor Marketplace への掲載	まだ掲載されていません	https://cursor.com/marketplace/publish から提出してください（所有者による操作が必要です）
Claude Code プラグイン（このリポジトリ内）	既存のものがあり、stdio ブリッジを使用	https://github.com/replynodes/replynodes-mcp/tree/master/.claude-plugin
Claude Code コミュニティマーケットプレイス	提出手順は所有者のみが実行できます	https://code.claude.com/docs/en/plugins.md

ライセンス

MIT