mcpField
B
Brilliant Directories MCP

Brilliant Directories MCP

本地服务
github.com/brilliantdirectories商业与营销182 周前更新
代码仓库

关于 Brilliant Directories MCP

Brilliant Directories MCP 是面向 Brilliant Directories 网站的 MCP 服务，供 AI Agent 通过 API 管理站点内容与会员数据。它支持多类 REST API 资源，并可选择连接托管服务或在本机运行。

主要功能

  1. 01管理会员、帖子和潜在客户
  2. 02管理评价、页面与重定向
  3. 03编辑表单、菜单和标签
  4. 04配置邮件模板与会员计划
  5. 05托管连接或本机运行

适用场景

  1. 01通过 AI Agent 更新目录站点内容
  2. 02创建或维护会员与潜在客户记录
  3. 03管理页面、表单及站点导航

MCP 相关

作为 MCP 服务，它向 AI 客户端开放 Brilliant Directories REST API 所涵盖的资源管理能力。连接时需要 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.612

工具

170

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

官方 Brilliant Directories MCP 服务 — 设置指南

npm version license MCP

为你的 BD 网站提供通用 AI 集成。只需一个 API 密钥，即可让任何 AI Agent 完全访问你的 Brilliant Directories 网站。

管理会员、帖子（单图和多图）、潜在客户、评价、顶级和子类别、电子邮件模板、页面（首页、着陆页）、301 重定向、智能列表、小组件、菜单、表单、标签、会员计划等 BD 通过 REST API 提供的所有资源。

本指南将带你将所选 AI（Claude、Cursor 等）连接到 BD 网站。选择下方的 AI 应用，粘贴两项内容，然后重启。大多数设置可在 5 分钟内完成。

⚠️ 要求 — 开始之前

  1. 你的 BD 网站 URL。 使用它在浏览器中打开时显示的完整规范 URL — 包含 https://（如果网站没有 SSL，则使用 http://），如果网站使用 www.，也要包含 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 — 请使用网站规范响应的形式

  2. 你的 BD API 密钥。

    BD Admin → Developer Hub → Generate API Key → 复制密钥。

    完整操作指南：如何创建 API 密钥。

  3. Node.js — 仅限高级路径（见下文）。简易路径无需安装。如果需要，可从 nodejs.org 一次性安装（点击 Get Node.js® 下载，然后点击 Windows Installer (.msi) — Mac：macOS Installer — 双击下载的文件进行安装，并按提示点击“下一步”）。

🚨 API 权限 — 务必设置

新的 BD API 密钥默认处于锁定状态 — 仅启用会员读取/写入权限。

所有其他资源（网页、表单、菜单、标签、电子邮件模板、评价、潜在客户、类别、帖子类型、小组件等）都由 “Advanced Endpoints” 开关控制。在启用该选项之前，访问这些资源会返回 403 API Key does not have permission to access this endpoint。

几乎所有首次使用的用户都会遇到这个问题。 如果你的 AI 能列出会员，却无法创建页面或更新表单，请先别继续排查 — 问题就在这里。

启用 Advanced Endpoints：

  1. BD Admin → Developer Hub
  2. 在列表中找到你的 API 密钥 → Actions 下拉菜单 → Permissions
  3. 点击 Advanced Endpoints 标签页
  4. 将所有选项切换为 ON（也可以只选用到的资源 — 但全部开启是避免反复遇到此问题最快的方法）
  5. 点击 Save Permissions

更改会立即生效 — 无需轮换密钥，也无需重启 AI。重新执行失败的请求即可成功。

想阻止 AI 删除任何内容？ 在 Advanced Endpoints 下取消勾选所有 delete 操作。AI 仍可读取、创建和更新 — 但任何 delete* 工具调用都会返回 403，而不会清除数据。对于不应让 AI 执行破坏性操作的生产网站，这是一个很好的基础设置。

