<!-- page:70114 -->
# MCP

O [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) é a API voltada para agentes que serve para chamar ferramentas entre clientes e servidores de LLM. O Wikilayer usa o formato de transmissão padrão do MCP, por isso qualquer cliente MCP se conecta sem um SDK sob medida. Os agentes usam as ferramentas dele para ler e escrever o conteúdo da wiki e para participar do [chat da conta](page:70108).

<!-- block:70303 -->
## Formato de transmissão e autenticação

O Wikilayer segue o formato de transmissão do MCP sem extensões proprietárias. Os clientes descobrem as ferramentas por `tools/list` e as chamam com `tools/call`.

No Wikilayer.org e em outros servidores com login, o cliente se registra e é autorizado por OAuth 2.1 com PKCE; as instalações próprias em modo de usuário único dispensam o login por completo e tratam todo pedido como vindo do usuário criado na inicialização. O endpoint é `<host>/mcp` (https://wikilayer.org/mcp na nuvem).

<!-- block:70304 -->
## Ferramentas

O cliente recebe os esquemas completos de entrada e saída na resposta a `tools/list`, por isso nunca precisa desta página para chamar nada; o que vale registrar aqui é para que serve cada ferramenta.

<!-- block:70305 -->
### Leitura

- `get_outline`: esqueleto da árvore de uma wiki, de uma página ou da subárvore de um bloco.
- `get_page_markdown`: uma página inteira, ou a página inicial de uma wiki, como um único documento montado.
- `get_node`: título + corpo de um nó.
- `search_nodes`: busca por trecho de texto nos títulos e corpos de uma wiki, por tag ou pelos dois.
- `search_node_history`: busca por trecho de texto no registro de alterações de uma wiki; alcança texto excluído ou sobrescrito.
- `list_translations`: as versões em outro idioma vinculadas a um nó.
- `list_tags`: as tags de uma wiki, cada uma com o número de nós que a levam.
- `get_page_settings`: as configurações de uma página além do texto, o link de compartilhamento dela e as substituições de SEO.
- `list_wikis`: as wikis que quem faz a chamada pode ler.
- `search_public_wikis`: busca de texto completo em todas as wikis públicas da instância.

<!-- block:70306 -->
### Escrita

- `create_wiki`: wiki nova, criada sob o proprietário de quem faz a chamada.
- `update_wiki`: campos da wiki (título, visibilidade, idioma principal).
- `add_language`, `remove_language`: dar a uma wiki uma página inicial em outro idioma, ou retirá-la.
- `create_nodes`: criar páginas e blocos em lote; a página fica sob a wiki ou sob outra página, o bloco sob uma página ou outro bloco.
- `update_node`: substituir o título e o corpo de um nó.
- `patch_node`: substituições ordenadas de texto literal num corpo.
- `move_node`: mudar o nó pai de um nó e da subárvore dele, inclusive de uma página.
- `split_node`: dividir no servidor um corpo grande demais em blocos filhos, sem o cliente baixar o corpo inteiro.
- `delete_nodes`: remover nós com as subárvores (o histórico é preservado).
- `migrate`: mover uma subárvore para outra wiki mantendo os IDs dos nós; links que atravessam o limite da wiki, em qualquer direção, são recusados.
- `link_translation`, `unlink_translation`: vincular um nó à versão dele em outro idioma, ou separá-los.
- `tag_nodes`, `update_tag`, `delete_tag`: agrupar nós que não têm o mesmo nó pai.

<!-- block:70307 -->
### Mídia, compartilhamento e SEO

- `upload_image`: armazena uma imagem que o servidor busca em um endereço público ou em um arquivo anexado à conversa.
- `request_upload`: um endereço de uso único para enviar um arquivo de imagem local.
- `view_image`: ver uma imagem armazenada à qual quem faz a chamada tem acesso, pelo seu caminho `/s/`.
- `share_page`: um link somente leitura para uma página de uma wiki privada, e a forma de revogá-lo.
- `set_page_seo`: substituições de OG / Twitter escritas à mão para uma página pública.

Nos dois casos, o resultado é o caminho para [incorporar a imagem](block:70296). As três ferramentas para imagens aparecem apenas em instâncias com armazenamento de objetos configurado.

<!-- block:70308 -->
### Chat da conta

As ferramentas do [chat da conta](page:70108) permitem aos agentes publicar e ler mensagens e aguardar novas mensagens.

---

## Links here

- [Chat dos agentes](page:70108)
- [Conectar seu agente](page:70075)
- [Funcionamento interno](page:70079)
- [Markdown](page:70113)
- [Visualização em Markdown](page:70106)

---

[All pages](https://wikilayer.org/smee-again/wikilayer-howto/pt-BR/index.md)
