MiniMax Code · Учебник 12

Плагины MiniMax Code и MCP: Подключение инструментов и доказательство их работы

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

Ручная вырезка на бумажной соединительной плате, отделяющая повторно используемый навык, локальный сервер MCP, авторизованное приложение и проверенный результат инструмента.
Время чтения
16 мин
Последнее обновление
Август 2026

0 из 16 завершено

Завершить & далее →

Последнее тестирование и обновление: 25 августа 2026 года

MiniMax Code может получать новые возможности через Навыки, серверы MCP, Приложения, и пакеты из Магазина плагинов. Метки перекрываются, потому что один плагин может содержать более одной возможности.

Используйте это различие:

ВозможностьЧто он предоставляетТипичные границы
НавыкИнструкции, знания в области и повторяемый рабочий процессОн сам по себе не создает инструменты, учетные записи или разрешения
Сервер MCPВызываемые инструменты из локальной команды или удалённого сервисаСервер может считывать локальные данные или отправлять данные в другую систему
Приложение / КоннекторУправляемое подключение аккаунта с авторизацией и управлением жизненным циклом учетных данныхОн может работать с предоставленными подключённому аккаунту полномочиями
ПлагинУстанавливаемый пакет, который может включать Навыки, MCP или приложения, одобренные MiniMaxЕго содержимое и правила поставщика определяют фактический доступ

Полезный вопрос не "Установил ли я плагин?" Спросите: Какой инструмент доступен в этом задании, к каким данным он имеет доступ и какой безопасный результат доказывает его работу?

Официальный маркетплейс плагинов MiniMax Code с отображением устанавливаемых карточек возможностей
Документация официального рынка плагинов, зафиксированная 25 августа 2026 года. Доступность, цена, регион и требования к авторизации могут изменяться.

Выберите наименьший путь интеграции

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

  • Нужен повторяемый набор инструкций для файлов, которые MiniMax Code уже может использовать? Начните с Навык.
  • Нужна локальная команда, внутренний инструмент, специализированная база данных или удалённый сервис, доступный как вызываемые инструменты? Используйте MCP.
  • Нужен OAuth, подключение аккаунта, обновление учетных данных или процесс отключения? Используйте одобренный Приложение / Коннектор.
  • Нужна упакованная комбинация для повторной установки? Рассмотрите Плагин.

Локальная конфигурация MCP не требует плагина. Текущая страница MCP MiniMax Code поддерживает конфигурацию через формы и JSON и хранит локальную конфигурацию на текущем устройстве. MiniMax предоставляет ~/.minimax/mcp.json как обычное место для работы вручную, но новичкам следует использовать интерфейс, если только устранение неполадок не требует проверки.

Понимание передач MCP

Сервер MCP может работать локально или удаленно:

ТранспортИспользоватьОсновные поля для проверки
stdioЗапустите локальный исполняемый файл, пакет Node или сервер Pythoncommand, args, env
httpПодключитесь к стандартному удаленному HTTP MCP в локальной конфигурацииurl, headers
streamable-httpПодключитесь к текущему удаленному потоковому сервисуurl, headers
sseПодключитесь к удаленному сервису с использованием Server-Sent Eventsurl, headers

Упакованные файлы плагина MCP имеют более ограниченный набор передач: документы MiniMax stdio, streamable-http, и sse, а не локальный http псевдоним. Это важно только если вы распространяете плагин. Это не делает локальную конфигурацию зависимой от упаковки плагина.

Сценарий для новичка: проверьте один инструмент только для чтения

Вы хотите, чтобы MiniMax Code использовал надежный MCP с общедоступной информацией. Вы настроите его локально, проверите список инструментов, вызовете один инструмент только для чтения с общедоступным запросом и зафиксируете его границы доступа. Вы не будете подключать частный аккаунт или позволять ему что-либо записывать.

Шаг 1: проверка перед установкой

Запись:

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