BD 为什么默认锁定这些权限： 遵循最小权限原则。即使密钥泄露，只具有基础权限的密钥也只能读取/写入网站上的会员，而无法重写整个目录。确定 Agent 实际需要哪些端点后，可以将权限精简到仅保留这些端点。

目录

按平台设置

每个平台都有两个选项：

  • 🚀 简易配置块 — 指向我们托管的 MCP：https://brilliantmcp.com。无需 Node.js、无需安装、无需终端。保存并重启 AI 应用后即可开始使用。

  • 🛠️ 高级配置块 — 在你的计算机上以 npx 子进程的形式启动 MCP。适用于希望在自己的硬件上运行 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（完整规范形式 — 使用 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
  • 双击文件 → 在所有提示中点击 Next，完成 Node.js 安装

如果跳过此步骤，日志中会出现 spawn npx ENOENT，并显示 “no MCP servers”。

为什么要使用 --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：**右键点击系统托盘中的应用图标（右下角，可能隐藏在 ^ 下）→ Quit，然后重新打开
  • **Mac：**按 Cmd+Q，或在菜单栏中选择 → Quit ，然后重新打开
Claude Desktop

⚠️ Claude Desktop 需要 Node.js + Advanced（npm）配置。 它不接受 Easy 的 url 格式配置块，只接受 stdio（command + args）。

⚠️ Windows 用户： 请从 claude.ai/download 安装 Claude Desktop，不要从 Microsoft Store 安装（Store 版本会对配置文件进行沙箱隔离）。

横幅提示“无法提交工具结果……连接中断”？ 这是所有 MCP 连接器都会遇到的外观问题 (anthropics/claude-code #51874)——工具仍然可以正常使用，可以放心忽略。

⚠️ 步骤 1 — 先安装 Node.js（再粘贴下面的配置）：

  • 前往 nodejs.org → 点击 Get Node.js®
  • 下载：Windows Installer (.msi) 或 macOS Installer
  • 双击文件 → 对所有提示都点击 Next，完成 Node.js 安装

如果跳过此步骤，日志中会显示 spawn npx ENOENT，并提示 “没有 MCP 服务”。

操作步骤（无需终端）：

  1. 打开 Claude Desktop。

  2. 菜单栏 → 设置。

    Developer 标签页 → Edit Config。

    这会在 TextEdit（Mac）或记事本（Windows）中打开 claude_desktop_config.json。

  3. 选择你的使用场景：

场景 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 服务）

合并，不要覆盖。遵循两条规则：

  • 顶层条目之间用逗号分隔。
  • 底部的最终 } 保留一个右花括号。

之前：

{
  "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"
      ]
    }
  }
}

有两处改动：在 preferences 的右花括号 } 后添加了 ,，并在最终的 } 前添加了 mcpServers 配置块。将 ENTER_API_KEY 替换为你的 BD API 密钥，并将 https://www.your-site.com 替换为你的 BD 网站 URL。保存后，完全退出并重新打开 Claude Desktop。

重启前，请将最终文件粘贴到 jsonlint.com，确保格式正确。

缺少逗号会导致 MCP 服务无声失效，验证器能立即标出问题。

  1. 完全退出并重新打开 Claude Desktop。 开始新的聊天。

    “完全退出”不仅仅是关闭窗口——Claude 只会在真正重新启动时加载 MCP 服务：

    • Windows： 右键点击系统托盘（右下角，图标可能隐藏在 ^ 下）的 Claude 图标 → 退出，然后重新打开
    • Mac： 按 Cmd+Q，或点击菜单栏 → Claude → 退出 Claude，然后重新打开

  2. 确认 BD MCP 已加载。 具体界面因 Claude Desktop 版本而异：

    • 在任意聊天中询问 “你有哪些工具？”——你应该能看到列出的 brilliant-directories 工具。
    • 或者查看 设置 → Developer → MCP servers——brilliant-directories 应显示为已连接（没有错误状态）。
    • 较旧版本还会在聊天输入框附近显示一个带工具数量的 🔨 锤子图标——点击即可查看工具。

