Huxly

Conecte Claude Code, Cursor, Windsurf, ChatGPT, Codex ou Antigravity diretamente aos seus projetos Huxly. Construa com sua própria assinatura de IA.

---

O AI Connector permite que você aponte suas ferramentas de IA existentes — Claude Code, Cursor, Windsurf, ChatGPT, Codex, Antigravity — diretamente para seus projetos Huxly. Sua IA lê arquivos reais, envia edições, inicia o sandbox, acompanha o build e entrega um link de preview ao vivo. Toda a inferência roda na sua própria assinatura. A Huxly fornece apenas a infraestrutura.

Requisito de plano: o AI Connector está disponível nos planos Developer, Business e Max. Usuários gratuitos podem conectar após fazer upgrade em huxly.app/pricing.

---

Combine com o Supabase MCP

O conector da Huxly cuida dos arquivos do seu app, do backend e dos deploys. Ele deliberadamente nunca lê seu banco de dados.

Adicione o servidor MCP próprio do Supabase junto e sua IA terá ambos: ela lê seu schema real do Supabase enquanto escreve código correspondente pela Huxly. Útil ao construir um backend, pois ela pode ver quais tabelas já existem em vez de inferir a partir de arquivos de migração.

Ambos rodam ao mesmo tempo — aponte sua ferramenta para o endpoint da Huxly e o do Supabase, e a IA escolhe o que precisar.

---

Como funciona

Existem duas formas de conectar, e a correta depende da sua ferramenta.

Entrar com Huxly (OAuth). Claude.ai e ChatGPT podem instalar a Huxly a partir de seus próprios diretórios. Você clica em Conectar, faz login na Huxly, aprova o acesso e pronto — sem chave para gerar, colar ou rotacionar. Esta é a rota mais fácil e a que deve ser usada se sua ferramenta oferecer essa opção.

Chave de API. Todos os outros clientes MCP — Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Warp, Antigravity, Codex — autenticam com uma chave de API da Huxly que você gera uma vez e coloca em um arquivo de configuração.

Os três endpoints, para referência:

Endpoint	Usado por	Autenticação
https://huxly.app/api/mcp	A maioria dos clientes MCP	Authorization: Bearer YOUR_API_KEY
https://huxly.app/api/mcp/stream	Codex — o transporte dele é mais restrito	?key=YOUR_API_KEY
https://huxly.app/api/mcp/v2	Instalações por diretório do Claude.ai e ChatGPT	OAuth

Você só precisa se preocupar com isso se estiver configurando um cliente manualmente. As instalações por diretório cuidam disso para você.

---

Passo 1 — Obtenha sua chave de API

Pule esta etapa se estiver conectando Claude.ai ou ChatGPT pelos diretórios deles — esses usam OAuth e não precisam de chave.

1. Abra Configurações da Huxly
2. Abra a aba MCP
3. Clique em Gerar chave de API
4. Copie a chave — ela é exibida apenas uma vez

Mantenha esta chave privada. Ela tem acesso total a todos os seus projetos Huxly.

---

Configuração por ferramenta

Claude.ai (navegador, desktop, mobile)

A Huxly está listada no Diretório de Conectores do Claude, então a instalação é feita com um clique, sem chave de API.

1. Abra Huxly no diretório do Claude
2. Clique em Conectar
3. Faça login na Huxly e aprove o acesso

Inicie uma nova conversa e peça ao Claude para listar seus projetos Huxly. Funciona igual no Claude Desktop, mobile e Cowork — conecte uma vez e ele segue sua conta.

Claude Code é diferente. Ele executa seu próprio login na sua máquina e não pode usar o conector de diretório. Use a configuração com chave de API abaixo.

Claude Code CLI

Adicione ao seu ~/.claude/claude_desktop_config.json (ou claude_code_config.json):

