Charming MCP Server

Charming — это размещённый сервер MCP, который генерирует, размещает и обновляет интерактивные веб-приложения. Подключите его к любому совместимому с MCP AI-клиенту и попросите построить приложение. В ответ вы получите живой URL за считанные секунды.

Подключение

Клиент	Конечная точка
Claude, Claude Code, Cursor, Codex, Gemini CLI и большинство клиентов MCP	https://charm.ing/mcp
ChatGPT	https://charm.ing/mcp/chatgpt (один клик через Charming в каталоге приложений ChatGPT; эта вставляемая строка — запасной режим Developer Mode)

Большинство клиентов MCP могут использовать эту удалённую конфигурацию:

{
  "mcpServers": {
    "charming": {
      "url": "https://charm.ing/mcp",
      "type": "streamableHttp"
    }
  }
}

Конечные точки MCP требуют Bearer-токен, и OAuth с динамической регистрацией клиента автоматически настраивает его: клиенты, поддерживающие это, показывают экран одноразового согласия, без необходимости вставлять API-ключ. Анонимное создание без токена доступно только по HTTP-пути. Руководство по аутентификации: авторизация.

Для отдельных строк вставки для каждого клиента и шагов настройки смотрите клиенты.txt.

Стартовый промпт

После подключения Charming вставьте этот текст, чтобы запустить сессию сборки:

Help me figure out what to build. Look at what you know about me and suggest 2-3 apps that fit, or ask me up to 3 short questions to find an idea.

Read https://usecharming.com/start.md then help me create my first app.

Инструменты

Charming предоставляет 21 инструмент. Подключённые клиенты автоматически обнаруживают их через tools/list.

Инструмент	Что делает
create_app	Сохранить модуль, созданный агентом (манифест плюс маршруты) с опциональным UI и CSS и отрендерить его встроенно. Требуется описание. Вернуть пользователю shareUrl без токена, никогда не возвращать URL, доступный только машине.
update_app	Редактировать существующее приложение путём замены его модуля/UI/стилей/описания или применения точечных изменений строк, с версионностью по принципу optimistic concurrency.
get_app	Отображать существующее приложение встроенно (там, где клиент поддерживает это) и возвращать его вызываемые операции API и метаданные.
get_app_source	Вернуть сохранённый модуль, UI и стили для существующего приложения вместе с текущей версией.
list_apps	Перечислить приложения запрашивающего пользователя и приложения, которыми с ним поделились, начиная с самых новых; для каждого приложения показать роль, описание и возможности.
delete_app	Навсегда удалить приложение, которым владеете. Необратимо; подтверждение обязательно: операция завершится только повторно с confirm: true. Укажите purge_storage: true, чтобы также стереть сохранённое состояние.
upload_asset	Сохранить статический ресурс (изображение, PDF, набор данных), чтобы код приложения оставался лёгким; чтение обратно по той же политике источника.
rename_app	Изменить «слаг» URL приложения. Старый URL будет продолжать работать через редирект.
set_remixable	Пометить приложение как remixable, чтобы посетители получили собственную редактируемую копию.
unset_remixable	Прекратить разрешать ремиксы; существующие ремиксы остаются без изменений.
set_starter_prompt	Установить или очистить подсказку по умолчанию в host-чате, когда посетитель открывает совместное приложение.
query_app	Выполнить операцию чтения на стороне бэкенда внутри модуля приложения.
mutate_app	Выполнить операцию изменения на стороне бэкенда внутри модуля приложения без редактирования кода.
submit_feedback	Зафиксировать反馈 агентом (ошибки, улучшения, сообщения о сбоях) об приложении.
list_feedback	Список записей отзывов для ваших приложений, самые новые в начале.
set_handle	Изменить подпись вошедшего пользователя (первый сегмент их URL-адресов приложений).
share_app	Пригласить кого‑то к приложению в качестве сотрудника (по умолчанию), конечного пользователя (запуск и запись данных, редактирование исходников запрещено) или просмотра (только чтение). Повторный вызов с новой ролью меняет роль на месте.
unshare_app	Отозвать доступ у любого получателя, независимо от того, ожидает ли приглашение или уже принято.
list_app_shares	Перечислить активные и ожидающие приглашения к совместному доступу к одному из ваших приложений.
set_public	Сделать приложение общедоступным: любой, у кого есть URL, может открыть его без входа и читать И запись его совместно используемых данных. Предупредите пользователя, что каждый анонимный посетитель разделяет один пул данных, поэтому любой, у кого есть URL, может переписать или удалить данные.
unset_public	Сделать общедоступное приложение приватным снова; анонимные посетители больше не смогут открыть его.

Использование с агентом-кодером

Работаете в Codex, Claude Code, Cursor или другом агенте по кодированию на базе искусственного интеллекта? Установите дополнительный навык авторства Charming из skills.sh с помощью npx skills add tambo-labs/charming-mcp. Это устанавливает инструкции по сборке Charming; оно не подключает MCP-сервер.

Он обучает контракту сборки Charming и рабочему процессу. Сам навык представлен как [SKILL.md]; AGENTS.md содержит инструкции по подключению и авторингу для любого AI-кодирующего агента. Пользователи Codex могут установить встроенный плагин Charming Codex.

Cursor

Cursor читает правила проекта из .cursor/rules/. Поместите .cursor/rules/charming.mdc в ваш проект (или скопируйте его содержимое в устаревший корневой .cursorrules), и агент Cursor будет обращаться к Charming (реальный URL, хранилище и встроенная отрисовка) всякий раз, когда вы попросите сохранить приложение. Правило указывает на обслуживаемые документы; оно не дублирует контракт.

Распределение

Этот репозиторий является каноническим источником для каждого публичного пакета интеграции Charming. Артефакты, независимые от платформы, редактируются вручную; адаптеры под платформу генерируются из них, поэтому факт хранится ровно в одном файле.

Вид	Артефакт
Независимый от платформы (редактируйте их)	canonical/facts.json, SKILL.md, AGENTS.md, .cursor/rules/charming.mdc, charming-icon.png
Адаптер (генерируемый)	plugins/cursor/charming, plugins/claude-code/charming, plugins/codex/charming, gemini-extension.json, GEMINI.md, три каталога на витрину marketplace

node scripts/build-packages.mjs          # regeneration каждого адаптера
node scripts/build-packages.mjs --check  # срыво на рассогласование (в CI)

Адаптеры ещё не опубликованы; публикация каждого из них отслеживается отдельно. См. DISTRIBUTION.md для структуры, проверок рассогласований и того, как Charming-монорепо подходит к изменениям здесь.

Документация

Навык агента: [SKILL.md] · руководство по кодированию агента: [AGENTS.md] · Правило Cursor: .cursor/rules/charming.mdc
Полное руководство по авторству: usecharming.com/llms-full.txt
Аутентификация и сопряжение: авторизация · ограничения: usecharming.com/pricing.md
Спецификация OpenAPI: официальная спецификация OpenAPI
Документация: документация на usecharming.com/docs

Издатель

Опубликовано компанией Tambo.