Skip to main content
OptiMind habla MCP estándar, así que funciona en cualquier cliente que lo soporte. Siempre es la misma URL:
No hay que registrar nada ni pedir acceso: al conectar, el cliente descubre solo cómo autorizarte y te abre el navegador. Entra con la misma cuenta con la que entras al panel.

​
Cursor

Edita ~/.cursor/mcp.json (global) o .cursor/mcp.json (solo ese proyecto):
Cursor abre el navegador solo la primera vez y guarda la sesión.

​
VS Code

Edita .vscode/mcp.json en tu proyecto (o el del perfil de usuario):
VS Code es el que más se equivoca la gente, por dos detalles:
  • La clave de arriba es servers, no mcpServers como en Cursor. Con la clave equivocada VS Code ignora el fichero entero y no dice nada.
  • Hace falta "type": "http". Sin él no levanta la conexión remota.

​
Gemini CLI

Edita ~/.gemini/settings.json (o .gemini/settings.json del proyecto). Ojo con el nombre del campo: aquí la URL va en httpUrl, no en url:
Gemini CLI descubre la autorización solo y guarda el token en ~/.gemini/mcp-oauth-tokens.json, renovándolo cuando caduca.

​
Cualquier otro cliente

Windsurf, Zed, Claude Desktop y el resto siguen el mismo patrón; lo único que cambia entre unos y otros son tres detalles, y merece la pena mirarlos en la doc del cliente antes de pelearse con el fichero:
  1. Cómo se llama la clave raíz — mcpServers en casi todos, servers en VS Code.
  2. Cómo se llama el campo de la URL — url en casi todos, httpUrl en Gemini CLI.
  3. Si hace falta declarar el tipo — "type": "http" en VS Code.

​
Si tu cliente se queda sin sitio para las herramientas

Algunos clientes limitan cuántas herramientas puede tener el modelo a la vez (Windsurf ronda las 100, VS Code las 128) contando todos tus servidores juntos. OptiMind trae 39 con ?features=all, así que si ya tienes varios conectores puedes quedarte corto. La solución es pedir solo lo que vayas a usar. La lista sustituye al set base, no lo amplía:
Los grupos están en la referencia de herramientas. Y si quieres mirar sin poder tocar nada:

​
Sin humano delante (headless)

Hoy no. La conexión exige que una persona autorice en el navegador con su cuenta, así que un agente que corra solo —un cron, un worker, el Agents SDK de OpenAI o el Agent SDK de Claude— no puede conectarse por su cuenta. Estamos trabajando en claves de agente para eso. Mientras tanto, si necesitas automatizar algo sin humano delante, escríbenos y lo vemos caso por caso.
Si tu cliente no ve tu negocio, o lo ve vacío, casi siempre es lo mismo: autorizaste con otra cuenta y estás conectado a un workspace distinto. Pregúntale a tu asistente «¿a qué cuenta estás conectado?» y, si no es la correcta, borra el conector y vuelve a conectarlo.