HAP CRM MCP服务器
为AI代理构建的简单CRM 主控程序 服务器和网关通过 人体工程学协议.
@humanagencyp/crm-mcp —
______________________________________________________________________
它的作用
四个实体。十三个工具。一个数据库文件。
- 联系人 --与您互动的人（客户、潜在客户、合作伙伴、供应商）
- 活动 --发生了什么（电子邮件、电话、会议、笔记、购买）
- 交易 --正在进行什么（管道阶段、价值观、预期结束）
- 任务 --下一步是什么（与联系人或交易相关的跟进）
每个写入操作都通过HAP进行门控 customers 配置文件——您的代理只能在您授权的范围内创建联系人、记录活动或管理交易。
______________________________________________________________________
快速开始
使用HAP网关
CRM作为内置集成提供。首选 集成 在网关UI中，激活 客户关系管理，你就完了。无需配置。
独立
npx @humanagencyp/crm-mcp@latest这将使用SQLite数据库启动MCP服务器 ~/.hap/crm.db.
对于Postgres：
DATABASE_URL=postgres://user:pass@host:5432/mydb npx @humanagencyp/crm-mcp@latest______________________________________________________________________
工具
联系人
| 工具 | 说明 |
|---|---|
create_contact | 创建新联系人（姓名、电子邮件、电话、公司、角色、类型、阶段、标签） |
find_contacts | 按姓名、电子邮件、公司、类型或阶段搜索 |
update_contact | 更新任何联系人字段 |
delete_contact | 删除联系人和所有相关活动、交易、任务 |
活动
| 工具 | 说明 |
|---|---|
log_activity | 记录互动（电子邮件、电话、会议、笔记、购买） |
get_timeline | 获取联系人的活动历史记录 |
交易
| 工具 | 说明 |
|---|---|
create_deal | 创建交易（标题、价值、货币、阶段、预期成交） |
update_deal | 更新交易阶段、价值或其他字段 |
get_pipeline | 按阶段查看交易 |
任务
| 工具 | 说明 |
|---|---|
create_task | 创建与联系人或交易链接的任务 |
list_tasks | 按状态、联系人、交易或受让人列出任务 |
complete_task | 将任务标记为已完成 |
出口
| 工具 | 说明 |
|---|---|
export_crm | 所有联系人、活动、交易、任务的完整JSON导出 |
______________________________________________________________________
数据库
SQLite（默认） --零配置。数据存储在 ~/.hap/crm.db.自动备份到 crm.backup.db 每天。
Postgres --set DATABASE_URL 连接字符串。适用于需要多个网关共享访问的团队。
架构在首次启动时自动创建。
______________________________________________________________________
HAP简介
此服务器通过 customers 轮廓：
- 边界 —
contact_create_daily_max,contact_modify_daily_max,activity_create_daily_max,deal_create_daily_max - 上下文 —
contact_type（客户、潜在客户、合作伙伴、供应商），access_level（读、写） - 路径 —
customers-read（24小时），customers-write（8h），customers-delete（2小时）
______________________________________________________________________
许可证
麻省理工学院
看 humanagencypotocol.org 以获取完整的协议规范。