BigValue-Imobiliário

Configuração do BigValue Imobiliário

Após instalar o plugin, verifique o status da conexão MCP e, se ainda não estiver logado, oriente o método de login adequado para o cliente.

A autenticação é feita via login Google no navegador (OAuth), não com entrada de chave API. Não há valores a serem inseridos durante a instalação; basta um login na primeira utilização para conectar. O armazenamento e a renovação do token são gerenciados pelo cliente.

Esta skill apenas verifica o status e fornece orientações. Ela não executa comandos de login em seu lugar — a navegação no navegador deve ser concluída pelo usuário diretamente no terminal interativo para garantir uma finalização estável. Ela também não edita arquivos de configuração ou credenciais.

Se você instalou apenas a skill com npx skills add, siga as instruções de integração para a conexão MCP e pule esta skill.

Verificação de Status

1. Identifique o cliente atual. No Claude Code, use claude plugin list --json e claude mcp list; no Codex, use codex plugin list --json e codex mcp list --json. Solicite aprovação do shell se necessário.
2. Verifique se o plugin bigvalue-realestate está instalado e ativo.
3. Verifique o status do servidor MCP bigvalue-realestate. Antes do login, o servidor rejeitará a conexão, aparecendo como ! Needs authentication; se aparecer ✔ Connected, está logado. Para ter certeza, chame uma ferramenta representativa para confirmar.
4. Se apenas o status foi solicitado, relate o resultado em português e não faça alterações.

Caminho para Claude Code

Após instalar o plugin, o servidor MCP é registrado automaticamente. Resta apenas fazer o login uma vez.

Não são necessários comandos adicionais — na primeira pergunta sobre dados, o cliente abrirá o login no navegador. Abaixo está o caminho manual.

1. Se claude mcp list mostrar ! Needs authentication, é normal — significa que você ainda não fez login.
2. Oriente o usuário a executar /mcp e selecionar bigvalue-realestate. O navegador abrirá e, após o login do Google e consentimento, a conexão será concluída.
3. Alternativa: o usuário pode executar claude mcp login plugin:bigvalue-realestate:bigvalue-realestate diretamente em um terminal interativo externo. Esta skill não executa esse comando em seu lugar.
4. Imediatamente após o primeiro login, verifique em uma nova sessão. Processos que estavam ativos antes do login podem não conseguir ler o estado de autenticação.
5. Se a conta de login não estiver na lista de permissões, uma tela "Conta não pode ser conectada" será exibida. Nesse caso, oriente o usuário a solicitar permissão da conta ao responsável pela integração.

Para usar no chat do Claude Desktop, oriente o uso de um conector personalizado em vez do plugin — Settings → Connectors → Add custom connector, insira https://datamarket-mcp.bigvalue.ai/mcp e clique em Connect; o mesmo login do Google será exibido.

Caminho para Codex

O plugin do Codex contém apenas a skill. O MCP deve ser registrado separadamente e o login feito conforme abaixo.

1. Oriente o usuário a adicionar o servidor em ~/.codex/config.toml. O método de autenticação padrão é OAuth, então não é necessário especificá-lo.

   [mcp_servers.bigvalue-realestate]
   url = "https://datamarket-mcp.bigvalue.ai/mcp"
   

2. O usuário executa o login em um terminal interativo externo. Esta skill também não executa esse comando.

   codex mcp login bigvalue-realestate
   

3. Reinicie o Codex em um novo processo. As configurações e o estado de login não são refletidos em processos em execução.

4. Verifique a conexão usando codex mcp list --json e chamando uma ferramenta representativa.

Verificação

Quando conectado, chame uma ferramenta representativa uma vez para confirmar a resposta (por exemplo, pesquisa de condomínios). Não imprima ou registre URLs de login, códigos de autorização ou tokens.

Limites de Segurança

• Não solicite, imprima, copie ou registre URLs de login, códigos de autorização ou tokens. A navegação no navegador é responsabilidade do usuário.
• A modificação de ~/.codex/config.toml deve ser mostrando o trecho acima para que o usuário o aplique. Não edite diretamente configurações do Claude, arquivos de credenciais ou cache de plugins.
• Não remova ou altere outros servidores MCP ou plugins não relacionados configurados pelo usuário.