Model Context Protocol

Ligue o HAVN ao seu espaço de trabalho de AI.

O HAVN MCP permite que clientes compatíveis consultem contexto imobiliário autorizado sem expor uma ligação direta à base de dados.

Endpoint https://mcp.havnre.app/mcp

Ligar Segurança

Definições móveis HAVN com acesso MCP e botão para criar chave

Definições móveis HAVN com acesso MCP e botão para criar chave

Passo 1

Crie a sua chave HAVN MCP

Abra o HAVN no iPhone, iPad, Android ou na aplicação web.
Em Definições, procure Acesso MCP.
Toque em Criar chave. A chave completa é apresentada apenas uma vez para ser copiada.
Use a chave como token Bearer com o endpoint HAVN MCP.

Guias em vídeo

Veja o processo de ligação

Vídeos curtos mostram como ligar o HAVN ao ChatGPT ou Claude por MCP.

Vídeo de configuração ChatGPT HAVN

Ligar ChatGPT ao HAVN

Escolha a aplicação oficial HAVN no ChatGPT, abra a autorização, cole a chave MCP e conclua a ligação.

Vídeo de configuração Claude MCP

Ligar Claude ao HAVN

Adicione o HAVN como conector MCP remoto no Claude e conclua a autorização.

Passo 2

Ligue clientes de AI comuns

ChatGPT

Ligar ChatGPT ao HAVN

Abra Aplicações ou Conectores no ChatGPT.
Encontre o HAVN e escolha Ligar.
Cole a chave MCP na autorização HAVN e aprove o acesso.

Claude

Ligar MCP remoto no Claude

Abra as definições de integrações do Claude.
Adicione o endpoint HAVN como integração personalizada.
Conclua a autorização com a chave MCP; no Claude Code use o comando HTTP abaixo.

claude mcp add --transport http havn https://mcp.havnre.app/mcp \
  --header "Authorization: Bearer YOUR_HAVN_MCP_API_KEY"

VS Code e GitHub Copilot

Adicionar o servidor HTTP MCP

Abra a configuração de servidores MCP no VS Code.
Adicione o HAVN como servidor HTTP MCP.
Defina Authorization como Bearer YOUR_HAVN_MCP_API_KEY.

{
  "mcpServers": {
    "havn": {
      "type": "http",
      "url": "https://mcp.havnre.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_HAVN_MCP_API_KEY"
      }
    }
  }
}

Cursor, Windsurf e outros clientes

Usar o padrão MCP remoto

Use o URL MCP remoto com cabeçalhos ou a configuração JSON mcpServers, sempre com o mesmo endpoint e token Bearer.

{
  "mcpServers": {
    "havn": {
      "type": "http",
      "url": "https://mcp.havnre.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_HAVN_MCP_API_KEY"
      }
    }
  }
}

O que a AI pode ler e fazer

Ferramentas HAVN MCP disponíveis

workspace_summary

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

search_properties

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

get_property_media

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

search_contacts

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

search_open_houses

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

search_leads

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

search_tasks

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

search_seller_reports

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

analytics_summary

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

search_files

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

search_media

Lê apenas dados HAVN autorizados para o utilizador e a sua função na agência.

create_task

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

update_task

Atualiza um registo HAVN autorizado após confirmar permissões e contexto.

create_property

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

update_property

Atualiza um registo HAVN autorizado após confirmar permissões e contexto.

add_property_photos

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

create_open_house

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

update_open_house

Atualiza um registo HAVN autorizado após confirmar permissões e contexto.

add_open_house_lead

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

create_inquiry

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

update_inquiry

Atualiza um registo HAVN autorizado após confirmar permissões e contexto.

create_contact

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

update_contact

Atualiza um registo HAVN autorizado após confirmar permissões e contexto.

add_contact_photo

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

add_contact_note

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

update_lead_status

Atualiza um registo HAVN autorizado após confirmar permissões e contexto.

create_follow_up

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

update_follow_up

Atualiza um registo HAVN autorizado após confirmar permissões e contexto.

draft_seller_report_summary

Cria um registo HAVN após um pedido explícito do utilizador e uma verificação de permissões.

update_seller_report_summary

Atualiza um registo HAVN autorizado após confirmar permissões e contexto.

Modelo de segurança

Acesso limitado pela função, não uma entrada na base de dados

Como o HAVN limita o acesso

Cada utilizador recebe uma chave MCP própria.
O HAVN valida a chave antes de ler ou escrever dados.
Os resultados respeitam o utilizador e a função na agência.
As ferramentas de escrita exigem permissão e um pedido claro.
Os média são devolvidos apenas para imóveis acessíveis.
Anexos privados usam URLs assinados de curta duração.
A chave pode ser rodada ou revogada em Definições.

Como proteger a chave

Trate a chave como uma palavra-passe.
Não a publique em conversas, pedidos, capturas ou código.
Rode a chave ao partilhar um dispositivo ou conta de AI.
Remova conectores que já não utiliza.

Legal e privacidade

Condições importantes do acesso MCP

A AI recebe toda a base de dados?

Não. O HAVN verifica a chave, a função e o acesso à agência e devolve apenas resultados autorizados.

Posso revogar o acesso?

Sim. Revogue ou rode a chave em Definições e remova o conector do cliente de AI.

A chave completa volta a ser apresentada?

Não. Só aparece na criação; depois são guardados apenas o hash e um prefixo curto.

O MCP altera a minha subscrição?

Não. É uma ponte de acesso, embora chamadas mais frequentes possam aumentar a utilização normal da infraestrutura.

Ao ligar um cliente de AI, autoriza o HAVN a enviar dados permitidos e a criar ou atualizar registos apenas quando pedir explicitamente ferramentas de escrita.

O fornecedor de AI pode tratar os dados segundo os seus próprios termos e política de privacidade. Reveja ambas as políticas antes de ligar dados de produção.

Política de Privacidade · Termos de Utilização

Documentação dos fornecedores

Referências oficiais