Подключите своего ИИ-ассистента к Kosmonaut

Если вы управляете пространством на Kosmonaut, теперь можно подключить к нему ИИ-ассистента напрямую. Попросите его исправить опечатку в сербском тексте, добавить преимущество, поменять порядок фотографий в галерее или подготовить событие на следующую неделю. Он работает с вашим настоящим пространством и входит под вашим аккаунтом.

Всё работает на Model Context Protocol (MCP), стандарте, через который большинство ассистентов сегодня подключаются к внешним инструментам. Вы добавляете один адрес и входите через браузер. Никаких API-ключей и никаких настроек, которые нельзя было бы показать другим.

Адрес

https://www.kosmonaut.rs/api/mcp

Это вся настройка. Когда ассистент впервые обращается к серверу, открывается окно браузера: вы входите в свой аккаунт Kosmonaut и один раз разрешаете чтение и изменения. Ассистент хранит токен и сам его обновляет.

Перед началом

Один раз войдите на kosmonaut.rs в браузере. Сервер сопоставляет ваш вход с пользователем Kosmonaut. У аккаунта, который ни разу не открывал сайт, нет записи для сопоставления.

Подключение к ассистенту

Claude Code

claude mcp add --transport http --scope user \
  kosmonaut https://www.kosmonaut.rs/api/mcp

Затем выполните /mcp и выберите Authenticate. Без --scope user сервер добавится только в текущий проект.

Claude, десктоп и веб

Settings → Connectors → Add custom connector. Вставьте адрес и нажмите Connect, чтобы войти. Для пользовательских коннекторов нужен платный план Claude.

ChatGPT

На chatgpt.com откройте Plugins (каталог плагинов, а не обычный чат).
Нажмите +, затем Add custom MCP server.
Заполните Name: Kosmonaut, Description: что-нибудь короткое, например Kosmonaut spaces, locations and passes, Server URL: адрес выше, Authentication: OAuth.
Прочитайте предупреждение и нажмите I understand and want to continue.
Нажмите Create as a plugin. ChatGPT откроет вход в Kosmonaut. Войдите в аккаунт, который управляет вашим пространством, и подтвердите доступ.
Когда плагин появится среди ваших плагинов, откройте его и нажмите +, чтобы установить.
Вернитесь на главную, переключите вкладку вверху с Chat на Work и откройте новый Work-чат.
Введите @, выберите Kosmonaut и попросите что-то конкретное, например найти ваше пространство.

Если в меню нет Add custom MCP server, ваш аккаунт или workspace не разрешает пользовательские MCP-серверы, и включить их должен администратор workspace. В старых версиях ChatGPT та же опция находится в Settings → Apps → Advanced settings → Developer mode → Create app, с тем же адресом и входом через OAuth.

Cursor

Добавьте это в ~/.cursor/mcp.json или в .cursor/mcp.json для одного проекта:

{
  "mcpServers": {
    "kosmonaut": { "url": "https://www.kosmonaut.rs/api/mcp" }
  }
}

Затем откройте Cursor Settings → Tools & MCP, найдите Kosmonaut и нажмите Connect, чтобы войти.

Codex CLI

codex mcp add kosmonaut --url https://www.kosmonaut.rs/api/mcp
codex mcp login kosmonaut

То же самое в ~/.codex/config.toml:

[mcp_servers.kosmonaut]
url = "https://www.kosmonaut.rs/api/mcp"

Gemini CLI

gemini mcp add --transport http \
  kosmonaut https://www.kosmonaut.rs/api/mcp

Или в ~/.gemini/settings.json:

{
  "mcpServers": {
    "kosmonaut": { "httpUrl": "https://www.kosmonaut.rs/api/mcp" }
  }
}

VS Code с Copilot в режиме агента

code --add-mcp '{"name":"kosmonaut","type":"http","url":"https://www.kosmonaut.rs/api/mcp"}'

Всё остальное

Ассистент, который поддерживает только старый транспорт stdio, может подключиться через мост mcp-remote, который запускает тот же вход через браузер:

{
  "mcpServers": {
    "kosmonaut": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.kosmonaut.rs/api/mcp"]
    }
  }
}

Что можно попросить

Ассистент может читать ваше пространство и его локации и менять то, что вы сами меняли бы в админке:

Тексты и переводы: заголовки, описания, все языки сразу, с отчётом о том, чего ещё не хватает
Макеты страниц: главная страница пространства и страница каждой локации, секция за секцией
Преимущества, рабочие зоны и галереи: добавить, переупорядочить, переименовать, удалить
Статьи и события: статус, slug, расписание, обложка, подпись

Он может ровно то же, что и ваш аккаунт, не больше. Сотрудник с доступом к одной локации остаётся ограничен этой локацией.

О чём помнить

Каждое изменение сразу публикуется. Промежуточного шага нет: правка текста сразу попадает на публичный сайт. Исключение составляют макеты страниц: они сохраняются в черновик и становятся видны посетителям только после публикации.

Публичные страницы могут отставать до десяти минут, потому что они кэшируются. Ссылка на предпросмотр, которую ассистент получает при каждом чтении, сразу показывает новую версию.

Каждое изменение записывается на вас и попадает в журнал активности вместе с названием ассистента, который его сделал. Если токен когда-нибудь понадобится отозвать, он принадлежит только вам.

Если не подключается

Отказ без открытия браузера. Проверьте, что адрес заканчивается на /api/mcp без косой черты в конце и что ассистент настроен на HTTP, а не на SSE.

Вход работает, но все запросы отклоняются. У вашего аккаунта ещё нет доступа для агентов. Напишите нам, и мы его откроем.

Изменение не видно. Если это макет страницы, он ждёт публикации в черновике. В остальных случаях подождите десять минут, пока обновится кэш, или откройте ссылку на предпросмотр.

Вопросы или доступ для вашей команды: напишите нам, и мы всё настроим.