Настройка MCP-сервера PandaNpc для Claude Code и Codex

Обновлено

MCP-сервер PandaNpc подключает MCP-совместимого кодирующего агента к вашей базе знаний PandaNote, журналам работы, запланированным задачам, конфигурации моделей и Центру обслуживания агентов. Он полезен, когда агенту требуется долговременный контекст проекта вместо того, чтобы каждый раз начинать с пустого разговора.

Сервер работает локально через стандартный транспорт ввода/вывода MCP. Ваш MCP-клиент запускает процесс pandanpc-mcp при открытии сеанса; вам не нужно открывать порт или запускать отдельный веб-сервер.

Перед установкой

Вам понадобятся:

  • Node.js и npm, доступные в том же окружении, где работает MCP-клиент.
  • Учётная запись PandaNpc с доступом к адресу электронной почты, используемому для проверки.
  • Claude Code, OpenAI Codex, Cursor или другой клиент, поддерживающий локальные stdio MCP-серверы.

Если вы хотите, чтобы агент планировал работу на одном из ваших компьютеров, сначала установите и подключите PandaPaw. Инструменты для заметок и рабочего пространства не требуют онлайн-устройства PandaPaw.

Установка или обновление MCP-сервера

Установите пакет глобально в macOS, Linux или Windows:

bash
npm install -g @pandanpc/mcp-server

Убедитесь, что исполняемый файл виден вашей оболочке:

bash
pandanpc-mcp --help

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

Проверьте историю версий MCP-сервера, когда инструмент или его поведение отличается от старого скриншота или руководства.

Добавление PandaNpc в Claude Code

Самый надёжный способ — собственная команда конфигурации Claude Code. Используйте область пользователя (user scope), если вы хотите, чтобы PandaNpc был доступен в каждом проекте:

bash
claude mcp add --scope user pandanpc -- pandanpc-mcp

Вместо этого используйте --scope project, если конфигурация должна распространяться через текущий репозиторий, или --scope local, если она должна применяться только к вам в текущем проекте.

Проверьте зарегистрированный сервер:

bash
claude mcp get pandanpc
claude mcp list

Вы также можете настроить stdio-сервер вручную в конфигурации MCP, используемой вашей установкой Claude Code:

json
{
  "mcpServers": {
    "pandanpc": {
      "command": "pandanpc-mcp"
    }
  }
}

Добавление PandaNpc в OpenAI Codex

Codex может зарегистрировать тот же локальный процесс из командной строки:

bash
codex mcp add pandanpc -- pandanpc-mcp

Проверьте сохранённую конфигурацию:

bash
codex mcp get pandanpc
codex mcp list

Эквивалентная запись в ~/.codex/config.toml:

toml
[mcp_servers.pandanpc]
command = "pandanpc-mcp"

Перезапустите Codex или откройте новый сеанс после добавления сервера. Если вы ведёте собственный файл конфигурации Codex, поместите таблицу MCP в этот файл, а не дублируйте её в нескольких файлах.

Настройка Cursor и других MCP-клиентов

Для Cursor добавьте локальный сервер в ~/.cursor/mcp.json, используя ту же структуру JSON, что показана для Claude Code. Для Windsurf и других клиентов создайте stdio MCP-сервер, команда которого — pandanpc-mcp, а список аргументов пуст.

Исполняемый файл должен находиться в PATH, унаследованном графическим приложением. Если он работает в терминале, но настольный клиент сообщает «command not found», используйте абсолютный путь к исполняемому файлу, возвращаемый следующей командой:

bash
command -v pandanpc-mcp

В Windows PowerShell используйте:

powershell
Get-Command pandanpc-mcp

Вход из агента

PandaNpc использует двухэтапную проверку по электронной почте. Попросите агента выполнить эти действия по порядку:

  1. Вызовите note_login с вашим адресом электронной почты. PandaNpc отправит код проверки.
  2. Вызовите note_login ещё раз с тем же адресом электронной почты и кодом.

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