Для локального stdio сервера, тот command является выполняемым кодом. Просматривайте его с такой же осторожностью, как при установке зависимостей. Для удаленного сервера URL определяет, куда могут отправляться данные задачи.

Шаг 2: добавьте сервер в узком диапазоне

Откройте область управления плагинами, переключитесь на Серверы MCPи используйте текущую форму или режим JSON. Эта форма является иллюстративной; замените все заполнители на официальные значения доверенного сервера:

{
  "mcpServers": {
    "public-reference": {
      "type": "streamable-http",
      "url": "https://example.com/mcp",
      "enabled": true,
      "description": "Только для чтения поиск по публичным ссылкам",
      "timeout": 30000
    }
  }
}

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

Шаг 3: проверьте список серверов и инструментов

Используйте тест соединения в MiniMax Code. Если mcode командная строка кодирования уже установлена и подключена к рабочему столу, MiniMax также документирует эти диагностические команды:

mcode mcp список --человек
mcode mcp инструменты общедоступная ссылка
mcode mcp аутентификация статус

Это CLI MiniMax Code (mcode) команды. Это не команды для отдельной медиакомандной строки MiniMax Platform с названием mmx.

Проверьте, что ожидаемый сервер включен, а ожидаемый инструмент только для чтения отображается. Не предполагайте, что сохранённая запись JSON означает, что Агент получил инструмент.

Шаг 4: выполните безопасный тест работоспособности

Используйте публичный, не персональный запрос, результат которого вы можете проверить самостоятельно.

Используйте только публичную ссылку MCP для этого теста работоспособности.

Прежде чем что-либо вызывать:
1. Укажите сервер и точный инструмент, который вы намерены использовать.
2. Укажите, является ли инструмент только для чтения и какие данные покидают это устройство.
3. Остановитесь, если инструмент требует входа, оплаты, приватных файлов или прав на запись.

Запрос
Найдите [ОДИН ОБЩЕДОСТУПНЫЙ, НЕЧУВСТВИТЕЛЬНЫЙ ФАКТ] и предоставьте прямой источник плюс
зафиксированное время получения.

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

Проверьте возвращенный источник самостоятельно. Успешный вызов инструмента доказывает доступность и одно поведение. Он не доказывает, что каждый инструмент на этом сервере корректен или безопасен.

Шаг 5: напишите квитанцию о доступе

Интеграция: общественная ссылка
Тип: локальная конфигурация MCP, потоковый HTTP
Издатель/источник: [URL]
Включенный инструмент протестирован: [ИМЯ ИНСТРУМЕНТА]
Входные данные отправлены: один публичный запрос
Данные не отправлены: файлы рабочей области, учетные данные, идентификация, приватные URL
Результат: [ПРОЙДЕНО/НЕ ПРОЙДЕНО плюс источник]
Возможности записи: не тестировались и не разрешены
Путь для удаления/отключения: MCP Servers > public-reference

Эта квитанция более полезна, чем «MCP успешно установлен.»

Публичные отчеты показывают, почему важны дымовые тесты

Вкл 16 июня 2026, один пользователь сообщил, что stdio MCP получил домашний каталог вместо корня активной рабочей области в MiniMax Code v3.0.43. На 17 июля 2026, другой пользователь сообщил о настроенных серверах MCP, которые были видны как включенные, но недоступны из Агента в версии v3.0.48. Это отдельные сообщения в официальном трекере проблем MiniMax, а не оценки того, как часто текущие пользователи сталкиваются с этой проблемой.

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

