MCP

O servidor é oficial, roda dentro do próprio arvorede.link e fala com a mesma API REST pública. Não existe ferramenta sem endpoint por trás, e nada que a IA faz é invisível para você: tudo aparece no painel do mesmo jeito.

A hierarquia que a IA enxerga é a mesma da página: seção, categoria e link, com toda camada opcional. A documentação da API explica o modelo campo a campo.

https://arvorede.link/mcp

Transporte streamable-http: nada roda na sua máquina, o cliente só precisa da URL e da credencial. O nome sugerido do servidor é arvorede.

1. No Claude, abra Configurações › Conectores e escolha Adicionar conector personalizado.
2. Dê um nome, cole o endereço do servidor e deixe as opções avançadas em branco.
3. Clique em Conectar: o Claude abre o arvorede.link. Entre, escolha a página e autorize.
4. Para desconectar, vá em Minha conta › Aplicativos conectados e clique em Revogar.

A conexão vale para uma página e para as permissões mostradas na autorização. O acesso expira sozinho e o Claude renova sem pedir de novo, até você revogar.

Authorization: Bearer arvl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Clientes que não fazem OAuth usam uma API key no header. Nos dois casos a credencial já diz qual página é a sua: nenhuma ferramenta pergunta, e nenhuma aceita que você informe outra. Revogar a key ou a conexão derruba o acesso na chamada seguinte.

• Conectar uma IA (MCP) Tudo que o MCP alcança: links, categorias, layout e números da página. links:read · links:write · categories:read · categories:write · sections:read · sections:write · layout:read · layout:write · analytics:read
• Gerenciar conteúdo Lê e altera links, categorias e seções. links:read · links:write · categories:read · categories:write · sections:read · sections:write
• Aparência Lê o conteúdo e altera o layout da página, sem tocar nos links. links:read · categories:read · sections:read · layout:read · layout:write
• Somente leitura Consulta links, categorias, layout e números, sem alterar nada. links:read · categories:read · sections:read · layout:read · analytics:read

Sem o escopo, a ferramenta nem aparece para a IA. Escrever não inclui ler: peça os dois quando ela precisar consultar antes de mudar.

1. Abra Desenvolvedores no painel da sua página e crie uma credencial com o preset "Conectar uma IA (MCP)".
2. Copie o segredo na hora: ele aparece uma única vez.
3. Cole a configuração do seu cliente e troque o placeholder pelo segredo.
4. Reinicie o cliente e peça algo à IA, em português mesmo.

claude mcp add --transport http arvorede https://arvorede.link/mcp --header "Authorization: Bearer arvl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "mcpServers": {
    "arvorede": {
      "type": "http",
      "url": "https://arvorede.link/mcp",
      "headers": {
        "Authorization": "Bearer arvl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

{
  "mcpServers": {
    "arvorede": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://arvorede.link/mcp",
        "--header",
        "Authorization: Bearer arvl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      ]
    }
  }
}

Troque o placeholder pelo segredo que você copiou. A key é um segredo: guarde em um gerenciador de secrets e não comite o arquivo de configuração com ela dentro.

• arvorede://layout/schema/v1 Layout Manifest v1 — JSON Schema application/json
• arvorede://layout/guide Layout Manifest v1 — guia para gerar um layout text/markdown
• arvorede://layout/examples/{id} Os manifestos de exemplo, um por id, para a IA partir de algo pronto. application/json

Os resources de layout só aparecem para credenciais com escopo de layout.

1. 1 install_marketplace_layout Opcional: parte de um layout pronto do marketplace, que entra como rascunho.
2. 2 get_layout_schema A IA lê o contrato do Layout Manifest v1, os limites e os exemplos.
3. 3 get_current_layout Ela vê o que está no ar hoje e o rascunho, se houver.
4. 4 validate_layout Ela valida o manifesto que gerou, quantas vezes precisar.
5. 5 update_layout_draft Grava como rascunho. Os visitantes continuam vendo o antigo.
6. 6 create_layout_preview Gera um link temporário para você conferir no navegador.
7. 7 publish_layout Publica, com confirmação explícita sua. Esse é o único passo que muda a página.

O rascunho nunca aparece para os visitantes: só o link de preview mostra ele, por 1 hora. Publicou e se arrependeu? O histórico guarda as versões anteriores, e restaurar traz uma de volta como rascunho — publicar continua sendo um passo seu.

• A página vem da credencial. Nenhuma ferramenta aceita workspaceId, handle, userId ou ownerId: não existe como pedir a página de outra pessoa.
• O servidor só anuncia as ferramentas que os escopos da credencial alcançam. Sem o escopo, a ferramenta nem aparece para a IA.
• Escrever não inclui ler. Peça os dois quando a IA precisar consultar antes de mudar.
• A IA nunca cria, lista nem revoga API key: uma credencial não produz outra mais forte que ela. Isso é ato de sessão, no painel.
• Conta, senha, email, endereço da página e exclusão da página estão fora do alcance de qualquer key.
• Publicar layout e voltar ao padrão pedem confirmação explícita. Salvar rascunho nunca publica como efeito colateral.
• O conteúdo que a IA lê é dado, não instrução: título, descrição, bio e texto de layout vêm de pessoas e de outras integrações, e o servidor nunca os trata como comando.
• Os números são agregados. Nunca IP, nunca user agent, nunca o hash do visitante.
• Instalar um layout do marketplace grava só no rascunho. A página pública continua como estava até você publicar.
• A IA não publica no marketplace: ela instala o que já está lá. Criar e publicar um anúncio é ato de sessão, no painel.
• Revogar a key no painel derruba a conexão na chamada seguinte.