{
  "mcpServers": {
    "huxly": {
      "type": "http",
      "url": "https://huxly.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Reinicie o Claude Code. Execute /mcp para verificar se o servidor conectou.

Cursor

1. Abra Cursor Settings → MCP
2. Clique em Add MCP Server
3. Defina o tipo como HTTP e cole:

{
  "huxly": {
    "type": "http",
    "url": "https://huxly.app/api/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

Windsurf

No seu arquivo de configuração do Windsurf (~/.codeium/windsurf/mcp_settings.json):

{
  "mcpServers": {
    "huxly": {
      "serverUrl": "https://huxly.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Antigravity (Google AI Editor)

Em ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "huxly": {
      "serverUrl": "https://huxly.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex (OpenAI)

Codex é a ferramenta de codificação agêntica da OpenAI — o equivalente da família GPT ao Claude Code. O transporte MCP dele é mais restrito que o de outros clientes, então ele usa o endpoint dedicado Streamable HTTP da Huxly: https://huxly.app/api/mcp/stream (observe o /stream).

No app Codex:

1. Abra Codex → Settings → MCP → Add server
2. Escolha Streamable HTTP como tipo de servidor e nomeie como huxly
3. Defina a URL para (sua chave vai na URL — deixe bearer token e headers vazios):

https://huxly.app/api/mcp/stream?key=YOUR_API_KEY

4. Salve e inicie uma nova conversa — execute /mcp para confirmar que as ferramentas Huxly foram carregadas

No Codex CLI (~/.codex/config.toml):

[mcp_servers.huxly]
url = "https://huxly.app/api/mcp/stream?key=YOUR_API_KEY"

Reinicie o Codex e execute /mcp para verificar. Se você vir Transport channel closed, confirme se está na URL /stream.

ChatGPT (Plus e superior)

O ChatGPT pode construir na Huxly diretamente — sem necessidade de Codex. Há duas formas de acesso.

Opção A — entrar com Huxly (recomendado)

1. Abra ChatGPT → Settings → Security e ative o Developer mode
2. Vá para a aba Plugins → clique em + para o diálogo New Plugin
3. Nomeie como Huxly e defina a Server URL para:

https://huxly.app/api/mcp/v2

4. Defina Authentication como OAuth, faça login na Huxly e aprove o acesso

Sem chave de API para gerar ou colar, e você pode revogar o acesso nas Configurações da Huxly a qualquer momento.

Opção B — chave de API

Se preferir não usar OAuth, o ChatGPT também funciona com uma chave na URL:

1. Developer mode ativado, New Plugin, nomeie como Huxly
2. Server URL:

https://huxly.app/api/mcp/stream?key=YOUR_API_KEY

3. Defina Authentication como No Auth — a chave na URL é o que autentica você
4. Marque I understand and want to continue e depois Create

Inicie um novo chat e peça para listar seus projetos Huxly para confirmar que as ferramentas foram carregadas.

Por que a Opção B diz No Auth? O diálogo de plugins do ChatGPT não consegue enviar um header Authorization personalizado, então a Huxly aceita a chave de API como parâmetro de consulta ?key=. Ela carrega exatamente o mesmo acesso que um bearer token, então trate a URL inteira como segredo — e prefira a Opção A, que evita colocar uma credencial em uma URL.

---

O que sua IA pode fazer

Ferramenta	O que faz
list_projects	Lista todos os seus projetos Huxly com framework e data de criação
list_files	Obtém a árvore completa de arquivos de um projeto
read_file	Lê qualquer arquivo de um projeto
search_files	Busca em todos os arquivos por uma string ou padrão
write_file	Cria ou substitui completamente um arquivo
write_files	Cria ou substitui vários arquivos em uma única chamada
edit_file	Faz uma alteração cirúrgica — encontra texto exato e substitui
delete_file	Exclui um arquivo
create_project	Cria um novo projeto (Expo, Flutter ou SwiftUI)
start_sandbox	Inicia o sandbox de preview ao vivo de um projeto
update_sandbox	Envia todos os arquivos atuais para o sandbox em execução e aguarda o rebuild
get_build_logs	Obtém o status atual do build e qualquer saída de erro
get_runtime_logs	Obtém logs de runtime do app em execução
get_project_url	Obtém a URL do dashboard Huxly de um projeto
get_conventions	Obtém convenções de código para o framework do projeto
get_figma_design	Puxa dados de design de um arquivo Figma conectado
get_preview_screenshot	Tira um screenshot do preview ao vivo
exec_in_sandbox	Executa um comando shell dentro do sandbox do projeto

---

Fluxo de trabalho típico

Sua IA pode executar este loop autonomamente após conectar:

1. list_projects → escolher o projeto alvo
2. list_files → entender a estrutura
3. read_file nos arquivos relevantes → entender o código atual
4. write_file / edit_file → fazer as alterações
5. update_sandbox → enviar e rebuildar (retorna o log do build inline)
6. Se o build falhar → ler o log, corrigir, enviar novamente
7. get_project_url → retornar o link de preview para você

Você observa. A IA entrega.

---

FAQ

Isso usa meus créditos Huxly?

Não. Toda a inferência de IA acontece na sua própria assinatura de IA (Claude, Cursor, ChatGPT, Codex, etc.). A Huxly fornece apenas o armazenamento de arquivos, o pipeline de build e o sandbox — que são cobertos pelo seu plano Huxly. Zero créditos Huxly consumidos por mensagem.

E se eu estiver no plano gratuito?

O AI Connector está disponível nos planos Developer, Business e Max — veja huxly.app/pricing. Usuários gratuitos veem um prompt de upgrade nas Configurações.

Posso conectar várias ferramentas de IA ao mesmo tempo?

Sim. Para ferramentas baseadas em chave, gere uma chave de API separada para cada uma nas Configurações — cada uma é independente, então revogar uma não afeta as outras. Claude.ai e ChatGPT conectam com OAuth, e você revoga esses acessos também pelas Configurações. Os dois tipos coexistem bem na mesma conta.

Meu código está seguro?

Sua chave de API concede acesso total de leitura/escrita a todos os seus projetos Huxly. Trate-a como uma senha — não compartilhe, não faça commit no git. Você pode revogar qualquer chave a qualquer momento nas Configurações.

Qual versão do protocolo MCP a Huxly usa?

2024-11-05. Compatível com todos os clientes MCP atuais.

E se minha ferramenta de IA não estiver listada?

Qualquer ferramenta que suporte o transporte HTTP do MCP funciona com a Huxly — use a mesma configuração de url e Authorization: Bearer. Para clientes estritos como Codex, use o endpoint /api/mcp/stream em vez disso, com ?key=YOUR_API_KEY na URL.

O login com Huxly atualmente funciona apenas com Claude.ai e ChatGPT, porque cada cliente OAuth é registrado individualmente conosco. Todos os outros clientes usam chave de API.