שרת MCP מאומת: Brave Search

שרת ה-MCP של Brave Search, רשימת הכלים החיה שלו נלכדה על Mac אמיתי.

  • הכלים נספרו2026-08-03macOS 14.4.1
  • חבילה@brave/brave-search-mcp-server 2.1.0
  • מדווח על עצמוbrave-search-mcp-server 2.1.0
  • פרוטוקול MCP2025-06-18
  • סביבת ריצהv25.8.1

רשימת הכלים למטה היא לכידה חיה מהשרת הרץ; קריאת כלי מאומתת עדיין ממתינה להרשאות.

התשובה הקצרה

אומת לאחרונה 2026-08-03

שרת ה-MCP של Brave Search מעמיד מנוע חיפוש מאחורי עוזר ה-AI שלכם: תוצאות רשת, חדשות, וידאו, תמונות ומקומות, ולצדן סיכומי AI של Brave ונקודת קצה שמחזירה תוכן עמודים לצורך ביסוס תשובות. שתי חבילות עונות לשם הזה, ובחירה בחבילה הלא נכונה היא הטעות הנפוצה כאן. זו שהרצנו, ‎@brave/brave-search-mcp-server, היא השרת הרשמי, מפורסמת תחת מרחב השמות ‎@brave ב-npm על ידי Brave Software ומפותחת במאגר brave/brave-search-mcp-server. זו שרוב המדריכים עדיין מציגים, ‎@modelcontextprotocol/server-brave-search, היא מימוש הייחוס הישן של Anthropic: npm מסמן אותה כמיושנת, הקוד שלה יושב במאגר הארכיוני servers-archived, היא חושפת שני כלים במקום שמונה, ובכל זאת היא נמשכה בשבוע האחרון ביותר הורדות מהחבילה הרשמית. אפילו עמוד ההתחלה המהירה של Anthropic עצמה עדיין נושא קטע הגדרות שמתקין אותה. הפעלנו את השרת הרשמי, ספרנו את כל 8 הכלים שהוא חושף ושמרנו את הפלט הגולמי, כולל השגיאות המדויקות שהוא מחזיר כשמפתח ה-API חסר או שגוי. [1][3][7][8][9][11][13]

  • כלים

    8, נספרו בריצה חיה

  • אישורי גישה

    נדרש מפתח API של Brave Search [4]

  • ערוץ תקשורת

    stdio, רץ על ה-Mac שלכם [4]

  • מתחזק

    Brave Software, רשמי [1][3]

  • הורדות

    25 אלף בשבוע האחרון [2]

  • רישיון

    MIT, Brave Software [3]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את השרת עם npx על גבי stdio, השלמנו את לחיצת היד של MCP, שלחנו notifications/initialized וקראנו ל-tools/list. טבלת הכלים למטה היא התשובה הזו, מילה במילה, כל 8 הכלים, וגרסת הפרוטוקול למעלה נקראה ישירות מתשובת ה-initialize הגולמית. על ה-Mac הזה אין מפתח API של Brave Search, והשרת מסרב לעלות בלעדיו, ולכן הגדרנו את BRAVE_API_KEY למחרוזת מציין מקום ברורה במקום מפתח אמיתי: מספיק כדי לעבור את בדיקת ההגדרות בהפעלה ולספור את מה שהשרת מציע, ולא מספיק כדי להגיע ל-Brave. קריאת הכלי היחידה שביצענו, brave_web_search, חזרה עם השגיאה SUBSCRIPTION_TOKEN_INVALID של Brave עצמה, המודפסת למטה. קריאה מאומתת עדיין ממתינה להרשאות. השרת לא כתב דבר ל-stderr בהפעלה תקינה, ולכן ההודעה למטה היא תשובת ה-initialize הגולמית מ-stdout.

הודעת הפתיחה של השרת

{"result":{"protocolVersion":"2025-06-18","capabilities":{"logging":{},"tools":{"listChanged":true}},"serverInfo":{"version":"2.1.0","name":"brave-search-mcp-server","title":"Brave Search MCP Server"},"instructions":"Use this server to search the Web for various types of data via the Brave Search API."},"jsonrpc":"2.0","id":1}

קריאת כלי אמיתית אחת

