Налаштування MCP-сервера PandaNpc для Claude Code та Codex

Оновлено

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

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

Перед встановленням

Вам знадобляться:

  • Node.js і npm, доступні в тому ж середовищі, де працює MCP-клієнт.
  • Обліковий запис PandaNpc із доступом до електронної адреси, яка використовується для підтвердження.
  • Claude Code, OpenAI Codex, Cursor або інший клієнт, що підтримує локальні MCP-сервери stdio.

Якщо ви хочете, щоб агент планував роботу на одному з ваших комп'ютерів, спочатку встановіть і підключіть 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. Використовуйте область користувача, якщо ви хочете, щоб 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, інструменти створення/оновлення/видалення Спочатку перелічіть, щоб використовувати актуальні ID і дійсні типи моделей
Правила та навички sync_rules Синхронізує підтримувані інструкції проєкту, пропускаючи незмінені файли

Для визначення полів провайдера та моделі дивіться Власні AI-провайдери та API-ключі. Для меж облікових записів і оплати дивіться Облікові записи, плани та вартість API PandaNpc.

Безпечні практики роботи

  • Починайте з інструментів списку, читання або пошуку перед діями створення, оновлення, видалення чи планування.
  • Читайте нотатку перед оновленням, оскільки оновлення нотаток замінює весь документ 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-клієнта, операційну систему, версію пакунка та точний текст помилки без секретів.