Konfiguracja serwera MCP PandaNpc dla Claude Code i Codex

Zaktualizowano

Serwer MCP PandaNpc łączy agenta kodującego zgodnego z MCP z Twoją bazą wiedzy PandaNote, dziennikami pracy, zaplanowanymi zadaniami, konfiguracją modeli i Agent Service Center. Jest przydatny, gdy agent potrzebuje trwałego kontekstu projektu zamiast zaczynać od pustej rozmowy za każdym razem.

Serwer działa lokalnie za pomocą standardowego transportu wejścia/wyjścia MCP. Klient MCP uruchamia proces pandanpc-mcp po otwarciu sesji; nie musisz otwierać portu ani uruchamiać osobnego serwera WWW.

Przed instalacją

Potrzebujesz:

  • Node.js i npm dostępne w tym samym środowisku, w którym działa klient MCP.
  • Konto PandaNpc z dostępem do adresu e-mail używanego do weryfikacji.
  • Claude Code, OpenAI Codex, Cursor lub inny klient obsługujący lokalne serwery MCP stdio.

Jeśli chcesz, aby agent planował pracę na jednym z Twoich komputerów, najpierw zainstaluj i podłącz PandaPaw. Narzędzia do notatek i obszarów roboczych nie wymagają urządzenia online PandaPaw.

Instalacja lub aktualizacja serwera MCP

Zainstaluj pakiet globalnie na macOS, Linux lub Windows:

bash
npm install -g @pandanpc/mcp-server

Potwierdź, że plik wykonywalny jest widoczny w Twojej powłoce:

bash
pandanpc-mcp --help

Uruchom to samo polecenie npm, gdy chcesz zaktualizować. Po aktualizacji uruchom ponownie klienta MCP, ponieważ już działający klient zachowuje wersję procesu, którą pierwotnie uruchomił.

Sprawdź historię wersji serwera MCP, gdy narzędzie lub jego zachowanie różni się od starszego zrzutu ekranu lub poradnika.

Dodawanie PandaNpc do Claude Code

Najbardziej niezawodną metodą jest własne polecenie konfiguracyjne Claude Code. Użyj zakresu użytkownika, jeśli chcesz, aby PandaNpc był dostępny w każdym projekcie:

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

Użyj --scope project, gdy konfiguracja ma być współdzielona przez bieżące repozytorium, lub --scope local, gdy ma dotyczyć tylko Ciebie w bieżącym projekcie.

Sprawdź zarejestrowany serwer:

bash
claude mcp get pandanpc
claude mcp list

Możesz także ręcznie skonfigurować serwer stdio w konfiguracji MCP używanej przez Twoją instalację Claude Code:

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

Dodawanie PandaNpc do OpenAI Codex

Codex może zarejestrować ten sam proces lokalny z wiersza poleceń:

bash
codex mcp add pandanpc -- pandanpc-mcp

Zweryfikuj zapisaną konfigurację:

bash
codex mcp get pandanpc
codex mcp list

Odpowiednik w ~/.codex/config.toml to:

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

Uruchom ponownie Codex lub otwórz nową sesję po dodaniu serwera. Jeśli prowadzisz niestandardowy plik konfiguracyjny Codex, umieść tabelę MCP w tym pliku, zamiast powielać ją w wielu plikach.

Konfiguracja Cursor i innych klientów MCP

Dla Cursor dodaj lokalny serwer do ~/.cursor/mcp.json, używając tego samego kształtu JSON, który pokazano dla Claude Code. Dla Windsurf i innych klientów utwórz serwer MCP stdio, którego poleceniem jest pandanpc-mcp, a lista argumentów jest pusta.

Plik wykonywalny musi znajdować się na PATH dziedziczonym przez aplikację graficzną. Jeśli działa w terminalu, ale klient desktopowy zgłasza „command not found”, użyj bezwzględnej ścieżki pliku wykonywalnego zwróconej przez następujące polecenie:

bash
command -v pandanpc-mcp

W systemie Windows PowerShell użyj:

powershell
Get-Command pandanpc-mcp

Logowanie z poziomu agenta

PandaNpc używa dwuetapowego przepływu weryfikacji e-mail. Poproś agenta o wykonanie tych czynności w kolejności:

  1. Wywołaj note_login z Twoim adresem e-mail. PandaNpc wyśle kod weryfikacyjny.
  2. Wywołaj note_login ponownie, używając tego samego adresu e-mail i kodu.

Poświadczenia lokalne są buforowane, więc nie powinieneś logować się podczas każdej sesji. Nigdy nie wklejaj kodu weryfikacyjnego do publicznego transkryptu ani wspólnego promptu.

Weryfikacja połączenia MCP

Przeprowadź mały test tylko do odczytu, zanim pozwolisz agentowi tworzyć lub edytować dane:

  1. Poproś go o wywołanie list_workspaces.
  2. Poproś go o wywołanie list_notes dla jednegoaru roboczego.
  3. Poproś go oyszukanie nieszkodliwego słowa kluczowego za pomocą search_notes.