tools/call brave_web_search {"query": "model context protocol", "count": 3}
422 
{
  "error": {
    "code": "SUBSCRIPTION_TOKEN_INVALID",
    "detail": "The provided subscription token is invalid.",
    "meta": {
      "component": "authentication"
    },
    "status": 422
  },
  "type": "ErrorResponse"
}

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 8 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

כלימה הוא עושה
brave_web_searchquery*countrysearch_langui_langcountoffsetsafesearchfreshnesstext_decorationsspellcheckresult_filtergogglesunitsextra_snippetssummary

Performs web searches using the Brave Search API and returns comprehensive search results with rich metadata. When to use: - General web searches for information, facts, or current topics - Location-based queries (restaurants, businesses, points of interest) - News searches for recent events or breaking stories - Finding videos, discussions, or FAQ content - Research requiring diverse result types (web pages, images, reviews, etc.) Returns a JSON list of web results with title, description, and URL. When the "results_filter" parameter is empty, JSON results may also contain FAQ, Discussions, News, and Video results.

brave_local_searchquery*countrysearch_langui_langcountoffsetsafesearchfreshnesstext_decorationsspellcheckresult_filtergogglesunitsextra_snippetssummary

Brave Local Search API provides enrichments for location search results. Access to this API is available only through the Brave Search API Pro plans; confirm the user's plan before using this tool (if the user does not have a Pro plan, use the brave_web_search tool). Searches for local businesses and places using Brave's Local Search API. Best for queries related to physical locations, businesses, restaurants, services, etc. Returns detailed information including: - Business names and addresses - Ratings and review counts - Phone numbers and opening hours Use this when the query implies 'near me', 'in my area', or mentions specific locations (e.g., 'in San Francisco'). This tool automatically falls back to brave_web_search if no local results are found.

brave_video_searchquery*countrysearch_langui_langcountoffsetspellchecksafesearchfreshness

Searches for videos using Brave's Video Search API and returns structured video results with metadata. When to use: - When you need to find videos related to a specific topic, keyword, or query. - Useful for discovering video content, getting video metadata, or finding videos from specific creators/publishers. Returns a JSON list of video-related results with title, url, description, duration, and thumbnail_url.

brave_image_searchquery*countrysearch_langcountsafesearchspellcheck

Performs an image search using the Brave Search API. Helpful for when you need pictures of people, places, things, graphic design ideas, art inspiration, and more. When relaying results in a markdown environment, it may be helpful to include images in the results (e.g., ![image.title](image.properties.url)).

brave_news_searchquery*countrysearch_langui_langcountoffsetspellchecksafesearchfreshnessextra_snippetsgoggles

This tool searches for news articles using Brave's News Search API based on the user's query. Use it when you need current news information, breaking news updates, or articles about specific topics, events, or entities. When to use: - Finding recent news articles on specific topics - Getting breaking news updates - Researching current events or trending stories - Gathering news sources and headlines for analysis Returns a JSON list of news-related results with title, url, and description. Some results may contain snippets of text from the article. When relaying results in markdown-supporting environments, always cite sources with hyperlinks. Examples: - "According to [Reuters](https://www.reuters.com/technology/china-bans/), China bans uncertified and recalled power banks on planes". - "The [New York Times](https://www.nytimes.com/2025/06/27/us/technology/ev-sales.html) reports that Tesla's EV sales have increased by 20%". - "According to [BBC News](https://www.bbc.com/news/world-europe-65910000), the UK government has announced a new policy to support renewable energy".

brave_summarizerkey*entity_infoinline_references

Retrieves AI-generated summaries of web search results using Brave's Summarizer API. This tool processes search results to create concise, coherent summaries of information gathered from multiple sources. When to use: - When you need a concise overview of complex topics from multiple sources - For quick fact-checking or getting key points without reading full articles - When providing users with summarized information that synthesizes various perspectives - For research tasks requiring distilled information from web searches Returns a text summary that consolidates information from the search results. Optional features include inline references to source URLs and additional entity information. Requirements: Must first perform a web search using brave_web_search with summary=true parameter. Requires a Pro AI subscription to access the summarizer functionality.

