PatchX Freenote Agent

Help me connect PatchX Freenote MCP and install the PatchX Freenote MCP Skill when the client supports Agent Skills. Use the production service at https://freenote.patch-x.cn/ and the setup page at https://freenote.patch-x.cn/mcp/setup/; if existing configuration explicitly points to the old test service, update the server address used for this connection to production first. First, if this is a local command-capable environment, run npx -y patchxnote-agent@latest skill install on this machine so future or long sessions remember the PatchX Freenote SOP; if the current client does not support Skill installation, do not treat that as a connection blocker and continue with MCP setup according to the client's capabilities. Identify the MCP client you are running in: if this is a local MCP client such as Codex, Cursor, VS Code, Claude Desktop, Claude Code, or Windsurf, run npx -y patchxnote-agent@latest setup --client <client-id> on this machine in the same OS/runtime that will later launch the MCP server. If this is an AI client or cloud platform that cannot run local commands but supports Remote MCP, custom connectors, custom MCP services, or tool plugins, create a custom MCP connector named PatchX Freenote MCP and connect it with this PatchX Freenote Remote MCP URL: https://freenote.patch-x.cn/mcp. If you are not sure which client ID or config format to use, local clients should first run npx -y patchxnote-agent@latest mcp config and use the printed generic stdio config, while remote clients should look for a Remote MCP Server URL, MCP Server URL, or Custom Connector setup entry. For login, open the browser and let me complete PatchX Freenote phone-code authorization there; do not ask me to paste OTP codes, OAuth codes, authorization codes, access tokens, refresh tokens, or webhook secrets into chat. After setup, call patchxnote_get_current_user and patchxnote_list_memories with {"platform":"mobile","limit":5} to verify it works. References: https://github.com/ZsTs119/patchx-freenote-agent and https://patchx2025.feishu.cn/wiki/PnVRwYT7IirFPckairGcWPnHnCd

便利なスキルインストーラーのオプション：

インストーラーは冪等です。既存の patchxnote-mcp ディレクトリの内容が異なり、このパッケージによって管理されていない場合、--force が指定されていない限り上書きを拒否します。管理対象のインストールには、パッケージのバージョンとソースハッシュを含む .patchxnote-agent-skill.json が含まれます。

標準の skills CLI を使用する場合、この Codex の例では GitHub から現在のプロジェクトにインストールします。インストールするのはスキルであり、MCP 接続ではありません。上記の方法と、npm パッケージに同梱されたインストール方法のどちらかを選んでください。

npx -y skills add ZsTs119/patchx-freenote-agent --skill patchxnote-mcp --agent codex --yes

ローカルセットアップでは、以下のクライアント ID に対応しています：

vscode, cursor, codex, claude-code, claude-desktop, windsurf, trae, qoder, workbuddy

vscode、cursor、codex、claude-desktop、windsurf は、確認後にローカル設定ファイルを書き込めます。V1 では、claude-code、trae、qoder、workbuddy に対して、手動コマンドまたはコピー可能な設定を返します。Feishu Aily、Doubao Work Partner、Tencent Agent Development Platform、エンタープライズ版 WorkBuddy などのプラットフォームクライアントでは、ローカルの npx ではなく、ホストされたリモート MCP ゲートウェイとプラットフォームコンソールでの承認が必要です。

便利なセットアップフラグ：

patchxnote setup --client cursor --dry-run --print-config
patchxnote setup --client cursor --yes
patchxnote setup --client cursor --no-browser
patchxnote setup --all-local-supported --dry-run
patchxnote setup --client cursor --output json

後で MCP を起動する環境と同じ OS／ランタイムでセットアップを実行してください。たとえば、Windows のデスクトップエディターでは Windows 資格情報マネージャーの認証情報が必要です。一方、WSL またはリモートの VS Code セッションでは、その Linux ランタイム内の認証情報が必要です。

汎用のローカル stdio MCP ホストでは、次のコマンドで出力される純粋な JSON を使用してください：

npx -y patchxnote-agent@latest mcp config

デフォルトの設定は次のようになります：

{
  "mcpServers": {
    "patchxnote": {
      "command": "npx",
      "args": ["-y", "patchxnote-agent@latest", "mcp", "serve"]
    }
  }
}

