Claude Code と Codex 向けに PandaNpc MCP サーバーを設定する

更新日

PandaNpc MCP サーバーは、MCP 互換のコーディングエージェントを PandaNote ナレッジベース、作業ログ、スケジュール済みタスク、モデル設定、およびエージェントサービスセンターに接続します。エージェントが毎回空の会話から始めるのではなく、永続的なプロジェクトコンテキストを必要とする場合に便利です。

サーバーは MCP の標準入出力トランスポートを介してローカルで実行されます。MCP クライアントはセッションを開くと pandanpc-mcp プロセスを起動します。ポートを公開したり、別の Web サーバーを実行したりする必要はありません。

インストール前に

必要なもの:

  • MCP クライアントが実行される環境で Node.js と npm が利用可能であること。
  • 認証に使用するメールアドレスにアクセスできる 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 サーバーのバージョン履歴を確認してください。

Claude Code に PandaNpc を追加する

最も信頼性の高い方法は、Claude Code 独自の設定コマンドを使用することです。PandaNpc をすべてのプロジェクトで利用できるようにするには、ユーザースコープを使用します:

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

設定を現在のリポジトリ全体で共有する場合は --scope project を、現在のプロジェクトで自分だけに適用する場合は --scope local を使用します。

登録されたサーバーを確認します:

bash
claude mcp get pandanpc
claude mcp list

Claude Code のインストールで使用される MCP 設定に stdio サーバーを手動で設定することもできます:

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

OpenAI Codex に PandaNpc を追加する

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 の場合は、Claude Code に示したものと同じ JSON 形式を使用して、~/.cursor/mcp.json にローカルサーバーを追加します。Windsurf およびその他のクライアントの場合は、コマンドが pandanpc-mcp で引数リストが空の stdio MCP サーバーを作成します。

実行可能ファイルは、グラフィカルアプリケーションが継承する PATH 上に存在する必要があります。ターミナルでは動作するのにデスクトップクライアントが「command not found」と報告する場合は、次のコマンドで返される実行可能ファイルの絶対パスを使用してください:

bash
command -v pandanpc-mcp

Windows PowerShell では、次を使用します:

powershell
Get-Command pandanpc-mcp

エージェントからサインインする

PandaNpc は 2 段階のメール認証フローを使用します。エージェントに次の操作を順番に実行するよう依頼してください:

  1. メールアドレスを指定して note_login を呼び出します。PandaNpc が認証コードを送信します。
  2. 同じメールアドレスとコードを指定して、再度 note_login を呼び出します。

ローカル資格情報はキャッシュされるため、毎回のセッションでサインインする必要はありません。認証コードを公開のトランスクリプトや共有プロンプトに貼り付けないでください。

MCP 接続を確認する

エージェントにデータの作成や編集を許可する前に、小さな読み取り専用テストを実行します:

  1. list_workspaces を呼び出すように依頼します。
  2. 1 つのワークスペースに対して 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 式は 6 つのフィールドを使用します
プロバイダーとモデル list_providers, list_models、作成/更新/削除ツール 最初にリストを取得して、現在の ID と有効なモデルタイプを使用してください
ルールとスキル sync_rules 変更のないファイルをスキップしながら、サポートされているプロジェクトの指示を同期します

プロバイダーとモデルのフィールド定義については、カスタム AI プロバイダーと API Key を参照してください。アカウントと課金の境界については、PandaNpc アカウント、プラン、API コスト を参照してください。

安全な運用プラクティス

  • 作成、更新、削除、またはスケジュールアクションの前に、リスト、読み取り、または検索ツールから始めてください。
  • メモの更新はパッチを適用するのではなく Markdown ドキュメント全体を置き換えるため、更新する前にメモを読み取ってください。
  • スケジュールされたプロンプトはコード実行リクエストとして扱ってください: ターゲットマシン、作業ディレクトリ、タイムゾーン、6 フィールドの cron 式を確認します。
  • プロバイダーの API Key をプロンプトやメモに含めないでください。シークレットは、意図したプロバイダー設定フローでのみ入力してください。
  • 破壊的または外部アクションを許可する前に、MCP ツール承認カードを確認してください。
  • 正しいワークスペースと日付フォルダーを手動で推測する代わりに、作業ログには save_done を使用してください。

トラブルシューティング

クライアントが `pandanpc-mcp` が見つからないと表示する

インストール後、新しいターミナルを開いて実行可能ファイルのパスを確認してください。デスクトップアプリケーションは古い PATH を継承することがあります。絶対パスを設定するか、アプリケーションを再起動してください。npm がバージョンマネージャーを通じてインストールされている場合は、MCP クライアントが同じユーザーと環境で起動することを確認してください。

サーバーは登録されているがツールが表示されない

クライアントを再起動してから、claude mcp get pandanpc または codex mcp get pandanpc を確認してください。コマンドが間違っている場合は、エントリを削除して再度追加してください。また、ローカルの stdio プロセスを HTTP URL として設定していないことを確認してください。

ツールが未認証と表示する

2 つの note_login 呼び出しを繰り返してください。最新の認証コードを使用し、スパムフォルダーを確認し、両方の呼び出しで同じメールアドレスを使用していることを確認してください。

スケジュールされたタスクがマシンを見つけられない

最初に list_scheduled_bridges を呼び出してください。利用可能なデバイスが返されない場合は、ターゲットマシンで PandaPaw のステータスとデバイス接続 を確認してください。電源がオフ、スリープ中、サインアウト中、または切断されているマシンは、スケジュールされた実行を開始できません。

メモの更新で既存のテキストが削除された

update_note は完全な置換本文を受け入れます。可能な場合は履歴またはゴミ箱からメモを復元し、現在のコンテンツを読み取って結合したドキュメントを送信してください。

アカウント固有のヘルプが必要ですか? support@pandanpc.com にお問い合わせいただき、MCP クライアント名、オペレーティングシステム、パッケージバージョン、およびシークレットを含まない正確なエラーメッセージをお知らせください。