> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalar com um comando

> Um comando (ou um prompt colado na IA) instala a conexão MCP, a Skill e os .md por função em todas as IAs do computador.

O comando `doglytdc-scripts` faz sozinho o que a página [Configurar manualmente](https://docs.doglytdc.dev/pt-BR/scripts/mcp/connect.md) explica: cria uma chave de conexão para cada IA, grava a configuração do MCP no lugar certo e instala a Skill com um arquivo `.md` por grupo de ferramentas. Você não copia nem cola chave.

## Pela internet: apps de chat (Claude.ai, Claude Desktop, ChatGPT)

> [!WARNING]
>
> O comando **não funciona dentro do Claude.ai ou do ChatGPT**. Nesses apps, os comandos rodam numa máquina isolada, sem internet (o npm responde `ENOTFOUND` / `getaddrinfo`), e nada instalado ali chega ao app. Use o conector abaixo.

Apps de chat conectam pelo endereço do MCP e pedem para você entrar no DoglyTdc — sem chave e sem terminal.

1. Copie o endereço do conector em **Conexões MCP** no site (ou use `https://api.doglytdc.dev/v1/scripts/mcp`).
2. **Claude.ai / Claude Desktop:** Configurações → Conectores → **Adicionar conector personalizado** → cole o endereço → **Conectar**.
3. **ChatGPT:** Configurações → Apps e conectores → Avançado → ligue o **Modo desenvolvedor**; depois **Criar**, cole o endereço e escolha OAuth.
4. Entre no DoglyTdc e clique em **Autorizar**. O app aparece em Conexões MCP, com identidade, regras de aprovação e **Revogar**.

Agentes com terminal e internet no seu computador (Claude Code, Codex, Cursor, Gemini CLI, VS Code, Windsurf) usam o comando abaixo.

## Cole no seu agente de IA

```text theme={null}
Instale o DoglyTdc Scripts e conecte a este agente usando `npx -y doglytdc-scripts@latest setup`. Primeiro rode com --dry-run e me mostre o plano de instalação para eu aprovar; depois rode de novo com --yes e confira se funcionou. Importante: só rode isso se você tiver um terminal com internet no MEU computador. Se você for um app de chat (Claude.ai, ChatGPT, Claude Desktop) ou rodar comandos numa máquina isolada sem internet, não rode nada: me explique como adicionar um conector personalizado com o endereço https://api.doglytdc.dev/v1/scripts/mcp (Configurações → Conectores → Adicionar conector personalizado → colar o endereço → Conectar → entrar no DoglyTdc e aprovar).
```

![Captura de tela: Aprovar o comando de instalação](https://mintcdn.com/dogly-tdc/qOnot79kPtISSKbW/images/scripts/scripts-cli.png?fit=max\&auto=format\&n=qOnot79kPtISSKbW\&q=85\&s=0d89568bfd1ccf129ac3fb23b20fdbe7)

Aprovar o comando de instalação

## Ou rode no terminal

> [tab] Node (qualquer sistema)
>
> ```bash theme={null}
> npx -y doglytdc-scripts@latest setup
> ```

> [tab] Windows (PowerShell)
>
> ```powershell theme={null}
> irm https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/install.ps1 | iex
> ```

> [tab] macOS / Linux
>
> ```bash theme={null}
> curl -fsSL https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/install.sh | sh
> ```

> [!NOTE]
>
> Precisa do Node.js 18 ou mais novo. Sem Node.js? Use [Configurar manualmente](https://docs.doglytdc.dev/pt-BR/scripts/mcp/connect.md).

## O que acontece

**1. Plano**

O comando procura as IAs instaladas e mostra exatamente quais arquivos vai criar ou mudar. Nada muda antes da sua aprovação.

**2. Aprovação**

No terminal, responda `s`. Pela IA: ela mostra o plano no chat e, quando você aprovar, roda de novo com `--yes`.

**3. Código no navegador**

Abre a página **Conectar IA** do DoglyTdc com um código de 8 letras (ex.: `BHKT-QXZM`). Confira se é o mesmo do terminal, escolha o que as IAs podem fazer e toque em **Aprovar**. O código vale 10 minutos e só uma vez.

**4. Instalação**

Cada IA recebe a própria chave (aparece em **Scripts › Conexões MCP** com o nome da IA e do computador), a conexão MCP e a Skill.

**5. Conferência**

O comando chama `whoami` com a chave de cada IA e mostra a sua conta. Reinicie as IAs para carregar o MCP.

## Onde fica cada coisa

| IA | Conexão MCP | Skill e .md por função |
| - | - | - |
| Claude Code | `claude mcp add-json --scope user` (ou `~/.claude.json`) | `~/.claude/skills/doglytdc-scripts/` |
| Codex | `~/.codex/config.toml` | `~/.codex/skills/doglytdc-scripts/` + aviso no `~/.codex/AGENTS.md` |
| Cursor | `~/.cursor/mcp.json` | `.cursor/rules/doglytdc-scripts*.mdc` do projeto |
| Gemini CLI | extensão `~/.gemini/extensions/doglytdc-scripts/` | `GEMINI.md` + `reference/` na mesma extensão |
| VS Code / Copilot | `mcp.json` do usuário | `.github/instructions/doglytdc-scripts.instructions.md` do projeto |
| Claude Desktop | `claude_desktop_config.json` (ponte `mcp-remote`) | `~/.doglytdc/scripts/doglytdc-scripts-skill.zip` para enviar em Skills |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `~/.doglytdc/scripts/skill/` |

As regras do Cursor e do VS Code são por projeto: são criadas quando você roda dentro de uma pasta com `.git`, `package.json` ou `doglytdc.json`, ou com `--project`. Uma cópia da Skill sempre fica em `~/.doglytdc/scripts/skill/`.

## Comandos

| Comando | O que faz |
| - | - |
| `setup` | Plano → aprovação → login → instalação → conferência (padrão) |
| `login` / `logout` | Cria / revoga as chaves deste computador |
| `status` (ou `doctor`) | O que está instalado em cada IA e se conecta |
| `update` | Baixa a Skill e os .md mais novos |
| `skills [nome]` | Lista a Skill ou mostra um arquivo (ex.: `skills codigo`) |
| `uninstall` | Remove só o que o comando instalou e revoga as chaves |

## Opções

| Opção | Para quê |
| - | - |
| `--agent a,b` | Só estas IAs: `claude-code`, `codex`, `cursor`, `gemini`, `vscode`, `claude-desktop`, `windsurf` |
| `--project` | Skill e regras nesta pasta (a conexão MCP continua no seu usuário) |
| `--yes`, `-y` | Já aprovado (a IA usa depois que você aprova o plano no chat) |
| `--dry-run` | Só mostra o plano |
| `--no-browser` | Não abre o navegador; o link aparece no terminal |

Exemplo:

```bash theme={null}
npx -y doglytdc-scripts@latest setup --agent codex,cursor --project --dry-run
```

## Segurança

* A chave nunca aparece no chat da IA nem no terminal: fica em `~/.doglytdc/scripts/credentials.json`, só com permissão do seu usuário.
* Codex e Claude Desktop recebem a chave por variável (`DOGLYTDC_AUTH`), não na linha de comando.
* Antes de mudar um arquivo de configuração o comando faz uma cópia `.bak` e só mexe na entrada `doglytdc-scripts`.
* Nunca aprove um código que outra pessoa mandou: quem tem o código aprovado recebe as chaves.
* Revogar uma conexão em **Conexões MCP** desliga aquela IA na hora.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.