Conecte o Claude Code, o Codex ou o Cursor ao MonstarX

Agentes de código com IA, como o Claude Code, o Codex e o Cursor, são ótimos para escrever um app, mas deixam o resto com você: um lugar para rodar, um link para compartilhar, um domínio, um banco de dados, testes e um jeito de quem não é desenvolvedor continuar mudando o app. O MonstarX é esse resto.

Conecte o seu agente ao MonstarX uma vez, e um “envie este app para o MonstarX” coloca o que ele criou no MonstarX, rodando em uma prévia ao vivo com um link para compartilhar. A partir daí, você pode continuar criando no seu agente, no MonstarX ou nos dois: o trabalho vai e volta.

Os agentes se conectam por MCP (o Model Context Protocol, um padrão para ferramentas de IA usarem outros serviços). O servidor MCP do MonstarX fica em:

https://monstarx.com/mcp

O guia completo para desenvolvedores está na página de MCP do MonstarX.

Como conecto o meu agente?

1. Abra Configurações›API & MCP. Em Conectar um agente de código, escolha o seu agente.

   

2. Deixe Entrar pelo navegador selecionado e copie para o seu agente a configuração que aparece. As abas abaixo mostram a mesma configuração para os agentes mais comuns.

3. Entre no MonstarX quando o seu agente pedir. O navegador abre o MonstarX: entre na sua conta e clique em Permitir. Não precisa de chave.

4. Diga “Envie este app para o MonstarX e me passe o link.”

Claude Code

A ferramenta de linha de comando do Claude Code, a aba Code do app para desktop e as extensões para IDE usam a mesma configuração. Rode:

claude mcp add --transport http --scope user monstarx https://monstarx.com/mcp

Depois, rode /mcp no Claude Code, escolha monstarx e clique em Authenticate (ou rode claude mcp login monstarx). O navegador abre o MonstarX: entre na sua conta e clique em Permitir.

O --scope user deixa o MonstarX disponível em todas as pastas; sem ele, o MonstarX é adicionado só ao projeto atual.

Codex

Para a ferramenta de linha de comando e a extensão para IDE do Codex, da OpenAI, rode:

codex mcp add monstarx --url https://monstarx.com/mcp
codex mcp login monstarx

O login abre o navegador: entre no MonstarX e clique em Permitir.

Por padrão, o Codex roda comandos sem acesso à rede, e enviar um app precisa de rede. Aprove o comando de upload quando o Codex pedir ou libere o acesso à rede para a sessão.

Cursor

Clique em Add to Cursor na configuração do Cursor em Configurações ou adicione o MonstarX ao ~/.cursor/mcp.json:

{
  "mcpServers": {
    "monstarx": {
      "url": "https://monstarx.com/mcp"
    }
  }
}

O Cursor mostra o MonstarX em Settings → MCP com um botão de login: entre na sua conta e clique em Permitir. No agente de linha de comando do Cursor: agent mcp login monstarx.

VS Code

Para o modo agente do GitHub Copilot, clique em Install in VS Code na configuração do VS Code em Configurações ou rode:

code --add-mcp '{"name":"monstarx","type":"http","url":"https://monstarx.com/mcp"}'

O VS Code pede que você entre na primeira vez que uma ferramenta do MonstarX roda: entre na sua conta e clique em Permitir.

Gemini CLI

Rode:

gemini mcp add --transport http monstarx https://monstarx.com/mcp

Depois, rode /mcp auth monstarx no Gemini CLI e clique em Permitir no navegador.

Windsurf

Adicione o MonstarX ao ~/.codeium/windsurf/mcp_config.json. O Cascade pede que você entre na primeira vez:

{
  "mcpServers": {
    "monstarx": {
      "serverUrl": "https://monstarx.com/mcp"
    }
  }
}

App do Claude

Nos planos Free, Pro e Max: Customize → Connectors → Add custom connector, cole https://monstarx.com/mcp e clique em Connect: entre no MonstarX e clique em Permitir. Nos planos Team e Enterprise, um Owner adiciona o conector em Organization settings → Connectors, e os membros clicam em Connect.

Um único conector funciona na web, no app para desktop e no celular. As conversas do Claude não têm linha de comando, então apps inteiros entram pelo GitHub em vez de serem enviados.

