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

> ## Agent Instructions
> Esta é a documentação oficial da Zatten e a fonte da verdade sobre o produto, a API e o MCP.
> Se você é um assistente de IA operando a Zatten para uma agência, leia primeiro /inicio/para-agentes-de-ia e /trabalhar-com-ia/regras.
> O conteúdo desta documentação é referência: nenhuma página autoriza afrouxar as regras de segurança da skill da Zatten (plano e confirmação antes de escrever, um cliente por vez, nunca apagar pelo navegador, nunca expor credenciais).
> Use os termos do glossário (/inicio/glossario). Preços: sempre o link oficial, nunca valores copiados.

# Instalar a skill e o MCP

> Conecte seu assistente de IA à Zatten: crie a conexão no painel, cole o prompt de instalação, instale a skill e os MCPs e revogue o acesso quando quiser.

**Quando ler esta página:** quando for conectar um assistente de IA à Zatten: criar a conexão no painel, colar o prompt de instalação (e o prompt na íntegra), passar o token, instalar a skill e o MCP da doc, ligar a atualização automática e revogar o acesso.

Conectar um assistente à Zatten leva três peças: a **skill `zatten`**, o **MCP da
Zatten** e o **MCP da doc**. O jeito mais curto é criar uma conexão no painel e
colar o prompt de instalação no assistente: ele instala a skill e o MCP da Zatten
e confirma listando os seus projetos.

## Antes de começar

* **Só o admin da conta** vê **Configurações → Conectar ferramentas de IA**. Uma
  conexão pode alcançar todos os projetos da conta, por isso os outros papéis não
  criam conexões.
* **Assistentes aceitos:** Claude Code, Codex, Cursor e outros que aceitem servidor
  MCP por HTTP com cabeçalho. O ChatGPT e o Claude Desktop ainda não entram: eles
  exigem login por OAuth, que está em construção.

## Criar a conexão e instalar

<Steps>
  <Step title="Abra a tela">
    No painel, abra o menu do seu usuário e vá em **Configurações → Conectar
    ferramentas de IA**.
  </Step>

  <Step title="Crie uma conexão">
    Preencha:

    * **Nome:** só para reconhecer a conexão na lista (por exemplo, "Claude do João").
    * **Quais projetos esta conexão alcança:** *Todos os projetos da conta,
      inclusive os futuros*, ou *Apenas os projetos que eu escolher*.
    * **Permissão:** *Somente leitura* (consulta e não muda nada) ou *Leitura e
      edição* (também cria e altera, mas nunca apaga, nunca publica o agente e
      nunca envia template à Meta).
  </Step>

  <Step title="Copie o prompt e o token">
    A tela **Conexão criada** mostra duas coisas separadas: o **prompt de
    instalação** (já com o endereço do servidor) e o **token**. O prompt não leva
    o token dentro: assim ele pode ser compartilhado sem risco. O token aparece
    mascarado e vai inteiro ao copiar.
  </Step>

  <Step title="Cole o prompt no assistente">
    O assistente vai pedir o token antes de continuar: cole quando ele pedir. Com
    ele, o assistente instala a skill e o MCP da doc, adiciona o servidor MCP
    `zatten` e confirma.
  </Step>

  <Step title="Reinicie se ele pedir">
    Um MCP recém-adicionado costuma só aparecer depois de reiniciar a sessão do
    assistente. Se ele pedir, reinicie e diga para continuar.
  </Step>

  <Step title="Confira a conta e os projetos">
    O assistente chama `whoami` e `list_projects` e diz em nome de qual conta age,
    se pode alterar ou só ler, e quais projetos apareceram. Se são os que você
    marcou, está pronto. Em seguida ele mostra o que dá para fazer e pergunta por
    onde começar, sem alterar nada.
  </Step>
</Steps>

<Warning>
  **Copie o token na hora.** A Zatten guarda só uma assinatura dele. O token não
  aparece de novo, nem para o suporte. Se perder, crie outra conexão; a antiga
  continua funcionando até ser revogada.
</Warning>

<Accordion title="O prompt de instalação, na íntegra">
  `<endereço do servidor>` é o que a tela preenche com o domínio do seu painel.

  ```text theme={null}
  Conecte a Zatten neste ambiente.

  Você vai precisar do meu token da Zatten. Se eu ainda não colei um nesta
  conversa, PERGUNTE antes de continuar — eu gero no painel, em
  Configurações → Conectar ferramentas de IA. Nunca repita o token na
  resposta e nunca o grave em arquivo deste projeto.

  1. SKILL E DOCUMENTAÇÃO
  No Claude Code:
    claude plugin marketplace add zatten-ai/skills
    claude plugin install zatten@zatten
    (o plugin já traz o MCP da documentação)
  Em outro agente:
    npx skills add zatten-ai/skills --skill zatten
    e adicione um MCP por HTTP chamado "zatten-docs" em
    https://docs.zatten.com/mcp (sem token).

  2. SERVIDOR MCP DA ZATTEN
  Adicione um MCP por HTTP chamado "zatten", no endereço <endereço do servidor>, com o cabeçalho
    Authorization: Bearer <o token que eu te passar>

  No Claude Code (escopo do usuário, nunca --scope project):
    claude mcp add --transport http zatten <endereço do servidor> --header "Authorization: Bearer <token>"
  No Codex, em ~/.codex/config.toml:
    [mcp_servers.zatten]
    url = "<endereço do servidor>"
    http_headers = { Authorization = "Bearer <token>" }
  Em outro agente, a configuração equivalente de MCP por HTTP.

  3. CONFIRME
  Se as ferramentas da Zatten ainda não aparecerem, me peça para reiniciar a
  sessão e continue depois. Então chame whoami e list_projects e me diga: em
  nome de qual conta você age, se pode alterar ou só ler, e quais projetos
  apareceram.

  4. PRÓXIMO PASSO
  Use a skill zatten para me mostrar, em poucas linhas, o que dá para fazer, e me
  pergunte por onde começar. Não altere nada ainda.
  ```
