Дайте агенту маленькую ясную задачу
Направьте MCP-клиент в своё рабочее пространство с токеном ограниченного доступа и дайте ему те же операции, что у API.
Подключите клиент
Создайте подключение на странице Разработчикам и выберите MCP. Конечная точка — https://<your host>/mcp (показана на той же странице). Клиенту, поддерживающему HTTP-сервер с заголовками, нужны только URL и токен:
{
"mcpServers": {
"small-world": {
"url": "https://<your host>/mcp",
"headers": { "Authorization": "Bearer sw_mcp_..." }
}
}
}Точный экран настроек зависит от клиента. Клиенты, которые входят только через OAuth, пока подключить нельзя.
Версии протокола
- 2026-07-28 (без состояния): один
POST /mcpна запрос сMCP-Protocol-Version: 2026-07-28,Mcp-Methodи, дляtools/call,Mcp-Name. Реализованыserver/discover,tools/list,tools/call,resources/listиresources/read. - Совместимость с 2025-11-25:
initialize, затемtools/listиtools/call. Идентификаторы сеансов не выдаются, аGET /mcpотвечает405.
Инструменты повторяют API
Каждая операция REST представлена инструментом с именем sw_<operation>, например sw_list_worlds или sw_publish_world. Инструмент принимает те же данные, что и вызов REST: параметры пути, при необходимости idempotency_key и if_match, а также body запроса. Результаты возвращаются как structuredContent: {data, request_id}, а сбои как isError: true с теми же сведениями о проблеме, что и REST.
tools/list показывает только инструменты, разрешённые областями доступа токена, поэтому подключение только для чтения видит только инструменты чтения.
Дайте агенту ясное задание
Укажите, какие casa или домены ему разрешено затрагивать, какие правила дизайна сохранять и что менять нельзя. Попросите сначала прочитать sw_list_capabilities и показать план перед записью. Текст посетителей, подписчиков, импортов или социальных лент возвращается с пометкой untrusted_data и никогда не является инструкцией.
Чего агент делать не может
- Одобрять собственные планы: он может запросить одобрение, но решение принимает только владелец после нового входа.
- Тратить деньги: оформление оплаты возвращает ссылку, по которой завершает действие человек.
- Отправлять людям почту: ответы на запросы сохраняются черновиками.
- Удалять или восстанавливать casa и аккаунты.
- Обращаться к другому рабочему пространству: чужие идентификаторы отвечают
404.
Завершив работу, отзовите подключение на странице разработчика. Оно перестанет работать со следующего запроса.