Configuração do Claude

O Claude Desktop traz o agente de programação Claude Code como uma aba Code. O servidor MCP do WEEGLOO é conectado e usado por meio dessa aba Code. Com essa conexão, o agente da aba Code pode criar, ler e modificar diretamente recursos como Content Type, Content e Media. A ferramenta de instalação instala as Skills e as Rules junto com o servidor MCP, ajudando o agente da aba Code a usar a API do WEEGLOO da maneira pretendida. As Skills são guias sobre como executar bem uma tarefa específica, e as Rules são regras a seguir em todas as tarefas. Você configura tudo de uma vez com a ferramenta de instalação, conclui a autenticação com o /mcp do claude e já pode usá-lo diretamente na aba Code.

Os detalhes sobre o servidor MCP e sobre as Skills e as Rules estão, respectivamente, nas páginas MCP e Skills e Rules. Esta página trata apenas de como se conectar à aba Code do Claude Desktop.

A aba Code do Claude Desktop funciona com o Claude Code. O WEEGLOO também é conectado por meio da aba Code, com as mesmas configurações de MCP, Skills e Rules do Claude Code. O Claude Code precisa estar instalado de forma que você possa executar o comando claude no terminal. Se você ainda não o tiver, consulte o guia de instalação do Claude Code.

Pré-requisitos

Para executar os comandos de instalação abaixo, você precisa do Node.js. Primeiro, verifique se ele está instalado e se a versão é 18 ou superior com os comandos a seguir.

Terminal
node --version # v18 ou superior está OK npx --version # OK se uma versão for exibida

Se o Node.js estiver instalado mas o npx não, atualize o npm para a versão mais recente com o comando abaixo. Ao atualizar o npm, o npx é instalado junto.

Terminal
npm install -g npm@latest

Se o Node.js não estiver instalado ou a versão for muito antiga, instale o Node.js usando o método adequado ao seu sistema operacional.

Terminal
brew install node

Se você não tiver o Homebrew, instale-o primeiro em brew.sh ou baixe o Node.js diretamente em nodejs.org.

Terminal
winget install OpenJS.NodeJS.LTS

Se o winget não existir ou não for reconhecido, baixe o instalador LTS em nodejs.org. Depois de instalar, você precisa abrir um novo terminal.

Os pacotes das distribuições podem estar desatualizados, então recomendamos instalar com o nvm, que funciona em várias distribuições.

Terminal
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install --lts

Para baixar o instalador diretamente, consulte nodejs.org.

Conectar

A instalação básica consiste em copiar o comando de instalação desta página e executá-lo uma vez no terminal. Para escolher você mesmo cada etapa do processo de instalação, abra Instalação personalizada.

Local de instalação
1

Instalar MCP e Skills

Copie o comando de instalação e execute-o no terminal.

Terminal
$ npx weegloo@latest -y \ --agent claude \ --token <Personal Access Token>
2

Autenticar a conexão MCP

Autentique na ordem abaixo.

Esta etapa requer o Claude Code CLI (claude). Se você ainda não o tiver, instale o Claude Code.

  1. Execute o Claude Code no terminal.

    Terminal
    claude

  2. Digite /mcp para abrir a tela de gerenciamento dos servidores MCP.

    Terminal
    /mcp

  3. Na lista, selecione weegloo. Ele aparece com o status needs authentication.

    Terminal
    Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

  4. Verifique se o endereço de conexão é https://ai.weegloo.com/mcp e selecione Authenticate.

    Terminal
    Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable

  5. Ao selecionar Authenticate, a página de autenticação do WEEGLOO abre no navegador, como abaixo. Copie o token com o botão Copiar token, cole-o e clique em Conectar servidor. Quando weegloo mudar para connected, está concluído.

    Tela de autenticação do WEEGLOO

1

Instalar MCP e Skills

Copie o comando de instalação e execute-o no terminal. Execute-o obrigatoriamente dentro da pasta do projeto que você quer conectar.

Terminal
$ npx weegloo@latest -y \ --agent claude \ --location project \ --token <Personal Access Token>
2

Autenticar a conexão MCP

Autentique na ordem abaixo.

Esta etapa requer o Claude Code CLI (claude). Se você ainda não o tiver, instale o Claude Code.

  1. Execute o Claude Code no terminal. Execute-o obrigatoriamente dentro da pasta do projeto que você quer conectar.

    Terminal
    claude

  2. Na primeira execução, ele pode perguntar se você quer ativar os novos servidores MCP. Nesse caso, verifique se weegloo e weegloo-upload estão marcados e pressione Enter para enviar.

    Terminal
    New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload

  3. Digite /mcp para abrir a tela de gerenciamento dos servidores MCP.

    Terminal
    /mcp

  4. Na lista, selecione weegloo. Ele aparece com o status needs authentication.

    Terminal
    Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

    Se os servidores não aparecerem na lista: se weegloo e weegloo-upload não aparecerem na lista, pode ser que você não tenha enviado na tela de ativação do passo 2 ou que eles estejam desativados. Encerre o Claude Code, digite o comando abaixo no terminal e execute claude novamente. Quando a mesma tela do passo 2 aparecer de novo, deixe weegloo e weegloo-upload marcados e pressione Enter para enviar.

    Terminal
    claude mcp reset-project-choices

  5. Verifique se o endereço de conexão é https://ai.weegloo.com/mcp e selecione Authenticate.

    Terminal
    Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable

  6. Ao selecionar Authenticate, a página de autenticação do WEEGLOO abre no navegador, como abaixo. Copie o token com o botão Copiar token, cole-o e clique em Conectar servidor. Quando weegloo mudar para connected, está concluído.

    Tela de autenticação do WEEGLOO

