Configuração do Claude Code

O Claude Code é um agente de programação que você executa no terminal. Ao conectar o servidor MCP do WEEGLOO a ele, o Claude Code passa a 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 Claude 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 e, depois, basta concluir a autenticação da conexão MCP.

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 ao 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.

O Claude Code também precisa estar instalado de forma que você possa executá-lo no terminal com o comando claude. Se você ainda não o tiver, consulte o guia de instalação do Claude Code.

Conectar

Para a instalação básica, basta copiar o comando de instalação desta página e executá-lo uma vez no terminal. Para escolher cada etapa da instalação você mesmo, abra a 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.

  1. Execute o Claude Code no terminal.

    Terminal
    claude

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

    Terminal
    /mcp

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

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

  4. Confirme que 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 da WEEGLOO abre no navegador, como mostrado 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 da 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 integrar.

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

Autenticar a conexão MCP

Autentique na ordem abaixo.

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

    Terminal
    claude

  2. Na primeira execução, pode ser perguntado se você quer ativar os novos servidores MCP. Nesse caso, confirme que 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 de servidores MCP.

    Terminal
    /mcp

  4. Na lista, selecione weegloo. Ele é exibido 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. Se a mesma tela do passo 2 reaparecer, deixe weegloo e weegloo-upload marcados e pressione Enter para enviar.

    Terminal
    claude mcp reset-project-choices

  5. Confirme que 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 da WEEGLOO abre no navegador, como mostrado 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 da WEEGLOO

Execute o npx weegloo de forma interativa e instale 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.

  1. Execute o Claude Code no terminal.

    Terminal
    claude

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

    Terminal
    /mcp

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

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

  4. Confirme que 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 da WEEGLOO abre no navegador, como mostrado 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 da WEEGLOO

1

Executar a ferramenta de instalação

Vá até a pasta do projeto que você quer integrar 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.

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

    Terminal
    claude

  2. Na primeira execução, pode ser perguntado se você quer ativar os novos servidores MCP. Nesse caso, confirme que 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 de servidores MCP.

    Terminal
    /mcp

  4. Na lista, selecione weegloo. Ele é exibido 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. Se a mesma tela do passo 2 reaparecer, deixe weegloo e weegloo-upload marcados e pressione Enter para enviar.

    Terminal
    claude mcp reset-project-choices

  5. Confirme que 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 da WEEGLOO abre no navegador, como mostrado 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 da WEEGLOO

Arquivo de configuração do servidor MCP

A ferramenta de instalação cria e gerencia o arquivo de configuração automaticamente, então você não precisa conferi-lo diretamente. O conteúdo 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.

Próximos passos

  • 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 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.