未连接？ 在 设置 → Developer → MCP servers 中查看错误信息。常见原因：

  • JSON 拼写错误——将文件粘贴到 jsonlint.com
  • API 密钥错误，或 URL 缺少 https:// / 末尾带有斜杠
  • 未安装 Node.js（Claude Desktop 会启动 npx）
  • 看到 “不是有效的 MCP 服务配置”？你粘贴了 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 图形界面 — 请通过终端安装。可在 Terminal.app（Mac）、PowerShell（Windows）或 Cursor / VS Code 内置终端中使用（按 Ctrl+` / Cmd+` 或选择 视图 → 终端 打开）。

前置条件 — 一次性安装：

  1. Node.js — 从 nodejs.org 获取（点击 Get Node.js® → Windows Installer (.msi) 或 macOS Installer → 双击安装，并根据提示点击“下一步”）。

  2. claude CLI — 在任意终端中运行：

    npm install -g @anthropic-ai/claude-code

    关闭并重新打开终端。运行 claude --version 进行验证。

以下是三个选项 — 选择最适合你的方式。

⚡ 插件（单行安装；如果你的 Claude Code 支持，推荐使用）

在已启动的 claude 会话中，运行以下两个斜杠命令：

/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。

🛠️ 高级（BD MCP 通过 npx 在本地运行）
claude mcp add brilliant-directories -- npx -y --prefer-online brilliant-directories-mcp@latest --api-key ENTER_API_KEY --url https://www.your-site.com

格式相同，但会在你的机器上以 npx 子进程的形式运行 MCP 服务。替换占位符。运行 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 原生 Agent 的配置相互独立。**在其中一个地方安装，不会自动安装到另一个地方。

**注意：**Claude 扩展和 Claude Code CLI 都读取同一个文件——~/.claude.json（Windows：C:\Users\<you>\.claude.json）。如果你已按照上面的章节配置了 Claude Code，Claude 扩展也已经加载了 BD MCP。本章节适用于只使用 Claude 扩展、未安装 CLI 的用户。

两套不同的 MCP 配置。工具显示在两个不同的位置。

1. Claude 扩展（在 Cursor 或 Claude Code CLI 中）

  • 配置文件（Windows）：C:\Users\<you>\.claude.json
  • 配置文件（Mac / Linux）：~/.claude.json
  • 工具显示位置：与 Claude 聊天时——询问 “你有哪些工具” 或输入 /mcp

2. Cursor 原生 Agent

  • 配置文件（Windows）：C:\Users\<you>\.cursor\mcp.json
  • 配置文件（Mac / Linux）：~/.cursor/mcp.json
  • 工具显示位置：Cursor Settings → Tools & MCP

最简单的设置方法——用记事本编辑 JSON 文件（无需终端，也无需 claude CLI）：

⚠️ 第 1 步——先安装 Node.js（然后再编辑下面的配置）：

  • 前往 nodejs.org → 点击 Get Node.js®
  • 下载：Windows Installer (.msi) 或 macOS Installer
  • 双击文件 → 对所有提示都点击 Next，完成 Node.js 安装

如果跳过此步骤，日志中会显示 spawn npx ENOENT，并提示 “no MCP servers”。

  1. **打开文件。**将路径粘贴到文件资源管理器（Windows）的地址栏，或 Finder（Mac）的 前往 → 前往文件夹。如果文件尚不存在，请在该路径下创建一个名为 .claude.json 的空白文本文件。

  2. **将以下内容粘贴到文件中。**如果文件已有内容且包含 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"
      ]
    }
  }
}

  3. 将 ENTER_API_KEY 替换为你的 BD API 密钥，并将 https://www.your-site.com 替换为你的 BD 网站 URL（包含 https://，末尾不要加斜杠）。

  4. 保存文件，然后完全退出并重新打开 Cursor，让 Claude 扩展加载新配置。仅保存是不够的。

  5. 与 Claude 聊天并询问 “你有哪些工具？”——你应该会看到 brilliant-directories 工具列表。

