Brilliant Directories MCP

Name: Brilliant Directories MCP
Author: brilliantdirectories

ローカル

github.com/brilliantdirectoriesビジネス・マーケティング182 週間前に更新

リポジトリ

Brilliant Directories MCP について

Brilliant Directories MCPは、AIエージェントからAPI経由でBrilliant Directoriesサイトの会員情報やコンテンツを管理するMCPサーバーです。幅広いREST APIリソースに対応し、ホスト型またはローカルで実行できます。

主な機能

01会員、投稿、リードの管理
02レビュー、ページ、リダイレクトの管理
03フォーム、メニュー、タグの編集
04メールテンプレートと会員プランの設定
05ホスト型またはローカルでの実行

活用シーン

01AIエージェントによるディレクトリサイトの更新
02会員やリードの記録の作成・保守
03ページ、フォーム、サイトナビゲーションの管理

MCP 対応

MCPサーバーとして、Brilliant Directories REST APIで扱えるリソースの管理機能をMCPクライアントに公開します。接続にはBD APIキーとサイトURLが必要で、ホスト型エンドポイントまたはローカルのnpxプロセスを利用できます。

#mcp #membership #directory #crm #cms #openapi #claude #cursor #ai-agents #anthropic #brilliant-directories #official

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "brilliant-directories": {
      "command": "npx",
      "args": [
        "-y",
        "brilliant-directories-mcp"
      ],
      "env": {
        "BD_API_KEY": "<BD_API_KEY>",
        "BD_SITE_URL": "<BD_SITE_URL>"
      }
    }
  }
}

起動コマンドnpx -y brilliant-directories-mcp

設定が必要な環境変数

BD_API_KEYシークレットYour Brilliant Directories API key. Generate one in BD Admin → Developer Hub → Generate API Key.

BD_SITE_URLYour BD site URL, e.g. https://yoursite.com (BD_API_URL is also accepted as a legacy alias).

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmbrilliant-directories-mcp6.58.612stdio

ツール

170

掲載時のツール一覧 · 3 週間前に更新

このツールにパラメーターはありません。

詳細

公式 Brilliant Directories MCP サーバー — セットアップガイド

BD サイトで AI を自由に活用できます。API キーを 1 つ使うだけで、あらゆる AI エージェントに Brilliant Directories サイトへのフルアクセスを提供できます。

BD が REST API を通じて公開しているすべてのリソースで、メンバー、投稿（単一画像および複数画像）、リード、レビュー、トップカテゴリーとサブカテゴリー、メールテンプレート、ページ（ホームページ、ランディングページ）、301 リダイレクト、スマートリスト、ウィジェット、メニュー、フォーム、タグ、会員プランなどを管理できます。

このガイドでは、お好みの AI（Claude、Cursor など）を BD サイトに接続する方法を説明します。以下から AI アプリを選び、2 つの情報を貼り付けて再起動してください。ほとんどのセットアップは 5 分以内に完了します。

⚠️ 必要なもの — 始める前に

BD サイトの URL。 ブラウザーで表示される正規の URL をそのまま使用してください。https://（サイトに SSL がない場合は http://）を含め、サイトで www. を使用している場合はそれも含めてください。末尾にスラッシュは付けません。
- ✅ https://www.mysite.com（ほとんどの BD サイト）
- ✅ https://mysite.com（サイトで www. を使用していない場合のみ）
- ✅ http://mysite.com（HTTP のみのサイト — プロトコルがそのまま使用されます）
- ❌ mysite.com（プロトコルがありません）
- ❌ https://mysite.com/（末尾にスラッシュがあります）
- ❌ サイトが実際には www.mysite.com で配信されている場合の https://mysite.com — サイトが正規に応答する形式を使用してください
BD API キー。

BD Admin → Developer Hub → Generate API Key → コピーします。

詳しい手順：API キーの作成方法。
Node.js — Advanced パスでのみ必要です（以下を参照）。Easy パスでは必要ありません。必要な場合は、nodejs.org から一度だけインストールしてください（Get Node.js® をクリックしてダウンロードし、次に Windows Installer (.msi) をクリックします — Mac の場合は macOS Installer をクリックします — ダウンロードしたファイルをダブルクリックしてインストールし、画面の指示に従って Next をクリックします）。

🚨 API 権限 — 必ず設定してください

新しい BD API キーでは、初期設定でメンバーの読み取りと書き込みのみが有効になっています。

その他すべてのリソース（ウェブページ、フォーム、メニュー、タグ、メールテンプレート、レビュー、リード、カテゴリー、投稿タイプ、ウィジェットなど）には 「Advanced Endpoints」 の切り替えが必要です。有効にするまでは 403 API Key does not have permission to access this endpoint が返されます。

初めて使用するユーザーのほとんどがここでつまずきます。 AI がメンバーの一覧を取得できても、ページを作成したりフォームを更新したりできない場合は、デバッグを中断してください。原因はこれです。

Advanced Endpoints を有効にする方法：

BD Admin → Developer Hub
一覧から API キーを見つけ → Actions ドロップダウン → Permissions
Advanced Endpoints タブをクリックします
すべてを ON に切り替えます（または使用するリソースだけを選択します。ただし、すべてを ON にするのが、問題を避ける最も手早い方法です）
Save Permissions をクリックします

変更はすぐに反映されます。キーのローテーションも AI の再起動も不要です。失敗したリクエストを再実行すれば成功します。

AI に何も削除させたくない場合は？ Advanced Endpoints の delete アクションをすべてオフにしてください。AI は引き続き読み取り、作成、更新を実行できますが、delete* ツール呼び出しはデータを消去せず、403 を返します。AI に破壊的な操作を任せるべきではない本番サイトに適した基本設定です。

BD が初期設定で制限している理由： 最小権限の原則です。基本権限のみのキーが漏えいしても、サイト全体のディレクトリを書き換えることはできず、メンバーの読み取りと書き込みしかできません。エージェントに実際に必要なエンドポイントを決めたら、権限を必要なものだけに絞ることができます。

プラットフォーム別のセットアップ
AI に依頼できること
更新は自動です
トラブルシューティング
よくある質問
認証
レート制限
ページネーション
フィルタリング
並べ替え
利用可能なリソース
フィールドの探索
安定したアセット URL
セキュリティ
サポート

プラットフォーム別のセットアップ

各プラットフォームには2 つの方法があります。

🚀 簡単な設定ブロック — ホスト型 MCP（https://brilliantmcp.com）に接続します。Node.js もインストールもターミナルも不要です。保存して AI アプリを再起動すれば、すぐに使えます。
🛠️ 高度な設定ブロック — お使いのマシン上で、MCP を npx 子プロセスとして起動します。MCP を自分のハードウェア上で実行したい場合に使用します。

事前に Node.js のインストールが必要です — nodejs.org から入手してください（Get Node.js® をクリックしてダウンロードし、次に Windows Installer (.msi) をクリックします。Mac の場合は macOS Installer をクリックします。ダウンロードしたファイルをダブルクリックしてインストールしてください）。

どちらの方法でも、BD の全ツールを利用でき、同じ手順、同じ軽量シェーパー、同じ安全ガードが適用されます。

🚀 簡単な設定ブロック（推奨 — 30 秒でインストール）

AI クライアントの MCP 設定（Cursor、Windsurf、Cline、Codex、n8n など）に、次のエントリーを追加します。

{
  "mcpServers": {
    "brilliant-directories": {
      "url": "https://brilliantmcp.com",
      "headers": {
        "X-Api-Key": "ENTER_API_KEY",
        "X-BD-Site-URL": "https://www.your-site.com"
      }
    }
  }
}

ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えてください（正規形式の URL 全体 — https:// を含め、ホスト名を正確に指定し、末尾にスラッシュを付けないでください。要件を参照）。

⚠️ Claude Desktop は簡単な設定ブロックに対応していません — Claude Desktop のセクションにある高度な設定ブロックを使用してください。

保存したら、AI アプリを完全に終了してから再度開いてください。 保存するだけでは不十分です。すべての AI クライアントは、ホットリロードではなく、新たに起動したときにのみ MCP サーバーを読み込みます。これで完了です。動作しましたか？「AI に依頼できること」へ進む。

