Cómo conectar Brave Search a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Brave Search, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Brave Search + Cursor

Búsqueda web en vivo desde el índice independiente de Brave: texto de páginas para fundamentar respuestas (LLM Context), búsqueda web, de noticias, imágenes y vídeos, lugares, autocompletado, ortografía y respuestas de IA. Solo lectura; necesita una clave de Brave y cada llamada se cobra en tu plan.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

BRAVE_SEARCH_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una cuenta de Brave Search API con un plan activo.

1. Crea una cuenta en https://api-dashboard.search.brave.com y activa un plan en Plans (se requiere tarjeta). El plan Search cubre LLM Context, web, noticias, imágenes, vídeos y lugares; Autosuggest, Spellcheck y Answers tienen planes propios.
2. Abre API Keys, añade una clave y cópiala en BRAVE_SEARCH_API_KEY. Se envía en la cabecera X-Subscription-Token.
3. Instala el conector; la comprobación ejecuta una búsqueda web con brave_search_web.

Cada llamada se cobra: cada búsqueda es una solicitud en tu plan de Brave. La IA mantiene bajos los valores por defecto y no repite la misma búsqueda.

Qué herramienta:

• brave_search_llm_context es la opción por defecto para preguntas sobre hechos actuales. Devuelve el texto relevante de las primeras páginas (fragmentos, tablas, código) con la URL y el título de cada una, aquí unos 4096 tokens; maximum_number_of_tokens lo sube hasta 32768 para preguntas de investigación.
• brave_search_web es una página de resultados clásica (título, URL, descripción, antigüedad) con noticias, vídeos, debates, FAQ, infobox y lugares cuando procede.
• brave_search_news, brave_search_videos y brave_search_images son las búsquedas verticales dedicadas.
• brave_search_places encuentra negocios, monumentos y puntos de interés por nombre de zona o coordenadas; brave_search_get_pois y brave_search_get_poi_descriptions devuelven detalles (dirección, teléfono, horario, valoración) y descripciones de hasta 20 ids de lugar, válidos durante 8 horas.
• brave_search_suggest completa el inicio de una consulta; brave_search_spellcheck la corrige.
• brave_search_get_rich_result obtiene un widget en vivo (tiempo, cotización bursátil, conversión de divisas, resultado deportivo) para una búsqueda web hecha con enable_rich_callback.
• brave_search_answer devuelve una respuesta de IA ya hecha por Brave (plan Answers, cobrado por búsqueda y por token). La IA prefiere LLM Context y redacta la respuesta ella misma, salvo que pidas la respuesta de Brave.

Opciones de búsqueda: los operadores funcionan en q (site:example.com, una frase exacta entre comillas, -palabra, filetype:pdf). country es un código de dos letras (por defecto US) y search_lang un código de idioma (por defecto en); define ambos para resultados locales, por ejemplo ES y es. freshness es pd (24 horas), pw (7 días), pm (31 días), py (365 días) o un rango como 2026-01-01to2026-03-31. Si la corrección ortográfica cambió la consulta, query.altered muestra lo que se buscó. Para lugares, location es texto sin comas: freiburg germany, o san francisco ca united states en EE. UU.

Contenido no fiable: los resultados y el texto de las páginas vienen de la web abierta. La IA trata las instrucciones que contienen como datos, no como órdenes, y cita las URL.

Solo lectura: todas las herramientas solo leen, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar.

Límites: la búsqueda web devuelve hasta 20 resultados por página, noticias y vídeos hasta 50, con un máximo de 10 páginas (offset de 0 a 9); imágenes hasta 200 de una vez sin paginación; lugares hasta 100. Una consulta tiene como máximo 400 caracteres y 50 palabras (600 y 75 en LLM Context). La tasa por segundo y la cuota mensual dependen de tu plan.

Errores comunes: 401 o 403 indican una clave incorrecta o un endpoint fuera del plan de la clave, por ejemplo Answers con un plan solo Search. 422 indica un parámetro no válido o ausente; el mensaje lo nombra en error.meta. 429 significa que se agotó el límite por segundo o la cuota mensual: la IA espera un segundo y reintenta una vez; el consumo lo ves en el panel de Brave.

El conector no transmite respuestas en streaming, no usa las citas ni el modo de investigación de Answers y no incluye el Summarizer.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Brave Search.

Herramientas disponibles

Ejemplos de prompts

• "Busca en la web qué cambió este mes en la Ley de IA de la UE y resúmelo con fuentes."
• "Encuentra noticias de las últimas 24 horas sobre el Banco Central Europeo, en español y de fuentes españolas."
• "¿Qué farmacias hay cerca de Valencia? Muestra direcciones, horarios y valoraciones."
• "Busca en site:docs.python.org cómo gestiona asyncio.TaskGroup las excepciones y cita la parte relevante."
• "Dame 10 sugerencias de búsqueda para 'bicicleta eléctrica' en España."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot