Tavily

Servidor MCP de Tavily

El servidor MCP de Tavily proporciona:

• herramientas de búsqueda, extracción, mapeo y rastreo
• Capacidades de búsqueda web en tiempo real a través de la herramienta tavily-search
• Extracción inteligente de datos de páginas web mediante la herramienta tavily-extract
• Potente herramienta de mapeo web que crea un mapa estructurado del sitio web
• Rastreador web que explora sitios web de forma sistemática

📚 Recursos útiles

• Tutorial sobre cómo combinar Tavily MCP con el servidor MCP de Neo4j
• Tutorial sobre la integración de Tavily MCP con Cline en VS Code

Servidor MCP remoto

Conéctate directamente al servidor MCP remoto de Tavily en lugar de ejecutarlo localmente. Esto proporciona una experiencia perfecta sin necesidad de instalación ni configuración local.

Simplemente usa la URL del servidor MCP remoto con tu clave API de Tavily:

https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key> 

Obtén tu clave API de Tavily en tavily.com.

Alternativamente, puedes pasar tu clave API a través de un encabezado Authorization si el cliente MCP lo soporta:

Authorization: Bearer <your-api-key>

Nota: Al usar el MCP remoto, puedes especificar parámetros predeterminados para todas las solicitudes incluyendo un encabezado DEFAULT_PARAMETERS que contenga un objeto JSON con los valores predeterminados deseados. Ejemplo:

{"include_images":true, "search_depth": "basic", "max_results": 10}

Conectar con Claude Code

Claude Code es la herramienta CLI oficial de Anthropic para Claude. Puedes añadir el servidor MCP de Tavily usando el comando claude mcp add. Hay dos formas de autenticarse:

Opción 1: Clave API en la URL

Pasa tu clave API directamente en la URL. Reemplaza <your-api-key> con tu clave API de Tavily real:

claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

Opción 2: Flujo de autenticación OAuth

Añade el servidor sin una clave API en la URL:

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

Después de añadirlo, deberás completar el flujo de autenticación:

1. Ejecuta claude para iniciar Claude Code
2. Escribe /mcp para abrir la gestión del servidor MCP
3. Selecciona el servidor Tavily y completa el proceso de autenticación

Consejo: Añade --scope user a cualquiera de los comandos para que el servidor MCP de Tavily esté disponible globalmente en todos tus proyectos:

claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

Una vez configurado, tendrás acceso a las herramientas de búsqueda, extracción, mapeo y rastreo de Tavily.

Conectar con Cursor

Haz clic en el botón ⬆️ Añadir a Cursor ⬆️, esto hará la mayor parte del trabajo por ti, pero aún necesitarás editar la configuración para añadir tu CLAVE API. Puedes obtener una clave API de Tavily aquí.

Una vez que hagas clic en el botón, deberías ser redirigido a Cursor...

Paso 1

Haz clic en el botón de instalar

Paso 2

Deberías ver que el MCP está ahora instalado; si el interruptor azul no está ya activado, actívalo manualmente. También necesitas editar la configuración para incluir tu propia clave API de Tavily.

Paso 3

Luego serás redirigido a tu archivo mcp.json donde deberás añadir your-api-key.

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

Flujo OAuth del servidor MCP remoto

El servidor MCP remoto de Tavily soporta autenticación OAuth segura, lo que te permite conectarte y autorizarte sin problemas con clientes compatibles.

Cómo configurar la autenticación OAuth

A. Usando MCP Inspector:

• Abre MCP Inspector y haz clic en "Open Auth Settings".
• Selecciona el flujo OAuth y completa estos pasos:
  1. Descubrimiento de metadatos
  2. Registro del cliente
  3. Preparación de la autorización
  4. Solicitud de autorización y obtención del código de autorización
  5. Solicitud de token
  6. Autenticación completada

Una vez finalizado, recibirás un token de acceso que te permite realizar solicitudes autenticadas de forma segura al servidor MCP remoto de Tavily.

B. Usando otros clientes MCP (Ejemplo: Cursor):

Puedes configurar tu cliente MCP para usar OAuth sin incluir tu clave API de Tavily en la URL. Por ejemplo, en tu mcp.json:

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

Si necesitas borrar las credenciales OAuth almacenadas y volver a autenticarte, ejecuta:

rm -rf ~/.mcp-auth

Nota:

• La autenticación OAuth es opcional. Puedes seguir usando la autenticación por clave API en cualquier momento incluyendo tu clave API de Tavily en el parámetro de consulta de la URL (?tavilyApiKey=...) o configurándola en el encabezado Authorization, como se describió anteriormente.

Seleccionar qué clave API se usa para OAuth

Después de una autenticación OAuth exitosa, puedes controlar qué clave API se usa nombrándola mcp_auth_default:

• Si estableces una clave llamada mcp_auth_default en tu cuenta personal, esa clave se usará para el flujo de autenticación.
• Si eres parte de un equipo que tiene una clave llamada mcp_auth_default, esa clave se usará para el flujo de autenticación.
• Si tienes ambas, una clave personal y una de equipo llamadas mcp_auth_default, la clave personal tendrá prioridad.
• Si no se establece ninguna clave mcp_auth_default, se usará la clave default en tu cuenta personal. Si no se establece ninguna clave default, se usará la primera clave disponible.

MCP local

Prerrequisitos 🔧

Antes de comenzar, asegúrate de tener:

• Clave API de Tavily
  • Si no tienes una clave API de Tavily, puedes registrarte para obtener una cuenta gratuita aquí
• Claude Desktop o Cursor
• Node.js (v20 o superior)
  • Puedes verificar tu instalación de Node.js ejecutando:
    • node --version
• Git instalado (solo necesario si usas el método de instalación con Git)
  • En macOS: brew install git
  • En Linux:
    • Debian/Ubuntu: sudo apt install git
    • RedHat/CentOS: sudo yum install git
  • En Windows: Descarga Git para Windows

Ejecutar con NPX

npx -y tavily-mcp@latest 

Configuración de parámetros predeterminados ⚙️

Puedes establecer valores de parámetros predeterminados para la herramienta tavily-search usando la variable de entorno DEFAULT_PARAMETERS. Esto te permite configurar el comportamiento de búsqueda predeterminado sin especificar estos parámetros en cada solicitud.

Ejemplo de configuración

export DEFAULT_PARAMETERS='{"include_images": true}'

Ejemplo de uso desde el cliente

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
      }
    }
  }
}

Identificar al usuario final (Opcional)

Opcionalmente, puedes identificar al usuario final en cuyo nombre se realizan las solicitudes configurando la variable de entorno TAVILY_HUMAN_ID. Cuando se establece, Tavily MCP la reenvía como el encabezado X-Human-Id en cada llamada a la API, lo que permite análisis por usuario.

Esto es completamente opcional — déjalo sin configurar y el comportamiento no cambia.

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "TAVILY_HUMAN_ID": "your-user-id"
      }
    }
  }
}

Nota de privacidad: Tavily aplica un hash a human_id del lado del servidor (SHA-256) antes del almacenamiento, por lo que el valor bruto nunca se conserva. Aun así, prefiere identificadores opacos (por ejemplo, un ID de usuario interno) sobre PII en bruto como correos electrónicos cuando sea posible.

Agradecimientos ✨

• Model Context Protocol por la especificación MCP
• Anthropic por Claude Desktop