クライアントごとの詳しい手順が必要ですか？以下の該当プラットフォームのセクションに進んでください。

🛠️ 高度な設定ブロック（Node.js のインストールが必要）

⚠️ 手順 1 — まず Node.js をインストールしてください（高度な方法では、マシン上で npx コマンドを実行します）。

nodejs.org にアクセスし、Get Node.js® をクリックします

Windows Installer (.msi) または macOS Installer をダウンロードします

ファイルをダブルクリックし、すべての画面で「次へ」をクリックして Node.js を完全にインストールします

この手順を省略すると、ログに spawn npx ENOENT が表示され、「MCP サーバーがありません」という状態になります。

--prefer-online と @latest を指定する理由は？ 起動するたびに npm がレジストリを再確認するようにし、常に最新バージョンを取得できるようにします。ローカルの npm キャッシュが古いと発生する ETARGET No matching version found エラーを防ぎます。

手順 2 — 次の設定を貼り付けます。

{
  "mcpServers": {
    "brilliant-directories": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "brilliant-directories-mcp@latest",
        "--api-key", "ENTER_API_KEY",
        "--url", "https://www.your-site.com"
      ]
    }
  }
}

手順 3 — AI アプリを完全に終了してから、再度開きます。 ウィンドウを閉じるだけでは不十分です。AI は完全に再起動したときにのみ MCP サーバーを読み込みます。

Windows： システムトレイ（右下。^ の下に隠れている場合があります）にあるアプリのアイコンを右クリック → 終了を選択してから、再度開きます
Mac： Cmd+Q を押すか、メニューバーから → Quit を選択してから、再度開きます

Claude Desktop

⚠️ Claude Desktop には Node.js と Advanced（npm）設定が必要です。 Easy の url 形式のブロックは受け付けず、stdio（command + args）のみを受け付けます。

⚠️ Windows ユーザーの方へ： Claude Desktop は Microsoft Store ではなく、claude.ai/download からインストールしてください（Store 版では設定ファイルがサンドボックス化されます）。

「Tool result could not be submitted… connection interrupted」というバナーが表示されますか？ すべての MCP コネクターに共通する見た目だけの UI バグです（anthropics/claude-code #51874。ツールは引き続き動作します。無視して問題ありません。

⚠️ 手順 1 — まず Node.js をインストールしてください（以下の設定を貼り付ける前に）：

nodejs.org にアクセスし、Get Node.js® をクリックします

Windows Installer (.msi) または macOS Installer をダウンロードします

ファイルをダブルクリックし、すべての画面で「次へ」をクリックして Node.js を完全にインストールします

この手順を省略すると、ログに spawn npx ENOENT と表示され、「MCP サーバーがありません」と表示されます。

手順（ターミナル不要）：

Claude Desktop を開きます。
メニューバー → Settings。

Developer タブ → Edit Config。

claude_desktop_config.json が TextEdit（Mac）またはメモ帳（Windows）で開きます。
該当するシナリオを選びます。

シナリオ A — ファイルが空の `{}` であるか、`mcpServers` の項目がない場合

すべて選択（Cmd+A / Ctrl+A）して削除し、以下を貼り付けます。

{
  "mcpServers": {
    "brilliant-directories": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "brilliant-directories-mcp@latest",
        "--api-key", "ENTER_API_KEY",
        "--url", "https://www.your-site.com"
      ]
    }
  }
}

ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えます。保存してから、Claude Desktop を完全に終了し、再度開きます。 保存するだけでは不十分です。Claude が MCP サーバーを読み込むのは、新しく起動したときだけです。

シナリオ B — ファイルにすでに内容がある場合（設定、Google コネクター、その他の MCP サーバー）

上書きせずに結合します。ルールは 2 つです。

トップレベルの項目間にはカンマを入れます。
最後の } は一つのまま末尾に残します。

変更前：

{
  "preferences": {
    "menuBarEnabled": false,
    "legacyQuickEntryEnabled": false
  }
}

変更後：

{
  "preferences": {
    "menuBarEnabled": false,
    "legacyQuickEntryEnabled": false
  },
  "mcpServers": {
    "brilliant-directories": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "brilliant-directories-mcp@latest",
        "--api-key", "ENTER_API_KEY",
        "--url", "https://www.your-site.com"
      ]
    }
  }
}

変更点は 2 つです。preferences を閉じる } の後に , を追加し、最後の } の前に mcpServers ブロックを追加します。ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えます。保存してから、Claude Desktop を完全に終了し、再度開きます。

再起動する前に、最終的なファイルを jsonlint.com に貼り付け、正しくフォーマットされていることを確認してください。

カンマの不足は MCP を機能しなくしますが、バリデーターですぐに検出できます。

Claude Desktop を完全に終了し、再度開きます。 新しいチャットを開始します。
「完全に終了」とは、ウィンドウを閉じるだけではありません — Claude が MCP サーバーを読み込むのは、実際に再起動したときだけです。
- Windows： システムトレイ（右下。^ の下に隠れている場合があります）の Claude アイコンを右クリック → Quit を選び、再度開きます
- Mac： Cmd+Q またはメニューバー → Claude → Quit Claude を選び、再度開きます
BD MCP が読み込まれたことを確認します。 UI は Claude Desktop のバージョンによって異なります。
- 任意のチャットで 「どんなツールがありますか？」 と尋ねます。brilliant-directories のツールが表示されるはずです。
- または Settings → Developer → MCP servers を確認します。brilliant-directories が接続済み（エラー状態ではない）と表示されるはずです。
- 古いビルドでは、チャット入力欄の近くにツール数とともに 🔨 ハンマーアイコン も表示されます。クリックするとツールを確認できます。

接続されませんか？ Settings → Developer → MCP servers でエラーを確認してください。よくある原因：

JSON の入力ミス — ファイルを jsonlint.com に貼り付けてください

API キーが間違っている、または URL に https:// がない／末尾にスラッシュがある

Node.js がインストールされていない（Claude Desktop は npx を起動します）

「not valid MCP server configurations」 と表示されましたか？ url 形式のブロックを貼り付けています。Claude Desktop が受け付けるのは、上記の stdio（command + args）形式のみです。

設定ファイルの直接パス（Settings を使わない場合）：

Mac：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

Claude Code

Claude Code には MCP 用 GUI がないため、ターミナルからインストールします。Terminal.app（Mac）、PowerShell（Windows）、または Cursor ／ VS Code の内蔵ターミナル（Ctrl+` ／ Cmd+` を押すか、表示 → ターミナルから開きます）で動作します。

前提条件 — 初回のみインストール：

Node.js — nodejs.org から入手します（Get Node.js® → Windows Installer (.msi) または macOS Installer をクリックし、ダブルクリックしてインストールします。画面の指示に従って「次へ」をクリックしてください）。
claude CLI — 任意のターミナルで次を実行します。
```
npm install -g @anthropic-ai/claude-code
```
ターミナルを閉じて、再度開きます。claude --version で確認してください。

以下の 3 つの方法から、都合のよいものを選んでください。

⚡ プラグイン（1 行でインストール。お使いの Claude Code が対応している場合におすすめ）

起動中の claude セッション内で、次のスラッシュコマンドを 2 つ実行します。

/plugin marketplace add brilliantdirectories/brilliant-directories-mcp
/plugin install brilliant-directories@brilliant-directories-mcp

Claude Code がプラグインマニフェストを取得し、BD MCP サーバーを登録すると、すぐにツールを利用できるようになります。初回使用時に BD_API_KEY と BD_SITE_URL の入力を求められます。または、claude の起動前に環境変数として設定してください。（以下の「簡単」と「詳細設定」の方法では、代わりに claude mcp add コマンド内で認証情報を直接指定します。方法は異なりますが、結果は同じです。）

/plugin コマンドが表示されませんか？ プラグインのサポートには新しいビルドが必要です。npm install -g @anthropic-ai/claude-code@latest を実行して、ターミナルを再起動してください。それでも表示されない場合は、以下の「簡単」または「詳細設定」の方法を使用してください。

🚀 簡単（ホスト型 Worker — ローカルの BD MCP サブプロセスは不要）