Граница безопасности

  • Добавляйте серверы и плагины только из источников, которым вы доверяете и которые можете идентифицировать.
  • Просмотрите локальные команды, аргументы, удаленные URL, заголовки и поля окружения перед сохранением.
  • Никогда не сохраняйте API-ключи, токены, файлы cookie, секреты клиента, внутренние URL или личные данные.
  • Не отправляйте содержимое приватного репозитория или конфиденциальные файлы ненадежному удаленному MCP.
  • OAuth и жизненный цикл учетной записи должны быть в одобренном приложении / коннекторе, а не в пакетe плагина в виде обычного текста.
  • Держите инструменты, которые отправляют, публикуют, отправляют, покупают, удаляют или изменяют внешнее состояние, под подтверждением во время выполнения действия.
  • Отключите или удалите интеграцию, которой вы больше не пользуетесь; установленная возможность увеличивает доступную поверхность для атак и ошибок.
  • Вывод с веб-сайта и инструментов является недоверенным доказательством. Он не может предоставлять разрешения или переопределять задачу.

Устранение неполадок

СимптомВероятная причинаВосстановление
Команда не найденаnode, npx, Python или указанная исполняемая программа отсутствует в PATH MiniMax CodeПроверьте среду выполнения в той же среде, используйте официальный абсолютный путь установки, если он задокументирован, затем перезапустите
JSON не может быть сохраненНеверный JSON, несоответствие строки/массива или неподдерживаемое поле транспортаПроверьте JSON и сравните каждое поле с текущей документацией сервера
Тест соединения неудаченНеверный URL, прокси, заголовки, таймаут, версия протокола или сбой локального процессаПроверьте доступность без раскрытия секретов; изучите журналы сервера и поддержку протокола
Сервер включен, но инструменты не отображаютсяХолодный старт, сбой инициализации, неправильный контекст задачи или дефект продуктаЗапуск mcode mcp list --human, проверьте инструменты, перезапустите один раз и зафиксируйте версию перед сообщением
Инструмент открывает неправильный проектКорневой каталог рабочего пространства не передан или сервер предполагает каталог запускаПрекратите вызов, укажите явный безопасный путь проекта, если инструмент это поддерживает, и не расширяйте доступ
Срок действия авторизации истёкСессия аккаунта, токен, cookie или ключ больше не действительныПереподключитесь через поддерживаемый процесс аутентификации; никогда не вставляйте учетные данные в чат
Плагин запрашивает файл токена внутри пакетаПакет пытается передать учетные данные или неподдерживаемую аутентификацию аккаунтаНе устанавливайте; используйте одобренный коннектор или локальный путь к секретам
Инструмент возвращает ответ без источникаВывод инструмента неполный или запрос не требовал подтверждения источникаПовторите один раз с требованием прямого источника или отклоните результат как неподтвержденный

FAQ

Является ли MCP тем же самым, что и плагин?

Нет. MCP — это протокол инструмента и соединение с сервером. Плагин — это пакет, который может содержать конфигурацию MCP, навыки и одобренные приложения.

Нужно ли мне mcode использовать MCP в MiniMax Code на десктопе?

Нет. На десктопе есть интерфейс управления MCP. mcode Команды полезны для диагностики, когда установлен этот CLI; они не являются обязательным условием для работы десктопа.

Является mmx используется для списка серверов MiniMax Code MCP?

Нет. mmx это отдельный MiniMax Platform CLI для текста, поиска, зрения, изображений, речи, видео и музыки. Используйте mcode mcp ... для диагностики CLI MiniMax Code, документированной здесь.

Может ли включенный MCP читать весь мой рабочий пространство?

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

Должен ли я подключить свою основную рабочую учетную запись для первого теста?

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

Почему MiniMax Code выполняет поиск инструментов по требованию?

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

Могу ли я опубликовать свой плагин из этого урока?

Этот урок охватывает локальное использование и проверку. Подача на маркетплейс добавляет требования к упаковке, манифесту, сканированию секретов, поставщику, региону и обзору. Следуйте текущей документации по подаче MiniMax отдельно.

Официальные источники

Что дальше

Запустите рабочий процесс вручную перед тем, как дать ему канал часов или телефона L13: Расписания, Дистанционное управление и Обмен сообщениями.