Проверка MCP-подключения

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

  1. Попросите его вызвать list_workspaces.
  2. Попросите его вызвать list_notes для одного рабочего пространства.
  3. Попросите его найти безобидное ключевое слово с помощью search_notes.

Успешный ответ доказывает, что MCP-клиент запустил процесс, аутентификация завершена и API учётной записи доступен. Для теста на запись создайте одноразовую заметку, а затем мягко удалите её.

Точный список инструментов, показываемый вашим MCP-клиентом, является источником истины для установленной версии. Инструменты сгруппированы вокруг следующих рабочих процессов:

Рабочий процесс Типичные инструменты Важное поведение
Заметки list_notes, create_note, read_note, update_note, search_notes update_note заменяет всё тело; читайте перед редактированием
Журналы работы save_done Автоматически сохраняет выполненную работу в папку сегодняшнего проекта
Рабочие пространства list_workspaces, create_workspace, update_workspace Привязанный путь проекта позволяет серверу найти нужное рабочее пространство
Запланированная работа list_scheduled_bridges, create_scheduled_task, list_scheduled_task_runs Машина PandaPaw должна быть онлайн; выражения cron используют шесть полей
Провайдеры и модели list_providers, list_models, инструменты создания/обновления/удаления Сначала получайте список, чтобы использовать актуальные идентификаторы и допустимые типы моделей
Правила и навыки sync_rules Синхронизирует поддерживаемые инструкции проекта, пропуская неизменённые файлы

Определения полей провайдеров и моделей см. в разделе Пользовательские AI-провайдеры и API-ключи. О границах учётных записей и биллинга см. Учётные записи PandaNpc, тарифы и стоимость API.

Безопасные методы работы

  • Начинайте с инструментов списка, чтения или поиска перед действиями создания, обновления, удаления или планирования.
  • Читайте заметку перед обновлением, потому что обновление заметки заменяет весь документ Markdown, а не применяет исправление.
  • Относитесь к запланированным промптам как к запросам на выполнение кода: подтверждайте целевую машину, рабочую директорию, часовой пояс и cron-выражение из шести полей.
  • Не помещайте API-ключи провайдеров в промпты и заметки. Вводите секреты только через предполагаемый поток конфигурации провайдера.
  • Проверяйте карточку одобрения инструмента MCP перед выполнением разрушительных или внешних действий.
  • Используйте save_done для журналов работы вместо ручного подбора правильного рабочего пространства и папки с датой.

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

Клиент сообщает, что `pandanpc-mcp` не найден

Откройте новый терминал после установки и проверьте путь к исполняемому файлу. Настольные приложения иногда наследуют более старый PATH; настройте абсолютный путь или перезапустите приложение. Если npm был установлен через менеджер версий, убедитесь, что MCP-клиент запускается под тем же пользователем и в том же окружении.

Сервер зарегистрирован, но инструменты не отображаются

Перезапустите клиент, затем проверьте claude mcp get pandanpc или codex mcp get pandanpc. Удалите и добавьте запись снова, если команда неверна. Также проверьте, что вы не настроили локальный stdio-процесс как HTTP-URL.

Инструменты сообщают, что вы не аутентифицированы

Повторите два вызова note_login. Используйте самый новый код проверки, проверьте папку спама и убедитесь, что оба вызова используют один и же адрес электронной почты.

Запланированные задачи не могут найти машину

Сначала вызовите list_scheduled_bridges. Если он не возвращает доступное устройство, проверьте статус PandaPaw и подключение устройства на целевой машине. Машина, которая выключена, спит, вышла из системы или отключена, не может запустить запланированный запуск.

Обновление заметки удалило существующий текст

update_note принимает полное тело замены. Восстановите заметку из её истории или корзины, где это доступно, затем прочитайте текущее содержимое и отправьте объединённый документ.

Нужна помощь по конкретной учётной записи? Свяжитесь с support@pandanpc.com и укажите имя MCP-клиента, операционную систему, версию пакета и точное сообщение об ошибке без секретов.