クライアントによっては、type: "stdio" のようなラッパー固有のフィールドや、異なるトップレベルキーが必要な場合がありますが、command と args は変わりません。クライアントが npx を拒否する場合、コールドスタートが遅いとプロセスを終了する場合、または許可リストに登録された絶対パスが必要な場合は、次のコマンドで出力される代替設定を使用してください：

npx -y patchxnote-agent@latest install --print-config

代替設定では、インストール済みのバイナリパスを使用します：

{
  "mcpServers": {
    "patchxnote": {
      "command": "/absolute/path/to/patchxnote",
      "args": ["mcp", "serve"]
    }
  }
}

アカウントと記録の検索

Webhook の設定と送信

AI 結果の確認

記録ツールでは、明示的な platform 引数として mobile または desktop を指定する必要があります。記録一覧には、正式に保存された結果に加え、サーバーにモデル IO データがある場合は読み取り可能なモデル生成出力も含まれます。patchxnote model-io list は引き続き、リクエスト ID の検索やタスクまたは状態による絞り込みに使用する、より低レベルの AI 処理一覧です。

Webhook の MCP ツールは、CLI と同じローカル設定、キーチェーン、テンプレート、送信モジュールを共有します。完全な Webhook URL や署名シークレットは返しません。また、送信呼び出しが外部へのネットワークリクエストを実行するのは、MCP クライアントが送信ツールを明示的に呼び出した場合のみです。

AI 結果ツールは、明示的な確認用ツールです。ログイン中のユーザーのソーステキストや AI ペイロードが公開される可能性があるため、信頼できるローカル MCP ホストからのみ使用してください。大きなフィールドは、明示的に指定したローカルの out ファイルに書き込んでください。

以下の例は、それぞれ独立したコマンドです。タスクに応じた操作を選択してください。上から順に実行する一連のスクリプトではありません。

ブラウザー MCP のログインとローカル MCP サービス：

patchxnote version
patchxnote mcp login
patchxnote mcp status
patchxnote mcp config
patchxnote setup --client cursor
patchxnote mcp serve

ターミナル CLI のログイン：

patchxnote login
patchxnote auth status

AI 処理の実行一覧を表示して、結果をエクスポートする：

patchxnote model-io list --platform mobile
patchxnote model-io source-text --request-id <request_id> --platform mobile --out ./source.txt
patchxnote model-io provider-response --request-id <request_id> --platform mobile --out ./provider-response.json
patchxnote model-io parsed-result --request-id <request_id> --platform mobile --out ./parsed-result.json
patchxnote model-io packaged-result --request-id <request_id> --platform mobile --out ./packaged-result.json
patchxnote model-io export --request-id <request_id> --platform mobile --out ./model-io.json

より低レベルの AI 処理実行が必要な場合は、patchxnote model-io list --platform mobile|desktop から request_id を取得してください。MCP の patchxnote_list_memories は、レコードのレンダリング、下書き、Webhook ワークフロー、モデル IO フィールドツール向けに id と platform を返します。モデル生成エントリーの場合、この id は request_id と同じ値になることがあります。

Webhook を設定して送信する：

patchxnote webhook set "Product Feishu" --type feishu --url-stdin
patchxnote webhook list
patchxnote webhook test "Product Feishu"
patchxnote webhook draft --memory-id <memory_id> --platform mobile --out ./patchxnote-drafts/example
patchxnote webhook send --target "Product Feishu" --file ./message.md
patchxnote webhook send --target "Product Feishu" --draft ./patchxnote-drafts/example
patchxnote webhook remove "Product Feishu"

便利なグローバルフラグ：

--server-base-url <url>   PatchX Freenote API base URL
--profile <name>          local profile name
--output json             machine-readable output where supported
--config <path>           non-secret config file path

npm パッケージは、小規模なインストーラー／ランチャーのラッパーです：

npx -y patchxnote-agent@latest mcp login
npx -y patchxnote-agent@latest mcp status
npx -y patchxnote-agent@latest mcp config
npx -y patchxnote-agent@latest mcp serve
npx -y patchxnote-agent@latest skill install
npx -y patchxnote-agent@latest login
npx -y patchxnote-agent@latest setup --client cursor
npx -y patchxnote-agent@latest install
npx -y patchxnote-agent@latest update

