Dê ao seu agente uma tarefa pequena e clara

Conecte um cliente

Crie uma conexão na página Desenvolvedores e escolha MCP. O endpoint é https://<seu host>/mcp (aparece na mesma página). Um cliente que aceita um servidor HTTP com cabeçalhos só precisa da URL e do token:

{
  "mcpServers": {
    "small-world": {
      "url": "https://<seu host>/mcp",
      "headers": { "Authorization": "Bearer sw_mcp_..." }
    }
  }
}

A tela de configuração muda de cliente para cliente. Clientes que só conseguem entrar com OAuth ainda não podem se conectar.

Versões do protocolo

• 2026-07-28 (sem estado): um POST /mcp por requisição com MCP-Protocol-Version: 2026-07-28, Mcp-Method e, para tools/call, Mcp-Name. Estão implementados server/discover, tools/list, tools/call, resources/list e resources/read.
• Compatibilidade com 2025-11-25: initialize e depois tools/list e tools/call. Nenhum id de sessão é emitido e GET /mcp responde 405.

As ferramentas espelham a API

Cada operação REST é uma ferramenta chamada sw_<operação>, por exemplo sw_list_worlds ou sw_publish_world. Uma ferramenta recebe a mesma entrada da chamada REST: os parâmetros de caminho, idempotency_key e if_match quando necessários, e o body da requisição. Os resultados chegam como structuredContent: {data, request_id} e as falhas como isError: true com os mesmos detalhes de problema da REST.

tools/list mostra só as ferramentas que as permissões do token permitem, então uma conexão de leitura vê ferramentas de leitura.

Dê ao agente um pedido claro

Diga quais casas ou domínios ele pode tocar, quais regras de design manter e o que não deve mudar. Peça que leia primeiro sw_list_capabilities e mostre um plano antes de escrever. Textos vindos de visitantes, inscritos, importações ou redes sociais chegam marcados como untrusted_data e nunca são instruções.

O que um agente não pode fazer

• Aprovar os próprios planos: ele pode pedir uma aprovação, mas só um proprietário decide, depois de entrar de novo.
• Gastar dinheiro: o pagamento devolve um link que uma pessoa conclui.
• Enviar e-mail para pessoas: respostas a contatos ficam salvas como rascunho.
• Excluir ou restaurar casas e contas.
• Alcançar outro espaço de trabalho: outros ids respondem 404.

Quando o trabalho terminar, revogue a conexão na página Desenvolvedores. Ela para de funcionar na próxima requisição.