Quais clientes de IA funcionam com o servidor MCP do Orbit?

Qualquer cliente MCP que ofereça suporte a conexões Streamable HTTP e cabeçalhos Authorization personalizados pode se conectar. Adicione o JSON gerado usando o método de configuração documentado pelo seu cliente.

O Orbit armazena uma conta de agente separada ou um banco de dados de agente?

Não. O endpoint MCP é stateless e usa sua conta Firebase existente, a identidade Flux, os registros na blockchain e o fluxo de pagamento via Stripe. O Orbit não adiciona um banco de dados separado para usuários de agentes ou implantações.

Um agente pode implantar sem minha aprovação?

Depende da política de aprovação no seu cliente MCP. O Orbit marca ferramentas que alteram estado como destrutivas ou não somente leitura quando apropriado. Configure seu cliente para pedir confirmação antes de implantações, compilações, controles de instância, atualizações, renovações e pagamentos.

Posso usar ZelCore ou SSP para conectar um agente?

Ainda não. A conexão MCP exige uma sessão do Firebase criada com login pelo Google ou por e-mail, porque a assinatura das requisições do lado do agente depende do SSO do Firebase.

Por quanto tempo dura uma conexão de agente?

A conexão gerada usa um token de ID Firebase de vida curta. A expiração aparece na página Conectar um agente. Gere uma nova configuração depois que ela expirar.

O agente pode ver meus tokens de repositório ou segredos do aplicativo?

O Orbit aceita credenciais de repositório privado como entradas secretas quando necessário, mas não as devolve. As respostas das ferramentas ocultam credenciais de repositório, segredos de gerenciamento, texto puro do Enterprise e variáveis de ambiente secretas conhecidas.

Implante e gerencie apps do Orbit com um agente de IA

O Orbit inclui um servidor Model Context Protocol (MCP) para implantação e operação de apps autenticadas. Conecte um agente de IA compatível, peça que ele inspecione ou gerencie seus apps e aprove as ações que você quer que ele execute. Este guia explica o fluxo de conexão, as ferramentas disponíveis, o modelo de segurança e o fluxo de trabalho recomendado.

O que o servidor MCP do Orbit faz

O Model Context Protocol, comumente chamado de MCP, dá aos clientes de IA uma forma padrão de descobrir e chamar ferramentas. O servidor MCP do Orbit expõe as mesmas capacidades de implantação e gerenciamento usadas na interface do Orbit por meio de um endpoint HTTP sem estado em https://runonflux.com/apps/mcp.

Inspecionar: liste planos e apps próprios, analise repositórios, inspecione especificações sanitizadas de apps, verifique instâncias e status de implantação, meça a capacidade da rede e leia logs limitados.
Implantação: valide uma especificação de app, registre uma implantação, teste a instalação e crie um checkout autoritativo do Stripe quando o pagamento for necessário.
Operar: dispare builds e execute ações aprovadas de start, stop, restart, pause, unpause, redeploy ou remove em instâncias atribuídas.
Manter: atualize as configurações compatíveis dos apps, preserve o período restante da assinatura e renove um app por uma duração aprovada.

Conecte seu agente

Você precisa de uma conta do Orbit com login pelo Google ou e-mail e de um cliente MCP que ofereça suporte a Streamable HTTP e cabeçalhos de autorização personalizados. Sessões somente com carteira, do ZelCore e do SSP, não podem criar uma conexão de agente no momento.

Entre no Orbit com Google ou e-mail.
Abra Painel, depois Conectar um agente.
Selecione Gerar configuração de conexão.
Copie o JSON gerado para a configuração do seu cliente MCP.
Reconecte com uma configuração recém-gerada depois que a credencial expirar.

{
  "mcpServers": {
    "orbit": {
      "type": "http",
      "url": "https://runonflux.com/apps/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FIREBASE_ID_TOKEN"
      }
    }
  }
}

Trate a configuração gerada como uma senha. Não a faça commit, não a inclua em mensagens de suporte, não a cole em prompts e não a compartilhe com outra pessoa. Gere a configuração diretamente no seu próprio painel.

Ferramentas de agente disponíveis

Recurso	Ferramentas	O que fazem
Descoberta	list_plans, analyze_repository	Compare planos e analise um repositório com as regras de compatibilidade do Orbit.
Inspeção de apps	list_apps, get_app, get_instances	Leia apps próprios do Orbit, especificações sanitizadas e nós atribuídos.
Status e capacidade	get_deployment_status, get_network_capacity	Verifique o estado do registro, as localizações ativas e a capacidade Flux adequada.
Implantação	validate_deployment, deploy_app	Visualize uma especificação autoritativa e depois registre e teste um app aprovado.
Pagamentos	create_stripe_checkout	Crie um checkout do Stripe a partir de uma transação Flux de sua propriedade e de um preço calculado pelo servidor.
Logs e builds	get_logs, trigger_build	Leia o final de um log limitado ou solicite um novo build do Orbit.
Controle de instâncias	control_instance	Execute uma ação permitida em um nó atribuído a um app próprio.
Manutenção	update_app, renew_app	Aplique alterações restritas ou estenda a assinatura de um app.

