Cosmic — MCP-сервер для Claude Code: что делает и как установить
Связывает AI-клиенты с безголовой CMS Cosmic для чтения записей, правки схем и загрузки медиафайлов прямо из диалога с агентом.
claude mcp add mcp -e COSMIC_BUCKET_SLUG=<COSMIC_BUCKET_SLUG> -e COSMIC_READ_KEY=<COSMIC_READ_KEY> -e COSMIC_WRITE_KEY=<COSMIC_WRITE_KEY> -- npx -y @cosmicjs/mcpЧто делает Cosmic
Сервер открывает агентам доступ к корзинам Cosmic. Через готовый набор инструментов модель читает записи, создаёт новые типы объектов со схемами метаполей, правит черновики и удаляет устаревший контент. Отдельный блок инструментов отвечает за медиатеку и генерацию текстов, картинок или видео через встроенные средства Cosmic.
Работать можно двумя путями: подключиться к облачной конечной точке по HTTP либо запускать локальный процесс через npx -y @cosmicjs/mcp. Для локального запуска требуются переменные окружения COSMIC_BUCKET_SLUG, COSMIC_READ_KEY и опциональный COSMIC_WRITE_KEY.
Без ключа записи сервер остаётся строго в режиме чтения: создать документ, изменить тип данных или загрузить медиафайл не выйдет. Для любых изменений нужен COSMIC_WRITE_KEY. В удалённом HTTP-режиме аутентификация передаёт оба ключа через двоеточие в заголовке Authorization либо через отдельный заголовок X-Cosmic-Write-Key.
Какие задачи решает
- загружать медиафайлы и графику в медиатеку Cosmic
- создавать и обновлять записи в контентных бакетах
- настраивать типы объектов и структуры метаполей
- читать контентные блоки
{{name /}}в rich-text полях
Примеры запросов агенту
- Найди все опубликованные статьи в бакете Cosmic и покажи их заголовки.
- Создай новый тип объекта Продукты с полями для названия, цены и описания.
- Загрузи изображение по этой ссылке в медиатеку блога.
Как установить Cosmic
1Командой платформы
claude mcp add mcp -e COSMIC_BUCKET_SLUG=<COSMIC_BUCKET_SLUG> -e COSMIC_READ_KEY=<COSMIC_READ_KEY> -e COSMIC_WRITE_KEY=<COSMIC_WRITE_KEY> -- npx -y @cosmicjs/mcpВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
claude mcp add --transport http cosmic https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}1Командой платформы
codex mcp add cosmic --env COSMIC_BUCKET_SLUG=<COSMIC_BUCKET_SLUG> --env COSMIC_READ_KEY=<COSMIC_READ_KEY> --env COSMIC_WRITE_KEY=<COSMIC_WRITE_KEY> -- npx -y @cosmicjs/mcpВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
codex mcp add cosmic --url https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}1Файл настроек
{
"mcpServers": {
"cosmic": {
"command": "npx",
"args": [
"-y",
"@cosmicjs/mcp"
],
"env": {
"COSMIC_BUCKET_SLUG": "<COSMIC_BUCKET_SLUG>",
"COSMIC_READ_KEY": "<COSMIC_READ_KEY>",
"COSMIC_WRITE_KEY": "<COSMIC_WRITE_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
2Файл настроек
{
"mcpServers": {
"cosmic": {
"url": "https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}"
}
}
}1Файл настроек
{
"servers": {
"cosmic": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cosmicjs/mcp"
],
"env": {
"COSMIC_BUCKET_SLUG": "<COSMIC_BUCKET_SLUG>",
"COSMIC_READ_KEY": "<COSMIC_READ_KEY>",
"COSMIC_WRITE_KEY": "<COSMIC_WRITE_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
2Файл настроек
{
"servers": {
"cosmic": {
"type": "http",
"url": "https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}"
}
}
}1Командой платформы
gemini mcp add -e COSMIC_BUCKET_SLUG=<COSMIC_BUCKET_SLUG> -e COSMIC_READ_KEY=<COSMIC_READ_KEY> -e COSMIC_WRITE_KEY=<COSMIC_WRITE_KEY> cosmic npx -y @cosmicjs/mcpВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
gemini mcp add -t http cosmic https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Cosmic
Как установить Cosmic в Claude Code?
Подключите удалённую конечную точку командой claude mcp add --transport http cosmic https://mcp.cosmicjs.com/v1/buckets/{bucket_slug} либо настройте локальный запуск через `claude mcp add mcp -e COSMIC_BUCKET_SLUG=<COSMIC_BUCKET_SLUG> -e COSMIC_READ_KEY=<COSMIC_READ_KEY> -e COSMIC_WRITE_KEY=<COSMIC_WRITE_KEY> -- npx -y @cosmicjs/mcp`.
Что делает Cosmic MCP-сервер?
Он предоставляет модели набор вызовов для манипуляции контентом, типами схем и медиатекой в безголовой CMS Cosmic, а также для генерации медиа через встроенный ИИ сервиса.
Чем отличается ключ чтения от ключа записи?
Ключ чтения COSMIC_READ_KEY разрешает только просмотр списков и записей. Для вызова cosmic_objects_create, загрузки файлов и генерации ассетов обязателен COSMIC_WRITE_KEY.
