mcpField
P
ppl - Personal CRM for AI Agents

ppl - Personal CRM for AI Agents

远程服务
withppl.com生产力26 天前更新
代码仓库访问官网

关于 ppl - Personal CRM for AI Agents

ppl 是面向个人及其 AI 助手的 CRM，将联系人、对话笔记、生日和跟进事项集中管理。授权 Agent 可通过托管服务访问同一份关系记录。

主要功能

  1. 01保存联系人和对话笔记
  2. 02跟踪生日与跟进事项
  3. 03与获授权的助手共享记录
  4. 04通过托管 MCP 和 REST API 连接

适用场景

  1. 01在 AI 对话中保留关系信息
  2. 02让 Agent 准备联系人简报
  3. 03导入联系人前检查 CSV 文件

MCP 相关

托管的 MCP 服务位于 https://withppl.com/mcp，供已连接的客户端访问关系记录。Agent 使用 Streamable HTTP 和 Bearer token 连接；兼容客户端也支持 OAuth 2.0。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://withppl.com/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

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。

示例

文档

许可证

MIT。请参阅 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。