Um fluxo de implantação seguro

Comece pela análise. Peça ao agente para analisar o repositório e explicar o runtime detectado, a porta, a branch e o diretório do projeto.
Valide antes da implantação. Use validate_deployment para revisar a especificação gerada, os recursos necessários e o preço autoritativo da rede sem registrar nada.
Revise chamadas de modificação. Exija confirmação no seu cliente MCP para deploy_app, trigger_build, control_instance, update_app e renew_app.
Guarde o identificador da transação. Salve o ID da transação retornado por uma implantação, atualização ou renovação. Ele identifica a operação Flux enviada e pode ser usado para consultar status e checkout.
Verifique o resultado. Peça o status da implantação e as instâncias depois do registro. Leia o final de um log limitado se a aplicação não estiver saudável.

Autenticação, propriedade e armazenamento de dados

Cada requisição verifica o bearer credential do Firebase, deriva a identidade Flux do usuário por meio do FluxCore e cria uma sessão limitada à requisição. O transporte MCP é sem estado. O Orbit não cria um banco de dados de usuários MCP separado nem armazena uma sessão de agente de longa duração.

Firebase, FluxCore, a blockchain Flux e a ponte de pagamento Stripe continuam sendo os sistemas de registro. O Orbit verifica a propriedade do app antes de retornar detalhes do app ou contatar um nó atribuído. Credenciais de repositório, segredos de gerenciamento, texto puro de Enterprise e URLs com credenciais são ocultados dos resultados das ferramentas.

Um token de ID do Firebase tem curta duração. O fluxo de conexão atual não inclui credenciais de renovação, então o agente não consegue estender o acesso silenciosamente. Gere uma nova configuração no painel quando o token expirar.

Solução de problemas

Não autorizado: gere uma nova configuração, confirme se todo o cabeçalho Authorization foi copiado e verifique se a conta usa login com Google ou e-mail.
Ferramenta não encontrada: reconecte o cliente MCP para que ele faça a descoberta de ferramentas na versão atual do servidor.
App não listado: confirme se o app pertence à identidade Flux vinculada à conta Firebase conectada e se é uma implantação do Orbit.
Repositório não pode ser analisado: verifique a URL do repositório, a branch, o subdiretório e a credencial do repositório privado.
Pagamento necessário: use o ID da transação retornado pela chamada de modificação para criar um checkout autoritativo do Stripe.
Tempo esgotado: tente novamente uma chamada somente leitura uma vez. Não repita uma chamada de modificação sem antes verificar o ID da transação retornado ou o status da implantação.

Perguntas frequentes

Quais clientes de IA funcionam com o servidor MCP do Orbit?: Qualquer cliente MCP que ofereça suporte a conexões Streamable HTTP e cabeçalhos Authorization personalizados pode se conectar. Adicione o JSON gerado usando o método de configuração documentado pelo seu cliente.
O Orbit armazena uma conta de agente separada ou um banco de dados de agente?: Não. O endpoint MCP é stateless e usa sua conta Firebase existente, a identidade Flux, os registros na blockchain e o fluxo de pagamento via Stripe. O Orbit não adiciona um banco de dados separado para usuários de agentes ou implantações.
Um agente pode implantar sem minha aprovação?: Depende da política de aprovação no seu cliente MCP. O Orbit marca ferramentas que alteram estado como destrutivas ou não somente leitura quando apropriado. Configure seu cliente para pedir confirmação antes de implantações, compilações, controles de instância, atualizações, renovações e pagamentos.
Posso usar ZelCore ou SSP para conectar um agente?: Ainda não. A conexão MCP exige uma sessão do Firebase criada com login pelo Google ou por e-mail, porque a assinatura das requisições do lado do agente depende do SSO do Firebase.
Por quanto tempo dura uma conexão de agente?: A conexão gerada usa um token de ID Firebase de vida curta. A expiração aparece na página Conectar um agente. Gere uma nova configuração depois que ela expirar.
O agente pode ver meus tokens de repositório ou segredos do aplicativo?: O Orbit aceita credenciais de repositório privado como entradas secretas quando necessário, mas não as devolve. As respostas das ferramentas ocultam credenciais de repositório, segredos de gerenciamento, texto puro do Enterprise e variáveis de ambiente secretas conhecidas.

Voltar ao Orbit