claude mcp add brilliant-directories --transport http https://brilliantmcp.com \
  --header "X-Api-Key: ENTER_API_KEY" \
  --header "X-BD-Site-URL: https://www.your-site.com"

ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えてください。claude mcp list で確認します。brilliant-directories に ✓ Connected と表示されます。Claude Code を閉じて、再度開いてください。

🛠️ 詳細設定（`npx` を使って BD MCP をローカルで実行）

claude mcp add brilliant-directories -- npx -y --prefer-online brilliant-directories-mcp@latest --api-key ENTER_API_KEY --url https://www.your-site.com

同じ形式ですが、MCP サーバーをお使いのマシン上で npx の子プロセスとして実行します。プレースホルダーを置き換えてください。claude mcp list で確認します。Claude Code を閉じて、再度開いてください。-y フラグを指定すると初回の npx インストール確認を自動的に承認するため、プロセスの起動が停止しません。

認証情報は claude mcp add コマンド内に保存されます。 ユーザーレベルの Claude 設定ファイルに書き込まれ、すべてのツール呼び出し時に BD に自動で渡されます。更新するには、claude mcp remove brilliant-directories を実行してから、新しい値を指定して claude mcp add を再実行してください。

Cursor 内の Claude 拡張機能

Cursor 内で Claude とチャットする場合（Cursor の拡張機能マーケットプレイスからインストールした Anthropic の「Claude」拡張機能）、この拡張機能には独自の MCP 設定があります。Cursor ネイティブのエージェントの設定とは別です。 一方にインストールしても、もう一方にはインストールされません。

注： Claude 拡張機能と Claude Code CLI は、同じファイル（~/.claude.json、Windows の場合は C:\Users\<you>\.claude.json）を読み込みます。上のセクションに従って Claude Code をすでに設定している場合、BD MCP は Claude 拡張機能にもすでに読み込まれています。このセクションでは、Claude 拡張機能だけを使用し、CLI をインストールしていないお客様向けに説明します。

MCP の設定は 2 種類あり、ツールが表示される場所も異なります。

1. Claude 拡張機能（Cursor 内または Claude Code CLI）

設定ファイル（Windows）：C:\Users\<you>\.claude.json
設定ファイル（Mac / Linux）：~/.claude.json
ツールの表示場所：Claude とチャットするとき。「どんなツールを使えますか」と尋ねるか、/mcp と入力してください。

2. Cursor のネイティブエージェント

設定ファイル（Windows）：C:\Users\<you>\.cursor\mcp.json
設定ファイル（Mac / Linux）：~/.cursor/mcp.json
ツールの表示場所：Cursor の 設定 → ツールと MCP

最も簡単な設定方法 — メモ帳で JSON ファイルを編集します（ターミナルも claude CLI も不要です）：

⚠️ 手順 1 — 先に Node.js をインストールしてください（以下の設定を編集する前に行います）。

nodejs.org にアクセスし、Get Node.js® をクリックします。

Windows Installer (.msi) または macOS Installer をダウンロードします。

ファイルをダブルクリックし、すべての画面で「次へ」をクリックして Node.js を完全にインストールします。

この手順を省略すると、ログに spawn npx ENOENT と表示され、「MCP サーバーがありません」というエラーが発生します。

ファイルを開きます。 パスをエクスプローラーのアドレスバー（Windows）または Finder の 移動 → フォルダへ移動（Mac）に貼り付けます。まだファイルがない場合は、そのパスに .claude.json という名前の空のテキストファイルを新規作成します。

以下を貼り付けます。 ファイルにすでに mcpServers キーを含む内容がある場合は、"brilliant-directories": {...} エントリを既存の mcpServers オブジェクトに追加してください。他のエントリを上書きしないでください。

{
  "mcpServers": {
    "brilliant-directories": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "brilliant-directories-mcp@latest",
        "--api-key", "ENTER_API_KEY",
        "--url", "https://www.your-site.com"
      ]
    }
  }
}

ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えます（https:// を含め、末尾にスラッシュを付けないでください）。
ファイルを保存し、Cursor を完全に終了してから再起動します。 これにより、Claude 拡張機能が新しい設定を読み込みます。保存するだけでは不十分です。
Claude とチャットし、「どんなツールを使えますか？」と尋ねてください。brilliant-directories のツールが一覧に表示されるはずです。

Cursor の「ツールと MCP」パネルは空のままですが、これは正常です。 Claude 拡張機能は ~/.claude.json を読み込みますが、Cursor のパネルには ~/.cursor/mcp.json の内容だけが反映されます。両方に BD ツールを表示したい場合は、Cursor のセクションの手順も実行してください。

別の方法 — claude CLI がインストールされている場合（ほとんどのユーザーはインストールしていません。何のことかわからない場合は読み飛ばしてください）：任意のターミナルで次を実行します。

claude mcp add brilliant-directories -- npx -y --prefer-online brilliant-directories-mcp@latest --api-key ENTER_API_KEY --url https://www.your-site.com

CLI が同じ JSON を ~/.claude.json に書き込みます。手動で編集した場合と同じ結果になります。

OpenAI（Codex Desktop）

OpenAI のサービス	対応状況
Codex Desktop（デスクトップアプリ）	✅ はい — 両方のトランスポートで MCP を完全にサポート
ChatGPT ウェブ版／デスクトップ版／モバイル版	❌ いいえ — コンシューマー向け ChatGPT は MCP コネクターをサポートしていません

OpenAI エコシステムで BD の自動化を行うには、Codex Desktop を使用してください。ChatGPT 自体はまだ MCP に対応していません。Codex を使わずに GUI で操作したい場合は、Claude Desktop／Cursor／Windsurf／Cline を使用してください。

Codex Desktop のセットアップ

1. Codex Desktop をダウンロードします。chatgpt.com/codex/get-startedにアクセスして、インストールしてください。

2. Codex Desktop を開き → File → Settings → MCP Servers → + Add Server の順に選択します。

「Connect to a custom MCP」フォームが開き、2 つのタブが表示されます。STDIO（上級者向け — ローカルで実行し、Node.js が必要）と Streamable HTTP（簡単 — ホスト型 Worker を使用し、Node.js は不要）です。どちらでも動作するので、どちらかを選んでください。

🚀 簡単（Streamable HTTP — 推奨、Node.js のインストール不要）：

Streamable HTTP タブをクリックします。フォームを上から順に入力します。

フィールド（Codex の表示名）	値
Name	`Brilliant Directories`（または任意のラベル）
URL	`https://brilliantmcp.com`
Bearer token env var	空欄のままにしてください — 触らないでください
Headers — Key	`X-Api-Key`
Headers — Value	BD API キー
+ Add header をクリックして 2 行目を追加します
Headers — Key（2 行目）	`X-BD-Site-URL`
Headers — Value（2 行目）	`https://www.your-site.com`
Headers from environment variables	空欄のままにしてください — 触らないでください

Save をクリックし、Codex を完全に終了してから再度開いてください。 保存するだけでは不十分です。Codex は起動し直したときにのみ MCP サーバーを読み込みます。

🛠️ 上級者向け（STDIO — お使いのマシンで実行し、Node.js が必要）：

⚠️ 手順 1 — まず Node.js をインストールしてください（以下の設定を貼り付ける前に行います）。

nodejs.orgにアクセスし、Get Node.js® をクリックします

ダウンロードするもの：Windows Installer (.msi) または macOS Installer

ファイルをダブルクリックし、すべての画面で「次へ」をクリックして Node.js を完全にインストールします

これを省略すると、ログに spawn npx ENOENT と表示され、「MCP サーバーがありません」という状態になります。

STDIO タブをクリックします。フォームを上から順に入力します。

フィールド（Codex の表示名）	値
Name	`Brilliant Directories`（または任意のラベル）
Command to launch	`npx`
Arguments — 1 行目	`-y`
以下の各行の間で + Add argument* をクリックします*
Arguments — 2 行目	`brilliant-directories-mcp@latest`
Arguments — 3 行目	`--api-key`
Arguments — 4 行目	BD API キー
Arguments — 5 行目	`--url`
Arguments — 6 行目	`https://www.your-site.com`
Environment variables	空欄のままにしてください — 触らないでください
Environment variable passthrough	空欄のままにしてください — 触らないでください
Working directory	空欄のままにしてください — 触らないでください