**Cursor 的 Tools & 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，可选择 Claude Desktop / Cursor / Windsurf / Cline 等 GUI 替代方案。

Codex Desktop 设置

1. 下载 Codex Desktop，从 chatgpt.com/codex/get-started 下载并安装。

2. 打开 Codex Desktop → File → Settings → MCP Servers → + Add Server。

系统会打开一个“Connect to a custom MCP”表单，包含两个标签页：STDIO（高级 — 在本地运行，需要 Node.js）和 Streamable HTTP（简易 — 使用托管 Worker，无需 Node.js）。两种方式都可行，任选其一。

🚀 简易方式（Streamable HTTP — 推荐，无需安装 Node.js）：

点击 Streamable HTTP 标签页。按从上到下的顺序填写表单：

字段（Codex 中显示的名称）值
NameBrilliant Directories（或任意标签）
URLhttps://brilliantmcp.com
Bearer token env var留空 — 不要修改
Headers — KeyX-Api-Key
Headers — Value你的 BD API 密钥
点击 + Add header 添加第二行
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
  • 双击文件 → 对每个提示都点击 Next，完成 Node.js 安装

如果跳过这一步，日志中会出现 spawn npx ENOENT，并显示 “no MCP servers”。

点击 STDIO 标签页。按从上到下的顺序填写表单：

字段（Codex 中显示的名称）值
NameBrilliant Directories（或任意标签）
Command to launchnpx
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留空 — 不要修改

点击 Save，然后彻底退出并重新打开 Codex。 仅保存还不够 — Codex 只会在重新启动时加载 MCP 服务。

“彻底退出”不只是关闭窗口 — 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 服务使用 serverUrl（而非 url）。**下方的 Easy 配置块已采用该设置。

  1. 打开 Windsurf。
  2. 打开设置：点击窗口右下角的 Windsurf - Settings，或打开命令面板（Cmd/Ctrl+Shift+P）→ 输入 Open Windsurf Settings。
  3. 在设置中找到 Cascade 部分 → Model Context Protocol (MCP) → 启用。
  4. 在窗口右侧的 Cascade 面板中，点击面板右上角的 MCPs 图标 → Configure。这会打开 MCP 配置文件。
  5. 粘贴以下其中一种（推荐 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，并显示 “no MCP servers”。