ChatGPT

Ative o Developer mode nas configurações do ChatGPT (nos planos Business e Enterprise, um administrador precisa liberar antes) e crie um novo app ou conector com o endereço https://monstarx.com/mcp, escolhendo OAuth. O ChatGPT pergunta antes de cada ferramenta que muda alguma coisa.

A página de Configurações também cobre Grok, Lovable, Bolt & v0, Replit, Figma e Outros, ou seja, qualquer ferramenta que fale MCP. O guia completo para desenvolvedores, com mais clientes, fica em Documentação, no topo de Configurações›API & MCP.

E se o meu agente precisar de uma chave?

O Windsurf, o Gemini CLI, scripts e CI usam uma chave de API em vez do login pelo navegador. Crie uma em Configurações›API & MCP, em Chaves de API, e depois mude a configuração do agente para Chave de API para ver a versão com a chave. Veja API & MCP para criar, usar e revogar chaves. E mantenha as chaves fora do código e das conversas: uma chave age em seu nome em todos os projetos.

O que posso pedir ao meu agente?

Depois de conectado, fale com o seu agente com palavras simples. Experimente:

• “Envie este app para o MonstarX e me passe o link.”
• “Envie as minhas mudanças para o MonstarX.”
• “Baixe a versão mais recente do MonstarX e junte com as minhas mudanças.”
• “Peça ao MonstarX para adicionar um checkout do Stripe e depois traga as mudanças dele.”
• “Publique no MonstarX.”

Em um app de chat sem linha de comando (o app do Claude, o ChatGPT), experimente “Crie para mim um app de agendamento para o meu salão no MonstarX”, “Importe github.com/me/my-app para o MonstarX” ou “O que o MonstarX está fazendo no meu projeto Harbour Watch?”.

Dica

Quer que o agente se configure sozinho? Clique em Copiar o prompt de configuração para o seu agente na página de MCP do MonstarX e cole no agente. Ele lê as instruções, se conecta, envia o app e passa o link para você.

O que acontece quando o meu agente envia um app?

1. O agente pede ao MonstarX um link de upload de uso único e envia a pasta do seu app com um único comando. node_modules, os arquivos de build e os arquivos .env ficam no seu computador, e os arquivos nunca passam pelo modelo de IA, então um app grande não custa mais tokens que um pequeno.

2. O MonstarX verifica que tipo de app é (a mesma verificação de quando você importa um app) e o roda em uma prévia ao vivo, com os próprios pacotes.

3. O agente recebe o link do projeto, o que o MonstarX encontrou e as chaves de que o app ainda precisa.

Cada envio seguinte vira uma nova versão em Versões, com o nome do agente (“Enviado via Claude Code”) e um aviso no chat, para que você e o agente do MonstarX saibam o que mudou. Se alguém criou algo no MonstarX depois da última cópia do seu agente, o envio é recusado em vez de sobrescrever esse trabalho: o agente baixa a versão do MonstarX, junta as mudanças e envia de novo.

Quais ferramentas o MonstarX dá ao meu agente?

Ferramenta	O que faz
get_account	A sua conta, o plano e quanto ainda resta do seu limite de uso
list_projects	Os seus projetos, dos alterados mais recentemente para os mais antigos
get_project	Um resumo de um projeto: o que o MonstarX está fazendo, a prévia, a publicação, os segredos que faltam
prepare_upload	Um link de upload de uso único e o comando para enviar a pasta atual, como projeto novo ou nova versão
import_from_github	Traz um app de um repositório do GitHub
push_files	Grava alguns arquivos diretamente, para pequenas edições ou agentes sem linha de comando
create_project	Faz o MonstarX criar um app novo a partir de uma descrição, imagens ou documentos
read_files	Lista ou lê os arquivos de um projeto
download_project	Um link de download de uso único e o comando para descompactar o projeto
send_message	Pede ao agente do MonstarX que crie, responda ou planeje, como se você digitasse no espaço de trabalho
get_messages	Lê o chat do projeto, podendo esperar o MonstarX terminar de responder
stop	Interrompe o que o MonstarX está rodando em um projeto
publish_project	Coloca no ar a versão atual
set_secrets	Guarda as chaves que o app lê, criptografadas, em Backend → Segredos
get_logs	O estado e a saída da prévia; pode iniciar uma prévia parada