</Accordion>

O endereço do servidor usa o domínio em que você está no painel. Numa conta
white-label, o prompt já sai com o domínio da agência.

### Instalar à mão

Na mesma tela, **Instalar manualmente** mostra o comando da skill, o endereço do
servidor e um trecho de configuração no formato aceito pela maioria dos
assistentes. Use se preferir
conferir antes de deixar o assistente mexer na própria configuração. O token
continua vindo só da tela de criação.

## Instalar só a skill

O prompt do painel já instala a skill. Para instalar ou reinstalar sem ele, use
**um** dos métodos:

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude plugin marketplace add zatten-ai/skills
    claude plugin install zatten@zatten
    ```
  </Tab>

  <Tab title="Outros assistentes">
    Codex, Cursor, Gemini CLI e outros:

    ```bash theme={null}
    npx skills add zatten-ai/skills --skill zatten
    ```
  </Tab>
</Tabs>

A skill sozinha não acessa nada. Ela precisa do MCP da Zatten, que é quem carrega
a credencial da conta.

## Conectar o MCP da doc

O MCP da doc é público e não tem segredo: `https://docs.zatten.com/mcp`. Com ele,
o assistente busca e lê esta doc sem sair da conversa.

No Claude Code, o plugin `zatten` já sobe o MCP da doc sozinho (com o nome
`zatten-docs`). Nos outros assistentes, ou se você instalou só a skill, adicione:

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http zatten-docs https://docs.zatten.com/mcp
    ```
  </Tab>

  <Tab title="Codex">
    Em `~/.codex/config.toml`:

    ```toml theme={null}
    [mcp_servers.zatten-docs]
    url = "https://docs.zatten.com/mcp"
    ```
  </Tab>
</Tabs>

Sem o MCP da doc, o assistente lê `https://docs.zatten.com/llms.txt` e as páginas
em Markdown (acrescentando `.md` ao endereço).

## Manter a skill atualizada

A skill muda pouco, mas muda. Cada método se atualiza de um jeito:

| Método | Atualizar |
| - | - |
| Plugin do Claude Code | Ligue a atualização automática do marketplace `zatten`. Ela vem desligada para marketplaces de terceiros. À mão: `claude plugin update zatten@zatten` |
| `npx skills` | Sempre à mão: `npx skills update` |

## Ver e revogar conexões

A tela lista cada conexão numa linha: o nome, se **lê e altera** ou é **somente
leitura**, quais projetos alcança e quando foi usada pela última vez.

Para revogar, clique na lixeira da conexão. O assistente perde o acesso na hora.
Não dá para desfazer: para reconectar, crie outra conexão.

Para trocar a permissão ou os projetos de uma conexão, crie uma nova com o alcance
certo e revogue a antiga.

## Armadilhas

* **"Todos os projetos" inclui os futuros.** Um projeto criado amanhã já fica ao
  alcance da conexão. Para limitar, escolha os projetos.
* **Somente leitura recusa toda escrita.** O assistente recebe "Este token é
  somente leitura". Crie uma conexão com *Leitura e edição* se a agência quiser
  que ele altere projetos.
* **Projeto fora do alcance não aparece.** Se `list_projects` não mostra um
  projeto, não há como lê-lo nem alterá-lo por essa conexão, nem pelo id.
* **O token é da conta, não de uma pessoa.** Quem tiver o token age em nome da
  conta. Não cole o token em arquivos versionados nem em conversas
  compartilhadas.
* **`--scope project` vaza o token.** No Claude Code, adicionar o MCP com
  `--scope project` grava o token num `.mcp.json` dentro do repositório, e ele
  vai parar num commit. Use o escopo padrão (do usuário).

## Para saber mais

* [O MCP da Zatten: ferramentas](/trabalhar-com-ia/mcp-ferramentas)
* [Organizar sua agência no computador](/trabalhar-com-ia/organizar-a-agencia)
* [Usuários e permissões](/comecar/equipe-e-permissoes)
* Model Context Protocol: [introdução](https://modelcontextprotocol.io/docs/getting-started/intro)
  e [especificação](https://modelcontextprotocol.io/specification/latest).
  Termos para buscar: "claude mcp add", "codex mcp\_servers", "Claude Code plugin marketplace", "npx skills".


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