「完全に終了する」とは、ウィンドウを閉じるだけではありません — Codex は実際に再起動したときにのみ MCP サーバーを読み込みます。

Windows： システムトレイ（右下。「^」の下に隠れている場合があります）にある Codex アイコンを右クリックし、Quit を選択してから再度開きます

Mac： Cmd+Q を押すか、メニューバーから Codex → Quit Codex を選択してから再度開きます

4. 接続をテストします： 新しい Codex チャットで 「BD サイトの最初の 5 人のメンバーを一覧表示して」 と尋ねます。ツールが実行され、データが返ってきます。

プロのヒント — 複数サイトの管理： BD サイトごとに Name と認証情報を変えて、このセットアップを繰り返します（例：brilliant-directories-main / brilliant-directories-staging）。その後、Codex に 「brilliant-directories-main で、上位のカテゴリを一覧表示して」 または 「これらのメールテンプレートを -main から -staging にコピーして」 と指示します。代理店や複数ブランドを運営する事業者に便利です。

Windsurf

Windsurf の AI ペインは Cascade と呼ばれます。MCP サーバーは Cascade に接続します。

⚠️ Windsurf では、リモート MCP サーバーに url ではなく serverUrl を使用します。 以下の Easy 設定ブロックもそれに合わせています。

Windsurf を開きます。
設定を開きます：ウィンドウの右下にある Windsurf - Settings をクリックするか、コマンドパレット（Cmd/Ctrl+Shift+P）を開き、Open Windsurf Settings と入力します。
設定で Cascade セクションを見つけ、Model Context Protocol (MCP) を選択して有効にします。
ウィンドウ右側の Cascade パネルで、MCPs icon（パネルの右上）をクリックし、Configure を選択します。MCP 設定ファイルが開きます。
次のいずれかを貼り付けます（Easy を推奨）：

🚀 Easy（推奨 — Node.js のインストールは不要です）：

{
  "mcpServers": {
    "brilliant-directories": {
      "serverUrl": "https://brilliantmcp.com",
      "headers": {
        "X-Api-Key": "ENTER_API_KEY",
        "X-BD-Site-URL": "https://www.your-site.com"
      }
    }
  }
}

🛠️ Advanced（お使いのマシンで実行します。Node.js が必要です）：

⚠️ 手順 1 — まず Node.js をインストールしてください（以下の設定を貼り付ける前に行ってください）：

nodejs.org にアクセスし、Get Node.js® をクリックします

Windows Installer (.msi) または macOS Installer をダウンロードします

ファイルをダブルクリックし、すべての画面で「次へ」をクリックして Node.js を完全にインストールします

この手順を省略すると、ログに spawn npx ENOENT が表示され、「MCP サーバーがありません」 という状態になります。

{
  "mcpServers": {
    "brilliant-directories": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "brilliant-directories-mcp@latest",
        "--api-key", "ENTER_API_KEY",
        "--url", "https://www.your-site.com"
      ]
    }
  }
}

ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えます。保存したら、Windsurf を完全に終了して再起動してください。 保存するだけでは不十分です。Windsurf が MCP サーバーを読み込むのは、起動し直したときだけです。

「完全に終了」とは、ウィンドウを閉じるだけではありません。 Windsurf が MCP サーバーを読み込むのは、実際に再起動したときだけです：

Windows： システムトレイ（右下。^ の下に隠れている場合があります）の Windsurf アイコンを右クリックし、Quit を選択してから、再度開きます

Mac： Cmd+Q を押すか、メニューバーから Windsurf → Quit Windsurf を選択してから、再度開きます

Cline（VS Code 拡張機能）

Cline 拡張機能をインストールした状態で VS Code を開きます。
VS Code のサイドバーにある Cline アイコンをクリックして、Cline パネルを開きます。
Cline の上部ナビゲーションで、MCP Servers アイコンをクリックします。
Configure MCP Servers をクリックします。VS Code で Cline の MCP 設定ファイルが開きます。
次のいずれかを貼り付けます（Easy を推奨）：

🚀 Easy（推奨 — Node.js のインストールは不要です）：

{
  "mcpServers": {
    "brilliant-directories": {
      "url": "https://brilliantmcp.com",
      "headers": {
        "X-Api-Key": "ENTER_API_KEY",
        "X-BD-Site-URL": "https://www.your-site.com"
      }
    }
  }
}

🛠️ Advanced（お使いのマシンで実行します。Node.js が必要です）：

⚠️ 手順 1 — まず Node.js をインストールしてください（以下の設定を貼り付ける前に行ってください）：

nodejs.org にアクセスし、Get Node.js® をクリックします

Windows Installer (.msi) または macOS Installer をダウンロードします

ファイルをダブルクリックし、すべての画面で「次へ」をクリックして Node.js を完全にインストールします

この手順を省略すると、ログに spawn npx ENOENT が表示され、「MCP サーバーがありません」 という状態になります。

{
  "mcpServers": {
    "brilliant-directories": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "brilliant-directories-mcp@latest",
        "--api-key", "ENTER_API_KEY",
        "--url", "https://www.your-site.com"
      ]
    }
  }
}

ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えます。保存したら、VS Code を完全に終了して再起動してください。 保存するだけでは不十分です。Cline が MCP サーバーを読み込むのは、パネルの再読み込みや切り替え時ではなく、新たに起動したときだけです。

MCP Servers パネルに戻り、brilliant-directories が表示されていることを確認します。まだ有効になっていない場合は、切り替えてオンにします。
「完全に終了」とは、ウィンドウを閉じるだけではありません。 Cline が MCP サーバーを読み込むのは、VS Code を実際に再起動したときだけです：
- Windows： システムトレイ（右下。^ の下に隠れている場合があります）の VS Code アイコンを右クリックし、Quit を選択してから、再度開きます
- Mac： Cmd+Q を押すか、メニューバーから Code → Quit Visual Studio Code を選択してから、再度開きます

Cursor

最速の方法（インストール不要、30 秒）： Cursor Settings → MCP（または Model Context Protocol）→ Add new MCP server を開き、API キーとサイト URL を入力した簡単設定ブロックを貼り付けます。Cursor を完全に終了して再起動すると、ツールがチャットに表示されます。

または、~/.cursor/mcp.json を直接編集してブロックを貼り付けます。どちらの方法でも設定できます。

ローカルインストールをお好みですか？このまま読み進めてください。以下の Cursor Directory インストーラーでは、Advanced パス（npx の子プロセスとして実行）を設定します。

Advanced パス用 Cursor Directory ワンクリックインストール（ターミナル不要、ファイル編集不要）：

⚠️ 手順 1 — まず Node.js をインストールしてください（Cursor Directory インストーラーは npx の子プロセスを設定します）：

nodejs.org にアクセスし、Get Node.js® をクリックします

ダウンロードするもの：Windows Installer (.msi) または macOS Installer

ファイルをダブルクリックし、すべての画面で Next をクリックして Node.js を完全にインストールします

この手順を省略すると、Cursor に "no MCP servers" と表示され、ログに spawn npx ENOENT と記録されます。

開きます → cursor.directory/plugins/brilliant-directories
Install / Add to Cursor をクリックし、ブラウザーから Cursor を開くことを許可します。

Cursor に、ほとんどの項目が入力済みの "Install MCP Server?" プロンプトが表示されます。変更が必要な項目は 2 つです。

Name フィールドの名前を変更します（server のままにしないでください。汎用的すぎます）：

brilliant-directories-60031 — サイト ID ベース（推奨パターン）
brilliant-directories-mysite — サイト名ベース
brilliant-directories-main / brilliant-directories-staging / brilliant-directories-client-acme — ニックネーム
理由：Cursor ではすべての MCP がこの Name で一覧表示されます。後から 2 つ目の BD サイトを追加した場合、区別できるようにする必要があります。

環境変数を入力します — 右側のみ：

左側（変更しないでください）	右側（値を貼り付けます）
`BD_API_KEY`	BD API キー
`BD_SITE_URL`	`https://www.your-site.com` — `https://` を含め、末尾にスラッシュを付けないでください

API キー → BD Admin → Developer Hub → Generate API Key（BD ではキーは一度だけ表示されます。紛失した場合は新しいキーを生成してください）。
ほとんどの書き込み操作では 403 エラーが発生するため、キーで Advanced エンドポイントの権限を有効にする必要があります。開始前の準備を参照してください。

