API Pública
Claude e ChatGPT (MCP)
Como conectar o Nobur ao Claude e ao ChatGPT pelo servidor MCP.
O Nobur tem um servidor MCP (Model Context Protocol), o padrão que o Claude e o ChatGPT usam para se conectar a outros sistemas. Com ele, você pede ao assistente, na própria conversa, que consulte ou cadastre corretores, imóveis, propostas, contratos e outros registros da sua organização.
O endereço do servidor é:
https://mcp.nobur.com.br/mcpA conexão está disponível em todos os planos que incluem acesso por API. Não é preciso criar uma chave de API: você entra com a sua conta do Nobur e autoriza o acesso.
Conectar no Claude
O Nobur ainda não aparece no diretório de conectores do Claude. Você o adiciona como conector personalizado, informando a URL acima. Os nomes de menus e botões abaixo estão em português, com os da interface em inglês entre parênteses; se a sua tela mostrar outro nome, use o equivalente.
Abra os conectores
Em claude.ai, vá em Personalizar > Conectores (Customize > Connectors) e clique em Adicionar conector personalizado (Add custom connector).
Informe a URL
Cole https://mcp.nobur.com.br/mcp. Não preencha client ID nem client secret. Se o Claude perguntar como se identificar (Cliente OAuth, OAuth client), mantenha Usar a identidade publicada do Claude (Use Claude's published identity), e em Autenticação (Authentication) escolha Entrar agora (Sign in now).
Adicione e conecte
Clique em Adicionar (Add) e depois em Conectar (Connect). O Claude abre a tela de autorização do Nobur.
No plano Free, o Claude permite um conector personalizado por conta.
Nesses planos, quem adiciona o conector é um Owner da organização no Claude. Cada membro depois conecta com a própria conta do Nobur.
Em vez do passo 1, o Owner pode abrir o formulário já preenchido pelo link Adicionar para toda a organização, revisar os dados e clicar em Adicionar (Add).
O Owner adiciona o conector
Em Configurações da organização > Conectores (Organization settings > Connectors), clique em Adicionar (Add) e depois em Personalizado (Custom). Se o Claude perguntar o tipo, escolha Web. Cole https://mcp.nobur.com.br/mcp, deixe client ID e client secret em branco e clique em Adicionar (Add).
Cada membro conecta
Em Personalizar > Conectores (Customize > Connectors), o Nobur aparece com a etiqueta Personalizado (Custom). Clique em Conectar (Connect) e autorize na tela do Nobur.
No terminal:
claude mcp add --transport http nobur https://mcp.nobur.com.br/mcpDepois, dentro do Claude Code, rode /mcp, selecione o servidor nobur e faça login no navegador que será aberto. Para usar o Nobur em todos os seus projetos, e não só no atual, inclua --scope user no comando.
Para sair, use Clear authentication no menu do /mcp. Isso apaga o acesso guardado no seu computador. Para encerrar a conexão também no Nobur, desconecte-a em Aplicativos conectados.
O Claude Desktop usa os mesmos conectores da sua conta em claude.ai: depois de adicionar o Nobur no navegador, ele também fica disponível no aplicativo.
Em cada conversa, você pode ligar ou desligar o Nobur pelo botão + do campo de mensagem, em Conectores (Connectors). O Claude pode pedir sua aprovação antes de executar uma ferramenta. Leia o pedido antes de aprovar, principalmente quando ele altera ou exclui dados.
Conectar no ChatGPT
No ChatGPT, o Nobur entra como servidor MCP personalizado, pela página de plugins:
- Abra chatgpt.com/plugins.
- Clique em + e escolha Adicionar servidor MCP personalizado (Add custom MCP server).
- Dê um nome e, em Conexão (Connection), informe a URL
https://mcp.nobur.com.br/mcp. - Em Autenticação (Authentication), escolha OAuth. Leia o aviso de risco e confirme em Entendo e quero continuar (I understand and want to continue).
- Clique em Criar como plugin (Create as a plugin) e autorize o acesso na tela do Nobur.
Quais planos permitem servidores MCP personalizados, e os nomes exatos dos menus, são definidos pela OpenAI e mudam com frequência. Em contas de empresa, as políticas da conta e do workspace podem restringir servidores personalizados. Veja o guia da OpenAI.
Tela de autorização
Ao conectar, o assistente abre uma página em app.nobur.com.br. Se você não estiver logado, o Nobur pede login primeiro e depois volta para a autorização. A tela mostra:
- Quem está pedindo acesso. O nome do aplicativo e o endereço para onde o acesso será enviado. Para o Claude e o ChatGPT, esse endereço é
claude.aiouchatgpt.com. No Claude Code, a tela avisa que o acesso vai para um programa no seu computador. - Organização. Escolha uma. A conexão só acessa os dados dessa organização, com as mesmas permissões que você tem nela.
- Permissões. Consultar dados é sempre concedida. Criar e alterar dados pode ser desligada para conceder apenas leitura. Nesse caso, o assistente não recebe nenhuma ferramenta de escrita. Para liberar a escrita depois, conecte de novo.
Clique em Permitir acesso para concluir ou em Recusar para cancelar.
Se a tela mostrar a etiqueta Não verificado, o Nobur não reconhece o endereço de destino. Só continue se foi você quem iniciou a conexão e se confia nesse endereço.
O que o assistente pode fazer
As ferramentas cobrem as mesmas áreas do aplicativo:
| Área | Exemplos |
|---|---|
| Corretores | Listar, buscar, cadastrar e editar |
| Partes | Listar, buscar, cadastrar e editar compradores, vendedores e outras partes |
| Imóveis | Listar, buscar, cadastrar, editar, duplicar e excluir |
| Anúncios | Criar, editar e excluir anúncios, organizar as fotos |
| Propostas | Criar, editar, mudar o status e gerenciar participantes |
| Contratos | Gerar a partir de uma proposta, editar, mudar o status e registrar observações |
| Documentos | Consultar, ver os que estão vencendo, gerar link de download e pedir documentos às partes |
| Certidões | Ver os tipos disponíveis e emitir certidões |
| Notificações | Ler e marcar como lidas |
| Auditoria | Buscar no histórico de ações da organização |
| Endereços | Buscar endereço pelo CEP |
A emissão de certidões consome créditos, como no aplicativo.
Segurança e privacidade
- O assistente age como você. Ele vê o que você vê na organização escolhida, e as regras de visibilidade e o seu papel valem para cada pedido. As ações ficam no histórico de auditoria em seu nome.
- Os dados vão para o provedor que você conectou. O que você pede ao assistente é enviado à Anthropic (Claude) ou à OpenAI (ChatGPT), sob a sua conta e os termos que você tem com eles. O Nobur não envia dados a esses provedores por iniciativa própria.
- O acesso é renovado automaticamente. Se a conexão ficar 30 dias sem uso, o assistente pede para conectar de novo.
- O acesso acaba no pedido seguinte se você desconectar o aplicativo, perder o acesso à organização ou excluir sua conta.
Revogar o acesso
Em Configurações > Aplicativos conectados, você vê cada conexão com a organização, as permissões (Leitura ou Escrita) e o último uso. Para encerrar uma, clique em Desconectar e confirme. O aplicativo perde o acesso imediatamente.