brave_llm_contextquery*countrysearch_langcountspellcheckmaximum_number_of_urlsmaximum_number_of_tokensmaximum_number_of_snippetscontext_threshold_modemaximum_number_of_tokens_per_urlmaximum_number_of_snippets_per_urlgogglesfreshnessenable_localenable_source_metadatax-loc-latx-loc-longx-loc-cityx-loc-statex-loc-state-namex-loc-countryx-loc-postal-codeapi-versionacceptcache-controluser-agent

Retrieves pre-extracted, relevance-ranked web content using Brave's LLM Context API, optimized for AI agents, LLM grounding, and RAG pipelines. Unlike a traditional web search that returns links and short descriptions, this tool returns the actual substance of matching pages — text chunks, tables, code blocks, and structured data — so the model can reason over it directly. When to use: - Grounding answers in fresh, relevant web content (RAG) - Giving an AI agent ready-to-use page content from a single search call - Question answering and fact-checking against current sources - Gathering source material for research without manually fetching pages - When you need the contents of pages, not just titles, descriptions, and URLs When relaying results in markdown-supporting environments, cite the source URLs from the "sources" map.

brave_place_searchqueryradiuscountlatitudelongitudelocationcountrysearch_langui_langunitssafesearchspellcheckgeolocapi-versionacceptcache-controluser-agent

Searches Brave's Place Search API. A single call may populate any combination of 'results' (POIs), 'cities', 'addresses', 'streets', and 'location' (the resolved search area), depending on the query's shape. When to use: - POIs near coordinates or a named area (e.g. "coffee shops in Paris") -> 'results', each with structured business data (postal address, hours, contact, ratings, photos, categories, timezone). - Browsing general POIs (omit 'query'; supply 'latitude'+'longitude' or 'location'). - Disambiguating a bare city name (e.g. "springfield") -> 'cities'. - Resolving a specific address (e.g. "350 5th avenue" with NYC coords) -> 'addresses' (often plus 'streets'). - Looking up a street by name (e.g. "michigan avenue" with Chicago coords) -> 'streets'. Inputs: - Anchor the search via 'latitude'+'longitude' or 'location' (or both). With neither, 'query' is required. - 'addresses' / 'streets' only surface when the query is address-/street-shaped AND geographically anchored. - 'location' format: US -- '<city> <state> <country>' (e.g. 'san francisco ca united states'); non-US -- '<city> <country>' (e.g. 'tokyo japan'). Capitalization and commas don't matter. - 'count' caps results (max 50, default 20). 'radius' (meters) biases toward closer results; it does NOT hard-limit the search area.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.

Claude Desktop

פתחו את הקובץ ‎~/Library/Application Support/Claude/claude_desktop_config.json (בתוך Claude Desktop: Settings, אחר כך Developer, אחר כך Edit Config) והוסיפו:

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@brave/brave-search-mcp-server"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

הדביקו את מפתח ה-API שלכם מ-Brave Search, ואז סגרו ופתחו מחדש את Claude Desktop. אזהרה אחת לגבי ה-README: הדוגמה שלו ל-Claude Desktop מוסיפה ל-args את ‎"--transport" ואת ‎"http". הדגל הזה הופך את התהליך לשרת אינטרנט במקום לתוכנית stdio ש-Claude Desktop מחכה לדבר איתה, לכן השמיטו אותו. הבלוק למעלה הוא הצורה שאותה אימתנו. [4][13]

Claude Code

פקודה אחת בטרמינל:

claude mcp add --env BRAVE_API_KEY=YOUR_API_KEY_HERE --transport stdio brave-search -- npx -y @brave/brave-search-mcp-server

כל מה שאחרי המקף הכפול הוא הפקודה המדויקת ש-Claude Code יריץ, והמקף הכפול הכרחי כדי שהדגלים של השרת עצמו לא ייקראו כדגלים של Claude Code. הוסיפו ‎--scope project כדי לכתוב את ההגדרה לקובץ ‎.mcp.json משותף במקום להגדרות האישיות שלכם. [14]

Cursor