Install をクリックします。
Cursor を完全に終了して再起動します。
「完全に終了する」とは、ウィンドウを閉じるだけではありません。 Cursor が MCP サーバーを読み込むのは、完全に再起動したときだけです：
- Windows： システムトレイ（右下。^ の下に隠れている場合があります）の Cursor アイコンを右クリック → Quit を選択し、再度開きます
- Mac： Cmd+Q またはメニューバー → Cursor → Quit Cursor を選択し、再度開きます
ツールは Settings → Tools & MCP に表示されます。

プロのヒント — 複数サイトの管理： BD MCP を、異なる API キーと URL を指定し、それぞれ固有の Name（例：brilliant-directories-60031、brilliant-directories-marketing）を付けて複数回インストールします。その後、Cursor に "brilliant-directories-60031 で、上位のカテゴリーを一覧表示して" や "2 つのサイトのメンバー数を比較して" と指示できます。同じ方法は Claude Desktop と Claude Code でも使えます。代理店や複数ブランドを運営する方に便利です。

別の方法 — ディレクトリーのリンクが機能しない場合、または手動で設定する場合（クリックして展開）

### 代替方法 A — Cursor の設定 GUI（手動、ターミナル不要）

Cursor を開きます。
設定を開きます。
- **Mac：**メニューバー → Cursor → Settings → Cursor Settings
- **Windows / Linux：**File → Preferences → Cursor Settings
- または、コマンドパレット（Cmd/Ctrl+Shift+P）を開き、Open MCP Settings と入力します。
サイドバーで Tools & MCP をクリックします。
New MCP Server をクリックします。
設定ブロックを貼り付けます。ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えます。
**Save をクリックしてから、Cursor を完全に終了し、再起動します。**保存するだけでは不十分です。Cursor が MCP サーバーを読み込むのは、起動直後のみです。

代替方法 B — 設定ファイルを直接編集する

GUI に「Tools & MCP」が表示されない場合や、「New MCP Server」ボタンをクリックしても何も起きない場合に使用します。GUI の方法と同じ結果になります。

Cursor は、ホームディレクトリ内の隠しフォルダー .cursor にある mcp.json を読み込みます。

Mac / Linux

Finder（Mac）またはファイルマネージャー（Linux）を開きます。
Cmd+Shift+G（Mac）または Ctrl+L（Linux）を押して、「フォルダーへ移動」の入力欄を開きます。
~/.cursor と入力し、Enter キーを押します。
- 「フォルダーが存在しません」と表示された場合：~/ に移動し、.cursor という名前のフォルダーを新規作成します（先頭にドットが付きます）。その後、もう一度試します。
.cursor 内の mcp.json を TextEdit または任意のテキストエディターで開きます。ファイルがない場合は作成します。TextEdit を使用する場合：まず「ファイル」→「新規」→「フォーマット」メニュー→標準テキストにするを選択してから、mcp.json として保存します（mcp.json.txt ではありません）。
設定ブロックを貼り付けます。ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えます。保存してから、Cursor を完全に終了し、再起動します。

Windows

Windows キーを押し、File Explorer と入力して Enter キーを押します。
上部のアドレスバーをクリックします。%USERPROFILE%\.cursor と入力し、Enter キーを押します。
- 「Windows で見つかりません」と表示された場合：%USERPROFILE% に移動し、右クリックして 新規作成 → フォルダー を選択し、.cursor という名前を付けます（先頭にドットが付きます）。その後、もう一度試します。
.cursor 内の mcp.json をメモ帳で開きます。ファイルがない場合：空白の領域を右クリックして 新規作成 → テキストドキュメント を選択し、mcp.json に名前を変更します（拡張子に関する警告が表示されたら「はい」をクリックします）。
- .txt / .json の拡張子が表示されない場合：エクスプローラーの表示メニューで ファイル名拡張子 にチェックを入れます。
設定ブロックを貼り付けます。ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えます。保存してから、Cursor を完全に終了し、再起動します。

n8n

✅ MCP Client Tool は動作します — SSE トランスポートと専用 URL を使用してください。

n8n の組み込み MCP Client Tool ノードは当社のサーバーに接続し、すべての BD ツールを読み込みます。次のように設定してください。

フィールド	値
Server Transport	`Server Sent Events (Deprecated)`
MCP Endpoint URL	`https://brilliantmcp.com/sse`
Authentication	`Multiple Headers Auth`
Header 1	Name: `X-Api-Key` · Value: 32 文字の 16 進数 BD API キー
Header 2	Name: `X-BD-Site-URL` · Value: `https://www.your-site.com`

ノードを保存します。Tool ドロップダウンをクリックすると、すべての BD ツールが表示されます。任意のツールを選択し、Execute をクリックしてください。

なぜ「SSE (Deprecated)」で、「HTTP Streamable」ではないのですか？

MCP 仕様では、SSE は非推奨となり、HTTP Streamable が推奨されています。

n8n の SSE クライアントは、現在当社のサーバーに対して動作します。

n8n の HTTP Streamable クライアントには、当社が報告した既知の上流バグがあります。

当社のサーバーは両方のトランスポートに対応しています。n8n が HTTP Streamable クライアントを修正したら、Transport = HTTP Streamable にして https://brilliantmcp.com（/sse パスなし）に切り替えられます。サーバー側の変更は不要です。

なぜ https://brilliantmcp.com/sse なのですか？ メインの brilliantdirectories.com ドメインには、ゾーンレベルのセキュリティルール（ボットチャレンジ、地域ブロック）があり、マーケティングサイトを保護していますが、n8n の SSE ハンドシェイクも気づかれないままブロックされていました。brilliantmcp.com は、継承されたセキュリティ設定のない専用ゾーンで、n8n は問題なく接続できます。ホスト型 MCP エンドポイントの唯一の正式な URL です。

MCP を使わない場合の n8n の代替方法：

✅ HTTP Request ノード + OpenAPI インポート — n8n はネイティブで OpenAPI に対応しています。この仕様 URL をカスタム API としてインポートしてください。

https://raw.githubusercontent.com/brilliantdirectories/brilliant-directories-mcp/main/mcp/openapi/bd-api.json

n8n はすべての BD 操作用のノードを自動生成します。インポート時に BD サイトの URL と API キーを求められます。MCP プロトコルを一切使用せず、すべての BD 操作を利用できます。

✅ 通常の HTTP Request ノード — 1 つの HTTP Request ノードを https://www.your-site.com/api/v2/user/get に向け、ヘッダー X-Api-Key: ENTER_API_KEY を設定します。複数の BD エンドポイントにまたがるワークフローでは、複数のノードを連結してください。最もシンプルな設定です。

サーバーが正常に稼働しているか自分で確認しますか？ 公式の MCP Inspector（npx @modelcontextprotocol/inspector）をインストールし、https://brilliantmcp.com/sse に接続してください。Inspector は MCP クライアント仕様のリファレンス実装です。

Make.com

Make.com には、リモート MCP サーバーに接続する MCP Client アプリ（現在オープンベータ版）が用意されています。詳しくはMake の MCP Client ドキュメントをご覧ください。当社の Worker に接続するには、次の手順に従います。

シナリオに MCP Client モジュールを追加し、Create a connection をクリックします。
+ New MCP Server をクリックします（当社はまだ Make の認証済みサーバー一覧に掲載されていません）。
URL： https://brilliantmcp.com
API Key / Access token： 32 文字の BD API キー。
Save をクリックしてから、シナリオを更新し、Make が新しい接続を認識するようにします。

⚠️ Make のベータ版リリース時点での既知の制限事項： MCP Client の UI にはトークンフィールドが 1 つしかありません。当社の Worker では、2 つのカスタムヘッダー（X-Api-Key と X-BD-Site-URL の両方）が必要です。Make が API キーだけを送信すると、Worker は Missing X-BD-Site-URL header エラーで拒否します。本番シナリオを構築する前に接続をテストしてください。失敗した場合は、以下の HTTP 方法に切り替えてください。

代替方法（現在すぐに利用でき、すべての BD 操作に対応）： Make の標準 HTTP モジュールを https://www.your-site.com/api/v2/* に対して使用し、次のヘッダーを設定します。

