Conexão ao MCP

Confira a disponibilidade antes de conectar um cliente.

Conexões hospedadas

O Cloud MCP usa https://mcp.altifigence.com/cloud-mcp com Streamable HTTP e OAuth. Consulte disponibilidade e qualificação de clientes antes de configurar um cliente.

  1. Adicione o endpoint exato nas configurações de conexão MCP remota do seu cliente.

  2. Conclua o login no Account e revise a organização e as permissões Cloud solicitadas na página de consentimento. O cliente gerencia as credenciais OAuth.

  3. Inicialize a conexão e atualize a lista de ferramentas do cliente. Somente as ferramentas Cloud atualmente permitidas aparecem.

  4. Com permissão de leitura, leia primeiro sua identidade e a lista de projetos. Use um ID de projeto retornado para ler projetos e arquivos; a leitura de arquivos exige um espaço de trabalho pronto.

  5. Para alterar projetos, arquivos, configurações ou Git, solicite https://mcp.altifigence.com/cloud.write e conclua um novo consentimento. Sua organização deve permitir explicitamente cada ferramenta. Leia as versões atuais do projeto e dos arquivos antes de alterar arquivos salvos; examine o estado após uma resposta incerta de mutação antes de decidir se deve tentar novamente.

  6. Para o ciclo de vida do runtime, ações de terminal ou jobs, solicite a permissão https://mcp.altifigence.com/cloud.execute e conclua um novo consentimento. A análise de RTL salvo na Cloud ainda não está aberta aos clientes. Consulte os fluxos de ferramentas. A disponibilidade depende da versão do serviço e da política de runtime e ferramentas da sua organização.

  7. Para conexões pessoais de IA, solicite somente os escopos de IA necessários listados em segurança da conta, obtenha a aprovação da organização para as ferramentas e conclua um novo consentimento. Use a URL segura de configuração retornada para que o usuário insira uma chave de provedor diretamente no Cloud. Revise o provedor selecionado, o modelo, o contexto e as possíveis cobranças antes de solicitar uma resposta de IA.

Novos nomes de ferramentas exigem novo consentimento, inclusive novas ferramentas dentro de uma permissão existente. Atualizar um token antigo não as adiciona. O projeto selecionado no console não concede autorização. Trocar a organização autorizada exige um novo consentimento. Uma solicitação de leitura não inicia um projeto parado. Não adicione tokens de conta, cookies do navegador ou chaves de provedores de IA à configuração da conexão.

Se a inicialização ou a autorização falhar, use a solução de problemas. Não recorra ao envio de solicitações de protocolo para a raiz de um site ou outro perfil.

Software instalado

Para ferramentas XLS locais, use a CLI verificada para Linux com ALTI_MCP_MODE=local-xls. Consulte CLI para a configuração. Este modo não usa o encaminhamento de operações ao Cloud do cliente. Consulte a visão geral do MCP para entender a diferença entre conexões locais e hospedadas.

Verifique sua primeira leitura

  1. Peça ao cliente que leia a conta e a organização Altifigence conectadas.

  2. Liste os projetos acessíveis e selecione um ID de projeto retornado.

  3. Leia o estado do projeto selecionado. Se a leitura de um arquivo estiver indisponível, confira o projeto selecionado, o acesso e o estado atual de armazenamento/serviço no Cloud. Iniciar um ambiente de execução é uma ação de execução separada; o acesso comum a arquivos salvos não exige iniciar um ambiente de execução pessoal.

  4. Liste os arquivos e escolha um caminho retornado. Leia seu conteúdo completo, seguindo os offsets de continuação quando necessário.

  5. Peça um resumo que inclua o projeto, o caminho e a versão salva. Confira-o no Cloud antes de usar a conexão para trabalhos maiores.

Exemplo de solicitação: “Liste meus projetos do Altifigence Cloud. Leia o README no projeto que eu selecionar, depois resuma as etapas de configuração e identifique o arquivo salvo que você usou.” Isso funciona dentro do escopo de leitura publicado e explicita o destino.