הוסיפו ל-‎~/.cursor/mcp.json עבור כל הפרויקטים, או ל-‎.cursor/mcp.json בתוך פרויקט אחד:

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@brave/brave-search-mcp-server"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Cursor קורא את הקובץ מחדש אחרי הפעלה מחדש. הוא מקבל גם את הערך ‎"${env:BRAVE_API_KEY}", שקורא את המפתח ממשתני הסביבה של המעטפת במקום לכתוב אותו לקובץ. שווה להשתמש בזה: קובץ ‎.cursor/mcp.json ברמת הפרויקט הוא טקסט רגיל שעלול להגיע למאגר שאתם דוחפים. [15]

Routines

בלי קובץ JSON ובלי טרמינל. ב-Routines: Settings, אחר כך Assistant, אחר כך Connections, אחר כך Add MCP Server. העבירו את הטופס ל-Command (stdio) והזינו:

Name        Brave Search
Command     npx
Arguments   -y @brave/brave-search-mcp-server

Environment Variables
BRAVE_API_KEY    YOUR_API_KEY_HERE

הערך בשדה ה-Arguments מתפצל לפי רווחים, לכן השאירו אותו בדיוק בשלוש המילים האלה. המפתח נכנס ל-Environment Variables, לעולם לא ל-Arguments. לחצו קודם על Test Connection: שרת תקין עונה עם מספר הכלים שלו, שמונה עבור השרת הזה. [16][4]

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ Brave Search בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים כמה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות. העיקוף היחיד הוא מפתח ה-API של Brave Search, והוא לוקח בערך חמש דקות בלוח הבקרה של Brave.

  1. 01

    התקינו את Routines

    הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.

  2. 02

    הפיקו מפתח API של Brave Search

    גשו ל-brave.com/search/api, פתחו חשבון ובחרו תוכנית. אחר כך פתחו את לוח הבקרה בכתובת api-dashboard.search.brave.com/app/keys והפיקו מפתח. Brave מבקשת כרטיס אשראי גם בתוכניות הבסיסיות, ושתי התוכניות כוללות קרדיט חודשי קטן לפני שמתחילים חיובים, לכן קראו את עמוד המחירים לפני שאתם מתחייבים.

  3. 03

    פתחו את הגדרות ה-MCP

    חזרה ב-Routines, לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.

  4. 04

    בחרו Command (stdio)‎

    הטופס נפתח במצב URL (SSE/HTTP)‎. העבירו אותו ל-Command (stdio): השרת הזה הוא פקודה, לא כתובת אינטרנט. Name: Brave Search. Command: npx. Arguments: ‎-y @brave/brave-search-mcp-server, בדיוק שלוש המילים האלה.

  5. 05

    הוסיפו את המפתח, ואז בדקו

    תחת Environment Variables הוסיפו את BRAVE_API_KEY עם המפתח שהפקתם. לחצו Test Connection: Routines מפעילה את השרת בלי לשמור אותו ומדווחת כמה כלים היא מצאה, שמונה עבור השרת הזה. אם המפתח חסר לגמרי, השרת יוצא עוד לפני שהוא מספיק לענות. אחר כך לחצו Add Server.

  6. 06

    השתמשו בו

    הכלים עובדים בצ׳אט מיד. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.

תדריך חדשות בוקר בנושאים שלכם

פרומפט

Every weekday at 7:30, search the news from the last 24 hours for my three tracked topics, keep only stories from sources I have not already seen this week, and save a five-bullet brief with links as news-brief.md in my Notes folder.

מעקב שבועי אחרי מתחרים

פרומפט

Every Monday at 9:00, search the web for each competitor on my list plus the words pricing, launch and funding, restricted to the last seven days, and write anything new to competitor-watch.md with the date, the source link and one line on why it matters.

סריקת אזכורים חודשית

פרומפט

On the first of every month at 10:00, search the web and the news for my product name and my own name, list every result published in the last 30 days grouped by site, and save it as mentions.md so I can see who is writing about us.

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.

השרת יוצא ברגע שהוא עולה

מה רואים

Error: A Brave API key is required via --brave-api-key, BRAVE_API_KEY, --brave-api-key-file, or BRAVE_API_KEY_FILE. You can get one at https://brave.com/search/api/.
Invalid configuration

הפתרון