X-Api-Key: <your 32-char BD API key>
X-BD-Site-URL: https://www.your-site.com

この方法では、BD の REST API に直接アクセスします。MCP を完全に介さず、すべてのエンドポイントに接続できます。

より洗練された UX を実現するには、当社の OpenAPI 仕様からカスタム Make アプリを作成することもできます。

Zapier

「MCP Client by Zapier」アプリは OAuth／Bearer Token のみをサポートしており、カスタムヘッダー用のフィールドがないため、Worker に対して認証できません（Make と同じく、単一トークンの制限があります）。

代わりに、次のいずれかの方法を使ってください。

BD の既存の Zapier アプリ（必要な機能が含まれている場合） — 同じ基盤 API、同じ API キーを使用します。
https://www.your-site.com/api/v2/* に対して Webhooks by Zapier を使い、カスタムヘッダー X-Api-Key: <your key> と X-BD-Site-URL: https://www.your-site.com を設定します。これにより BD の REST API に直接アクセスし、MCP を完全に経由しません — すべての BD 操作を利用できます。

Abacus.AI（ChatLLM Agent）

Abacus AI Agent は、Configure MCP ページ（Agent Settings → MCP Server Config）から、stdio（npm）とリモート（URL）の両方の MCP サーバーをサポートします。詳しくはAbacus の MCP ドキュメントをご覧ください。

✅ 推奨（stdio／npm — 2 つの認証情報を確実に渡せます）： 以下を MCP Server Config JSON に貼り付けます。Abacus のホスト環境でパッケージを実行し、API キーとサイト URL を引数として渡すため、カスタムヘッダーのサポートは不要です。

{
  "brilliant-directories": {
    "command": "npx",
    "args": [
      "-y",
      "--prefer-online",
      "brilliant-directories-mcp@latest",
      "--api-key", "ENTER_API_KEY",
      "--url", "https://www.your-site.com"
    ]
  }
}

ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えてください。Abacus がサーバーに問い合わせ、すべての BD ツールを一覧表示します。

🚀 リモート URL（Abacus の MCP 設定がカスタムヘッダーを受け付ける場合のみ）： Worker には 2 つのヘッダー（X-Api-Key と X-BD-Site-URL の両方）が必要です。Abacus のドキュメントにあるリモートサーバーの例は url フィールドのみを示しています。設定で headers/env ブロックも受け付ける場合は、次を使用してください。

{
  "brilliant-directories": {
    "url": "https://brilliantmcp.com",
    "headers": {
      "X-Api-Key": "ENTER_API_KEY",
      "X-BD-Site-URL": "https://www.your-site.com"
    }
  }
}

Abacus が単一トークンのみを送信し（2 つ目のヘッダーがない場合）、Worker が Missing X-BD-Site-URL header で拒否した場合は、代わりに上記の stdio 設定を使ってください。

サーバー設定の JSON のみを貼り付けてください。{ "mcpServers": { ... } } のラッパーは含めないでください — Abacus が必要とするのは内側のオブジェクトです。Abacus で設定できるのは最大 5 サーバー／50 個の有効なツールです。BD サーバーだけで 50 個を超えるツールを公開するため、他のサーバーは軽量に保つか、有効にするツールの範囲を絞ってください。

curl／任意の HTTP クライアント

以下をターミナルに貼り付けてください（Mac：Terminal.app · Windows：PowerShell）。ENTER_API_KEY を BD API キーに、https://www.your-site.com を BD サイトの URL に置き換えてください。

これらの例で X-BD-Site-URL ではなく X-Api-Key のみが必要な理由： これらの呼び出しは、MCP Worker を経由せず、BD サイト（your-site.com/api/v2/...）に直接アクセスします。X-BD-Site-URL ヘッダーが必要なのは、ホスト型 Worker（https://brilliantmcp.com）を呼び出す場合だけです — Worker はこのヘッダーを使って適切な BD サイトにルーティングします。BD サイトを直接呼び出す場合、URL 自体がルーティング情報になります。

# Verify your API key
curl -H "X-Api-Key: ENTER_API_KEY" https://www.your-site.com/api/v2/token/verify

# List members
curl -H "X-Api-Key: ENTER_API_KEY" https://www.your-site.com/api/v2/user/get?limit=10

# Create a member
curl -X POST -H "X-Api-Key: ENTER_API_KEY" \
  -d "[email protected]&password=secret123&subscription_id=1&first_name=Jane&last_name=Doe" \
  https://www.your-site.com/api/v2/user/create

# Search members (spaces in values need URL-encoding as + or %20)
curl -X POST -H "X-Api-Key: ENTER_API_KEY" \
  -d "q=dentist&address=Los+Angeles&limit=10" \
  https://www.your-site.com/api/v2/user/search

# Update a member
curl -X PUT -H "X-Api-Key: ENTER_API_KEY" \
  -d "user_id=42&company=New Company Name" \
  https://www.your-site.com/api/v2/user/update

AI に依頼できること

接続すると、AI は BD サイトのデータを読み取り、書き込みできます。プロンプトの例：

「今月登録したメンバーをすべて一覧表示して」
「Jane Doe という名前で、メールアドレスが [email protected] の新しいメンバーを作成して」
「メンバー 42 が投稿した『Welcome to our directory』というタイトルのブログ投稿を追加して」
「未払いの請求書を表示して」
「Jane に VIP タグを追加して」
「ヒーローセクションを含む新しいランディングページを /promo に作成して」

メンバー、投稿、リード、レビュー、ページ、フォーム、メニュー、ウィジェット、メールテンプレート、タグ、リダイレクト、スマートリスト、カテゴリー、メンバーシッププランなどを幅広くカバーしています。

成功時の動作： AI が依頼したデータを返すか、新しい ID とともに操作の完了を確認します。 失敗時の動作： AI が「アクセスできません」、「利用可能なツールがありません」、「不明な関数」などと応答します。→ トラブルシューティングに進んでください。

⚠️ AI はライブデータを削除および変更することもできます。 書き込みはライブサイトに直接反映され、取り消しはできません。一括操作や破壊的な操作を実行する前に、まず 1 件のレコードでテストしてください。バックアップの作成も検討してください。判断に迷う場合は、操作を実行する前に、AI にプレビュー（一覧表示／表示）を依頼してください。

成長自動化スキル（bd-skill-content）

このリポジトリには、BD MCP を利用して、公開ソースの調査、SEO に強い投稿の作成、重複の排除、BD サイトへの投稿といった効果の高いコンテンツワークフローを実行する、付属の Claude Skill が含まれています。

ダウンロード

GitHub リリースページから最新のスキル zip を入手してください：bd-skill-content.zip。

インストール

claude.ai を開き、Settings → Customize → Skills → Upload Skill の順に選択します。
ダウンロードした bd-skill-content.zip ファイルをアップロードします。
BD MCP が接続されていることを確認します（ホスト型の https://brilliantmcp.com または npm でインストールしたローカルサーバーのいずれか）。
チャットを開始し、Claude に希望する内容を伝えます：「オースティンで開催予定のフィットネスイベントの投稿を作成して。」

v0.1 のコンテンツタイプ

イベント — 公開ウェブソース（商工会議所のサイト、観光局、市民向けカレンダー、公開されている Eventbrite ページなど）から地域のイベントを調査し、FAQ、関連イベントへの内部リンク、出典表記、Nominatim でジオコーディングした座標を含む、構造化されたイベント投稿を作成します。

今後のリリースでは、さらに多くのコンテンツタイプ（求人、不動産、ブログ、SEO ランディングページ）を追加する予定です。これらも同じ共通の方法論に基づき、同じ zip に含まれます。

デフォルト設定

自律実行ではデフォルトで下書きを作成します（公開前に確認できます）
無料で実行できます（API キーや有料サービスは不要です）
ホワイトハットなスクレイピングを行います（事実のみ、公開ページのみ、常に出典を明記）
現実的な実行時間：投稿 10～20 件で 30～60 分

ソースからビルド

スキルのソースは bd-skill-content/ にあります。zip を自分で再ビルドするには：

node scripts/build-skill-zip.js
# Output: bd-skill-content/bd-skill-content.zip

