mistral-mcp — MCP-сервер для Claude Code: что делает и как установить
Превращает счета и договоры из текста, Markdown или PDF в структурированный JSON через API Mistral. Пригодится для разбора первичных документов в чате с агентом.
claude mcp add --env MISTRAL_API_KEY=<MISTRAL_API_KEY> --env MISTRAL_BASE_URL=<MISTRAL_BASE_URL> --env MISTRAL_MCP_PROFILE=<MISTRAL_MCP_PROFILE> --env MISTRAL_DEFAULT_MODEL=<MISTRAL_DEFAULT_MODEL> --transport stdio mistral-mcp -- npx -y mistral-mcpЧто делает mistral-mcp
Сервер подключает модели Mistral к MCP-клиенту для обработки входящей документации. Главная функция process_document находит реквизиты поставщика, суммы, даты платежа и список позиций в тексте или разметке Markdown. Для сканов и файлов PDF используется OCR от Mistral.
По умолчанию профиль core даёт шесть инструментов, включая чат, зрение, транскрипцию и генерацию кода. Через переменную MISTRAL_MCP_PROFILE можно переключиться на альтернативные наборы: от сценариев workflows до профиля admin на 46 инструментов. Также поддерживается свой эндпоинт в режиме self-hosted.
Валидация схемы гарантирует только типы и структуру JSON, но не проверяет арифметику и налоги. Для работы нужны Node.js 20+, ключ с доступной квотой и текст объёмом до 60 000 символов UTF-16.
Какие задачи решает
- извлечь суммы и позиции из счёта в формате Markdown
- распарсить скан квитанции или PDF через OCR
- классифицировать входящие контракты и удостоверения личности
- подключить модели Mistral для зрения и транскрипции в MCP-клиенте
Примеры запросов агенту
- Извлеки данные поставщика и итоговую сумму из файла
invoice.mdв JSON - Разбери скан квитанции
check.pdfчерез инструментprocess_document - Классифицируй входящий договор
contract.txtи верни структурированные поля
Как установить mistral-mcp
Командой платформы
claude mcp add --env MISTRAL_API_KEY=<MISTRAL_API_KEY> --env MISTRAL_BASE_URL=<MISTRAL_BASE_URL> --env MISTRAL_MCP_PROFILE=<MISTRAL_MCP_PROFILE> --env MISTRAL_DEFAULT_MODEL=<MISTRAL_DEFAULT_MODEL> --transport stdio mistral-mcp -- npx -y mistral-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mistral-mcp --env MISTRAL_API_KEY=<MISTRAL_API_KEY> --env MISTRAL_BASE_URL=<MISTRAL_BASE_URL> --env MISTRAL_MCP_PROFILE=<MISTRAL_MCP_PROFILE> --env MISTRAL_DEFAULT_MODEL=<MISTRAL_DEFAULT_MODEL> -- npx -y mistral-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mistral-mcp": {
"command": "npx",
"args": [
"-y",
"mistral-mcp"
],
"env": {
"MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
"MISTRAL_BASE_URL": "<MISTRAL_BASE_URL>",
"MISTRAL_MCP_PROFILE": "<MISTRAL_MCP_PROFILE>",
"MISTRAL_DEFAULT_MODEL": "<MISTRAL_DEFAULT_MODEL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mistral-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mistral-mcp"
],
"env": {
"MISTRAL_API_KEY": "<MISTRAL_API_KEY>",
"MISTRAL_BASE_URL": "<MISTRAL_BASE_URL>",
"MISTRAL_MCP_PROFILE": "<MISTRAL_MCP_PROFILE>",
"MISTRAL_DEFAULT_MODEL": "<MISTRAL_DEFAULT_MODEL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MISTRAL_API_KEY=<MISTRAL_API_KEY> -e MISTRAL_BASE_URL=<MISTRAL_BASE_URL> -e MISTRAL_MCP_PROFILE=<MISTRAL_MCP_PROFILE> -e MISTRAL_DEFAULT_MODEL=<MISTRAL_DEFAULT_MODEL> mistral-mcp npx -y mistral-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mistral-mcp
Как установить mistral-mcp в Claude Code?
Выполните команду claude mcp add mistral-mcp -e MISTRAL_API_KEY=<MISTRAL_API_KEY> -- npx -y mistral-mcp, подставив свой действующий ключ Mistral API.
Что делает mistral-mcp?
Сервер передаёт текст документов в API Mistral, извлекает реквизиты, даты и списки позиций, а затем валидирует результат по заданной JSON-схеме. В базовый набор также входят инструменты для чата, OCR, зрения и транскрипции.
Проверяет ли сервер правильность подсчёта налогов и сумм?
Нет, встроенная валидация контролирует только формат данных и типы полей в JSON. Фактическую точность расчётов и бухгалтерские правила нужно сверять с исходником вручную.