אין כאן כישלון רך. השרת מאמת את ההגדרות שלו לפני שהוא פותח חיבור MCP בכלל, ובלי מפתח הוא מדפיס את שתי השורות האלה ויוצא עם קוד יציאה 1, כך שהלקוח שלכם ידווח על שרת שלא הצליח לעלות ולא על כלי שלא הצליח לרוץ. הגדירו את BRAVE_API_KEY בבלוק env (ב-Claude Desktop וב-Cursor), עם ‎--env (ב-Claude Code) או תחת Environment Variables (ב-Routines). גם BRAVE_API_KEY_FILE, שמצביע על קובץ שמכיל את המפתח, עובד וגובר על השני.

הכלים מופיעים ברשימה, אבל כל חיפוש מחזיר 422

מה רואים

422 
{
  "error": {
    "code": "SUBSCRIPTION_TOKEN_INVALID",
    "detail": "The provided subscription token is invalid.",
    "meta": {
      "component": "authentication"
    },
    "status": 422
  },
  "type": "ErrorResponse"
}

הפתרון

זו התשובה של Brave, לא של השרת: המפתח הועבר הלאה וה-API של Brave Search דחה אותו. זה בדיוק מה שהריצה שלנו הפיקה, כי הפעלנו את השרת עם מפתח מציין מקום בכוונה. בדקו שהעתקתם את המפתח מ-api-dashboard.search.brave.com/app/keys ולא אישור אחר, שהמפתח עדיין פעיל, ושהתוכנית המשויכת אליו היא זו שאתם חושבים. כמה כלים, ובהם brave_local_search ו-brave_summarizer, כותבים בתיאור שלהם עצמם שהם דורשים תוכנית Pro וייכשלו בתוכנית נמוכה יותר גם עם מפתח תקין.

קריאת כלי חוזרת כשגיאת אימות קלט

מה רואים

MCP error -32602: Input validation error: Invalid arguments for tool brave_web_search: [
  {
    "expected": "string",
    "code": "invalid_type",
    "path": [
      "query"
    ],
    "message": "Invalid input: expected string, received undefined"
  }
]

הפתרון

גרמנו לזה בכוונה כשקראנו ל-brave_web_search בלי query. השרת מאמת ארגומנטים מול הסכמה שלו לפני שהוא פונה ל-Brave, כך ששדה חובה חסר או ערך מסוג שגוי לעולם לא מגיעים ל-API. אותה צורה חוזרת גם על סוג שגוי, למשל count שנשלח כמילה three במקום כמספר. אם אתם רואים את זה בשימוש רגיל, העוזר ניחש שם פרמטר: הטבלה למעלה היא הרשימה המלאה, ורק השדות המסומנים בכוכבית הם חובה.

השרת דוחה את ערוץ התקשורת שביקשתם

מה רואים

Invalid --transport value: 'sse'. Must be one of: stdio, http.
Invalid configuration

הפתרון

יש בדיוק שני ערוצי תקשורת, stdio ו-http, וגרסה 2 הפכה את stdio לברירת המחדל. גרסה 1 השתמשה כברירת מחדל ב-http, ולכן מדריכים ישנים מעבירים ‎--transport http או מגדירים את BRAVE_MCP_TRANSPORT. SSE לא נתמך. אם אתם כן מריצים את ערוץ ה-HTTP, שימו לב שהוא מאזין בלי אימות, לכן השאירו אותו קשור ל-127.0.0.1 ואל תרחיבו את BRAVE_MCP_HOST ל-0.0.0.0 על מכונה משותפת.

לקוח ה-MCP לא מצליח להפעיל את השרת בכלל

הפתרון

הפקודה npx שייכת ל-Node.js. אם Node לא מותקן על ה-Mac, כל לקוח בעמוד הזה ייכשל בשלב ההפעלה עוד לפני שהשרת מספיק לומר משהו. התקינו Node מ-nodejs.org, הפעילו מחדש את לקוח ה-MCP ונסו שוב.

שאלות נפוצות

שאלות שאנשים שואלים.

מה זה שרת ה-MCP של Brave Search?

