SearchApi

Servidor MCP

Dale a los asistentes de IA acceso a datos en tiempo real. Busca en la web, compara vuelos, encuentra hoteles y más.

El servidor MCP de SearchApi admite dos métodos de autenticación.

OAuth (Recomendado)

Los clientes compatibles (incluidos Claude, Cursor, Codex, VS Code y Zed) manejan la autenticación automáticamente. Los clientes modernos usan Documentos de metadatos de ID de cliente; otros clientes OAuth usan registro dinámico seguro. Solo proporciona la URL base de MCP:

https://www.searchapi.io/mcp

Cuando tu cliente se conecta por primera vez, abrirá una ventana del navegador donde puedes iniciar sesión y seleccionar qué integración de MCP autorizar. Las conexiones posteriores reutilizan el token almacenado automáticamente.

Autenticación por token

Para clientes sin soporte OAuth o para integraciones servidor a servidor, envía tu token de MCP en el encabezado X-MCP-Token:

X-MCP-Token: YOUR_TOKEN

Obtén tu token desde el panel de integraciones de MCP. No pongas credenciales en una URL de MCP; las URLs pueden quedar retenidas en el historial del navegador y en registros intermedios.

¿Qué método debo usar?

Usa OAuth si tu cliente lo soporta: es más seguro (los tokens expiran y rotan automáticamente) y más fácil de gestionar. Usa autenticación por token para acceso programático o clientes que no soporten OAuth.

OAuth (Recomendado)

Si tu cliente soporta OAuth, usa la URL base. La autenticación se maneja automáticamente en la primera conexión.

No se necesita token. Tu cliente maneja la autenticación automáticamente mediante OAuth.

Claude Code

Ejecuta este comando en tu terminal:

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

Tu navegador se abre en la primera conexión para iniciar sesión y elegir una integración.

Claude Desktop

Agrégalo desde la aplicación: no se necesita archivo de configuración:

1. Abre Personalizar → Conectores.
2. Haz clic en Agregar → Agregar conector personalizado.
3. Pega la URL anterior, haz clic en Agregar y luego sigue el aviso de OAuth para autorizar.

Disponible en todos los planes.

VS Code

Crea .vscode/mcp.json en la raíz de tu proyecto:

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

Inicia el servidor de SearchApi desde la vista de MCP; VS Code maneja el inicio de sesión de OAuth.

Zed

Agrega esto bajo context_servers en tu configuración de Zed:

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

Zed usa context_servers en lugar de mcpServers y ejecuta el inicio de sesión de OAuth en la primera conexión.

Cursor

Agrega esto a ~/.cursor/mcp.json:

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

Cursor abre el inicio de sesión de OAuth cuando se conecta por primera vez.

Codex

Ejecuta este comando en tu terminal:

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

Codex descubre OAuth automáticamente. Ejecuta codex mcp login searchapi si el inicio de sesión no se abre de inmediato.

Cualquier cliente solo stdio

Usa el puente mcp-remote compatible con OAuth:

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

Requiere Node.js (para npx). Tu navegador se abre para autorización en la primera conexión.

Autenticación por token

Reemplaza YOUR_TOKEN con el token de tu panel.

Envía el token con el encabezado X-MCP-Token — no en la URL ni en el encabezado Authorization (eso está reservado para OAuth).

Cursor

Agrega esto a ~/.cursor/mcp.json:

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

O instálalo automáticamente:

Windsurf

Agrega esto a ~/.codeium/windsurf/mcp_config.json:

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

Windsurf usa la clave serverUrl en lugar de url.

Codex

Agrega esto a ~/.codex/config.toml:

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

VS Code

Crea .vscode/mcp.json en la raíz de tu proyecto:

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

Zed

Agrega esto bajo context_servers en tu configuración de Zed:

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

OpenCode

Agrega esto a opencode.json en la raíz de tu proyecto:

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

Claude Code

Ejecuta este comando en tu terminal:

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

Claude Desktop

Agrega esto a tu 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"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar. Requiere Node.js (para npx).

Cualquier otro cliente

Conecta un cliente solo stdio con mcp-remote. Establece MCP_TOKEN en su entorno:

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

Haz clic en cualquier tarjeta de herramienta para copiar un ejemplo de prompt que puedas usar con tu asistente de IA.

• Máximo 10 integraciones de MCP por cuenta
• Se aplican los límites de tasa estándar de la API
• Cada llamada a herramienta cuenta como una solicitud de API