Brilliant Directories MCP
✓ Brand-named GitHub · github.com/brilliantdirectories
Zum Liken anmelden0 Likes
What it does
Official MCP server for Brilliant Directories — manage members, posts, leads, reviews, and more.
- Connects Computer oder Cloud
- Account or key Cloud: Needs X-Api-Key, X-BD-Site-URL · Local: Needs BD_API_KEY · 1 setting to fill in (BD_SITE_URL)
- Category Marketing & Social Media
Zusammen nutzen mit
Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem
Warum es hier steht
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 30/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 12/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 8/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 50/100 |
Qualität: 3/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte Brilliant Directories MCP. Folge https://mcp.popnx.com/i/brilliantdirectories-brilliant-directories-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
3/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (brilliantmcp.com) · ✓ Befehle geprüft am 17. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude · etwa 5 Min.
Du brauchst einen Schlüssel von Brilliant Directories MCP (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
Bei Brilliant Directories MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Öffne die Connectors-Seite von Claude
CustomizeConnectors
Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus
Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue
Name · NameBrilliant Directories MCPRemote MCP server URL · Adressehttps://brilliantmcp.com/mcpUnter Request headers diesen Namen und Wert hinzufügen
Header-NameX-Api-KeyWert<Schlüssel hier einfügen>Header-NameX-BD-Site-URLWert<Schlüssel hier einfügen>Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add
Im Chat einschalten
+ConnectorsBrilliant Directories MCP
Ausprobieren
Nutze Brilliant Directories MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Brilliant Directories MCP nutzt, oder ein Werkzeug von Brilliant Directories MCP in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Brilliant Directories MCP noch nicht verbinden
Brilliant Directories MCP braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen
Das kannst du stattdessen tun
A · Eine App nutzen, die Brilliant Directories MCP verbinden kann
- Du brauchst einen Schlüssel von Brilliant Directories MCP (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
- Du brauchst einen Schlüssel von Brilliant Directories MCP (auf der Seite des Anbieters erstellen)
- Du brauchst einen Schlüssel von Brilliant Directories MCP (auf der Seite des Anbieters erstellen)
- Du brauchst einen Schlüssel von Brilliant Directories MCP (auf der Seite des Anbieters erstellen)
B · Andere in Marketing & Social Media, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
- Google Ads + Meta Ads + SEO/GEO MCP✓ ChatGPT
- Cargo✓ ChatGPT
- NotFair✓ ChatGPT
Klappt mit Claude Code · etwa 5 Min.
Du brauchst einen Schlüssel von Brilliant Directories MCP (auf der Seite des Anbieters erstellen)
Bei Brilliant Directories MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Diesen Befehl einfügen und Enter drücken
claude mcp add --transport http --scope user brilliant-directories https://brilliantmcp.com/mcp --header 'X-Api-Key: your-value' --header 'X-BD-Site-URL: your-value'Ersetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
/mcp in Claude Code eingeben
Brilliant Directories MCP sollte in der Liste als verbunden erscheinen
Ausprobieren
Nutze Brilliant Directories MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Brilliant Directories MCP nutzt, oder ein Werkzeug von Brilliant Directories MCP in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor · etwa 5 Min.
Du brauchst einen Schlüssel von Brilliant Directories MCP (auf der Seite des Anbieters erstellen)
Bei Brilliant Directories MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Schlüssel eintragen
In den Einstellungen von Brilliant Directories MCP ist X-Api-Key, X-BD-Site-URL leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
KI-Chat in Cursor im Agent-Modus öffnen
Ausprobieren
Nutze Brilliant Directories MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Brilliant Directories MCP nutzt, oder ein Werkzeug von Brilliant Directories MCP in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code · etwa 5 Min.
Du brauchst einen Schlüssel von Brilliant Directories MCP (auf der Seite des Anbieters erstellen)
Bei Brilliant Directories MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Mit diesem Button VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
Schlüssel eintragen
In den Einstellungen von Brilliant Directories MCP ist X-Api-Key, X-BD-Site-URL leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
KI-Chat in VS Code im Agent-Modus öffnen
Ausprobieren
Nutze Brilliant Directories MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Brilliant Directories MCP nutzt, oder ein Werkzeug von Brilliant Directories MCP in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
Adresse für Apps, die über das Web verbinden
https://brilliantmcp.com/mcpJSON-Einstellungen stehen unten unter „Für Entwickler“
Für Entwickler: Terminal-Befehle und JSON-Einstellungen
Über das Web
Claude Code
claude mcp add --transport http --scope user brilliant-directories https://brilliantmcp.com/mcp --header 'X-Api-Key: your-value' --header 'X-BD-Site-URL: your-value'Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"brilliant-directories": {
"url": "https://brilliantmcp.com/mcp",
"headers": {
"X-Api-Key": "your-value",
"X-BD-Site-URL": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"brilliant-directories": {
"type": "http",
"url": "https://brilliantmcp.com/mcp",
"headers": {
"X-Api-Key": "your-value",
"X-BD-Site-URL": "your-value"
}
}
}
}Auf deinem Computer installiert
Claude Code
claude mcp add --scope user brilliant-directories --env BD_API_KEY=your-value --env BD_SITE_URL=your-value -- npx -y brilliant-directories-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"brilliant-directories": {
"command": "npx",
"args": [
"-y",
"brilliant-directories-mcp"
],
"env": {
"BD_API_KEY": "your-value",
"BD_SITE_URL": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"brilliant-directories": {
"command": "npx",
"args": [
"-y",
"brilliant-directories-mcp"
],
"env": {
"BD_API_KEY": "your-value",
"BD_SITE_URL": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"brilliant-directories": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"brilliant-directories-mcp"
],
"env": {
"BD_API_KEY": "your-value",
"BD_SITE_URL": "your-value"
}
}
}
}Werte, die du selbst einträgst
BD_API_KEYgeheim erforderlich envDein Brilliant-Directories-API-Schlüssel. Erzeuge ihn unter BD Admin → Developer Hub → Generate API Key.Englisches Original anzeigen
Your Brilliant Directories API key. Generate one in BD Admin → Developer Hub → Generate API Key.BD_SITE_URLerforderlich envDie BD-Site-URL genau so, wie sie im Browser geladen wird, einschließlich https:// und www (falls verwendet), ohne abschließenden Schrägstrich. BD_API_URL wird auch als veralteter Alias akzeptiert.Englisches Original anzeigen
Your BD site URL exactly as it loads in a browser, including https:// and www if used, with no trailing slash. BD_API_URL is also accepted as a legacy alias.- Dein Brilliant-Directories-API-Schlüssel. Erzeuge ihn unter BD Admin → Developer Hub → Generate API Key.
Englisches Original anzeigen
Your Brilliant Directories API key. Generate one in BD Admin → Developer Hub → Generate API Key. X-BD-Site-URLerforderlich HTTP headerDie BD-Site-URL genau so, wie sie in einem Browser geladen wird, einschließlich https:// und www, falls verwendet, ohne abschließenden Schrägstrich.Englisches Original anzeigen
Your BD site URL exactly as it loads in a browser, including https:// and www if used, with no trailing slash.
Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Auf einen Blick
- Downloads pro Wochei
- 1.379/Wo.
- Verbindung
- Computer oder Cloud
- Neueste Versioni
- 6.59.691
- Kategoriei
- Marketing & Social Media
- In der Registry veröffentlichti
- 17. Nov. 2026
- Code zuletzt geänderti
- 17. Nov. 2026
- Zuletzt geprüft
- 19. Nov. 2026
- Entwickler
- brilliantdirectories
- Pakete
npm: brilliant-directories-mcp- Registry-Status
- Aktiv
Welche Apps ihn nutzen können
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Verbinden sich über das Internet in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Was er kann
Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto brilliantdirectories bestätigt, dem das Repo gehört
- ✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vorgestern
- ✓ Bestanden
Hat eine Lizenz
Nutzt MIT
- ! Vorsicht
Endpunkt antwortet
Zugriff verweigert (HTTP 401) ohne OAuth-Anmeldung. Braucht vielleicht einen Schlüssel oder blockiert Bots; nicht bestätigt.
- ! Vorsicht
Anmeldung mit OAuth
Braucht einen Schlüssel oder Token, den du selbst kopierst und einfügst
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen
Die Cloud-Adresse hat bei 5 der letzten 5 Prüfungen geantwortet · zuletzt 177 ms · geprüft 19. Nov. 2026
Veröffentlichte Schwachstellen (OSV.dev)
Noch nicht geprüft
Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/brilliantdirectories-brilliant-directories-mcp)Diskussion
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Nutzerbewertungen
Noch keine Bewertungen
Im Vergleich mit anderen in Marketing & Social Mediai
- Mehr Sterne als 97 % der anderen 4196 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 91 % der anderen 4196 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 9 % der anderen 4196 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist Brilliant Directories MCP sicher?
Er hat 3 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Das musst du eintragen: X-Api-Key, X-BD-Site-URL, BD_API_KEY
Läuft er auf meinem Computer oder in der Cloud?
Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt vorgestern geändert, und die neueste Version (6.59.691) kam vorgestern in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).
Was kann ich stattdessen nutzen?
In derselben Kategorie: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
Ähnliche Alternativen
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Relaticle
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
ChatbotX
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
X (Twitter) MCP Server by Xquik
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Betterlytics
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
| Dieser Brilliant Directories MCP | Relaticle | ChatbotX | X (Twitter) MCP Server by Xquik | Betterlytics | BibiGPT YouTube Video Summarizer | |
|---|---|---|---|---|---|---|
| Läuft wo | In der Cloud oder auf deinem Rechner | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation |
| Braucht Schlüssel | Ja | Nein | Nein | Nein | Ja | Nein |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Nein | Nein | Nein |
| Basisprüfungen | 3/5 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| Lizenz | MIT | AGPL-3.0 | NOASSERTION | MIT | AGPL-3.0 | MIT |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
Official Brilliant Directories MCP Server — Setup Guide
Universal AI integration for your BD site. Give any AI agent full access to your Brilliant Directories site with one API key.
Manage members, posts (single-image and multi-image), leads, reviews, top and sub categories, email templates, pages (homepage, landing pages), 301 redirects, smart lists, widgets, menus, forms, tags, membership plans, and more — across every resource BD exposes via its REST API.
This guide walks you through connecting your AI of choice (Claude, Cursor, etc.) to your BD site. Pick your AI app below, paste two things, restart. Most setups take under 5 minutes.
⚠️ REQUIREMENTS — Before you start
- Your BD site URL. Use the full canonical URL exactly as it loads in a browser — include
https://(orhttp://if your site has no SSL), includewww.if your site uses it, no trailing slash.
- ✅
https://www.mysite.com(most BD sites) - ✅
https://mysite.com(only if your site has nowww.) - ✅
http://mysite.com(HTTP-only sites — protocol respected) - ❌
mysite.com(missing protocol) - ❌
https://mysite.com/(trailing slash) - ❌
https://mysite.comif the site actually serves atwww.mysite.com— use the form your site canonically responds at
- Your BD API key.
BD Admin → Developer Hub → Generate API Key → copy it.
Full walkthrough: How to Create an API Key .
- Node.js — only for the Advanced path (see below). Not needed for the Easy path. If you need it, one-time install from nodejs.org (click
Get Node.js®to download, then clickWindows Installer (.msi)— Mac:macOS Installer— double-click the downloaded file to install, Next through the prompts).
🚨 API PERMISSIONS — DO NOT SKIP THIS
New BD API keys ship locked down — only member read/write is enabled by default.
Every other resource (web pages, forms, menus, tags, email templates, reviews, leads, categories, post types, widgets, etc.) lives behind an "Advanced Endpoints" toggle and returns 403 API Key does not have permission to access this endpoint until you flip it on.
This catches almost every first-time user. If your AI can list members but can't create a page or update a form, stop debugging — it's this.
Turn on Advanced Endpoints:
- BD Admin → Developer Hub
- Find your API key in the list → Actions dropdown → Permissions
- Click the Advanced Endpoints tab
- Toggle everything ON (or cherry-pick only the resources you'll use — but ALL ON is the fastest way to stop tripping over this)
- Click Save Permissions
The change is immediate — no key rotation, no AI restart needed. Re-run the failed request and it'll succeed.
Want to stop the AI from deleting anything? Uncheck every
deleteaction under Advanced Endpoints. The AI will still be able to read, create, and update — but anydelete*tool call will return 403 instead of wiping data. Good baseline for production sites where the AI shouldn't be trusted with destructive operations.
Why BD locks it down by default: least-privilege. A leaked key with baseline-only permissions can only read/write members on your site, not rewrite your whole directory. Once you've decided which endpoints your agent actually needs, you can pare the permissions back down to just those.
Table of Contents
- Setup by Platform
- Claude Desktop
- Claude Code
- Claude extension inside Cursor
- OpenAI (Codex Desktop)
- Windsurf
- Cline (VS Code extension)
- Cursor
- n8n
- Make.com
- Zapier
- Abacus.AI (ChatLLM Agent)
- curl / any HTTP client
- What you can ask the AI
- Updates are automatic
- Troubleshooting
- FAQ
- Authentication
- Rate Limits
- Pagination
- Filtering
- Sorting
- Available Resources
- Field Discovery
- Stable asset URLs
- Security
- Support
Setup by Platform
Each platform has two options:
- 🚀 Easy config block — points at our hosted MCP at
https://brilliantmcp.com. No Node.js, no install, no terminal. Starts working the moment you save and restart your AI app. - 🛠️ Advanced config block — spawns the MCP as a
npxchild process on your machine. Use when you want the MCP on your own hardware.
Needs Node.js installed first — get it from nodejs.org (click Get Node.js® to download, then click Windows Installer (.msi) — Mac: macOS Installer — and DOUBLE-CLICK the downloaded file to install it).
Both give the full BD tool surface, same instructions, same lean shapers, same safety guards.
🚀 Easy config block (recommended — 30-second install)
In your AI client's MCP config (Cursor, Windsurf, Cline, Codex, n8n, etc.), add this entry:
{
"mcpServers": { "brilliant-directories": { "url": "https://brilliantmcp.com", "headers": { "X-Api-Key": "ENTER_API_KEY", "X-BD-Site-URL": "https://www.your-site.com" } } } }
Replace ENTER_API_KEY with your BD API key and https://www.your-site.com with your BD site URL (full canonical form — https://, exact host, no trailing slash, see Requirements).
⚠️ Claude Desktop doesn't accept the Easy block — use the Advanced block in the Claude Desktop section.
Save, then fully quit and reopen the AI app. Saving alone is not enough — every AI client loads MCP servers only at fresh launch, not on hot-reload. Done. Working? Skip to "What you can ask the AI".
Need a client-specific walkthrough? Jump to your platform's section below.
🛠️ Advanced config block (requires Node.js install)
⚠️ STEP 1 — Install Node.js FIRST (the Advanced path runs an
npxcommand on your machine):
- Go to nodejs.org → click Get Node.js®
- Download: Windows Installer (.msi) or macOS Installer
- Double-click the file → click Next through every prompt to fully install Node.js
Skip this and you'll see *"no MCP servers"* with
spawn npx ENOENTin the log.
Why `--prefer-online` + `@latest`? Forces npm to revalidate against the registry on every launch so you always pull the newest version. Prevents the
ETARGET No matching version founderror that hits when your local npm cache is stale.
STEP 2 — Paste this config:
{
"mcpServers": { "brilliant-directories": { "command": "npx", "args": [ "-y", "--prefer-online", "brilliant-directories-mcp@latest", "--api-key", "ENTER_API_KEY", "--url", "https://www.your-site.com" ] } } }
STEP 3 — Fully quit the AI app, then reopen. Closing the window is NOT enough — the AI loads MCP servers only at a true relaunch:
- Windows: right-click the app's icon in the system tray (bottom-right, may be hidden under
^) → Quit, then reopen - Mac:
Cmd+Qor menu bar → → Quit , then reopen
Claude Desktop
⚠️ Claude Desktop requires Node.js + the Advanced (npm) config. It doesn't accept the Easy
url-shaped block — only stdio (command+args).
⚠️ Windows users: install Claude Desktop from claude.ai/download , NOT the Microsoft Store (the Store version sandboxes the config file).
Banner saying "Tool result could not be submitted… connection interrupted"? Cosmetic UI bug across every MCP connector (anthropics/claude-code #51874) — your tools still work. Safe to ignore.
⚠️ STEP 1 — Install Node.js FIRST (before pasting the config below):
- Go to nodejs.org → click Get Node.js®
- Download: Windows Installer (.msi) or macOS Installer
- Double-click the file → click Next through every prompt to fully install Node.js
Skip this and you'll see *"no MCP servers"* with
spawn npx ENOENTin the log.
Steps (no terminal):
- Open Claude Desktop.
- Menu bar → Settings.
Developer tab → Edit Config.
This opens claude_desktop_config.json in TextEdit (Mac) or Notepad (Windows).
- Pick your scenario:
Scenario A — file is empty {} or has no mcpServers entry
Select all (Cmd+A / Ctrl+A) and delete. Paste this:
{
"mcpServers": { "brilliant-directories": { "command": "npx", "args": [ "-y", "--prefer-online", "brilliant-directories-mcp@latest", "--api-key", "ENTER_API_KEY", "--url", "https://www.your-site.com" ] } } }
Replace ENTER_API_KEY with your BD API key and https://www.your-site.com with your BD site URL. Save, then fully quit and reopen Claude Desktop. Saving alone is not enough — Claude loads MCP servers only at fresh launch.
Scenario B — file already has content (preferences, Google connectors, other MCP servers)
Merge — don't overwrite. Two rules:
- Comma between top-level entries.
- Final
}at the bottom stays one brace.
Before:
{
"preferences": { "menuBarEnabled": false, "legacyQuickEntryEnabled": false } }
After:
{
"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" ] } } }
Two changes: , added after the preferences closing }, and the mcpServers block added before the final }. Replace ENTER_API_KEY with your BD API key and https://www.your-site.com with your BD site URL. Save, then fully quit and reopen Claude Desktop.
Paste your final file into jsonlint.com before restarting to ensure correct formatting.
Missing commas silently break the MCP — a validator flags them instantly.
- Fully quit and reopen Claude Desktop. Start a new chat.
"Fully quit" means more than closing the window — Claude loads MCP servers only at a true relaunch:
- Windows: right-click the Claude icon in the system tray (bottom-right, may be hidden under
^) → Quit, then reopen
- Mac:
Cmd+Qor menu bar → Claude → Quit Claude, then reopen
- Verify the BD MCP loaded. The exact UI varies by Claude Desktop version:
- In any chat, ask "what tools do you have?" — you should see
brilliant-directoriestools listed. - OR check **Sett