Tavily

Servidor MCP Tavily

O servidor MCP Tavily oferece:

• ferramentas de busca, extração, mapeamento e rastreamento
• Capacidades de busca na web em tempo real através da ferramenta tavily-search
• Extração inteligente de dados de páginas web via ferramenta tavily-extract
• Poderosa ferramenta de mapeamento web que cria um mapa estruturado do site
• Rastreador web que explora sites sistematicamente

📚 Recursos Úteis

• Tutorial sobre como combinar o Tavily MCP com o servidor MCP Neo4j
• Tutorial sobre como integrar o Tavily MCP com o Cline no VS Code

Servidor MCP Remoto

Conecte-se diretamente ao servidor MCP remoto da Tavily em vez de executá-lo localmente. Isso proporciona uma experiência perfeita sem exigir instalação ou configuração local.

Basta usar a URL do servidor MCP remoto com sua chave de API Tavily:

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

Obtenha sua chave de API Tavily em tavily.com.

Alternativamente, você pode passar sua chave de API através de um cabeçalho Authorization se o cliente MCP suportar isso:

Authorization: Bearer <your-api-key>

Nota: Ao usar o MCP remoto, você pode especificar parâmetros padrão para todas as requisições incluindo um cabeçalho DEFAULT_PARAMETERS contendo um objeto JSON com os padrões desejados. Exemplo:

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

Conectar ao Claude Code

Claude Code é a ferramenta CLI oficial da Anthropic para o Claude. Você pode adicionar o servidor MCP Tavily usando o comando claude mcp add. Existem duas formas de autenticar:

Opção 1: Chave de API na URL

Passe sua chave de API diretamente na URL. Substitua <your-api-key> pela sua chave de API Tavily real:

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

Opção 2: Fluxo de Autenticação OAuth

Adicione o servidor sem uma chave de API na URL:

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

Após adicionar, você precisará completar o fluxo de autenticação:

1. Execute claude para iniciar o Claude Code
2. Digite /mcp para abrir o gerenciamento do servidor MCP
3. Selecione o servidor Tavily e complete o processo de autenticação

Dica: Adicione --scope user a qualquer um dos comandos para tornar o servidor MCP Tavily disponível globalmente em todos os seus projetos:

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

Uma vez configurado, você terá acesso às ferramentas de busca, extração, mapeamento e rastreamento da Tavily.

Conectar ao Cursor

Clique no botão ⬆️ Add to Cursor ⬆️, isso fará a maior parte do trabalho para você, mas você ainda precisará editar a configuração para adicionar sua API-KEY. Você pode obter uma chave de API Tavily aqui.

assim que clicar no botão, você deverá ser redirecionado para o Cursor ...

Passo 1

Clique no botão instalar

Passo 2

Você deverá ver que o MCP agora está instalado. Se o controle azul não estiver ativado, ative-o manualmente. Você também precisa editar a configuração para incluir sua própria chave de API Tavily.

Passo 3

Você será então redirecionado para o seu arquivo mcp.json onde deverá adicionar your-api-key.

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

Fluxo OAuth do Servidor MCP Remoto

O servidor MCP Remoto da Tavily suporta autenticação OAuth segura, permitindo que você se conecte e autorize de forma integrada com clientes compatíveis.

Como Configurar a Autenticação OAuth

A. Usando o MCP Inspector:

• Abra o MCP Inspector e clique em "Open Auth Settings".
• Selecione o fluxo OAuth e complete estes passos:
  1. Descoberta de metadados
  2. Registro do cliente
  3. Preparação da autorização
  4. Solicitar autorização e obter o código de autorização
  5. Solicitação de token
  6. Autenticação concluída

Uma vez finalizado, você receberá um token de acesso que permite fazer requisições autenticadas com segurança ao servidor MCP Remoto da Tavily.

B. Usando outros Clientes MCP (Exemplo: Cursor):

Você pode configurar seu cliente MCP para usar OAuth sem incluir sua chave de API Tavily na URL. Por exemplo, no seu mcp.json:

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

Se precisar limpar as credenciais OAuth armazenadas e reautenticar, execute:

rm -rf ~/.mcp-auth

Nota:

• A autenticação OAuth é opcional. Você ainda pode usar a autenticação por chave de API a qualquer momento, incluindo sua chave de API Tavily no parâmetro de consulta da URL (?tavilyApiKey=...) ou definindo-a no cabeçalho Authorization, conforme descrito acima.

Selecionando Qual Chave de API é Usada para OAuth

Após a autenticação OAuth bem-sucedida, você pode controlar qual chave de API é usada nomeando-a mcp_auth_default:

• Se você definir uma chave chamada mcp_auth_default na sua conta pessoal, essa chave será usada para o fluxo de autenticação.
• Se você faz parte de uma equipe que tem uma chave chamada mcp_auth_default, essa chave será usada para o fluxo de autenticação.
• Se você tiver ambas uma chave pessoal e uma chave de equipe chamadas mcp_auth_default, a chave pessoal será priorizada.
• Se nenhuma chave mcp_auth_default estiver definida, a chave default na sua conta pessoal será usada. Se nenhuma chave default estiver definida, a primeira chave disponível será usada.

MCP Local

Pré-requisitos 🔧

Antes de começar, certifique-se de ter:

• Chave de API Tavily
  • Se você não tem uma chave de API Tavily, pode se inscrever para uma conta gratuita aqui
• Claude Desktop ou Cursor
• Node.js (v20 ou superior)
  • Você pode verificar sua instalação do Node.js executando:
    • node --version
• Git instalado (necessário apenas se usar o método de instalação via Git)
  • No macOS: brew install git
  • No Linux:
    • Debian/Ubuntu: sudo apt install git
    • RedHat/CentOS: sudo yum install git
  • No Windows: Baixe o Git para Windows

Executando com NPX

npx -y tavily-mcp@latest 

Configuração de Parâmetros Padrão ⚙️

Você pode definir valores de parâmetros padrão para a ferramenta tavily-search usando a variável de ambiente DEFAULT_PARAMETERS. Isso permite configurar o comportamento de busca padrão sem especificar esses parâmetros em cada requisição.

Exemplo de Configuração

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

Exemplo de uso pelo 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\"}"
      }
    }
  }
}

Identificando o Usuário Final (Opcional)

Você pode, opcionalmente, identificar o usuário final em nome de quem as requisições estão sendo feitas, definindo a variável de ambiente TAVILY_HUMAN_ID. Quando definida, o Tavily MCP a encaminha como o cabeçalho X-Human-Id em cada chamada de API, permitindo análises por usuário.

Isso é totalmente opcional — deixe-a indefinida e o comportamento permanece inalterado.

{
  "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 privacidade: A Tavily faz hash do human_id no lado do servidor (SHA-256) antes do armazenamento, de modo que o valor bruto nunca é persistido. Mesmo assim, prefira identificadores opacos (por exemplo, um ID de usuário interno) em vez de PII bruto como e-mails, quando possível.

Agradecimentos ✨

• Model Context Protocol pela especificação MCP
• Anthropic pelo Claude Desktop