זו תוכנית קטנה שיושבת בין עוזר AI לבין ה-API של Brave Search ומדברת את פרוטוקול Model Context Protocol. אחרי החיבור, עוזר כמו Claude יכול להריץ חיפושי רשת, חדשות, וידאו, תמונות, מקומות ונקודות עניין, לבקש סיכום AI של אוסף תוצאות, ולמשוך תוכן עמודים מוכן לקריאה לצורך ביסוס תשובה. הוא רץ כתהליך מקומי על ה-Mac שלכם ומדבר עם אפליקציית ה-AI על גבי stdio, שהיא ברירת המחדל בגרסה 2. [4][3]

איזו חבילה של Brave Search MCP כדאי להתקין?

את הרשמית, ‎@brave/brave-search-mcp-server, שמפורסמת תחת מרחב השמות ‎@brave ב-npm על ידי Brave Software ומפותחת ב-github.com/brave/brave-search-mcp-server. החבילה שרוב המדריכים עדיין מציגים, ‎@modelcontextprotocol/server-brave-search, היא מימוש הייחוס הישן של Anthropic: היא מסומנת כמיושנת ב-npm, הקוד שלה חי במאגר הארכיוני servers-archived, וה-README הנוכחי של modelcontextprotocol/servers אומר במפורש שהיא הוחלפה בשרת הרשמי. היא עדיין נמשכת ביותר הורדות מהחבילה הרשמית, 29,660 מול 25,437 בשבוע שהסתיים ב-2026-08-01, וזה מדד לכמות המדריכים המיושנים ולא לשאלה במה להשתמש. [1][2][7][8][9][11][13]

אילו כלים כלולים בשרת ה-MCP של Brave Search?

השרת הרץ חושף 8 כלים: חיפוש (brave_web_search, brave_news_search, brave_video_search, brave_image_search), מקומות (brave_local_search, brave_place_search) ופלט מותאם ל-AI (brave_summarizer לסיכום כתוב, brave_llm_context לתוכן עמודים מחולץ). הטבלה למעלה היא פלט ה-tools/list החי, מילה במילה. חבילת הייחוס הארכיונית חושפת רק שניים מהם, brave_web_search ו-brave_local_search. [10]

הוא דורש מפתח API או חשבון?

כן, את שניהם. צריך חשבון ב-Brave Search API ומפתח מ-api-dashboard.search.brave.com/app/keys, שמוגדר כ-BRAVE_API_KEY או כנתיב קובץ ב-BRAVE_API_KEY_FILE. בלעדיו השרת בכלל לא עולה: הוא מדפיס שגיאת הגדרות ויוצא, כפי שלכדנו בקטע פתרון התקלות למעלה. זה ההבדל המעשי העיקרי משרת ללא אישורי גישה כמו שרת הקבצים. [4][5][6]

כמה עולה ה-API של Brave Search?

עמוד המחירים של Brave מציג תוכנית Search במחיר 5 דולר לכל 1,000 בקשות עם מגבלה של 50 שאילתות בשנייה, ותוכנית Answers במחיר 4 דולר לכל 1,000 בקשות בתוספת 5 דולר למיליון טוקנים עם מגבלה של 2 שאילתות בשנייה. כל אחת כוללת קרדיט חינם של 5 דולר בחודש, ומחיר Enterprise נקבע לפי דרישה. פרסומים ישנים יותר, ובהם ה-README של החבילה הארכיונית, מצטטים שכבה חינמית של 2,000 שאילתות בחודש, ומבנה התוכניות הזה כבר לא תואם למה שכתוב בעמוד המחירים. הנתונים נקראו ב-2026-08-03; בדקו את העמוד לפני שאתם בונים תקציב. [12][10]

האם שרת ה-MCP של Brave Search בטוח להרצה?

הוא לקוח חיפוש לקריאה בלבד: כל כלי שולח שאילתה ל-API של Brave Search ומחזיר תוצאות, ושום דבר על ה-Mac שלכם לא נקרא ולא נכתב. שני דברים כן שווים תשומת לב. המפתח שאתם מדביקים הוא אישור גישה שמחויב בכסף, לכן התייחסו לקובץ ההגדרות שמחזיק אותו כסוד והעדיפו את צורת משתנה הסביבה במקומות שהלקוח שלכם תומך בה. ואם אתם מדליקים את ערוץ ה-HTTP, השרת עצמו לא מאמת את מי שפונה אליו, לכן השאירו אותו קשור לכתובת הלולאה המקומית ואל תחשפו אותו לרשת. [4]