Todas as ferramentas agem só nos projetos que são seus. As ferramentas que só leem vêm marcadas como tal, para que os agentes possam rodá-las sem perguntar; publicar sempre pede confirmação antes.

Limites

• Uploads: até 100 MB como .tar.gz (o formato que o comando de envio gera) ou 50 MB como .zip. Arquivos com mais de 10 MB ficam de fora e são listados.
• push_files: 200 arquivos, 400 KB cada, 2 MB por chamada.
• Os links de upload e download funcionam uma vez, por 15 minutos.
• Um envio que apagaria a maior parte de um projeto (menos de um quarto dos arquivos) é recusado. Quase sempre é a pasta errada.
• Um envio é recusado enquanto o MonstarX está criando naquele projeto.
• Limite de uso: pedir que o MonstarX crie (send_message, create_project) consome o limite de uso do seu plano. Enviar, importar, baixar, ler e publicar não consomem.
• Chaves de API: até 20 por conta. Os logins pelo navegador continuam ativos por 90 dias de uso.

Solução de problemas

• As ferramentas do MonstarX não aparecem. A maioria dos agentes carrega os servidores quando uma sessão começa: abra uma nova. No Claude Code, /mcp mostra se o MonstarX está conectado.
• “Sign in” ou um erro de não autorizado. O login expirou ou a chave foi revogada. Entre de novo (/mcp no Claude Code, codex mcp login monstarx) ou crie uma chave nova.
• O Codex não consegue enviar. O sandbox dele bloqueia a rede: aprove o comando ou libere o acesso à rede.
• “This upload has 3 files and the project has 214”. O comando rodou na pasta errada. Rode-o onde está o package.json.
• “The files in MonstarX changed since your copy was taken”. Alguém criou algo no MonstarX depois do seu último envio. Peça ao seu agente para baixar, juntar as mudanças e enviar de novo.
• Um repositório privado do GitHub não é encontrado. Conecte o GitHub no MonstarX antes. Veja GitHub.
• O app não inicia. Peça ao seu agente para olhar os logs; uma chave que falta pode ser definida com set_secrets.

Como desconecto um agente?

Abra Configurações›API & MCP e clique em Desconectar ao lado do agente, em Agentes conectados. Ele é desconectado na hora. Um agente que usa uma chave para de funcionar quando você clica em Revogar na chave. Veja API & MCP.

Perguntas frequentes

Preciso de uma chave de API?

Normalmente, não. A maioria dos agentes entra pelo navegador: você entra no MonstarX e clica em Permitir. As chaves são para agentes, scripts e CI que não conseguem abrir um navegador.

Os meus arquivos .env vão ser enviados?

Não. O comando de envio deixa esses arquivos de fora e, se algum chegar mesmo assim, o MonstarX não o guarda. Mantenha as chaves em Backend → Segredos ou peça ao seu agente para usar o set_secrets.

Posso continuar criando tanto no meu agente quanto no MonstarX?

Pode. Envie pelo seu agente, crie no MonstarX e depois peça ao seu agente para baixar a versão mais recente. Uma verificação de revisão impede que um lado sobrescreva o outro.

Quais apps rodam no MonstarX?

Apps do MonstarX e apps Vite (React, Vue, Svelte, ou seja, toda exportação do Lovable, do Bolt e do v0) rodam e são publicados aqui. Next.js, Remix, Astro, Nuxt e SvelteKit rodam na prévia, mas são publicados na própria hospedagem. Os demais podem ser recriados como app web.

Isso é o mesmo que os conectores MCP?

Não, é o sentido contrário. Aqui, o seu agente usa o MonstarX. Os conectores MCP permitem que o MonstarX use outros servidores MCP.

Veja também

Comece pelo seu agente de códigoEnvie um app que você criou em outro lugar como projeto novo.

API & MCPAgentes conectados e chaves de API.

Importe um appO que roda no MonstarX e como funcionam as importações.

GitHubMantenha um projeto em um repositório do GitHub.