潜在客户管理服务器

GetProspect MCP Server 是一个为潜在客户生成平台提供模型上下文协议的服务器,支持AI助手搜索潜在客户、查找电子邮件、管理联系人并与CRM系统交互。

  • by jacob-hartmann
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jacob-hartmann/getprospect-mcp

使用说明

获取spect MCP服务器

A. 模型上下文协议 (MCP)服务器 获取spect 潜在客户开发平台。使Claude等AI助手能够搜索潜在客户、查找电子邮件、管理联系人,并与您的GetProspect CRM进行交互。

特性

  • 电子邮件发现 --验证电子邮件,按姓名+公司查找电子邮件,通过电子邮件查找联系人
  • 潜在客户搜索 --使用丰富的过滤器(职位、资历、行业、地点)搜索潜在客户和公司
  • 联系人管理 --CRM联系人与物业支持的完整CRUD
  • 公司管理层 --CRM公司的完整CRUD
  • 列表管理 --创建、更新、删除列表;添加/删除联系人
  • LinkedIn丰富 --通过LinkedIn URL丰富联系人
  • 工作区属性 --浏览工作区中的所有自定义属性
  • 双重运输 --支持stdio和HTTP(流式HTTP)传输

安装

使用npx(推荐)

npx getprospect-mcp

使用npm

npm install -g getprospect-mcp
getprospect-mcp

配置

环境变量

变量 必填 描述
GETPROSPECT_API_KEY 是 API密钥来自 获取spect设置
MCP_TRANSPORT 否 运输方式: stdio (默认)或 http
MCP_SERVER_HOST 否 HTTP服务器主机(默认值: 127.0.0.1)
MCP_SERVER_PORT 否 HTTP服务器端口(默认值: 3000)

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "getprospect": {
      "command": "npx",
      "args": ["-y", "getprospect-mcp"],
      "env": {
        "GETPROSPECT_API_KEY": "your-api-key-here"
      }
    }
  }
}

工具

工具 说明
getprospect.validate 验证API密钥和连接
getprospect.email.verify 验证电子邮件的可送达性
getprospect.email.find 按姓名和公司查找电子邮件
getprospect.email.lookup 通过电子邮件地址查找联系人
getprospect.search.leads 使用过滤器搜索潜在客户
getprospect.search.companies 使用筛选器搜索公司
getprospect.search.linkedin 通过LinkedIn URL丰富联系方式
getprospect.search.fast 快速搜索联系人和公司
getprospect.contacts.search 搜索CRM联系人
getprospect.contacts.get 获取特定联系人
getprospect.contacts.create 创建新联系人
getprospect.contacts.update 更新联系人
getprospect.contacts.delete 删除联系人
getprospect.contacts.addCompanies 将公司链接到联系人
getprospect.companies.search 搜索CRM公司
getprospect.companies.get 找一家特定的公司
getprospect.companies.create 创建新公司
getprospect.companies.update 更新公司
getprospect.companies.delete 删除公司
getprospect.lists.list 列出所有联系人列表
getprospect.lists.create 创建新列表
getprospect.lists.update 更新列表
getprospect.lists.delete 删除列表
getprospect.lists.sizes 获取每个列表的联系人数量
getprospect.lists.addContacts 将联系人添加到列表中
getprospect.lists.contacts 在列表中获取联系人
getprospect.properties.list 列出所有工作区属性

资源

资源 URI 描述
列表 getprospect://lists 所有联系人列表
列出联系人 getprospect://lists/{id}/contacts 特定列表中的联系人
物业 getprospect://properties 所有工作区属性

提示

提示 描述
find-leads 搜索潜在客户的指导性工作流程
enrich-contact 丰富联系人的指导性工作流程
setup-api-key API密钥配置说明

发展

# Install dependencies
pnpm install

# Run in development mode (stdio)
pnpm run dev

# Run in development mode (HTTP)
pnpm run dev:http

# Run checks
pnpm run check

# Build
pnpm run build

调试

您可以使用 MCP检查员 要调试服务器,请执行以下操作:

# Run from source
pnpm inspect

# Run from built output
pnpm inspect:dist

pnpm inspect 负载 .env 自动通过 dotenv (参见 .env.example).

故障排除

缺少API密钥

如果您看到身份验证错误,请确保 GETPROSPECT_API_KEY 在您的环境或MCP客户端配置中设置正确。您可以在以下位置生成密钥 GetProspect API设置.

余额不足

GetProspect操作(如潜在客户搜索和电子邮件查找)会消耗积分。如果请求失败并出现信用错误,请在GetProspect仪表板中检查您的剩余余额,并在需要时升级您的计划。

速率限制

GetProspect API强制执行速率限制。如果你收到 429 响应,减少请求的频率。服务器将返回错误详细信息,以便您在指定的等待期后重试。

使用MCP检查器进行调试

如果工具没有按预期运行,请使用MCP检查器直接发送请求并检查原始响应:

pnpm inspect

这将启动一个交互式UI,您可以在其中调用单个工具、查看请求/响应有效负载和诊断问题。

贡献

欢迎投稿!请见 贡献.md 了解如何为这个项目做出贡献的指导方针。

安全

看 安全.md 用于安全策略和报告漏洞。

支持

这是一个“按原样”提供的社区项目 没有保证的支持。参见 支持.md 了解详情。

许可证

麻省理工学院©雅各布·哈特曼