אילו אפליקציות יכולות להשתמש בשרת ה-MCP של Brave Search?

כל לקוח MCP שמסוגל להפעיל שרת stdio מקומי: Claude Desktop, Claude Code, Cursor ו-Routines כולם יכולים, וההגדרה המדויקת לכל אחד נמצאת למעלה. השרת עצמו זהה בכל לקוח; רק המקום שבו מדביקים את ההגדרה משתנה. גם VS Code עובד, אבל הקובץ שלו משתמש במפתח ‎"servers" ובמערך inputs במקום בצורת ‎"mcpServers" שמוצגת כאן, לכן אל תעתיקו קטע של VS Code לתוך הגדרות של Claude או Cursor. [4][14][15][16]

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

  1. [1]

    npm registry: @brave/brave-search-mcp-serverנקרא בתאריך 2026-08-03

    Latest version 2.1.0, published 2026-07-18; 90 versions since 2025-07-16; author Brave Software, Inc.

  2. [2]

    npm downloads API: last weekנקרא בתאריך 2026-08-03

    25,437 downloads for the week ending 2026-08-01.

  3. [3]

    GitHub: brave/brave-search-mcp-serverנקרא בתאריך 2026-08-03

    1,344 stars, MIT License, not archived, last push 2026-07-30, per the GitHub API.

  4. [4]

    Brave Search MCP server READMEנקרא בתאריך 2026-08-03

    Tool list, BRAVE_API_KEY and BRAVE_API_KEY_FILE, the stdio and http transports, and the Claude Desktop and VS Code config examples.

  5. [5]

    Brave Search MCP server source: src/config.tsנקרא בתאריך 2026-08-03

    getOptions() rejects a missing key and prints the four accepted key sources.

  6. [6]

    Brave Search MCP server source: src/index.tsנקרא בתאריך 2026-08-03

    Exits with process.exit(1) on invalid configuration, before any MCP session opens.

  7. [7]

    npm registry: @modelcontextprotocol/server-brave-searchנקרא בתאריך 2026-08-03

    Latest version 0.6.2, published 2024-12-04, flagged deprecated: Package no longer supported.

  8. [8]

    npm downloads API: last week, archived packageנקרא בתאריך 2026-08-03

    29,660 downloads for the week ending 2026-08-01, more than the official package in the same week.

  9. [9]

    GitHub: modelcontextprotocol/servers-archivedנקרא בתאריך 2026-08-03

    Archived repository, 293 stars, last push 2025-05-28, per the GitHub API. Reference MCP servers that are no longer maintained.

  10. [10]

    Archived Brave Search server README (src/brave-search)נקרא בתאריך 2026-08-03

    Documents only brave_web_search and brave_local_search, and still advertises a free tier of 2,000 queries a month.

  11. [11]

    modelcontextprotocol/servers READMEנקרא בתאריך 2026-08-03

    Lists Brave Search as replaced by the official server and links to brave/brave-search-mcp-server.

  12. [12]

    Brave Search API pricingנקרא בתאריך 2026-08-03

    Search plan $5 per 1,000 requests at 50 qps; Answers plan $4 per 1,000 requests plus $5 per million tokens at 2 qps; $5 a month in free credits on each.

  13. [13]

    modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

    The official Claude Desktop quickstart and the config file location. Its Windows troubleshooting snippet still installs the archived @modelcontextprotocol/server-brave-search.

  14. [14]

    Claude Code docs: MCPנקרא בתאריך 2026-08-03

    The claude mcp add syntax for local stdio servers, the --env and --scope flags, and the required double dash.

  15. [15]

    Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

    The mcp.json shape, the env block, the ${env:VAR} interpolation form, and the file locations.

  16. [16]

    Routines: Connectorsנקרא בתאריך 2026-08-03

    How Routines runs one-click OAuth connectors and any MCP server.

העמוד הזה מתאר את Brave Search כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.

מאחורי המדריך הזה

Routines, האפליקציה שמאחורי המדריך הזה, מריצה שרתי MCP כמו זה בלי טרמינל: כך עובדים המחברים. התדריכים שהיא כותבת נשארים קובצי markdown על ה-Mac שלכם, ואין חשבון ענן לשלם. להורדת Routines