Configuração do Claude

Ao conectar o servidor MCP do WEEGLOO ao Claude, o Claude pode criar, ler e modificar diretamente recursos como Space, Content Type, Content e Media. O que é o MCP e quais preparativos são necessários é tratado em MCP. Esta página orienta, passo a passo, como fazer a conexão especificamente no Claude.

O Claude pode ser conectado em dois ambientes: a versão web (claude.ai) e o aplicativo desktop. As diferenças entre os dois ambientes são as seguintes.

• Versão web: apenas o servidor weegloo no formato HTTP é conectado. Todas as operações de criar, ler e modificar recursos são possíveis.
• Aplicativo desktop: além do servidor weegloo, também é conectado o servidor weegloo-upload, que lida com arquivos. Para realizar operações que envolvem arquivos, como upload de Media ou implantação de Web Hosting, o aplicativo desktop é necessário.

Em ambos os ambientes, é preciso ter um plano pago do Claude (Pro ou superior) para conectar servidores MCP.

A emissão do Personal Access Token necessário para a conexão é tratada em Emitir um Personal Access Token. Na configuração abaixo, no lugar onde está escrito <Personal Access Token>, insira o valor emitido como está.

Conectar à versão web (claude.ai)

A versão web conecta apenas o servidor weegloo no formato HTTP. O servidor de upload de arquivos (weegloo-upload) só é conectado no aplicativo desktop, portanto, se você precisar de operações com arquivos, siga as orientações do aplicativo desktop abaixo.

1. Após fazer login no claude.ai, abra a tela de adicionar conector.
2. Insira as informações do servidor. No nome, coloque weegloo, e no endereço do servidor, coloque https://ai.weegloo.com/mcp.
3. Conclua o login (autenticação) conforme as orientações.
4. Clique no ícone de ferramentas no campo de entrada; se as ferramentas do servidor weegloo aparecerem, a conexão foi feita.

Ao adicionar o valor ?group= ao final do endereço do servidor, é possível alterar o conjunto de ferramentas que você pode usar. Por exemplo, para usar todas as ferramentas, coloque https://ai.weegloo.com/mcp?group=all. As diferenças por grupo são tratadas na tabela de grupos de servidores MCP em MCP.

Conectar ao aplicativo desktop

O aplicativo desktop conecta os dois servidores separadamente. O servidor weegloo, usado para operações com recursos, é conectado no formato HTTP, igual à versão web; o servidor weegloo-upload, usado para operações com arquivos, é conectado executando-o diretamente no computador.

Para executar o servidor weegloo-upload, é preciso ter o Node.js 18 ou superior instalado.

Conectar o servidor weegloo

O servidor weegloo é conectado da mesma forma que na versão web.

1. Nas configurações do aplicativo desktop, abra a tela de conectores (Connectors).
2. Clique no botão de adicionar conector.
3. No nome, coloque weegloo, e no endereço do servidor, coloque https://ai.weegloo.com/mcp.
4. Conclua o login (autenticação) conforme as orientações.

Conectar o servidor weegloo-upload

O servidor weegloo-upload, usado para operações com arquivos, é registrado escrevendo-o diretamente no arquivo de configuração.

1. Abra o arquivo de configuração do aplicativo desktop do Claude. A localização por sistema operacional é a seguinte.

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Insira o seguinte conteúdo no arquivo. Se outros servidores já estiverem registrados, adicione apenas o item weegloo-upload dentro de mcpServers.

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

3. No valor de AUTH_BEARER_TOKEN (no lugar de <Personal Access Token>), insira o Personal Access Token emitido.

4. Encerre completamente o aplicativo desktop do Claude e abra-o novamente. No macOS, use Cmd+Q; no Windows, encerre pelo ícone na barra de tarefas para fechar o aplicativo por completo.

5. Clique no ícone de ferramentas no campo de entrada; se as ferramentas dos servidores weegloo e weegloo-upload aparecerem todas, a conexão foi feita.

Ao usar a ferramenta de instalação npx weegloo@latest, é possível tratar automaticamente a edição do arquivo de configuração acima. Como usar a ferramenta de instalação é tratado em MCP.

Quando a conexão não funciona

• Erro npx: command not found: o Node.js não está instalado ou não está acessível no caminho de execução. Instale a versão LTS no site oficial do Node.js.
• Quando o servidor não aparece no Windows: no arquivo de configuração, altere command para cmd e args para ["/c", "npx", "-y", "weegloo-upload"] e tente novamente.
• Erro de autenticação: verifique se o Personal Access Token inserido em AUTH_BEARER_TOKEN está correto e se não está expirado.

Próximos passos

• MCP: trata do panorama completo da conexão MCP, incluindo a ferramenta de instalação, os grupos de servidores e o que é possível fazer.
• Emitir um Personal Access Token: trata de como emitir o token usado na conexão.
• Migrar páginas estáticas com IA: acompanha o fluxo de migrar páginas reais para um serviço baseado em conteúdo usando o MCP conectado.