すべては同じ基盤に基づいています：共通の調査方法、品質ゲート、重複排除、粗雑さを避ける文体、ホワイトハットな情報源の利用。

アップデートは自動です

一度設定すれば、AI アプリを完全に終了して再起動したときに、新しい MCP バージョンが自動的に適用されます。

トラブルシューティング

1つのコマンドで設定を確認できます。 ターミナルに貼り付けてください（Mac：Terminal.app · Windows：PowerShell）。ENTER_API_KEY をBD APIキーに、https://www.your-site.com をBDサイトのURLに置き換えてください：

npx --prefer-online brilliant-directories-mcp@latest --verify --api-key ENTER_API_KEY --url https://www.your-site.com

認証情報が有効な場合は OK を、そうでない場合はエラーとともに FAIL を出力します。接続に問題がある場合は、まずこれを試してください。

デバッグモード — 実際の動作を確認する：

npx --prefer-online brilliant-directories-mcp@latest --debug --verify --api-key ENTER_API_KEY --url https://www.your-site.com

すべてのAPIリクエストとレスポンスをstderrに記録してから終了します（APIキーは自動的にマスキングされます）。正常に動作しない場合に、出力をBDサポートと共有する際に便利です。

--verify を削除すると、デバッグログを有効にした状態でMCP stdioサーバー全体が起動します。MCP サーバーはAIクライアントの接続を待ちながらstdio経由で常時実行されるため、通常のターミナルではハングしたように見えます。シェルから1回限りのデバッグを行うには、--debug --verify を使用してください。

よくある問題：

AIが「ツールがありません」または「アクセスできません」と言う — 設定後にAIアプリを完全に終了して再起動していません。アプリを完全に終了し（Macでは Cmd+Q、Windowsではタスクバーを右クリック → 終了）、再起動してください。
401 Unauthorized — APIキーが間違っている、取り消されている、またはエンドポイントへのアクセス権限がありません。BD Admin → Developer Hubで再生成してください。
403 API Key does not have permission to access this endpoint — このエンドポイントがAPIキーに許可されていません。BD Admin → Developer Hubでキーを編集し、不足しているエンドポイントを有効にしてください（エラーにエンドポイント名が表示されます）。
404 Not Found — サイトのURLが間違っています。https:// を含め、末尾にスラッシュを付けず、サイトが応答する正規の形式と一致させてください（サイトで www. を使用している場合は含めます）。正しい例：https://www.mysite.com。間違った例：mysite.com、https://mysite.com/、またはサイトが実際には www.mysite.com で応答している場合の https://mysite.com。
429 Too Many Requests — レート制限に達しました（デフォルトは100件／60秒）。60秒待つか、BDサポートにメールして、サイトの上限を最大1,000件／分に引き上げてもらってください。
Claudeからの Unknown tool — MCP サーバーが読み込まれていません。まずAIアプリを完全に終了して再起動してください。それでも解決しない場合、npxのキャッシュに古いインストールが残っています：
- Windows PowerShell： Remove-Item -Recurse -Force "$env:LOCALAPPDATA\npm-cache\_npx"
- Mac/Linux Terminal： rm -rf ~/.npm/_npx
- その後、アプリを完全に終了して再起動してください。設定の -y により npx が自動的に再ダウンロードするため、npm install -g brilliant-directories-mcp を実行する必要はありません。
npx: command not found または spawn npx ENOENT — Node.jsがインストールされていないか、Nodeのインストール前にAIアプリを起動しています。nodejs.orgからインストールし、AIアプリを完全に終了して再起動してください。それでも表示される場合は、コンピューターを再起動してください（まれですが、インストール後に残ることがあるWindowsの PATH キャッシュの問題が解決します）。
ETARGET No matching version found — ローカルのnpmキャッシュが古くなっています。上記の設定例のように設定引数へ --prefer-online を追加すると、この問題を防げます。まだ設定に追加されていない場合は、npm cache clean --force を実行してAIアプリを再起動してください。
「not valid MCP server configurations」（Claude Desktop） — claude_desktop_config.json は url 形式のブロックを受け付けません。Claude DesktopのセクションにあるAdvanced（npm/stdio）設定を使用してください。Microsoft Store版のClaude Desktopを使用しているWindowsユーザーは、claude.ai/downloadからアンインストールして再インストールしてください（Store版では設定がサンドボックス化されており、MCPの読み込みが通知なしに失敗することがあります）。

認証

2つの認証情報を、各リクエストでHTTPヘッダーとして送信します。OAuth、Bearerトークン、署名は不要です。

ヘッダー	値	必須	備考
`X-Api-Key`	BD APIキー	はい	リクエストを認証します。Admin → Developer Hub → Generate API Key。
`X-BD-Site-URL`	`https://www.your-site.com`	はい	APIキーを対応するBDサイトと紐付けます。完全な正規URL（`https://` を含み、ホスト名を正確に指定し、末尾にスラッシュを付けない形式）。

汎用 MCP クライアントのリファレンス

汎用 MCP クライアント（LibreChat、カスタムエージェントなど）では、共通して次の4つの項目を設定します。この表を使って設定してください。

クライアントが尋ねる項目	入力する値
MCP Server URL / Endpoint URL / Remote Server URL	`https://brilliantmcp.com`（`/sse` なし、末尾にパスなし）
Transport	`Streamable HTTP`（「HTTP Streamable」とも呼ばれます）。SSE ではありません。 WebSocket ではありません。
Custom / Multiple Headers	次の2項目：`X-Api-Key: <your key>` と `X-BD-Site-URL: https://www.your-site.com`
OAuth	オフ／いいえ／無効 — OAuth は使用しません
Bearer Token	空欄のまま — Bearer 認証は使用しません

n8n は例外です。 n8n の Streamable HTTP クライアントには上流のバグがあるため、n8n ユーザーは Transport = Server Sent Events (Deprecated) と URL https://brilliantmcp.com/sse（/sse パス付き）を使用する必要があります。正確なフィールド値については、n8n のセクションを参照してください。当社のサーバーは両方のトランスポートに対応していますが、現時点では n8n では旧式のトランスポートが必要です。

ほかの MCP クライアントが使えるかどうかの見分け方： 常に確認すべきなのは、「このクライアントはカスタム HTTP ヘッダーを送信できるか」です。UI に Custom Headers／Multiple Headers／HTTP Headers フィールドがあれば使用できます。2つのヘッダーを入力してください。UI で OAuth または Bearer Token しか選べない場合、そのクライアントは現時点では当社の Worker に接続できません。

レート制限

デフォルト： API キーごとに60秒あたり100リクエストです。
申請時： 最大で1分あたり1,000リクエストです。サイトの制限を引き上げるには、Brilliant Directories サポートチームにお問い合わせください（100～1,000件／分の範囲で設定できます）。

制限は BD によってサーバー側で設定されており、管理画面からセルフサービスで変更する設定ではありません。大量の API 利用を予定している場合は、一括操作の前に BD サポートへメールで連絡し、一時的または恒久的な上限引き上げを依頼してください。

制限を超えると、API は HTTP 429 Too Many Requests を返します。MCP サーバーはこれを、AI エージェントが対応できるエラーとして提示します。エージェントは処理を控えるか、より高い上限を申請するよう提案します。

一括操作を計画する： エージェントに数百件のレコードのインポートや更新を依頼する場合は、（a）まず BD サポートに上限の引き上げを依頼するか、（b）エージェントに処理のペースを調整するよう指示してください（例：「この500人のメンバーをインポートし、1分あたり100件のレート制限を守るために間隔を空けてください」）。

ページネーション

すべてのリストエンドポイントはページネーションに対応しています。

パラメーター	説明
`limit`	1ページあたりのレコード数（デフォルトは25、最大100）
`page`	前回のレスポンスに含まれる `next_page` のカーソルトークン

レスポンスには次の項目が含まれます：total、current_page、total_pages、next_page、prev_page

フィルタリング

すべてのリストエンドポイントはフィルタリングに対応しています。構文は AI が処理するので、自然な言葉で依頼するだけです（「今月追加されたロサンゼルスのメンバー」、「タイトルに sale を含むページ」など）。HTTP を直接使ってフィルタリングする必要がある場合（curl、Postman、Zapier の Webhook など）、フィルターパラメーターは property、property_value、property_operator です。複数の条件で検索する場合は、property[] 配列として繰り返し指定できます。演算子の完全なリファレンスは、MCP ツールの説明と SKILL.md に記載されています。