Instale executando o npx weegloo de forma interativa, escolhendo você mesmo os itens solicitados.

Local de instalação
1

Executar a ferramenta de instalação

Execute o comando abaixo no terminal e escolha os itens solicitados um a um. Onde ele pedir o token, copie o token com o botão Copiar token abaixo e cole-o.

Terminal
npx weegloo@latest
Terminal
✔ Select your IDE: Claude Code ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← token copiado ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Global … ✔ Installation complete!
2

Autenticar a conexão MCP

Autentique na ordem abaixo.

Esta etapa requer o Claude Code CLI (claude). Se você ainda não o tiver, instale o Claude Code.

  1. Execute o Claude Code no terminal.

    Terminal
    claude

  2. Digite /mcp para abrir a tela de gerenciamento dos servidores MCP.

    Terminal
    /mcp

  3. Na lista, selecione weegloo. Ele aparece com o status needs authentication.

    Terminal
    Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

  4. Verifique se o endereço de conexão é https://ai.weegloo.com/mcp e selecione Authenticate.

    Terminal
    Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable

  5. Ao selecionar Authenticate, a página de autenticação do WEEGLOO abre no navegador, como abaixo. Copie o token com o botão Copiar token, cole-o e clique em Conectar servidor. Quando weegloo mudar para connected, está concluído.

    Tela de autenticação do WEEGLOO

1

Executar a ferramenta de instalação

Vá até a pasta do projeto que você quer conectar e, nessa pasta, execute o comando abaixo e escolha os itens solicitados um a um. Onde ele pedir o token, copie o token com o botão Copiar token abaixo e cole-o. Execute-o obrigatoriamente dentro dessa pasta do projeto.

Terminal
npx weegloo@latest
Terminal
✔ Select your IDE: Claude Code ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← token copiado ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!
2

Autenticar a conexão MCP

Autentique na ordem abaixo.

Esta etapa requer o Claude Code CLI (claude). Se você ainda não o tiver, instale o Claude Code.

  1. Execute o Claude Code no terminal. Execute-o obrigatoriamente dentro da pasta do projeto que você quer conectar.

    Terminal
    claude

  2. Na primeira execução, ele pode perguntar se você quer ativar os novos servidores MCP. Nesse caso, verifique se weegloo e weegloo-upload estão marcados e pressione Enter para enviar.

    Terminal
    New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload

  3. Digite /mcp para abrir a tela de gerenciamento dos servidores MCP.

    Terminal
    /mcp

  4. Na lista, selecione weegloo. Ele aparece com o status needs authentication.

    Terminal
    Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

    Se os servidores não aparecerem na lista: se weegloo e weegloo-upload não aparecerem na lista, pode ser que você não tenha enviado na tela de ativação do passo 2 ou que eles estejam desativados. Encerre o Claude Code, digite o comando abaixo no terminal e execute claude novamente. Quando a mesma tela do passo 2 aparecer de novo, deixe weegloo e weegloo-upload marcados e pressione Enter para enviar.

    Terminal
    claude mcp reset-project-choices

  5. Verifique se o endereço de conexão é https://ai.weegloo.com/mcp e selecione Authenticate.

    Terminal
    Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable

  6. Ao selecionar Authenticate, a página de autenticação do WEEGLOO abre no navegador, como abaixo. Copie o token com o botão Copiar token, cole-o e clique em Conectar servidor. Quando weegloo mudar para connected, está concluído.

    Tela de autenticação do WEEGLOO

Arquivo de configuração do servidor MCP

A aba Code usa as configurações de MCP, Skills e Rules do Claude Code como estão. Por isso, o servidor conectado não aparece nas telas de conectores, plugins ou MCP do Claude Desktop, e só pode ser usado na aba Code. Para conferir o servidor instalado, execute claude no terminal e digite /mcp. O .mcp.json abaixo também é criado e gerenciado automaticamente pela ferramenta de instalação, então você raramente precisa abri-lo diretamente. O conteúdo de configuração abaixo é material de referência para quem precisa da estrutura e dos caminhos concretos do arquivo de configuração.

O servidor weegloo conecta-se a https://ai.weegloo.com/mcp pelo modo HTTP, e o servidor weegloo-upload, que lida com arquivos, é executado via npx e usa o Personal Access Token na autenticação.

{
  "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>"
      }
    }
  }
}

Para mudar o grupo de servidores, acrescente o valor group ao final do url do servidor weegloo. Por exemplo, para usar todas as ferramentas, escreva https://ai.weegloo.com/mcp?group=all. Para a composição de ferramentas por grupo, consulte Grupos de servidores MCP.

Skills

O Claude Code oferece suporte nativo a Skills. A ferramenta de instalação organiza cada Skill em um diretório próprio. A instalação global usa ~/.claude/skills/, e a instalação de projeto usa .claude/skills/ na pasta do projeto.

Rules

O Claude Code oferece suporte nativo a Rules. A ferramenta de instalação organiza cada regra em um arquivo .md. A instalação global usa ~/.claude/rules/, e a instalação de projeto usa .claude/rules/ na pasta do projeto.

O que fazer a seguir

  • MCP: trata do conteúdo que serve de base para a conexão, como grupos de servidores e o servidor de upload de arquivos.
  • Skills e Rules: trata do que são as Skills e Rules que a ferramenta de instalação instala em conjunto.
  • Manter atualizado: trata de como manter atualizadas as Skills e Rules instaladas.
  • Migrar uma página estática com IA: siga o fluxo de migrar uma página real para um serviço baseado em conteúdo com a conexão MCP que você configurou.