mcp-malt

MCP-сервер для Malt API. Он охватывает все 13 операций, которые публикует Malt: счета, которые вы выставляете, комиссию, которую Malt выставляет вам, платежи, которые вы получаете, и SCIM-провижининг пользователей для организационных аккаунтов.

Что этот сервер охватывает и чего не охватывает

API Malt меньше, чем ожидает большинство людей. Он охватывает только бэк-офисный биллинг и корпоративный провижининг пользователей — и не больше:

Здесь нет поиска талантов, профилей, миссий, офферов и сообщений. Именно этим Malt известен, но ничего из этого нет в публичном API. Если вы пришли за этим, этот сервер не сможет вам этого дать — как и всё остальное, построенное на документированном API.

Два комьюнити MCP-сервера для Malt действительно получают доступ к этим данным: они управляют веб-приложением через автоматизацию браузера и собирают данные из DOM. Их собственная документация предупреждает, что автоматизация изменений профиля может нарушать условия Malt. Этот сервер работает только с документированным API.

Related MCP server: fintaro-mcp

Получение токена

1. Создайте учётную запись на странице регистрации, если у вас её ещё нет.

2. Откройте «My Account», затем — «API Keys».

3. Создайте токен доступа с нужными правами (scopes). Согласуйте их с наборами инструментов, которые вы планируете включить.

4. Сразу же скопируйте токен. Он показывается один раз при создании — больше никогда.

Токены для фриланс-аккаунтов получить можно самостоятельно. Токены для клиентских команд и организаций, которые нужны набору scim, выдаются через вашего представителя Malt.

Здесь нет OAuth 2.0. Malt не публикует ни авторизационный сервер, ни токен-эндпоинт, поэтому API-токен выше — единственный способ входа. В docs/authentication.md это разобрано подробнее, включая особенность заголовка, на которой спотыкаются многие.

Установка

Из одного релиза публикуется три варианта: npm-пакет на npmjs и в GitHub Packages, а также образ контейнера на GHCR. Для MCP-клиента обычно выбирают npx; Docker подходит для изолированной или общей инфраструктуры.

Чтобы устанавливать из GitHub Packages вместо npmjs, укажите scope для реестра: @ialejandro:registry=https://npm.pkg.github.com в вашем .npmrc.

npx

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "npx",
      "args": ["-y", "@ialejandro/mcp-malt"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Claude Code

claude mcp add malt \
  --env MALT_API_TOKEN=your-token-here \
  --env MALT_TOOLSETS=invoices,payments,fee-invoices \
  -- npx -y @ialejandro/mcp-malt

Docker

Сервер общается по JSON-RPC через stdin и stdout, поэтому обязателен -i, а -t должен быть опущен.

docker run -i --rm \
  -e MALT_API_TOKEN=your-token-here \
  -e MALT_TOOLSETS=invoices \
  ghcr.io/ialejandro/mcp-malt

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Из исходного кода

git clone https://github.com/ialejandro/mcp-malt
cd mcp-malt
npm ci && npm run build

{
  "mcpServers": {
    "malt": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-malt/dist/index.js"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Конфигурация

Без MALT_TOOLSETS сервер запускается, но не предлагает ничего. Это сделано сознательно, а не является сбоем: вы решаете, что видит модель. Включайте наборы инструментов по одному.

Неизвестное имя набора останавливает сервер с ошибкой, а не игнорируется, потому что опечатка, молча отнимающая у вас три инструмента, превращается в мучительный дебаг.

Типовые задачи

Сверка за квартал. Включите invoices,payments,fee-invoices и запустите prompt malt_reconcile_revenue. Он получает все три списка, сопоставляет платежи со счетами, которые они оплачивают, и показывает сумму выставленных счетов, налог, комиссию Malt и полученную выручку.

Сверьте мои показатели Malt за Q1 2026.

Получить PDF-счёт. Malt возвращает PDF-файлы в base64 внутри JSON-тела. Инструменты декодируют их и возвращают настоящий PDF-вложение.

Скачать PDF для счёта INV-123456.

Вывести пользователя. Включите scim с MALT_ALLOW_WRITES=true и используйте malt_user_lifecycle. Он деактивирует, а не удаляет, — это тот путь, который Malt реально поддерживает.

Выведите jane.doe@acme.com из нашей Malt-организации.

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

• Получение и управление токеном

• Аутентификация и почему не OAuth

• Наборы инструментов: что и когда подключать

• Каждый endpoint, запросы и ответы

• Ошибки и их значение

• Лимиты запросов

• Расширение сервера

Разработка

npm ci
npm run typecheck
npm test
npm run build
npm run check-spec   # diff the live Malt spec against spec/malt-openapi.json

В тестах fetch заменяется моком, и реальный API не вызывается.

spec/malt-openapi.json — зафиксированный снимок опубликованного документа Malt. Ежедневный процесс сравнивает живую спецификацию с этим снимком и открывает PR, если в ней что-то меняется. Malt не меняет info.version с значения 0.0.1, поэтому проверка сравнивает операции, а не полагается на номер версии.

Участие в разработке

См. CONTRIBUTING.md. Как добавить endpoint или целый набор, описано в docs/extending.md.

Лицензия

MIT.