KasyKasy

Instalar o Kasy

Comece pelo MCP no Cursor ou Claude. Sem Node, instale o Node. Quem preferir terminal usa o instalador.

O caminho principal é pelo assistente de IA (MCP). O terminal entra só pra instalar uma vez.

Implementação

1. Caminho recomendado: MCP

Funciona em Windows, macOS e Linux.

  1. Tem Node.js 18+? Rode node -v.
    Não tem? O instalador abaixo instala o Node pra você.

  2. Rode o instalador (CLI + MCP + config do Cursor / Claude Desktop):

    macOS e Linux

    curl -fsSL https://kasy.dev/install | bash

    Windows (PowerShell)

    irm https://kasy.dev/install.ps1 | iex
  3. Feche e abra o Cursor (ou Claude Desktop). No Claude Desktop, feche o app de verdade, não só a janela.

  4. Pronto. Peça ao assistente: "Prepara minha máquina com o Kasy".

O kasy mcp setup grava o bloco kasy no ~/.cursor/mcp.json (e no Claude Desktop, se existir). Feche o Cursor com Cmd+Q e abra de novo. Em Settings → MCP, confira se kasy está verde. Só então abra um chat novo.

Se preferir fazer na mão (ou se o automático falhar), cole o JSON abaixo em Cursor → Settings → MCP ou no arquivo ~/.cursor/mcp.json.

Atualizar (quando sair versão nova):

kasy upgrade

Depois feche e abra o cliente de novo. O comando atualiza CLI e MCP juntos.

Com assistente MCP: peça "checa atualização do Kasy" (check_kasy_updates) e, se precisar, upgrade_kasy (não run_kasy_command upgrade). Reinicie o Cursor/Claude depois.

Outras IDEs (Antigravity, Codex, Windsurf…)

O protocolo MCP é o mesmo em todas. O instalador configura Cursor, Claude Desktop e Antigravity IDE automaticamente. Para outra IDE, rode kasy mcp setup e cole o JSON que ele mostrar no arquivo de MCP da sua ferramenta.

Config manual (Cursor Settings → MCP, ~/.cursor/mcp.json ou ~/.gemini/antigravity-ide/mcp_config.json):

{
  "mcpServers": {
    "kasy": {
      "command": "/caminho/absoluto/para/kasy-mcp",
      "args": [],
      "env": {}
    }
  }
}

O kasy mcp setup preenche o caminho absoluto automaticamente. Antes rode npm install -g kasy-mcp (o instalador já faz isso).

Tools, resources e o fluxo completo: MCP do Kasy.

2. Caminho alternativo: terminal (CLI global)

Pra digitar kasy no terminal em vez de falar com o assistente:

  1. Use o instalador acima (passo 2 do MCP) ou npm install -g kasy-cli
  2. Confirme: kasy --version
  3. Próximo passo: preparar a máquina

Pode usar os dois: MCP no Cursor e kasy no terminal.

Informações

O que o MCP traz

MCP (kasy mcp setup)CLI no terminal
Assistente usa o kitSimSim (você digita)
Comando kasy no terminalOpcionalSim
Atualizarcheck_kasy_updates + upgrade_kasy + reabrir clientekasy upgrade

npm (só CLI, sem instalador)

npm install -g kasy-cli

O pacote correto é kasy-cli, não kasy.

O que o instalador faz

Se não houver Node, ele instala (macOS via Homebrew, Windows via winget) e em seguida instala a CLI global.

Atualizado em 03/11/2026