Servidor MCP

Visão geral

O servidor MCP do Orbit permite usar o Orbit de dentro do assistente de IA que você já usa. Depois de conectado uma única vez, o Claude, o ChatGPT ou o Codex passam a enxergar as suas simulações e a operar sobre elas em linguagem natural: ler indicadores, montar um estudo de viabilidade do zero, revisar premissas ou conduzir o acompanhamento de uma obra.

MCP, ou Model Context Protocol, é um padrão aberto que dá a um assistente um conjunto de ferramentas que ele pode chamar. O assistente vê a lista, decide quando uma ferramenta ajuda, chama e recebe o resultado. O servidor do Orbit é um desses conjuntos de ferramentas, e cada chamada vira uma requisição ao mesmo sistema que a interface do Orbit usa. Não existe uma cópia dos seus dados nem uma lógica paralela: o que os formulários consideram válido, as ferramentas também consideram.

Importante

O servidor MCP está disponível nos planos Teams e Enterprise. A conexão é individual: cada membro conecta o próprio assistente com a própria conta do Orbit, e o assistente só enxerga o que aquela pessoa já pode ver.

O que o assistente pode fazer

As ferramentas se dividem em quatro grupos. O assistente escolhe entre elas sozinho; os nomes aqui servem para você reconhecer o que ele está fazendo quando mostra a chamada.

Ler

• Listar as simulações da organização, ou só as de um projeto, e saber quais são estudos de viabilidade e quais são de acompanhamento.
• Abrir qualquer uma das visões da simulação: custos, despesas, receita, financiamento, sócios, dashboard com VPL, TIR e margem, cronograma, sensibilidade, fluxo de caixa e alocações por pessoa.
• Listar os itens de uma simulação por tipo, como obras, produtos, terrenos, curvas e planos de pagamento, e os itens da organização, como projetos e pessoas.
• Pesquisar e ler esta documentação, para responder "como" e "por que" com a fonte ao lado.

Escrever

• Criar, alterar e excluir as entidades de um estudo: terreno e proprietários, aprovações, obras, produtos, linhas de receita, planos de pagamento, curvas, composições de custo, pessoas, cotas e transferências, variáveis, projetos, simulações e os três tipos de financiamento (à produção, empréstimo e operação estruturada).
• Executar as ações que não são um simples cadastro: vincular produtos a uma linha de receita, reprojetar uma curva, configurar a análise de sensibilidade.

A exclusão é restrita a administradores da organização e, antes de apagar, o assistente recebe a lista do que depende do item, para mostrar a você o impacto.

Acompanhar

Em uma simulação de acompanhamento, o assistente lê o realizado até a data de referência, faz uma prévia da reprojeção da curva e só então grava. As duas regras do acompanhamento valem para ele como valem para você: a curva não pode começar depois do primeiro realizado e o orçamento não pode ficar abaixo do que já foi gasto. Se uma delas não fecha, a ferramenta recusa em vez de gravar uma curva que não soma.

Acertar de primeira

Um grupo de ferramentas existe só para o assistente não precisar adivinhar: descrever os campos e os valores aceitos de uma entidade, com um exemplo completo; listar o que pode ser referenciado em uma data ou valor relativo; listar os lugares onde uma curva de custo pode ser encaixada; um guia por assunto; e a lista de erros da simulação já reduzida às causas, com a correção de cada uma.

Dica

Ao pedir para montar ou alterar um estudo, comece por "consulte o guia do Orbit". O assistente lê o mapa completo das entidades e das dependências antes de criar qualquer coisa.

Conectar o seu assistente

A página Servidor MCP, nas configurações do Orbit, tem um passo a passo por assistente e o que cada um pede. Ela só aparece quando o seu plano admite o MCP, e traz os passos para Claude, ChatGPT e Codex.

Importante

Um conector atende a uma única organização. Com a URL de uma organização, o Orbit recusa as chamadas se a organização escolhida na autorização não for a mesma, em vez de responder com os dados da outra.

Várias organizações

O conector do diretório atende a uma organização por vez, a que você escolhe ao autorizar. Para manter mais de uma conectada ao mesmo tempo, adicione um conector personalizado para cada uma, com a URL da organização, que termina com o identificador dela. No Claude: Customize → Connectors → + → Add custom connector, cole a URL e, ao autorizar, selecione essa mesma organização; nos planos Team e Enterprise do Claude, é um Owner quem adiciona conectores personalizados, e cada membro só conecta a própria conta. A URL está na página Servidor MCP, dentro de cada organização. Duas recomendações:

• Dê a cada conector o nome da organização, como "Orbit Acme". É por esse nome que você e o assistente distinguem um do outro, já que as ferramentas são idênticas.
• Diga em qual organização quer trabalhar ao começar a conversa. O assistente fixa essa organização e permanece nela; para envolver outra, peça explicitamente.

O método do Orbit, já no conector

A conexão dá ao assistente as ferramentas e, junto com elas, o método: como montar um estudo respeitando os pré-requisitos de cada entidade, o que cada indicador significa, como dar um parecer com análise de sensibilidade e como conduzir uma rodada de acompanhamento. Esses guias, em português e escritos para profissionais do mercado imobiliário, vêm do próprio servidor do Orbit: o assistente os consulta quando a tarefa pede. Não há nada para instalar além do conector, e vale para qualquer assistente compatível — Claude, ChatGPT ou Codex.

Segurança e privacidade

• Quem é você vem do seu login, nunca do assistente. A cada chamada o Orbit verifica a autorização feita na conexão e deriva dela o usuário, a organização e o papel. Nada que o assistente envie muda isso.
• Só o que você já pode ver. As ferramentas operam sobre os dados da organização do conector, com as mesmas permissões da sua conta. Exclusões seguem restritas a administradores.
• As mesmas regras da interface. Toda escrita passa pelas validações do Orbit. Um valor impossível é recusado; um valor legal mas provavelmente errado, como juros de 10% ao mês, é aceito com um aviso que o assistente repassa a você. Pedidos ambíguos são recusados em vez de adivinhados.
• Texto é dado, não instrução. Nomes, descrições e campos importados do ERP são tratados como conteúdo. Se algum deles contiver algo que pareça uma ordem para o assistente, ele é orientado a relatar e não executar.
• Registro de auditoria. Cada chamada registra qual ferramenta foi usada, o resultado e a duração. Nunca os argumentos nem os dados.

Você pode desconectar o Orbit do seu assistente a qualquer momento, pelas configurações do próprio assistente.

Boas práticas

• Comece pela visão geral. "Liste minhas simulações" ou "abra o resumo do projeto X" dão ao assistente o contexto para as próximas perguntas.
• Prévia antes de gravar. No acompanhamento, peça a prévia da reprojeção e confira antes de mandar gravar. É assim que o fluxo foi desenhado.
• Peça os erros pela causa. "Quais são os problemas desta simulação?" retorna as causas reais, e não os dezenas de erros derivados delas.
• Delimite pedidos grandes. Visões muito extensas, como o plano de contas inteiro, podem exceder o tamanho de resposta; peça por parte ou por período.

Conteúdo relacionado

• Inteligência Artificial: a Orbit AI dentro do Orbit
• Projetos e simulações: o que o assistente lista e edita
• Performance: o acompanhamento que o assistente conduz
• Segurança e acesso: sessões e permissões da sua conta