Configurar o Claude Code

Última atualização: 22 de junho de 2026

O Claude Code é um agente de programação que funciona 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 forma de conexão é a mesma de outros ambientes. Você configura tudo de uma vez com a ferramenta de instalação e, depois, basta concluir a autenticação no Claude Code.

A explicação sobre o MCP em si, os grupos de servidores e o servidor de upload de arquivos está em MCP. Esta página trata apenas das etapas de conexão ao Claude Code.

Pré-requisitos

  • Node.js 18 ou superior: necessário para executar a ferramenta de instalação e o servidor de transferência de arquivos (weegloo-upload).
  • Personal Access Token: usado na autenticação. O método de emissão é tratado em Emitir um Personal Access Token.
  • Claude Code: em um estado em que seja executado no terminal com o comando claude.

Conectar com a ferramenta de instalação

Vá até a pasta do projeto que você quer conectar e, dentro dela, execute a ferramenta de instalação. As configurações do MCP são salvas por pasta, portanto o local em que você executa é o projeto ao qual a configuração será aplicada.

npx weegloo@latest

Ao executar, as perguntas aparecem em sequência. Em cada item, escolha o seguinte.

  1. Select plugin version (branch): a versão de Skills e Rules. Escolha latest.
  2. Select your IDE: escolha Claude Code.
  3. What would you like to install?: você pode instalar o servidor MCP e Skills / Rules separadamente. Se for a primeira instalação, instale tudo.
  4. Enter your Weegloo Personal Access Token: cole o Personal Access Token emitido previamente.
  5. Select the MCP server group: normalmente, escolha default. As diferenças entre os grupos de servidores são tratadas em Grupos de servidores MCP.
  6. Where would you like to install ... configuration: para aplicar apenas ao projeto atual, escolha Project. Se a instalação em Project não for suportada na sua versão do Claude Code, instale como Global.

Quando a instalação termina, a pasta do projeto passa a ter um .mcp.json e um diretório .claude/, e os dois servidores MCP weegloo e weegloo-upload ficam registrados.

√ Select plugin version (branch): latest  (recommended)
√ Select your IDE: Claude Code
√ What would you like to install? Install MCP server, Install Skills and Rules
√ Enter your Weegloo Personal Access Token: ********
√ Select the MCP server group: default
√ Where would you like to install Claude Code configuration? Project
 
√   MCP servers configured   → ./.mcp.json
√   Skills installed         → ./.claude/skills
√   Rules installed          → ./.claude/rules
 
  ✔  Installation complete!

Conferir o arquivo de configuração diretamente

O .mcp.json criado pela ferramenta de instalação tem o seguinte formato. 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 da 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.

Ligar o servidor no Claude Code

Execute o Claude Code na pasta do projeto em que está o arquivo de configuração.

claude

Na primeira execução, ele pergunta se você quer ligar os servidores recém-adicionados ao .mcp.json. Selecione os dois servidores e pressione Enter para ligá-los.

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

O servidor weegloo-upload é autenticado de imediato com o Personal Access Token informado no arquivo de configuração e fica no estado connected. O servidor weegloo usa conexão HTTP e precisa de autenticação à parte, por isso aparece no estado needs authentication.

Autenticar o servidor weegloo

Para autenticar o servidor weegloo, entre na tela de gerenciamento de servidores MCP. Na lista de servidores registrados, escolha weegloo.

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

Ao escolher weegloo, aparece a tela de estado. Confirme se o endereço de conexão está correto como https://ai.weegloo.com/mcp e escolha Authenticate.

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

Ao escolher Authenticate, abre-se uma página de login no navegador. Se o navegador não abrir automaticamente, digite o endereço exibido no Claude Code diretamente na barra de endereços do navegador. Quando você informa o Personal Access Token emitido previamente, a autenticação é concluída.

Concluída a autenticação, o estado do servidor weegloo muda para connected. A partir daí, basta fazer pedidos em linguagem natural no Claude Code para manipular diretamente os recursos do WEEGLOO.

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