Carbone MCP — MCP-сервер для Claude Code: что делает и как установить
Собирает PDF, Word и Excel из макетов с JSON-данными и конвертирует файлы через API Carbone прямо в ассистенте.
claude mcp add --transport http carbone-mcp https://mcp.carbone.ioЧто делает Carbone MCP
Инструмент связывает клиент с сервисом Carbone. Он заполняет метки вида {d.field} в DOCX, XLSX, PPTX, Markdown или готовых формах PDF переданным JSON. Дополнительно сервер умеет преобразовывать более 100 форматов в таблицы, картинки или PDF, накладывать водяные знаки, задавать пароли и формировать PDF/A.
Подключить сервер можно локально через npx carbone-mcp либо по HTTP к адресу https://mcp.carbone.io. В облачном варианте по HTTP локальные файлы с диска прочесть нельзя: сервер принимает исключительно ссылки и строки base64. Для локального запуска на машине требуется Node.js версии не ниже 20.3 и API-ключ из личного кабинета Carbone.
Какие задачи решает
- генерировать отчёты и счета в PDF по макетам DOCX и JSON
- конвертировать офисные форматы и Markdown в изображения или PDF
- узнавать список обязательных полей шаблона перед генерацией
- пакетом собирать до 100 документов с отправкой на webhook
Примеры запросов агенту
- Заполни шаблон счёта invoice.docx вот этим JSON и экспортируй результат в PDF
- Проверь макет contract.docx и покажи, какие переменные ему нужны
- Сконвертируй этот файл Markdown в PDF с защитой паролем
Как установить Carbone MCP
1Командой платформы: удалённый сервер
claude mcp add --transport http carbone-mcp https://mcp.carbone.io2Командой платформы
claude mcp add --env CARBONE_API_KEY=<CARBONE_API_KEY> --env CARBONE_BASE_URL=<CARBONE_BASE_URL> --transport stdio carbone-mcp -- npx -y carbone-mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add carbone-mcp --url https://mcp.carbone.io2Командой платформы
codex mcp add carbone-mcp --env CARBONE_API_KEY=<CARBONE_API_KEY> --env CARBONE_BASE_URL=<CARBONE_BASE_URL> -- npx -y carbone-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"carbone-mcp": {
"url": "https://mcp.carbone.io"
}
}
}{
"mcpServers": {
"carbone-mcp": {
"command": "npx",
"args": [
"-y",
"carbone-mcp"
],
"env": {
"CARBONE_API_KEY": "<CARBONE_API_KEY>",
"CARBONE_BASE_URL": "<CARBONE_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"carbone-mcp": {
"type": "http",
"url": "https://mcp.carbone.io"
}
}
}{
"servers": {
"carbone-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"carbone-mcp"
],
"env": {
"CARBONE_API_KEY": "<CARBONE_API_KEY>",
"CARBONE_BASE_URL": "<CARBONE_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http carbone-mcp https://mcp.carbone.io2Командой платформы
gemini mcp add -e CARBONE_API_KEY=<CARBONE_API_KEY> -e CARBONE_BASE_URL=<CARBONE_BASE_URL> carbone-mcp npx -y carbone-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Carbone MCP
Как установить Carbone MCP в Claude Code?
Для запуска через локальный процесс выполните команду claude mcp add --env CARBONE_API_KEY=<CARBONE_API_KEY> --env CARBONE_BASE_URL=<CARBONE_BASE_URL> --transport stdio carbone-mcp -- npx -y carbone-mcp. Либо подключите облачный сервер командой claude mcp add --transport http carbone-mcp https://mcp.carbone.io.
Чем отличается локальный запуск от облачного mcp.carbone.io?
Локальный пакет умеет читать пути на диске вашего компьютера и сохранять готовые файлы. Сервер по адресу https://mcp.carbone.io не имеет доступа к локальной файловой системе и принимает только внешние URL или base64.
Нужен ли платный тариф Carbone для работы?
Нет, бесплатный тестовый ключ позволяет генерировать документы в формате PDF без ограничений по количеству, но с водяным знаком. На бесплатном тарифе доступно 100 готовых документов без водяных знаков в месяц.
