Weegloo Docs - Configuração de outros ambientes

Há muitas ferramentas compatíveis com MCP. Ferramentas como Claude, Claude Code, Codex e Cursor têm páginas de instruções dedicadas, e esta página trata do método geral para conectar o WEEGLOO MCP diretamente a outras ferramentas compatíveis com MCP.

O servidor e o endereço a conectar são os mesmos em qualquer ferramenta. Mas cada ferramenta usa um formato e nomes de chave diferentes para registrar essa informação na configuração. Por isso, esta página não descreve o formato de configuração de uma ferramenta específica, mas sim "o que você conecta" do ponto de vista do protocolo MCP. Verifique também a documentação da ferramenta que você quer conectar quanto à localização e ao formato do arquivo de configuração real.

Depois de conectar, o agente LLM da ferramenta realiza, apenas com pedidos em linguagem natural, o trabalho que uma pessoa fazia no estúdio de conteúdo. Se você descrever em palavras o que quer criar, o agente cuida diretamente de tarefas como projetar um Content Type e criar um Content ou uma Media.

Pré-requisitos

Node.js 18 ou superior: necessário para executar localmente o servidor de transferência de arquivos (weegloo-upload). Você pode baixá-lo em Download do Node.js.
Uma ferramenta compatível com MCP: qualquer ferramenta que permita registrar um servidor MCP na configuração pode ser conectada da mesma maneira. Verifique a localização e o formato do arquivo de configuração na documentação dessa ferramenta.

Os dois servidores e o transport

O WEEGLOO oferece dois servidores MCP, e os dois usam transports diferentes. Há basicamente duas maneiras de um cliente MCP se conectar a um servidor, e cada um dos dois servidores do WEEGLOO usa uma delas.

weegloo: o servidor principal, que cria, lê, edita e exclui recursos. É um servidor HTTP remoto e usa o transport Streamable HTTP do MCP. O cliente se conecta por um único endereço de endpoint, https://ai.weegloo.com/mcp, e a autenticação é feita por OAuth (veja Autenticação abaixo). O conjunto de ferramentas disponível é definido pelo valor ?group= acrescentado ao final do endereço (veja MCP).
weegloo-upload: o servidor que lida com arquivos, como o upload de Media ou a implantação de Web Hosting. É um servidor executado localmente e usa o transport stdio do MCP. O cliente inicia o próprio processo do servidor com o comando npx -y weegloo-upload e se comunica por entrada/saída padrão. A execução requer Node.js, e a autenticação é feita com um Personal Access Token colocado em uma variável de ambiente.

A maioria das ferramentas registra os dois servidores juntos em um único arquivo de configuração.

Autenticação

Os dois servidores também usam métodos de autenticação diferentes.

weegloo (HTTP remoto): autentica com o OAuth padrão do MCP. Você não coloca nenhum token no arquivo de configuração.
weegloo-upload (stdio local): sem OAuth, você coloca diretamente um Personal Access Token na variável de ambiente AUTH_BEARER_TOKEN.

O servidor weegloo é conectado remotamente, e a autenticação é feita pelo OAuth padrão do MCP. O fluxo é o seguinte.

Quando a ferramenta se conecta ao servidor weegloo pela primeira vez, a página de autenticação do WEEGLOO abre no navegador.
Cole nessa página o Personal Access Token emitido abaixo e aprove a conexão para concluir a autenticação.

Como é o método padrão do MCP, em ferramentas recentes com suporte a OAuth basta registrar o endereço do servidor para que essa autenticação aconteça automaticamente.

A página de autenticação do WEEGLOO que abre no navegador na primeira conexão é a seguinte.

Tela de autenticação do WEEGLOO

Emita um Personal Access Token com o botão abaixo. Cole-o na página de autenticação acima e use o mesmo token também no AUTH_BEARER_TOKEN do weegloo-upload.

O token é emitido apenas no momento em que você clica no botão de copiar e pode ser revogado a qualquer momento no Weegloo Console. Como o arquivo de configuração armazena o token real diretamente, tenha cuidado para não tornar esse arquivo público nem enviá-lo a um repositório compartilhado.

Exemplo de configuração

As informações necessárias para transferir cada servidor para a configuração da ferramenta são as seguintes:

weegloo (HTTP remoto): a indicação de que o transport é HTTP e o endereço de endpoint https://ai.weegloo.com/mcp.
weegloo-upload (stdio local): o comando de execução npx e os argumentos -y weegloo-upload, além das variáveis de ambiente UPLOAD_API_URL e AUTH_BEARER_TOKEN.

Cada ferramenta usa nomes de chave e um formato de arquivo diferentes para guardar essa informação. Abaixo está um exemplo no formato .mcp.json do Claude Code. Em outras ferramentas os nomes das chaves podem ser diferentes, então mantenha os valores como estão e adapte-os ao formato dessa ferramenta.

{
  "mcpServers": {
    "weegloo": {
      "type": "http",
      "url": "https://ai.weegloo.com/mcp"
    },
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

No lugar de <Personal Access Token> em AUTH_BEARER_TOKEN, coloque o token que você copiou acima. A chave em que se registra o endereço do servidor weegloo remoto varia especialmente de ferramenta para ferramenta. Veja alguns exemplos a seguir.

Ferramenta	Formato de configuração	Chave de endereço do `weegloo` remoto
Claude Code · Cursor	JSON	`type: "http"` + `url`
Codex	TOML	`url`
Antigravity	JSON	`serverUrl`
Android Studio	JSON	`httpUrl`

O servidor weegloo-upload local usa, na maioria dos casos, as chaves command, args e env com os mesmos nomes do exemplo acima. No entanto, no Windows há ferramentas em que é preciso escrever command como cmd e args como ["/c", "npx", "-y", "weegloo-upload"].

Depois de salvar a configuração, é preciso reiniciar a ferramenta ou recarregar a configuração de MCP para que as alterações entrem em vigor. Se necessário, altere o conjunto de ferramentas disponível acrescentando um grupo ao final do endereço weegloo, como ?group=all (veja MCP).

Verificar a conexão

Depois de reiniciar a ferramenta, se as ferramentas dos dois servidores aparecerem na lista de ferramentas MCP dela, a conexão foi estabelecida.

weegloo: aparecem as ferramentas que lidam com recursos. Por ser um servidor HTTP remoto, a página de autenticação do WEEGLOO abre no navegador na primeira conexão. Siga as instruções na tela e cole o token que você copiou anteriormente para concluir a autenticação.
weegloo-upload: aparecem as ferramentas que lidam com arquivos.

Depois de conectado, basta pedir ao agente da ferramenta que crie um Space ou um Content Type.

O que você pode fazer

Depois de conectar, o agente LLM pode realizar diretamente as seguintes tarefas.

Criar, ler, editar e excluir recursos como Organization, Space, Content Type, Content e Media
Implantar um site estático já compilado como Web Hosting

O que fazer em seguida

MCP: trata do panorama completo da conexão, incluindo os grupos de servidores e o servidor weegloo-upload.
Emitir um Personal Access Token: trata de como emitir o token que será usado na conexão.
Migrar uma página estática com IA: acompanha o fluxo de migrar uma página real para um serviço baseado em conteúdo usando o MCP conectado.