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
1
Abra a tela
No painel, abra o menu do seu usuário e vá em Configurações → Conectar
ferramentas de IA.
2
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).
3
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.
4
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.5
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.
6
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.O prompt de instalação, na íntegra
O prompt de instalação, na íntegra
<endereço do servidor> é o que a tela preenche com o domínio do seu painel.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:- Claude Code
- Outros assistentes
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:
- Claude Code
- Codex
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: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_projectsnã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 projectvaza o token. No Claude Code, adicionar o MCP com--scope projectgrava o token num.mcp.jsondentro 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
- Organizar sua agência no computador
- Usuários e permissões
- Model Context Protocol: introdução e especificação. Termos para buscar: “claude mcp add”, “codex mcp_servers”, “Claude Code plugin marketplace”, “npx skills”.