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

托管服务现已推出。可自托管版本即将推出。你的 Agent 通过 Streamable HTTP 和 Bearer 令牌连接。

从你的客户端开始

使用连接指南设置客户端，或使用开发者指南了解身份验证、权限、入门示例和恢复操作。新用户可以在连接过程中创建账户并验证电子邮箱所有权。某些客户端需要单独配置；可用功能可能取决于账户方案和管理员设置。

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 文档。

Agent 连接流程

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 等）可以通过标准 OAuth 2.0 连接：Dynamic Client Registration、PKCE 和刷新令牌。请参阅 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 适配器

文档

• Agent 集成指南 - 任务范围的工作流、工具和模式
• 适用于 MCP 客户端的 OAuth - Dynamic Client Registration 流程

许可证

MIT。请参阅 LICENSE。