Pomyślna odpowiedź potwierdza, że klient MCP uruchomił proces, uwierzytelnianie zakończyło się sukcesem, a interfejs API konta jest osiągalny. W teście zapisu utwórz jednorazową notatkę, a następnie wykonaj miękkie usunięcie.

Dokładna lista narzędzi wyświetlana przez klienta MCP jest źródłem prawdy dla zainstalowanej wersji. Narzędzia są pogrupowane wokół następujących przepływów pracy:

Przepływ pracy Typowe narzędzia Ważne zachowanie
Notatki list_notes, create_note, read_note, update_note, search_notes update_note zastępuje całą treść; przeczytaj przed edycją
Dzienniki pracy save_done Automatycznie przechowuje ukończoną pracę w dzisiejszym folderze projektu
Obszary robocze list_workspaces, create_workspace, update_workspace Powiązana ścieżka projektu pozwala serwerowi znaleźć właściwy obszar roboczy
Planowane zadania list_scheduled_bridges, create_scheduled_task, list_scheduled_task_runs Maszyna PandaPaw musi być online; wyrażenia cron używają sześciu pól
Dostawcy i modele list_providers, list_models, narzędzia create/update/delete Najpierw wyświetl listę, aby używać bieżących identyfikatorów i prawidłowych typów modeli
Reguły i umiejętności sync_rules Synchronizuje obsługiwane instrukcje projektu, pomijając niezmienione pliki

Definicje pól dostawców i modeli znajdziesz w sekcji Niestandardowi dostawcy AI i klucze API. Informacje o kontach i rozliczeniach znajdziesz w sekcji Konta PandaNpc, plany i koszty API.

Bezpieczne praktyki operacyjne

  • Zaczynaj od narzędzi listowania, odczytu lub wyszukiwania przed akcjami tworzenia, aktualizacji, usuwania lub planowania.
  • Przeczytaj notatkę przed jej zaktualizowaniem, ponieważ aktualizacje notatek zastępują cały dokument Markdown, a nie stosują poprawkę.
  • Traktuj zaplanowane prompty jak żądania wykonania kodu: potwierdź maszynę docelową, katalog roboczy, strefę czasową i sześciopolowe wyrażenie cron.
  • Trzymaj klucze API dostawców z dala od promptów i notatek. Wprowadzaj sekrety tylko przez przeznaczony do tego przepływ konfiguracji dostawcy.
  • Przejrzyj kartę zatwierdzania narzędzi MCP przed zezwoleniem na destrukcyjne lub zewnętrzne działania.
  • Używaj save_done do dzienników pracy zamiast ręcznego zgadywania właściwego obszaru roboczego i folderu daty.

Rozwiązywanie problemów

Klient zgłasza, że nie znaleziono `pandanpc-mcp`

Otwórz nowy terminal po instalacji i sprawdź ścieżkę pliku wykonywalnego. Aplikacje desktopowe czasami dziedziczą starszy PATH; skonfiguruj ścieżkę bezwzględną lub uruchom ponownie aplikację. Jeśli npm został zainstalowany za pomocą menedżera wersji, upewnij się, że klient MCP uruchamia się na tym samym użytkowniku i w tym samym środowisku.

Serwer jest zarejestrowany, ale nie pojawiają się żadne narzędzia

Uruchom ponownie klienta, a następnie sprawdź claude mcp get pandanpc lub codex mcp get pandanpc. Usuń i dodaj wpis ponownie, jeśli polecenie jest nieprawidłowe. Sprawdź również, czy nie skonfigurowałeś lokalnego procesu stdio jako adresu URL HTTP.

Narzędzia zgłaszają brak uwierzytelnienia

Powtórz dwa wywołania note_login. Użyj najnowszego kodu weryfikacyjnego, sprawdź folder spamu i potwierdź, że oba wywołania używają tego samego adresu e-mail.

Planowane zadania nie mogą znaleźć maszyny

Najpierw wywołaj list_scheduled_bridges. Jeśli nie zwróci żadnego dostępnego urządzenia, sprawdź status PandaPaw i łączność urządzenia na maszynie docelowej. Maszyna wyłączona, uśpiona, wylogowana lub rozłączona nie może rozpocząć zaplanowanego uruchomienia.

Aktualizacja notatki usunęła istniejący tekst

update_note przyjmuje pełną treść zastępczą. Przywróć notatkę z jej historii lub kosza, jeśli to możliwe, a następnie przeczytaj bieżącą treść i prześlij połączony dokument.

Potrzebujesz pomocy dotyczącej konkretnego konta? Skontaktuj się z support@pandanpc.com i podaj nazwę klienta MCP, system operacyjny, wersję pakietu oraz dokładny komunikat o błędzie bez sekretów.