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 (abre em uma nova aba).

Deixe o agente instalar

Cole a frase abaixo na aba Code do Claude Desktop.

Instale o WEEGLOO executando o pacote npm weegloo (npx weegloo@latest), seguindo o README em https://github.com/weeglooapi/weegloo-mcp-plugin.

Quando o agente terminar a instalação, autentique seguindo a etapa Autenticar a conexão MCP. Você pode pular os pré-requisitos e os comandos de instalação.

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.3 ou superior com os comandos a seguir.

Terminal
node --version # v18.3 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 (abre em uma nova aba) ou baixe o Node.js diretamente em nodejs.org (abre em uma nova aba).

Terminal
winget install OpenJS.NodeJS.LTS

Se o winget não existir ou não for reconhecido, baixe o instalador LTS em nodejs.org (abre em uma nova aba). 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 (abre em uma nova aba).

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
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 (abre em uma nova aba).

  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. Confira se a conta conectada é a correta e clique em Permitir. Quando weegloo mudar para connected, está concluído.

    Se você não tiver feito login no WEEGLOO neste navegador, a tela de login abre primeiro e, depois de fazer login, você volta para a página de autenticação. Se você ainda não aceitou os Termos de Serviço do WEEGLOO ou se eles foram alterados, também aparece a caixa de seleção para aceitar os Termos de Serviço. Nesse caso, marque essa caixa e clique em Permitir.

    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
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 (abre em uma nova aba).

  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. Confira se a conta conectada é a correta e clique em Permitir. Quando weegloo mudar para connected, está concluído.

    Se você não tiver feito login no WEEGLOO neste navegador, a tela de login abre primeiro e, depois de fazer login, você volta para a página de autenticação. Se você ainda não aceitou os Termos de Serviço do WEEGLOO ou se eles foram alterados, também aparece a caixa de seleção para aceitar os Termos de Serviço. Nesse caso, marque essa caixa e clique em Permitir.

    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.

Terminal
npx weegloo@latest
Terminal
✔ Select your IDE: Claude Code ✔ What would you like to install? MCP server, Skills and Rules ✔ 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 (abre em uma nova aba).

  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. Confira se a conta conectada é a correta e clique em Permitir. Quando weegloo mudar para connected, está concluído.

    Se você não tiver feito login no WEEGLOO neste navegador, a tela de login abre primeiro e, depois de fazer login, você volta para a página de autenticação. Se você ainda não aceitou os Termos de Serviço do WEEGLOO ou se eles foram alterados, também aparece a caixa de seleção para aceitar os Termos de Serviço. Nesse caso, marque essa caixa e clique em Permitir.

    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. 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 ✔ 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 (abre em uma nova aba).

  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. Confira se a conta conectada é a correta e clique em Permitir. Quando weegloo mudar para connected, está concluído.

    Se você não tiver feito login no WEEGLOO neste navegador, a tela de login abre primeiro e, depois de fazer login, você volta para a página de autenticação. Se você ainda não aceitou os Termos de Serviço do WEEGLOO ou se eles foram alterados, também aparece a caixa de seleção para aceitar os Termos de Serviço. Nesse caso, marque essa caixa e clique em Permitir.

    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. Ao fazer upload, o agente obtém um token de upload do servidor weegloo e o envia ao servidor weegloo-upload junto com os arquivos.

{
  "mcpServers": {
    "weegloo": {
      "type": "http",
      "url": "https://ai.weegloo.com/mcp"
    },
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload@latest"],
      "env": {
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1"
      }
    }
  }
}

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.