Dale a tu agente una tarea pequeña y clara

Conecta un cliente

Crea una conexión en la página Desarrolladores y elige MCP. El endpoint es https://<tu host>/mcp (aparece en esa misma página). Un cliente que acepte un servidor HTTP con cabeceras solo necesita la URL y el token:

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

La pantalla de configuración cambia según el cliente. Los clientes que solo pueden iniciar sesión con OAuth todavía no pueden conectarse.

Versiones del protocolo

• 2026-07-28 (sin estado): un POST /mcp por solicitud con MCP-Protocol-Version: 2026-07-28, Mcp-Method y, para tools/call, Mcp-Name. Están implementados server/discover, tools/list, tools/call, resources/list y resources/read.
• Compatibilidad con 2025-11-25: initialize y después tools/list y tools/call. No se emiten ids de sesión y GET /mcp responde 405.

Las herramientas reflejan la API

Cada operación REST es una herramienta llamada sw_<operación>, por ejemplo sw_list_worlds o sw_publish_world. Una herramienta recibe la misma entrada que la llamada REST: los parámetros de ruta, idempotency_key e if_match cuando hacen falta, y el body de la solicitud. Los resultados llegan como structuredContent: {data, request_id} y los fallos como isError: true con los mismos detalles de problema que en REST.

tools/list solo muestra las herramientas que permiten los permisos del token, así que una conexión de solo lectura ve herramientas de solo lectura.

Dale al agente un encargo claro

Dile qué casas o dominios puede tocar, qué reglas de diseño debe respetar y qué no debe cambiar. Pídele que lea primero sw_list_capabilities y que te muestre un plan antes de escribir. El texto que procede de visitantes, suscriptores, importaciones o redes sociales llega marcado como untrusted_data y nunca es una instrucción.

Lo que un agente no puede hacer

• Aprobar sus propios planes: puede pedir una aprobación, pero solo la decide un propietario tras iniciar sesión de nuevo.
• Gastar dinero: el pago devuelve un enlace que completa una persona.
• Enviar correo a personas: las respuestas a consultas se guardan como borradores.
• Eliminar o restaurar casas y cuentas.
• Llegar a otro espacio de trabajo: otros ids responden 404.

Cuando termine el trabajo, revoca la conexión en la página Desarrolladores. Deja de funcionar en la siguiente solicitud.