FutureInfra MCP

npx add-mcp 'https://futureinfra.ai/v1/mcp'

Conexão com o Claude Code

Não é necessário copiar chaves. Depois de adicionar o MCP, basta fazer login ou se cadastrar no navegador.

claude mcp add --transport http futureinfra https://futureinfra.ai/v1/mcp

# Claude Code에서
/mcp

Quando você aprovar a permissão no navegador, a janela será fechada e o Claude retomará a solicitação que havia sido interrompida. Se houver várias organizações, escolha a organização à qual deseja se conectar na tela de aprovação. Depois de conectar, basta dizer à IA "mude para a organização de marketing" e ela alternará sem exigir novo login.

Conexão com chave de API (ambientes sem navegador, automação e CI)

Use a chave pk_live_ emitida em Console → Chaves de API como cabeçalho. Essa chave é secreta.

claude mcp add --transport http --scope user futureinfra https://futureinfra.ai/v1/mcp --header "Authorization: Bearer 발급받은_키"

Se você fornecer o endereço https://futureinfra.ai/llms.txt e a chave ao agente de IA, ele orientará o comando acima. A maioria das IAs não grava chaves secretas nas configurações por conta própria, então cole diretamente no terminal o comando retornado pela IA.

Quando há várias organizações

A chave de API está vinculada apenas à organização que a emitiu. Para usar duas organizações juntas, obtenha uma chave para cada uma e registre-as com nomes diferentes. Se registrar com o mesmo nome, a mais recente sobrescreverá a anterior, fazendo a IA trabalhar na organização errada.

claude mcp add --transport http --scope user futureinfra-onto https://futureinfra.ai/v1/mcp --header "Authorization: Bearer 온투_조직_키"
claude mcp add --transport http --scope user futureinfra-marketing https://futureinfra.ai/v1/mcp --header "Authorization: Bearer 마케팅_조직_키"

• A IA é informada a qual organização está conectada a cada conexão e confirma a organização antes de criar ou excluir recursos
• Conexões feitas por login no navegador (como o conector do app Claude) ficam em uma organização por vez e são alteradas com account.switch_org
• Se já houver futureinfra registrada e você receber uma nova chave, verifique primeiro a qual organização essa conexão pertence antes de excluí-la

Chaves coladas no chat

Uma chave colada no chat é considerada exposta. Ao concluir o trabalho, a IA pode revogá-la por conta própria (account.revoke_key, chamado sem argumentos revoga a chave em uso). Uma chave só pode revogar a si mesma; outras chaves são revogadas manualmente por uma pessoa no console. A revogação não afeta outros recursos, como servidores e aplicativos.

Depois de alterar, reinicie o cliente de IA. Isso vale quando você altera o endereço, conclui a autenticação e quando adicionamos novas ferramentas.
A lista de ferramentas é lida apenas uma vez, no início da conexão. Por isso, mesmo que já esteja disponível no servidor, ela não aparece na janela em execução — não é uma falha, é apenas algo que ainda não foi carregado.

Fluxo de conexão pelo navegador

É um fluxo que não expõe senhas, informações pessoais, dados de pagamento ou chaves de longo prazo à conversa com a IA.

1. Verificação de conta A IA pergunta se você já tem uma conta.
2. Autenticação no navegador Você faz login ou se cadastra diretamente no FutureInfra.
3. Confirmação de permissões Você aprova os escopos necessários e o limite mensal.
4. Retomada automática Ao fechar a janela, a IA retoma a solicitação interrompida.

O que configurar antes de delegar

• Reduza os escopos. Se precisar apenas de leitura, basta conceder cloud:read.
• Defina limites. Cada chave tem um teto mensal; ao ultrapassá-lo, as chamadas são recusadas.
• Exclusões não são automáticas. Operações irreversíveis passam por aprovação humana.
• Consulte os logs de auditoria. Tudo o que o agente fez fica registrado.

Escopos

Escopo	Permissão
cloud:read	Consulta de servidores, snapshots e firewall
cloud:write	Criação, energia, snapshots e abertura de portas (exclusão exige aprovação)
domain:read / domain:write	Consulta / alteração de domínios
llm:*	Chamadas de modelos de IA
billing:read	Consulta de saldo e uso

Recursos administrativos não podem ser acessados por chave de API. Mesmo que uma chave vaze, ela não alcança recursos de outros clientes nem configurações de cobrança.