{
  "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 扩展）
  1. 打开已安装 Cline 扩展的 VS Code。
  2. 点击 VS Code 侧边栏中的 Cline 图标，打开 Cline 面板。
  3. 在 Cline 顶部导航栏中，点击 MCP Servers 图标。
  4. 点击 Configure MCP Servers — 在 VS Code 中打开 Cline MCP 配置文件。
  5. 粘贴以下其中一种（推荐 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，并显示 “no MCP servers”。

{
  "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 服务，而不会在重新加载面板或切换开关时加载。

  1. 返回 MCP Servers 面板，确认其中显示 brilliant-directories——如果尚未启用，请将其切换为开启。

    “完全退出”不只是关闭窗口——Cline 只会在真正重新启动 VS Code 时加载 MCP 服务：

    • **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/mcp.json 并粘贴配置块。两种方式都可行。

更喜欢本地安装？请继续阅读——下面的 Cursor Directory 安装程序会设置高级路径（作为 npx 子进程运行）。

通过 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。

  1. 打开 → cursor.directory/plugins/brilliant-directories

  2. 点击 Install / Add to Cursor → 允许浏览器打开 Cursor。

  3. Cursor 会显示一个 "Install MCP Server?" 提示，其中大部分字段已预先填好。你需要修改两项：

    重命名 Name 字段（不要保留 server——太笼统）：

    • brilliant-directories-60031 — 基于站点 ID（推荐模式）
    • brilliant-directories-mysite — 基于站点名称
    • brilliant-directories-main / brilliant-directories-staging / brilliant-directories-client-acme — 自定义名称
    • 原因：Cursor 会按此 Name 列出所有 MCP；如果之后添加第二个 BD 站点，你需要能区分它们。

    填写 Environment Variables — 仅填写右侧：

    左侧（请勿触碰）右侧（粘贴你的值）
    BD_API_KEY你的 BD API 密钥
    BD_SITE_URLhttps://www.your-site.com — 包含 https://，末尾不要加斜杠
    • API 密钥 → BD Admin → Developer Hub → Generate API Key（BD 只会显示一次；如果丢失，请生成新的）。
    • 密钥必须启用高级端点权限，否则大多数写入操作会返回 403。请参阅开始之前。

  4. 点击 Install。

  5. 完全退出并重新打开 Cursor。

    “完全退出”不只是关闭窗口——只有真正重新启动后，Cursor 才会加载 MCP 服务：

    • **Windows：**右键点击系统托盘中的 Cursor 图标（右下角，可能隐藏在 ^ 下）→ Quit，然后重新打开
    • **Mac：**按 Cmd+Q 或在菜单栏中选择 Cursor → Quit Cursor，然后重新打开

  6. 工具会显示在 Settings → Tools & MCP 中。

**专业提示 — 多站点管理：**使用不同的 API 密钥和 URL 多次安装 BD MCP，并为每个实例设置唯一的 Name（例如 brilliant-directories-60031、brilliant-directories-marketing）。然后告诉 Cursor "在 brilliant-directories-60031 上列出热门分类" 或 "比较两个站点的会员数"。Claude Desktop 和 Claude Code 也适用相同模式。适合代理机构和多品牌运营者。

其他方法 — 如果目录链接无法使用，或你更喜欢手动设置（点击展开） ### 替代方案 A — Cursor 设置图形界面（手动，无需终端）
  1. 打开 Cursor。
  2. 打开设置：
    • **Mac：**菜单栏 → Cursor → Settings → Cursor Settings
    • **Windows / Linux：**File → Preferences → Cursor Settings
    • 或者：打开命令面板（Cmd/Ctrl+Shift+P）→ 输入 Open MCP Settings
  3. 在侧边栏中，点击 Tools & MCP。
  4. 点击 New MCP Server。
  5. 粘贴配置块。将 ENTER_API_KEY 替换为你的 BD API 密钥，将 https://www.your-site.com 替换为你的 BD 网站 URL。
  6. **点击 Save，然后完全退出并重新打开 Cursor。**仅保存是不够的——Cursor 只会在全新启动时加载 MCP 服务。
替代方案 B — 直接编辑配置文件

如果图形界面中没有显示“Tools & MCP”，或者“New MCP Server”按钮点击后没有反应，请使用此方法。效果与图形界面方法相同。

Cursor 从你主目录中隐藏的 .cursor 文件夹里的 mcp.json 读取配置。

Mac / Linux
  1. 打开 Finder（Mac）或文件管理器（Linux）。
  2. 按 Cmd+Shift+G（Mac）或 Ctrl+L（Linux），打开“前往文件夹”输入框。
  3. 输入 ~/.cursor → 按 Enter。
    • 如果提示“文件夹不存在”：转到 ~/，新建一个名称完全为 .cursor 的文件夹（名称以点开头），然后重试。
  4. 在 .cursor 中，使用 TextEdit 或任何文本编辑器打开 mcp.json。如果文件不存在：新建该文件。TextEdit 用户：依次选择 File → New → Format 菜单 → 先选择 Make Plain Text，然后另存为 mcp.json（而非 mcp.json.txt）。
  5. 粘贴配置块。将 ENTER_API_KEY 替换为你的 BD API 密钥，将 https://www.your-site.com 替换为你的 BD 网站 URL。保存，然后完全退出并重新打开 Cursor。
Windows
  1. 按 Windows 键 → 输入 File Explorer → 按 Enter。
  2. 点击顶部的地址栏。输入 %USERPROFILE%\.cursor → 按 Enter。
    • 如果提示“Windows 找不到”：转到 %USERPROFILE%，右键点击 → New → Folder → 将名称设为 .cursor（名称以点开头），然后重试。
  3. 在 .cursor 中，使用记事本打开 mcp.json。如果文件不存在：右键点击空白区域 → New → Text Document → 将文件重命名为 mcp.json（在扩展名警告中点击“是”）。
    • 看不到 .txt / .json 扩展名？在文件资源管理器中打开 View 菜单 → 勾选 File name extensions。
  4. 粘贴配置块。将 ENTER_API_KEY 替换为你的 BD API 密钥，将 https://www.your-site.com 替换为你的 BD 网站 URL。保存，然后完全退出并重新打开 Cursor。
n8n

✅ MCP 客户端工具可用 — 使用 SSE 传输方式和我们的专用 URL。

n8n 内置的 MCP 客户端工具节点可以连接到我们的服务并加载所有 BD 工具。按以下方式配置：

字段值
服务传输方式Server Sent Events (Deprecated)
MCP 端点 URLhttps://brilliantmcp.com/sse
身份验证Multiple Headers Auth
标头 1名称：X-Api-Key · 值：你的 32 位十六进制 BD API 密钥
标头 2名称：X-BD-Site-URL · 值：https://www.your-site.com

保存节点。点击 工具下拉菜单——其中应会显示所有 BD 工具。选择任意工具，然后点击“执行”。

为什么选“SSE（已弃用）”，而不是“HTTP Streamable”？

  • MCP 规范已弃用 SSE，转而采用 HTTP Streamable
  • n8n 的 SSE 客户端目前可连接到我们的服务
  • n8n 的 HTTP Streamable 客户端存在已知上游缺陷，我们已提交相关问题
  • 我们的服务支持这两种传输方式——等 n8n 修复其 HTTP Streamable 客户端后，你可以切换到 https://brilliantmcp.com（不带 /sse 路径），并将传输方式设为 HTTP Streamable。无需更改服务。

为什么使用 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 密钥。可使用所有 BD 操作，完全无需涉及 MCP 协议。

✅ 普通 HTTP Request 节点 — 将单个 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 客户端应用（目前处于 Open Beta 阶段），可连接远程 MCP 服务——请参阅 Make 的 MCP 客户端文档。连接到我们的 Worker：

  1. 将 MCP 客户端模块添加到你的场景中，然后点击创建连接。
  2. 点击 + 新建 MCP 服务（我们尚未列入 Make 的已验证服务列表）。
  3. URL： https://brilliantmcp.com
  4. API 密钥 / 访问令牌： 你的 32 位 BD API 密钥。
  5. 保存，然后刷新场景，让 Make 加载新连接。

⚠️ Make Beta 版本已知限制： MCP 客户端界面仅提供一个令牌字段。我们的 Worker 需要两个自定义标头（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；所有端点均可访问。

你也可以根据我们的 OpenAPI 规范构建自定义 Make 应用，获得更完善的使用体验。

Zapier

“MCP Client by Zapier” 应用仅支持 OAuth / Bearer Token — 没有自定义请求头字段，因此无法通过身份验证访问我们的 Worker（与 Make 有相同的单令牌限制）。

请改用以下方式之一：

  • BD 现有的 Zapier 应用（如果它满足你的需求）— 使用相同的底层 API 和 API 密钥。
  • Webhooks by Zapier，访问 https://www.your-site.com/api/v2/*，并设置自定义请求头 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 支持 MCP 服务，包括 stdio（npm）和远程（URL）方式，可通过其 Configure MCP 页面（Agent Settings → MCP Server Config）进行配置。请参阅 Abacus 的 MCP 文档。

✅ 推荐（stdio / npm — 可可靠传递两项凭据）： 将以下内容粘贴到 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 需要两个请求头（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 只发送单个令牌（没有第二个请求头），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-Api-Key（而不需要 X-BD-Site-URL）： 这些调用会直接访问你的 BD 站点（your-site.com/api/v2/...），绕过 MCP Worker。只有在调用托管于 https://brilliantmcp.com 的 Worker 时才需要 X-BD-Site-URL 请求头 — 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 也可以删除和修改线上数据。 写入会直接作用于你的线上站点 — 无法撤销。在执行批量或破坏性操作前，请先在一条记录上测试。建议先备份。如有疑问，请先让 AI 预览（列出/显示），再让它执行操作。

增长自动化技能（bd-skill-content）

此仓库附带一个 Claude Skill，它使用 BD MCP 为你执行高效的内容工作流：研究公开来源、制作富含 SEO 内容的帖子、去重，并发布到你的 BD 网站。

下载

从 GitHub Releases 页面获取最新版技能压缩包：bd-skill-content.zip。

安装
  1. 打开 claude.ai → Settings → Customize → Skills → Upload Skill。
  2. 上传你下载的 bd-skill-content.zip 文件。
  3. 确保已连接 BD MCP（可使用托管的 https://brilliantmcp.com，或通过 npm 安装的本地服务）。
  4. 开始聊天，告诉 Claude 你的需求：“为 Austin 即将举行的健身活动创建活动帖子。”
v0.1 中的内容类型
  • 活动 — 从公开网络来源（商会网站、旅游局网站、市政日历、公开的 Eventbrite 页面等）研究本地活动，创建结构化活动帖子，包含常见问题解答、指向相关活动的内部链接、来源注明，以及通过 Nominatim 地理编码的坐标。

未来版本将推出更多内容类型（职位、房产、博客、SEO 落地页）。它们将采用相同的共享方法，并包含在同一个压缩包中。

默认设置
  • 自主运行时默认创建草稿（由你审核后再发布）
  • 免费运行（无需 API 密钥，无需付费服务）
  • 白帽抓取（仅收集事实，仅访问公开页面，始终注明来源）
  • 合理的运行时间：创建 10–20 篇帖子需 30–60 分钟
从源代码构建

技能源代码位于 bd-skill-content/。你可以自行重新构建压缩包：

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

所有内容都构建在相同的基础之上：共享的研究方法、质量关卡、去重、反垃圾写作风格，以及白帽来源采集。

自动更新

完成设置后，下次完全退出并重新打开 AI 应用时，即可自动获取新版 MCP。

故障排除

用一条命令验证设置。 在终端中粘贴（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 服务会通过 stdio 永久运行，等待 AI 客户端连接。从 shell 进行一次性调试时，请使用 --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 — 此密钥未获准访问该特定端点。在 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 req/60s）。等待 60 秒，或发送邮件联系 BD 支持团队，将网站的限制提高到每分钟最多 1,000 次请求。
  • Unknown tool（来自 Claude） — 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（或者 AI 应用在安装 Node.js 之前就已启动）。请从 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 部分中的高级（npm/stdio）配置。使用 Microsoft Store 版 Claude Desktop 的 Windows 用户还应卸载该版本，并从 claude.ai/download 重新安装（商店版会以可能导致 MCP 加载静默失败的方式隔离配置）。

身份验证

两个凭据会在每个请求中作为 HTTP 标头发送。无需 OAuth、Bearer 令牌或签名。

标头值必填说明
X-Api-Key你的 BD API 密钥是用于验证请求。Admin → Developer Hub → Generate API Key。
X-BD-Site-URLhttps://www.your-site.com是将 API 密钥与对应的 BD 网站关联。完整的规范 URL（包含 https://，主机名必须准确，末尾不能有斜杠）。
通用 MCP 客户端参考

任何通用 MCP 客户端（LibreChat、自定义 Agent 等）都会询问相同的四个问题。使用此表填写相应信息。

客户端询问的字段填写内容
MCP 服务 URL / Endpoint URL / Remote Server URLhttps://brilliantmcp.com（不要加 /sse，也不要添加尾随路径）
传输方式Streamable HTTP（也称为 "HTTP Streamable"）。不是 SSE。不是 WebSocket。
自定义 / 多个标头两项：X-Api-Key: <your key> 和 X-BD-Site-URL: https://www.your-site.com
OAuth关闭 / 否 / 已禁用——我们不使用 OAuth
Bearer Token留空——我们不使用 Bearer 身份验证

n8n 是个例外。 n8n 的 Streamable HTTP 客户端存在上游缺陷，因此 n8n 用户必须使用传输方式 = Server Sent Events (Deprecated)，并将 URL 设为 https://brilliantmcp.com/sse（带有 /sse 路径）。具体字段值请参见 n8n 部分。我们的服务同时支持这两种传输方式——只是 n8n 目前需要使用旧版传输方式。

**如何判断其他 MCP 客户端是否可用：**关键在于“客户端能否发送自定义 HTTP 标头”。如果界面中有 Custom Headers / Multiple Headers / HTTP Headers 字段，就可以使用——填入我们的两个标头即可。如果界面只提供 OAuth 或 Bearer Token，该客户端目前就无法访问我们的 Worker。

速率限制

**默认：**每个 API 密钥每 60 秒 100 个请求。
**可申请：**每分钟最多 1,000 个请求——联系 Brilliant Directories 支持团队，提高你的网站限额（100 到 1,000 次/分钟之间的任意值）。

限额由 BD 在服务器端设置，并非管理后台中的自助设置。如果你预计会大量使用 API，请在批量操作前给 BD 支持团队发送电子邮件，申请临时或永久提高限额。

超过限额时，API 会返回 HTTP 429 Too Many Requests。MCP 服务会将此信息作为可采取操作的错误反馈给你的 AI Agent——它会知道需要稍后重试，或建议申请更高限额。

**规划批量操作：**如果你要让 Agent 导入或更新数百条记录，请先（a）向 BD 支持团队申请提高限额，或（b）告诉 Agent 控制操作速度（例如，“导入这 500 位会员，并暂停操作以遵守每分钟 100 次的速率限制”）。

分页

所有列表端点都支持分页：

参数说明
limit每页记录数（默认 25，最多 100）
page上一条响应中 next_page 返回的游标令牌

响应包含：total、current_page、total_pages、next_page、prev_page

筛选

所有列表端点都支持筛选。语法由 AI 处理——只需用自然语言提问（“本月添加的洛杉矶会员”、“标题中包含 sale 的页面”等）。如果需要通过直接 HTTP 请求筛选（curl、Postman、Zapier Webhooks 等），筛选参数为 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 Agent 订阅（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 会看到来自这两个网站的工具。

团队可以共用一个密钥，还是每个人都应该有自己的密钥？ 每个人都应该生成自己的 API 密钥（BD Admin → Developer Hub）。密钥按用户分配，因此撤销一个密钥不会影响其他人。

如何断开连接／移除 MCP？

  • Claude Code：claude mcp remove brilliant-directories
  • Cursor / Windsurf / Cline：从 MCP 配置 JSON 文件中删除 brilliant-directories 条目，保存后完全退出并重新打开应用。

如何撤销 AI 执行的操作？ BD 的 API 没有通用撤销功能。对于成员，建议使用 updateUser active=3（已取消）代替 deleteUser，因为前者可以恢复。对于不可逆操作，请先备份，或先在一条记录上进行测试。

我可以先在测试网站上安全试用，再用于生产环境吗？ 可以。在 BD 暂存／开发网站上生成单独的 API 密钥，并在 MCP 配置中设置对应的 URL 和密钥。确认工作流可靠后，再切换到生产环境。

如何查看我的 API 密钥拥有哪些端点权限？ 在 BD Admin → Developer Hub 中查看密钥。当你遇到 403 API Key does not have permission to access this endpoint 错误时，错误信息会指出被拒绝访问的端点——在密钥设置中启用该端点，保存后重试。

支持

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。