SearchApi

Servidor MCP

Dê aos assistentes de IA acesso a dados em tempo real. Pesquise na web, compare voos, encontre hotéis e muito mais.

O servidor MCP da SearchApi suporta dois métodos de autenticação.

OAuth (Recomendado)

Clientes compatíveis (incluindo Claude, Cursor, Codex, VS Code e Zed) lidam com a autenticação automaticamente. Clientes modernos usam Documentos de Metadados de ID de Cliente; outros clientes OAuth usam registro dinâmico seguro. Basta fornecer a URL base do MCP:

https://www.searchapi.io/mcp

Quando seu cliente conectar pela primeira vez, ele abrirá uma janela do navegador onde você pode entrar e selecionar qual integração MCP autorizar. Conexões subsequentes reutilizam o token armazenado automaticamente.

Autenticação por Token

Para clientes sem suporte a OAuth ou para integrações servidor a servidor, envie seu token MCP no cabeçalho X-MCP-Token:

X-MCP-Token: YOUR_TOKEN

Obtenha seu token no painel de integrações MCP. Não coloque credenciais em uma URL MCP; URLs podem ser retidas no histórico do navegador e em logs intermediários.

Qual método devo usar?

Use OAuth se seu cliente suportar — é mais seguro (tokens expiram e rotacionam automaticamente) e mais fácil de gerenciar. Use autenticação por token para acesso programático ou clientes que não suportam OAuth.

OAuth (Recomendado)

Se seu cliente suporta OAuth, use a URL base. A autenticação é tratada automaticamente na primeira conexão.

Nenhum token necessário. Seu cliente lida com a autenticação automaticamente via OAuth.

Claude Code

Execute este comando no seu terminal:

claude mcp add --transport http searchapi https://www.searchapi.io/mcp

Seu navegador abre na primeira conexão para entrar e escolher uma integração.

Claude Desktop

Adicione pelo aplicativo — nenhum arquivo de configuração necessário:

1. Abra Personalizar → Conectores.
2. Clique em Adicionar → Adicionar conector personalizado.
3. Cole a URL acima, clique em Adicionar e siga o prompt OAuth para autorizar.

Disponível em todos os planos.

VS Code

Crie .vscode/mcp.json na raiz do seu projeto:

{
  "servers": {
    "searchapi": {
      "type": "http",
      "url": "https://www.searchapi.io/mcp"
    }
  }
}

Inicie o servidor SearchApi pela visualização MCP; o VS Code lida com o login OAuth.

Zed

Adicione isto em context_servers nas configurações do Zed:

{
  "context_servers": {
    "searchapi": {
      "url": "https://www.searchapi.io/mcp"
    }
  }
}

O Zed usa context_servers em vez de mcpServers e executa o login OAuth na primeira conexão.

Cursor

Adicione isto a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "searchapi": {
      "url": "https://www.searchapi.io/mcp"
    }
  }
}

O Cursor abre o login OAuth quando conecta pela primeira vez.

Codex

Execute este comando no seu terminal:

codex mcp add searchapi --url https://www.searchapi.io/mcp

O Codex descobre OAuth automaticamente. Execute codex mcp login searchapi se o login não for aberto imediatamente.

Qualquer cliente somente stdio

Use a ponte mcp-remote com suporte a OAuth:

{
  "mcpServers": {
    "searchapi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.searchapi.io/mcp"
      ]
    }
  }
}

Requer Node.js (para npx). Seu navegador abre para autorização na primeira conexão.

Autenticação por Token

Substitua YOUR_TOKEN pelo token do seu painel.

Envie o token com o cabeçalho X-MCP-Token — não na URL ou no cabeçalho Authorization (isso é reservado para OAuth).

Cursor

Adicione isto a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "searchapi": {
      "url": "https://www.searchapi.io/mcp",
      "headers": {
        "X-MCP-Token": "YOUR_TOKEN"
      }
    }
  }
}

Ou instale automaticamente:

Windsurf

Adicione isto a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "searchapi": {
      "serverUrl": "https://www.searchapi.io/mcp",
      "headers": {
        "X-MCP-Token": "YOUR_TOKEN"
      }
    }
  }
}

O Windsurf usa a chave serverUrl em vez de url.

Codex

Adicione isto a ~/.codex/config.toml:

[mcp_servers.searchapi]
url = "https://www.searchapi.io/mcp"
http_headers = { "X-MCP-Token" = "YOUR_TOKEN" }

VS Code

Crie .vscode/mcp.json na raiz do seu projeto:

{
  "servers": {
    "searchapi": {
      "type": "http",
      "url": "https://www.searchapi.io/mcp",
      "headers": {
        "X-MCP-Token": "YOUR_TOKEN"
      }
    }
  }
}

Zed

Adicione isto em context_servers nas configurações do Zed:

{
  "context_servers": {
    "searchapi": {
      "url": "https://www.searchapi.io/mcp",
      "headers": {
        "X-MCP-Token": "YOUR_TOKEN"
      }
    }
  }
}

OpenCode

Adicione isto a opencode.json na raiz do seu projeto:

{
  "mcp": {
    "searchapi": {
      "type": "remote",
      "url": "https://www.searchapi.io/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "X-MCP-Token": "YOUR_TOKEN"
      }
    }
  }
}

Claude Code

Execute este comando no seu terminal:

claude mcp add --transport http searchapi https://www.searchapi.io/mcp --header "X-MCP-Token: YOUR_TOKEN"

Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "searchapi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.searchapi.io/mcp",
        "--header",
        "X-MCP-Token:${MCP_TOKEN}"
      ],
      "env": {
        "MCP_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar. Requer Node.js (para npx).

Qualquer outro cliente

Conecte um cliente somente stdio com mcp-remote. Defina MCP_TOKEN no ambiente dele:

npx mcp-remote https://www.searchapi.io/mcp --header "X-MCP-Token:${MCP_TOKEN}"

Clique em qualquer cartão de ferramenta para copiar um exemplo de prompt que você pode usar com seu assistente de IA.

• Máximo de 10 integrações MCP por conta
• Limites de taxa padrão da API se aplicam
• Cada chamada de ferramenta conta como uma solicitação de API