Confiez à votre agent une tâche petite et claire

Connecter un client

Créez une connexion dans Développeurs et choisissez MCP. Le point d’accès est https://<your host>/mcp, indiqué sur la même page. Un client acceptant un serveur HTTP avec en-têtes n’a besoin que de l’URL et du jeton :

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

L’écran de réglage exact dépend du client. Les clients qui ne se connectent qu’avec OAuth ne peuvent pas encore utiliser cette connexion.

Versions du protocole

• 2026-07-28 (sans état) : un POST /mcp par requête avec MCP-Protocol-Version: 2026-07-28, Mcp-Method et, pour tools/call, Mcp-Name. server/discover, tools/list, tools/call, resources/list et resources/read sont implémentés.
• Compatibilité 2025-11-25 : initialize, puis tools/list et tools/call. Aucun identifiant de session n’est émis, et GET /mcp répond 405.

Les outils reflètent l’API

Chaque opération REST est un outil nommé sw_<operation>, par exemple sw_list_worlds ou sw_publish_world. Il reçoit les mêmes entrées que l’appel REST : paramètres de chemin, idempotency_key et if_match au besoin, ainsi que le body de la requête. Les résultats reviennent comme structuredContent: {data, request_id}, et les échecs comme isError: true avec les mêmes détails de problème qu’en REST.

tools/list ne montre que les outils permis par les portées du jeton : une connexion en lecture seule voit les outils en lecture seule.

Donner une consigne claire à l’agent

Précisez les casas ou domaines qu’il peut toucher, les règles de design à garder et ce qu’il ne doit pas changer. Demandez une lecture de sw_list_capabilities d’abord, puis un plan avant toute écriture. Les textes des visiteurs, abonnés, imports ou flux sociaux portent la marque untrusted_data et ne sont jamais des instructions.

Ce qu’un agent ne peut pas faire

• Approuver ses propres plans : il peut demander une approbation, mais seul un propriétaire décide après une nouvelle connexion.
• Dépenser de l’argent : le paiement renvoie un lien qu’une personne doit compléter.
• Envoyer du courrier à des personnes : les réponses aux demandes sont enregistrées comme brouillons.
• Supprimer ou restaurer des casas et des comptes.
• Atteindre un autre espace : les autres identifiants renvoient 404.

Une fois le travail terminé, révoquez la connexion dans Développeurs. Elle s’arrête dès la requête suivante.