Webhook URL と、オプションの Feishu／DingTalk 署名シークレットは、非シークレット設定ファイルではなく、ローカルのセキュアな認証情報ストアに保存されます。--url-stdin と --secret-stdin を使うと、シェルの履歴に残りません。CLI と MCP による Webhook 送信は手動のみで、リダイレクトには従わず、プロバイダーのエラーをそのまま表示します。

AI 処理をすべてエクスポートするには、patchxnote model-io export を推奨します。patchxnote webhook export-model-io も互換性のため引き続き利用できます。

バージョン 0.2.12 以降では、本番環境がデフォルトになります。既存の明示的な --server-base-url フラグ、PATCHXNOTE_SERVER_BASE_URL／旧 PATCHNOTE_SERVER_BASE_URL 環境変数、および server.base_url 設定値はこのデフォルトを上書きします。ターミナルと MCP ホスト設定の両方で、テストサーバーへの上書きを更新するか削除してください。

MCP を起動する OS／ランタイムおよびプロファイルと同じ環境で mcp login を実行し、次に mcp status --verify を確認してください。OAuth 認証情報はサーバーアドレスに紐付けられているため、テスト環境でのログインでは本番環境に認証されません。この更新によってテストアカウントやレコードが移行されることはありません。両方の環境を維持するには、別々のプロファイルを使用し、それぞれに明示的なベース URL を指定してください。

0.2.15 の主な変更点

• GitHub オーナー名の大文字・小文字を保持するよう、MCP Registry の名前空間を修正しました：io.github.ZsTs119/patchxnote-agent。
• mcp serve の起動引数を追加し、公開前にリリースメタデータを検証します。
• 既存のランタイム動作と Skill のライセンスを維持します。

0.2.13 の主な変更点

• README、npm、同梱の Skill、マーケットプレイス向けの説明文で、英語と中国語のセットアッププロンプトを統一しました。
• 本番サービス、Remote MCP エンドポイント、セットアップページ、App のダウンロード URL を明記しました。切り替え時には、既存のテスト用アドレスのオーバーライドを更新する必要があります。
• npm とプラグインのホームページメタデータを本番のセットアップページに変更し、現在のガイダンスでは古いドメイン案を廃止しました。

0.2.12 の主な変更点

• 本番 API https://freenote.patch-x.cn をデフォルトにしました。ホスト型 MCP では https://freenote.patch-x.cn/mcp を使用します。
• テスト環境向けに、明示的なサーバーフラグ、環境変数、設定ファイルによるオーバーライドを引き続き利用できます。
• 本番環境への再ログインと、既存のテストサーバー設定の移行について記載しました。

0.2.11 の主な変更点

• 正式版の PatchX Freenote MCP Skill を npm パッケージに同梱しました。
• 別途 Skills CLI や GitHub のクローンに頼らず、npm から Skill をインストールできる npx -y patchxnote-agent@latest skill install を追加しました。
• Skill のインストールを冪等にし、管理対象マーカーを記録するようにしました。また、--force を明示的に使用しない限り、手動で編集された Skill フォルダーを保護します。
• Skill パッケージの同期と検証を拡張し、OpenAI、Claude、npm の各コピーが skills/patchxnote-mcp/ と完全に同一であることを確認します。
• 1 行のセットアッププロンプトとディスカバリメタデータを更新し、npm に同梱された Skill インストーラーを優先するようにしました。MCP のセットアップ、ブラウザー OAuth、ツールの検証は引き続き行います。

0.2.10 の主な変更点

• 互換性のある AI クライアントが、新しいセッションや長時間のセッションでもセットアップと使用の SOP を維持できるよう、再利用可能な PatchX Freenote MCP Skill を skills/patchxnote-mcp/ に追加しました。
• OpenAI/Codex、Claude Code、Agent Skills、MCP Registry、Smithery、サードパーティディレクトリ向けのドラフト作成および掲載用資料を追加しました。
• server.json と package.json#mcpName による MCP Registry のメタデータに加え、リリースの証跡用にローカル検証スクリプトと stdio のスモークテストスクリプトを追加しました。
• Skill がサポートされている場合はエージェントがインストールしてから、MCP のセットアップ、ブラウザー OAuth、ツールの検証を実行するよう、1 行のセットアッププロンプトを更新しました。その際、チャットへのコードやトークンの貼り付けをユーザーに求めません。