並べ替え

GET /api/v2/user/get?order_column=last_name&order_type=ASC

利用可能なリソース

Operations 列について： list, get, create, update, delete のような短い動詞は、動詞をリソースの前に付けることで MCP ツール名に対応します（例：Reviews → listReviews、getReview、createReview...）。同じ動詞が複数のリソースのサブタイプに対応する場合（例：単一画像投稿と複数画像投稿は /api/v2/data_posts/ と /api/v2/users_portfolio_groups/ のパスを共有しますが、別々のツールです）、曖昧さを避けるため、この表では完全なツール名を記載しています。

リソース	ベースパス	操作
ブランドキット	`/api/v2/website_design_settings/`	getBrandKit
クリック数（プロフィール分析）	`/api/v2/users_clicks/`	list, get, create, update, delete
データタイプ	`/api/v2/data_types/`	list, get, create, update, delete
メールテンプレート	`/api/v2/email_templates/`	list, get, create, update, delete
フォームフィールド	`/api/v2/form_fields/`	list, get, create, update, delete
フォーム	`/api/v2/form/`	list, get, create, update, delete
フォーム受信箱	`/api/v2/form_inquiries/`	listFormInquiries, getFormInquiry
リードの一致	`/api/v2/lead_matches/`	list, get, create, update, delete
リード	`/api/v2/leads/`	list, get, create, match, update, delete
メンバー ↔ サブカテゴリーのリンク	`/api/v2/rel_services/`	listMemberSubCategoryLinks, getMemberSubCategoryLink, createMemberSubCategoryLink, updateMemberSubCategoryLink, deleteMemberSubCategoryLink
メンバーシッププラン	`/api/v2/subscription_types/`	list, get
メニュー項目	`/api/v2/menu_items/`	list, get, create, update, delete
メニュー	`/api/v2/menus/`	list, get, create, update, delete
複数画像投稿の写真	`/api/v2/users_portfolio/`	listMultiImagePostPhotos, getMultiImagePostPhoto, createMultiImagePostPhoto, updateMultiImagePostPhoto, deleteMultiImagePostPhoto
複数画像投稿	`/api/v2/users_portfolio_groups/`	listMultiImagePosts, getMultiImagePost, createMultiImagePost, updateMultiImagePost, deleteMultiImagePost, getMultiImagePostFields
投稿タイプ	`/api/v2/data_categories/`	list, get, update, delete, custom_fields
リダイレクト（301）	`/api/v2/redirect_301/`	list, get, create, update, delete
レビュー	`/api/v2/users_reviews/`	list, get, create, update, delete
単一画像投稿	`/api/v2/data_posts/`	listSingleImagePosts, getSingleImagePost, createSingleImagePost, updateSingleImagePost, deleteSingleImagePost, getSingleImagePostFields
サイト情報	`/api/v2/site_info/`	getSiteInfo
スマートリスト	`/api/v2/smart_lists/`	list, get, create, update, delete
サブカテゴリー	`/api/v2/list_services/`	listSubCategories, getSubCategory, createSubCategory, updateSubCategory, deleteSubCategory
タググループ	`/api/v2/tag_groups/`	list, get, create, update, delete
タグの関連付け	`/api/v2/rel_tags/`	list, get, create, update, delete
タグタイプ	`/api/v2/tag_types/`	list, get
タグ	`/api/v2/tags/`	list, get, create, update, delete
トップカテゴリー	`/api/v2/list_professions/`	listTopCategories, getTopCategory, createTopCategory, updateTopCategory, deleteTopCategory
配信停止	`/api/v2/unsubscribe_list/`	list, get, create, update, delete
ユーザーメタデータ	`/api/v2/users_meta/`	list, get, update, delete
ユーザー写真	`/api/v2/users_photo/`	list, get, create, update, delete
ユーザー／メンバー	`/api/v2/user/`	list, get, create, update, delete, search, login, transactions, subscriptions, fields
ウェブページ（SEO／静的）	`/api/v2/list_seo/`	listWebPages, getWebPage, createWebPage, updateWebPage, deleteWebPage
ウェブサイト設定	`/api/v2/website_settings/`	refreshSiteCache
ウィジェット	`/api/v2/data_widgets/`	list, get, create, update, delete, render

フィールドの検出

一部のエンドポイントでは、動的なフィールドの検出がサポートされています。

# Get all available user fields
curl -H "X-Api-Key: ENTER_API_KEY" https://www.your-site.com/api/v2/user/fields

# Get custom fields for a specific post type
curl -H "X-Api-Key: ENTER_API_KEY" https://www.your-site.com/api/v2/data_posts/fields?form_name=my-form

安定したアセット URL

URL で仕様をインポートするツール（ChatGPT Actions、n8n、Postman）向け：

https://raw.githubusercontent.com/brilliantdirectories/brilliant-directories-mcp/main/mcp/openapi/bd-api.json

セキュリティ

API キーがパッケージに埋め込まれることはありません
すべてのリクエストは、ユーザーのマシンから BD サイトに直接送信されます
データがサードパーティのサーバーを経由することはありません
API キーの権限によって、アクセス可能なエンドポイントが制御されます
API キーはパスワードと同様に扱ってください

よくある質問

費用はかかりますか？ MCP サーバーは無料です（MIT ライセンス、オープンソース）。AI エージェントのサブスクリプション（Claude、Cursor など）は別途必要です。BD サイトへの API 呼び出しは、サイトのレート制限に含まれますが、追加料金はかかりません。

データは Anthropic／OpenAI／サードパーティに送信されますか？ BD サイトのデータは、BD サイトからマシン上の AI クライアントに直接送信され、その後、AI との会話の一部として、利用する AI プロバイダー（Anthropic、OpenAI など）に送信されます。MCP サーバー自体がデータをほかの場所に中継することはありません。テレメトリーも、途中で経由するサードパーティのサーバーもありません。

複数の BD サイトに接続できますか？ はい。mcpServers に異なる名前（例：bd-site-a、bd-site-b）で複数のエントリーを追加し、それぞれに独自の API キーと URL を設定してください。AI から両方のツールを利用できます。

チームで 1 つのキーを共有できますか？それとも各自でキーを用意するべきですか？ 各自で独自の API キーを生成してください（BD Admin → Developer Hub）。キーはユーザーごとに発行されるため、1 つのキーを取り消しても、ほかのユーザーには影響しません。

MCP を切断／削除するにはどうすればよいですか？

Claude Code：claude mcp remove brilliant-directories
Cursor／Windsurf／Cline：MCP 設定 JSON ファイルから brilliant-directories のエントリーを削除して保存し、アプリを完全に終了してから再起動してください。

AI が行った操作を元に戻すにはどうすればよいですか？ BD の API には、あらゆる操作に対応する汎用的な元に戻す機能はありません。会員については、deleteUser よりも、取り消し可能な updateUser active=3（キャンセル済み）を優先してください。破壊的な操作を行う場合は、事前にバックアップするか、1 件のレコードでテストしてください。

本番環境の前に、テストサイトで安全に試せますか？ はい。BD のステージング／開発サイトで別の API キーを生成し、その URL とキーを MCP 設定に指定してください。ワークフローに問題がないと確認できたら、本番環境に切り替えてください。

API キーで権限があるエンドポイントを確認するにはどうすればよいですか？ BD Admin → Developer Hub でキーを確認してください。403 API Key does not have permission to access this endpoint が表示された場合、エラーに権限がないエンドポイントが示されます。そのキーで有効にして保存し、再試行してください。

サポート

バグ報告／機能リクエスト： https://github.com/brilliantdirectories/brilliant-directories-mcp/issues
BD サポート： https://support.brilliantdirectories.com
API ドキュメント： https://support.brilliantdirectories.com/support/solutions/articles/12000108045

Markdown 対応

ログインしてコメント

基本情報

作者: brilliantdirectories
言語: node
バージョン: 6.58.612
トランスポート: stdio
掲載日: 2026年4月18日
最終更新: 2 週間前
公式 Registry: io.github.brilliantdirectories/brilliant-directories-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。