Conectar Cursor, VS Code y otros clientes MCP

Searcherries es un servidor MCP estándar de tipo Streamable HTTP. Los clientes que admiten OAuth se registran solos contra la URL del servidor e inician sesión a través del navegador. Un cliente que no pueda hacerlo puede usar un token de acceso personal.

La URL del servidor es:

https://app.searcherries.com/mcp/searcherries

Necesitas acceso a un plan de pago en Searcherries (un periodo de prueba activo cuenta). La página de MCP tiene una pestaña con una configuración copiable para cada cliente.

Cursor

La forma más rápida es el enlace de instalación: Añadir Searcherries a Cursor. Cursor se abre y te pide que instales el servidor. Después selecciona Connect (Conectar) junto a Searcherries en los ajustes de MCP y aprueba el acceso en tu navegador.

Para añadirlo a mano:

Abre los ajustes de Cursor y busca MCP. Abre la configuración global de MCP, o abre directamente ~/.cursor/mcp.json.
Pega la configuración de abajo y guarda. Si el archivo ya tiene servidores, añade Searcherries dentro de su objeto mcpServers.
Activa Searcherries en la lista de MCP. Selecciona Connect (Conectar) o el aviso de inicio de sesión y aprueba el acceso en tu navegador.
Abre un chat de Agent y pregunta: «Lista mis proyectos de Searcherries». Permite la llamada a la herramienta de Searcherries cuando se te pida.

{
  "mcpServers": {
    "searcherries": {
      "url": "https://app.searcherries.com/mcp/searcherries"
    }
  }
}

Para usar el servidor en un solo proyecto, guarda la misma configuración en .cursor/mcp.json dentro de ese proyecto. La guía de MCP de Cursor describe sus ajustes.

VS Code con GitHub Copilot

La forma más rápida es el enlace de instalación: Instalar Searcherries en VS Code. VS Code se abre y te pide que instales el servidor. Después inicia el servidor, confirma que confías en él e inicia sesión en Searcherries en tu navegador.

Para añadirlo a mano:

Abre la paleta de comandos: Ctrl+Shift+P en Windows y Linux, Cmd+Shift+P en Mac.
Ejecuta MCP: Add Server, elige HTTP y pega la URL del servidor.
Llama al servidor searcherries. Elige Global para todos los proyectos o Workspace para el actual.
Inicia el servidor, confirma la confianza y completa el inicio de sesión de Searcherries cuando se te pida.
Abre Copilot Chat en modo Agent, activa Searcherries en Configure Tools y pregunta: «Lista mis proyectos de Searcherries».

También puedes añadir el servidor a .vscode/mcp.json. Conserva los servidores que ya existan dentro del objeto servers.

{
  "servers": {
    "searcherries": {
      "type": "http",
      "url": "https://app.searcherries.com/mcp/searcherries"
    }
  }
}

La extensión de Codex dentro de VS Code tiene sus propios ajustes de MCP; para ella sigue la guía de Codex. La guía de servidores MCP de VS Code describe la parte de Copilot.

Cualquier otro cliente

Busca MCP servers o Integrations en tu aplicación y añade un servidor remoto llamado Searcherries.
Elige Streamable HTTP, pega la URL del servidor y usa OAuth o el inicio de sesión en el navegador cuando esté disponible.
Si la aplicación solo admite un token bearer, crea uno como se describe abajo y pon en la cabecera Authorization el valor Bearer YOUR_TOKEN.
Guarda, activa el servidor y pregunta: «Lista mis proyectos de Searcherries».

Un cliente que solo admite servidores de comando local (stdio) necesita su propio adaptador HTTP remoto.

Tokens de acceso

Usa un token de acceso personal cuando un cliente MCP no pueda completar la autorización en el navegador. Un token permite a ese cliente leer los datos de Searcherries disponibles para tu cuenta. Los clientes que inician sesión a través del navegador no lo necesitan.

Crear un token

Abre MCP en Searcherries.
Abre la pestaña Other clients (Otros clientes) y busca Access tokens (Tokens de acceso).
Escribe un Token name (nombre del token) descriptivo, como «Asistente de analítica en mi portátil».
Selecciona Create token (Crear token).
Copia el valor mostrado de inmediato y guárdalo en un lugar seguro.

El token se muestra una sola vez y no se puede recuperar desde la página más adelante. Si lo pierdes, revócalo y crea otro.

Una cuenta puede tener hasta cinco tokens de acceso personales activos. La tabla muestra la fecha de creación y de caducidad de cada token. Fíate de la caducidad mostrada en lugar de suponer que un token dura indefinidamente.

Configurar el cliente

Usa una conexión MCP remota o Streamable HTTP con la URL del servidor indicada arriba y configura una cabecera HTTP de autorización:

Authorization: Bearer YOUR_TOKEN

YOUR_TOKEN es un marcador de ejemplo. Sustitúyelo por el valor que generaste, usando el campo de credenciales seguro del cliente o su compatibilidad con variables de entorno cuando exista.

Algunos clientes usan una configuración parecida a esta:

{
  "mcpServers": {
    "searcherries": {
      "type": "http",
      "url": "https://app.searcherries.com/mcp/searcherries",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Los formatos de configuración varían según el cliente. La pestaña Other clients de la página de MCP de Searcherries ofrece los datos de conexión que debes adaptar a tu cliente.

Revocar el acceso

Busca el token personal en la tabla y selecciona Revoke (Revocar). Confirma la acción. Los clientes que usan ese token pierden el acceso de inmediato, así que actualiza o desconecta cualquier cliente que dependiera de él.

La tabla de tokens personales gestiona los tokens creados ahí. Para una conexión establecida mediante OAuth, usa los controles de conectores del cliente externo para desconectarla; no des por hecho que revocar un token personal no relacionado desconecta también OAuth.

Mantener el token en privado

No pongas tokens en repositorios públicos, documentos compartidos, mensajes a soporte ni capturas de pantalla. Si un token queda expuesto, revócalo y emite uno de reemplazo.

Si la sección Access tokens no está disponible, usa OAuth donde esté admitido o contacta con soporte. No tienes que ejecutar ningún comando de administración del servidor.