Wheremind

Wheremind é a localização para sua IA: busca de lugares em tempo real, geocodificação e rotas passo a passo via MCP, para que ela consulte em vez de adivinhar. Projetado para humanos e bots. Beta privado. Solicite um convite em https://wheremind.ai. MCP: https://wheremind.ai/mcp

Ver em wheremind.aiExperimente este MCPPatrocinado

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Wheremind — como os agentes se conectam

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

Somente por convite. Entre na lista de espera em https://wheremind.ai (Solicite um convite) ou resgate um código de convite em https://invite.wheremind.ai. Este documento é o contrato do agente sobre apex e convite.

Quando usar o Wheremind

Wheremind é a localização para sua IA. Busca de lugares ao vivo, detalhes de lugares, busca por proximidade, geocodificação e rotas passo a passo. Use-o sempre que o usuário precisar de um lugar real, endereço ou rota. Não invente localizações. As ferramentas de mapas são consultas somente leitura (os hosts podem permiti-las por padrão).

Humano (OAuth)

Adicione a URL MCP em um host de conectores OAuth → o usuário faz login quando solicitado. Sem colar Bearer. Somente redirecionamentos na lista de permissões — não todos os hosts. Na lista de permissões: Claude, ChatGPT, Cursor e clientes de loopback locais (ex.: Claude Code). Na página de consentimento, uma conta conectada aprova com um clique. Caso contrário, o usuário faz login lá com um código enviado para seu e-mail e retorna à mesma solicitação. "Usar uma conta diferente" encerra a sessão e mantém a solicitação.

Agente (Bearer)

Uma configuração durável. Armazene a URL MCP e o Bearer uma vez no conector. mcp.json do Cursor, cabeçalhos do Claude Code ou qualquer conector que armazene um cabeçalho Bearer. Nunca coloque o Bearer em uma URL. Nenhum clique humano é necessário após o Bearer ser armazenado. Crie o Bearer em https://invite.wheremind.ai após resgatar um convite (Conectar → Criar um Bearer) e mantenha-o no conector. Revogue Bearers em Console → Seus Bearers. Os Bearers começam com wm_. Os códigos de convite têm a aparência INVITE-XXXX-XXXX-XXXX e não são Bearers — nunca envie um código de convite como Authorization.

Configuração de conector personalizado

Todo host usa a mesma URL MCP: https://wheremind.ai/mcp (HTTP streamable). O usuário precisa de uma conta Wheremind (resgate um convite em https://invite.wheremind.ai). O login é um código enviado para seu e-mail. Os rótulos dos menus mudam; se um for diferente, o objetivo é o mesmo: adicionar a URL MCP remota e, em seguida, fazer login quando o host solicitar.

Claude (claude.ai web, Desktop, mobile)

  1. Free, Pro, Max: Personalizar → Conectores → Adicionar conector personalizado. Team ou Enterprise: um Proprietário o adiciona em Configurações da organização → Conectores (Adicionar → Personalizado), e então cada membro clica em Conectar em Personalizar → Conectores.
  2. Insira a URL MCP. Deixe o ID do cliente OAuth e o segredo em branco. Se for perguntado como autenticar, escolha uma opção de login (OAuth). Se for perguntado como o Claude identifica seu cliente OAuth, escolha registro automático (o Wheremind suporta Registro Dinâmico de Clientes).
  3. Clique em Adicionar e depois em Conectar. Faça login no Wheremind na janela que abrir e aprove. Bearer armazenado: somente se sua organização Claude mostrar Cabeçalhos de solicitação (beta). Escolha Sem login, adicione um cabeçalho de autorização com o valor Bearer wm_… (inclua "Bearer " antes do token).

Claude Code

  1. claude mcp add --transport http wheremind https://wheremind.ai/mcp
  2. No Claude Code, execute /mcp, escolha wheremind e autentique no navegador. Bearer armazenado: adicione --header "Authorization: Bearer wm_…" ao passo 1.

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

  1. Ative o Modo desenvolvedor nas configurações do ChatGPT. Em Business, Enterprise e Edu, um administrador do workspace deve permitir primeiro.
  2. Crie um aplicativo em modo desenvolvedor para um servidor MCP remoto: nomeie-o Wheremind, insira a URL MCP, escolha autenticação OAuth e deixe as credenciais do cliente vazias.
  3. O ChatGPT abre o login do Wheremind; faça login e aprove.
  4. Em um chat, escolha Modo desenvolvedor no menu + e selecione Wheremind. O ChatGPT não tem configuração de cabeçalho Authorization personalizado; use OAuth.

Avançado

Aprovação de dispositivo: POST /device/code, abra verification_uri, aprove o user_code, e então consulte POST /device/token. A aprovação de dispositivo não é anunciada no OAuth well-known. Opcional. Não é a configuração Humano ou Agente.

Autenticação

Conecte a URL MCP e autentique. Solicitações MCP não autenticadas recebem HTTP 401 com WWW-Authenticate (resource_metadata) para que hosts OAuth iniciem o login. As ferramentas de mapas permanecem fechadas até então.

O host descobre OAuth (PKCE) em /.well-known/oauth-protected-resource. Um cabeçalho Authorization presente é respeitado e não é substituído pela descoberta OAuth — não remova um Authorization presente.

Nunca coloque um código ou token na URL. Humano = OAuth. Agente = Bearer durável.

Ferramentas

As ferramentas de mapas são consultas somente leitura do Google Maps (os hosts podem permiti-las por padrão).

Escolha a ferramenta que corresponde à solicitação:

  • places_search_text — autenticação necessária: Bearer ou OAuth. Encontre lugares por texto livre (nome, categoria ou "X perto de Y"). Padrão para encontrar lugares. Retorna place_id, nome, endereço formatado, lat/lng, tipos, avaliação, horários de funcionamento, atribuições.
  • places_nearby — autenticação necessária: Bearer ou OAuth. Lugares dentro de um raio de uma lat/lng que você já possui, opcionalmente filtrados por tipo. Para consultas de texto livre, use places_search_text.
  • places_details — autenticação necessária: Bearer ou OAuth. Um lugar por place_id: telefone, site, horários de funcionamento, avaliação, endereço, lat/lng, atribuições.
  • geocode — autenticação necessária: Bearer ou OAuth. Endereço para lat/lng, ou lat/lng para endereço. Retorna endereço formatado, lat/lng, place_id, tipos, além do código.
  • directions — autenticação necessária: Bearer ou OAuth. Rota de A para B (carro, caminhada, bicicleta, transporte público, moto). Aceita endereços diretamente. Retorna duração, distância, polilinha e etapas passo a passo por trecho.

Não armazene em cache resultados do Places além dos Termos de Serviço da Google Maps Platform; repasse as atribuições.

O acesso hospedado é gerenciado pelo Wheremind. Consulte /tos para detalhes do provedor.