ppl - Personal CRM for AI Agents

ppl

あなたと AI のための関係性の記憶。

ppl は、あなたと、あなたが選んだ AI アシスタントのためのパーソナル CRM です。連絡先、会話のメモ、誕生日、フォローアップをまとめて管理できます。ブラウザーで作業することも、アシスタントに同じ記録を使う権限を付与することもできます。

ppl、パーソナル CRM の選び方、または連絡先のインポートについてご覧ください。

ガイドと無料ツールでは、クライアントの設定、製品の比較、連絡先の移行について説明しています。まずは、お使いのクライアントに合わせたClaude、ChatGPT、Cursor、またはVS Codeのガイドをご覧ください。インポートする前に、ローカル CSV チェッカーを使うと、連絡先をアップロードせずにファイルのよくある問題を検出できます。ライターやディレクトリの管理者は、プレスキットで最新の製品情報、オリジナルのロゴ、公開スクリーンショットを利用できます。

開発者向けホーム：ppl-crm.github.io。アカウントを接続せずに、架空の関係性記憶デモをお試しください。

AI を接続する

ホスト型 MCP サーバー： https://withppl.com/mcp

ホスト型サービスは現在利用できます。セルフホスト版は近日公開予定です。エージェントは Bearer トークンを使い、Streamable HTTP 経由で接続します。

クライアントで始める

クライアントの設定については接続ガイドを、認証、権限、スターターレシピ、復旧については開発者ガイドをご覧ください。新規ユーザーは接続時にアカウントを作成し、メールアドレスの所有権を確認できます。一部のクライアントでは別途設定が必要です。また、利用できる機能はアカウントプランや管理者の設定によって異なる場合があります。

Codex CLI

Codex は、OAuth と Dynamic Client Registration による Streamable HTTP MCP サーバーに対応しています。ppl を追加してから、サインインしてください。

codex mcp add ppl --url https://withppl.com/mcp
codex mcp login ppl

または ~/.codex/config.toml に追加し、codex mcp login ppl を実行してください。

[mcp_servers.ppl]
url = "https://withppl.com/mcp"

ログインするとブラウザーで ppl が開き、アクセスを承認できます。ppl を初めて利用する場合は、無料アカウントを作成してください（無料ベータ版、連絡先は最大 1,000 件）。codex mcp list を実行するか、Codex TUI 内で /mcp を実行して、サーバーを確認してください。Codex MCP のドキュメントをご覧ください。

エージェントの接続フロー

1. {"client_name": "Your agent"} を指定して POST https://withppl.com/api/agent/connect/request を実行します。
2. approve_url をユーザーに提示します。ユーザーはサインインまたはアカウントを作成し、メールアドレスの所有権を確認して、要求された権限を確認します。
3. 承認されるまで、返された poll_url を適切な間隔でポーリングし、一度だけ使用できる api_token を保護された認証情報ストアに保存します。拒否または期限切れの場合は停止します。
4. MCP サーバーまたは REST API でトークンを使用します。

OAuth に対応した MCP クライアント（Claude、ChatGPT など）は、Dynamic Client Registration、PKCE、リフレッシュトークンを含む標準の OAuth 2.0 で接続できます。docs/oauth.mdをご覧ください。

機械可読な情報：ppl.json、llms.txt、および REST API の OpenAPI 仕様。

MCP レジストリ

公式 MCP レジストリに io.github.ppl-crm/ppl として登録されています。server.jsonをご覧ください。

例

• Python のブリーフィング例 - 依存関係のない REST クライアントと MCP SDK クライアント
• Node MCP クライアント - MCP TypeScript SDK を使った接続
• ppl-memory PyPI パッケージ - LangGraph、CrewAI、AutoGen のアダプター

ドキュメント

• エージェント統合ガイド - タスクごとのワークフロー、ツール、パターン
• MCP クライアント向け OAuth - Dynamic Client Registration のフロー

ライセンス

MIT。LICENSEをご覧ください。