Wheremind

npx add-mcp 'https://wheremind.ai/mcp'

Wheremind — cómo se conectan los agentes

URL MCP HTTP transmisible: https://wheremind.ai/mcp

Solo con invitación. Únete a la lista de espera en https://wheremind.ai (Solicita una invitación) o canjea un código de invitación en https://invite.wheremind.ai. Este documento es el contrato del agente sobre apex e invitación.

Cuándo usar Wheremind

Wheremind es la ubicación para tu IA. Búsqueda de lugares en vivo, detalles de lugares, búsqueda cercana, geocodificación e indicaciones paso a paso. Úsalo siempre que el usuario necesite un lugar real, una dirección o una ruta. No inventes ubicaciones. Las herramientas de mapas son consultas de solo lectura (los hosts pueden permitirlas por defecto).

Humano (OAuth)

Añade la URL MCP en un host de conectores OAuth → el usuario inicia sesión cuando se le pida. Sin pegar Bearer. Solo redirecciones permitidas — no todos los hosts. Permitidos: Claude, ChatGPT, Cursor y clientes de bucle local (p. ej., Claude Code). En la página de consentimiento, una cuenta con sesión iniciada aprueba con un clic. De lo contrario, el usuario inicia sesión allí con un código enviado a su correo electrónico y vuelve a la misma solicitud. "Usar una cuenta diferente" cierra la sesión y mantiene la solicitud.

Agente (Bearer)

Una configuración duradera. Almacena la URL MCP y el Bearer una vez en el conector. Cursor mcp.json, encabezados de Claude Code o cualquier conector que almacene un encabezado Bearer. Nunca pongas el Bearer en una URL. No se requiere clic humano después de almacenar el Bearer. Crea el Bearer en https://invite.wheremind.ai después de canjear una invitación (Conectar → Crear un Bearer) y luego mantenlo en el conector. Revoca Bearers en Consola → Tus Bearers. Los Bearers comienzan con wm_. Los códigos de invitación tienen el formato INVITE-XXXX-XXXX-XXXX y no son Bearers — nunca envíes un código de invitación como Authorization.

Configuración de conector personalizado

Cada host usa la misma URL MCP: https://wheremind.ai/mcp (HTTP transmisible). El usuario necesita una cuenta de Wheremind (canjea una invitación en https://invite.wheremind.ai). El inicio de sesión es un código enviado a su correo electrónico. Las etiquetas de menú cambian; si una difiere, el objetivo es el mismo: añadir la URL MCP remota y luego iniciar sesión cuando el host lo solicite.

Claude (claude.ai web, Desktop, móvil)

1. Free, Pro, Max: Personalizar → Conectores → Añadir conector personalizado. Team o Enterprise: un Propietario lo añade en Configuración de organización → Conectores (Añadir → Personalizado), y luego cada miembro hace clic en Conectar en Personalizar → Conectores.
2. Introduce la URL MCP. Deja el ID de cliente OAuth y el secreto en blanco. Si se pregunta cómo autenticar, elige una opción de inicio de sesión (OAuth). Si se pregunta cómo identifica Claude su cliente OAuth, elige registro automático (Wheremind admite Dynamic Client Registration).
3. Haz clic en Añadir y luego en Conectar. Inicia sesión en Wheremind en la ventana que se abre y aprueba. Bearer almacenado: solo si tu organización de Claude muestra Request headers (beta). Elige Sin inicio de sesión, añade un encabezado de autorización con el valor Bearer wm_… (incluye "Bearer " antes del token).

Claude Code

1. claude mcp add --transport http wheremind https://wheremind.ai/mcp
2. En Claude Code ejecuta /mcp, elige wheremind y autentícate en el navegador. Bearer almacenado: añade --header "Authorization: Bearer wm_…" al paso 1.

ChatGPT (web; Plus, Pro, Business, Enterprise, Edu)

1. Activa el modo Desarrollador en la configuración de ChatGPT. En Business, Enterprise y Edu, un administrador del espacio de trabajo debe permitirlo primero.
2. Crea una aplicación en modo Desarrollador para un servidor MCP remoto: nómbrala Wheremind, introduce la URL MCP, elige autenticación OAuth y deja las credenciales de cliente vacías.
3. ChatGPT abre el inicio de sesión de Wheremind; inicia sesión y aprueba.
4. En un chat, elige Modo Desarrollador desde el menú + y selecciona Wheremind. ChatGPT no tiene configuración de encabezado Authorization personalizado; usa OAuth.

Avanzado

Aprobación de dispositivo: POST /device/code, abre verification_uri, aprueba el user_code, luego consulta POST /device/token. La aprobación de dispositivo no se anuncia en OAuth well-known. Opcional. No es la configuración Humano ni Agente.

Autenticación

Conecta la URL MCP y luego autentícate. Las solicitudes MCP no autenticadas reciben HTTP 401 con WWW-Authenticate (resource_metadata) para que los hosts OAuth inicien el inicio de sesión. Las herramientas de mapas permanecen cerradas hasta entonces. El host descubre OAuth (PKCE) en /.well-known/oauth-protected-resource. Un encabezado Authorization presente se respeta y no se reemplaza por el descubrimiento OAuth — no elimines un Authorization presente.

Nunca pongas un código o token en la URL. Humano = OAuth. Agente = Bearer duradero.

Herramientas

Las herramientas de mapas son consultas de solo lectura de Google Maps (los hosts pueden permitirlas por defecto).

Elige la herramienta que coincida con la solicitud:

• places_search_text — autenticación requerida: Bearer u OAuth. Encuentra lugares por texto libre (nombre, categoría o "X cerca de Y"). Predeterminada para encontrar lugares. Devuelve place_id, nombre, dirección formateada, lat/lng, tipos, calificación, horario de apertura, atribuciones.
• places_nearby — autenticación requerida: Bearer u OAuth. Lugares dentro de un radio de una lat/lng que ya tengas, opcionalmente filtrados por tipo. Para consultas de texto libre usa places_search_text.
• places_details — autenticación requerida: Bearer u OAuth. Un lugar por place_id: teléfono, sitio web, horario de apertura, calificación, dirección, lat/lng, atribuciones.
• geocode — autenticación requerida: Bearer u OAuth. Dirección a lat/lng, o lat/lng a dirección. Devuelve dirección formateada, lat/lng, place_id, tipos, más código.
• directions — autenticación requerida: Bearer u OAuth. Ruta de A a B (coche, caminando, bicicleta, transporte público, moto). Acepta direcciones directamente. Devuelve duración, distancia, polilínea y pasos paso a paso por tramo.

No almacenes en caché resultados de Places más allá de los Términos de servicio de Google Maps Platform; transmite las atribuciones.

El acceso alojado es gestionado por Wheremind. Consulta /tos para detalles del proveedor.