Configuração do Cursor IDE

Ao conectar o WEEGLOO MCP ao Cursor IDE, o agente LLM dentro do IDE realiza, apenas com pedidos em linguagem natural, o trabalho que antes uma pessoa fazia no estúdio de conteúdo. Você descreve em palavras o que quer criar e o agente cuida diretamente de tarefas como projetar um Content Type e criar Content ou Media. A ferramenta de instalação instala as Skills e as Rules junto com o servidor MCP, ajudando o agente 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.

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 Cursor IDE.

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 Cursor também precisa estar instalado. Se você ainda não o tiver, pode baixá-lo em Download do Cursor.

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 cursor \ --token <Personal Access Token>
2

Autenticar a conexão MCP

Autentique na ordem abaixo.

  1. Clique no ícone de engrenagem no canto inferior esquerdo do Cursor para abrir as configurações.

  2. No menu de configurações à esquerda, escolha Tools & MCPs; a aba Home abre. Clique em Connect à direita de weegloo.

  3. A página de autenticação da WEEGLOO abre no navegador. Copie o token com o botão Copiar token, cole-o e clique em Conectar servidor.

  4. Você pode confirmar que a conexão foi bem-sucedida pelo ponto verde aceso ao lado de weegloo e weegloo-upload.

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 cursor \ --location project \ --token <Personal Access Token>
2

Autenticar a conexão MCP

Autentique na ordem abaixo.

  1. Clique no ícone de engrenagem no canto inferior esquerdo do Cursor para abrir as configurações.

  2. No menu de configurações à esquerda, escolha Tools & MCPs e, nas abas superiores, escolha a aba com o nome do projeto atual.

  3. Ative os dois interruptores de weegloo e weegloo-upload na lista Installed.

  4. Quando weegloo mudar para Needs authentication, clique em Connect à direita. O weegloo-upload conecta automaticamente.

  5. A página de autenticação da WEEGLOO abre no navegador. Copie o token com o botão Copiar token, cole-o e clique em Conectar servidor.

  6. Você pode confirmar que a conexão foi bem-sucedida pelo ponto verde aceso ao lado de weegloo e weegloo-upload.

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: Cursor ✔ 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. Clique no ícone de engrenagem no canto inferior esquerdo do Cursor para abrir as configurações.

  2. No menu de configurações à esquerda, escolha Tools & MCPs; a aba Home abre. Clique em Connect à direita de weegloo.

  3. A página de autenticação da WEEGLOO abre no navegador. Copie o token com o botão Copiar token, cole-o e clique em Conectar servidor.

  4. Você pode confirmar que a conexão foi bem-sucedida pelo ponto verde aceso ao lado de weegloo e weegloo-upload.

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: Cursor ✔ 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. Clique no ícone de engrenagem no canto inferior esquerdo do Cursor para abrir as configurações.

  2. No menu de configurações à esquerda, escolha Tools & MCPs e, nas abas superiores, escolha a aba com o nome do projeto atual.

  3. Ative os dois interruptores de weegloo e weegloo-upload na lista Installed.

  4. Quando weegloo mudar para Needs authentication, clique em Connect à direita. O weegloo-upload conecta automaticamente.

  5. A página de autenticação da WEEGLOO abre no navegador. Copie o token com o botão Copiar token, cole-o e clique em Conectar servidor.

  6. Você pode confirmar que a conexão foi bem-sucedida pelo ponto verde aceso ao lado de weegloo e weegloo-upload.

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.

A ferramenta de instalação registra o servidor no arquivo de configuração MCP do Cursor. A instalação global usa ~/.cursor/mcp.json, e a instalação de projeto usa .cursor/mcp.json na pasta do projeto. 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

A ferramenta de instalação organiza cada Skill em um diretório próprio. A instalação global usa ~/.cursor/skills/, e a instalação de projeto usa .cursor/skills/ na pasta do projeto.

Rules

O Cursor oferece suporte nativo a Rules (Cursor Rules). A ferramenta de instalação organiza cada regra em um arquivo .mdc. A instalação global usa ~/.cursor/rules/, e a instalação de projeto usa .cursor/rules/ na pasta do projeto.

Próximos passos