Heyreach MCP

HeyReach多客户端MCP服务器

一个可扩展的模型上下文协议（MCP）服务器，用于管理多个HeyRach客户端帐户。使用简单的基于JSON的配置系统，可以轻松地从3个客户端扩展到100多个客户端。

特性

• ✅ 多客户端支持：从单个MCP服务器管理多个HeyReach帐户
• ✅ 易于扩展：只需更新JSON配置文件即可添加新客户端
• ✅ 基于客户端的路由：根据客户端名称自动将请求路由到正确的API密钥
• ✅ 简单管理：用于添加、删除和更新客户端的命令行工具
• ✅ 默认客户端支持：当未指定客户端时，为操作设置默认客户端

安装

1. 安装Python依赖项：

pip install -r requirements.txt

1. 设置您的配置：

编辑 config.json 您的客户信息：

{
  "clients": {
    "Client1": {
      "mcp_key": "your_mcp_key_here",
      "mcp_url": "https://mcp.heyreach.io/your_workspace_id"
    },
    "Client2": {
      "mcp_key": "your_mcp_key_here",
      "mcp_url": "https://mcp.heyreach.io/your_workspace_id"
    }
  },
  "default_client": "Client1"
}

获取HeyReach MCP密钥

对于每个客户：

1. 导航到HeyRach工作区
2. 首选 集成 > HeyReach MCP服务器
3. 如果需要，生成新的MCP密钥
4. 复制MCP连接URL和密钥
5. 将它们添加到您的 config.json

用法

运行MCP服务器

启动MCP服务器：

python mcp_server.py

或者，如果使用stdio传输（在MCP客户端中很常见）：

python -m mcp_server

管理客户

交互模式

运行交互式菜单的无参数管理脚本：

python manage_clients.py

命令行

添加新客户端：

python manage_clients.py add ClientName "mcp_key_here" "mcp_url_here"

列出所有客户：

python manage_clients.py list

删除客户端：

python manage_clients.py remove ClientName

设置默认客户端：

python manage_clients.py set-default ClientName

更新客户端配置：

python manage_clients.py update ClientName --mcp-key "new_key" --mcp-url "new_url"

与Claude（或其他MCP客户端）一起使用

MCP服务器运行后，您可以通过Claude与之交互：

示例1：列出Client1的所有活动

"List all campaigns for Client1"

示例2：为Client2创建活动

"Create a new campaign called 'Q4 Outreach' for Client2"

示例3：为Client3发送消息

"Send a message to John Doe for Client3 with the content 'Hello, interested in connecting!'"

示例4：获取Client1的统计信息

"Get statistics for Client1 for the last month"

MCP服务器将自动：

1. 从请求中解析客户端名称
2. 在中查找相应的API密钥 config.json
3. 将请求路由到正确的HeyReach帐户

可用工具

MCP服务器提供以下工具：

• list_clients -列出所有已配置的客户端
• get_client_info -获取特定客户的信息
• heyreach_campaign_list -为客户列出活动
• heyreach_campaign_create -为客户创建新活动
• heyreach_send_message -通过HeyReach为客户发送消息
• heyreach_get_statistics -获取客户的统计数据/报告
• set_default_client -设置操作的默认客户端

扩展到100多个客户

添加新客户端很简单：

1. 选项1：使用管理脚本

   python manage_clients.py add NewClient "new_mcp_key" "new_mcp_url"

1. 选项2：直接编辑config.json

只需在 clients 对象：

   "NewClient": {
     "mcp_key": "new_mcp_key",
     "mcp_url": "new_mcp_url"
   }

服务器将自动接收新客户端，无需重新启动。

配置文件结构

{
  "clients": {
    "ClientName": {
      "mcp_key": "your_mcp_key",
      "mcp_url": "https://mcp.heyreach.io/workspace_id"
    }
  },
  "default_client": "ClientName"
}

• clients：将客户端名称映射到其配置的对象
• default_client：默认客户端的名称（未指定客户端时使用）

安全最佳实践

1. 永不承诺 config.json 到版本控制 -添加到 .gitignore
2. 使用环境变量 对于敏感密钥（考虑扩展代码以支持此功能）
3. 限制文件权限 上 config.json （例如。， chmod 600 config.json)
4. 使用安全保险库 用于生产部署

工作流示例

初始设置（3个客户端）

# Add your first 3 clients
python manage_clients.py add Client1 "key1" "url1"
python manage_clients.py add Client2 "key2" "url2"
python manage_clients.py add Client3 "key3" "url3"

# Set Client1 as default
python manage_clients.py set-default Client1

# Verify setup
python manage_clients.py list

添加更多客户端（扩展到100+）

随着您的成长，只需添加更多客户：

# Add clients 4-10
for i in {4..10}; do
  python manage_clients.py add "Client$i" "key$i" "url$i"
done

# Or add them individually
python manage_clients.py add Client50 "key50" "url50"

所有客户端都能立即工作，无需更改代码！

故障排除

错误：“找不到客户端'ClientName'”

• 验证客户端是否存在于 config.json
• 使用 python manage_clients.py list 查看所有可用客户端

错误：“MCP密钥未配置”

• 确保客户端输入 config.json 具有有效 mcp_key 领域
• 在HeyReach中检查密钥是否正确

错误：“找不到配置文件”

• 创建 config.json 至少有一个空的客户端对象
• 或者跑 python manage_clients.py add 自动创建它

发展

要使用其他HeyReach API端点扩展服务器，请执行以下操作：

1. 将新工具添加到 list_tools() 功能在 mcp_server.py
2. 在中实现处理程序 call_tool() 函数
3. 使用 make_heyreach_request() 使用正确的API键路由请求的助手函数

许可证

MIT许可证-可根据需要自由修改和使用。

支持

有关特定于HeyReach的API问题，请参阅 HeyReach MCP文档.