梅塔尔弗雷德·麦克普
MCP服务器 遇见阿尔弗雷德 --LinkedIn自动化活动监控、潜在客户管理、回复跟踪、消息传递、标签管理、活动CRUD和社交帖子调度。
特性
- 活动监控 --列表、筛选、暂停/恢复、重命名、克隆、存档活动
- 潜在客户管理 --获取潜在客户、添加到活动、标记、排除、返回活动
- 回复跟踪 --拉取回复、查看对话线程、发送消息
- 标签管理 --标签的完整CRUD操作(创建、列表、更新、删除)
- 潜在客户标签 --在单个潜在客户或批量添加/设置标签
- 社交帖子调度 --创建、更新、重新安排、存档和删除LinkedIn帖子
- 动态消息 --查看所有渠道的最近帐户操作
- 通知 --检查未读计数
- 团队可见性 --列出团队成员及其关系
- 用户资料 --获取当前经过身份验证的用户信息
- 白标支持 --自定义实例的可配置基本URL
双API体系结构
此服务器使用 两个MeetAlfred API层:
| 层 | 身份验证 | 必需 | 功能 |
|---|
| Webhook API | MEETALFRED_API_KEY | 是 | 活动、潜在客户、回复、联系、活动(阅读量大) |
| 内部API | MEETALFRED_JWT_TOKEN | 否 | 标签CRUD、活动管理、消息传递、潜在客户操作、发布计划、通知 |
webhook API提供核心读取操作。内部API(可选)支持完整的CRUD、消息传递和更丰富的数据。两者同时工作。
安装
pip install meetalfred-mcp
或者从源代码安装:
git clone https://github.com/cphoskins/meetalfred-mcp.git
cd meetalfred-mcp
pip install -e .
配置
获取API密钥
- 登录MeetAlfred
- 首选 设置>集成>Webhooks
- 生成API密钥
获取您的JWT令牌(可选,用于内部API)
- 在浏览器中登录MeetAlfred
- 打开DevTools>应用程序>Cookie
- 复制
token cookie值
克劳德代码
添加到您的 .claude/settings.json 或项目 .mcp.json:
{
"mcpServers": {
"meetalfred": {
"command": "meetalfred-mcp",
"env": {
"MEETALFRED_API_KEY": "your-api-key-here",
"MEETALFRED_JWT_TOKEN": "your-jwt-token-here"
}
}
}
}
白标实例
如果您使用的是白色标签MeetAlfred实例,请设置基本URL:
{
"mcpServers": {
"meetalfred": {
"command": "meetalfred-mcp",
"env": {
"MEETALFRED_API_KEY": "your-api-key-here",
"MEETALFRED_JWT_TOKEN": "your-jwt-token-here",
"MEETALFRED_BASE_URL": "https://api.your-instance.com/api/integrations/webhook",
"MEETALFRED_API_BASE_URL": "https://api.your-instance.com/api/v1"
}
}
}
}
克劳德桌面版
添加 claude_desktop_config.json:
{
"mcpServers": {
"meetalfred": {
"command": "python",
"args": ["-m", "meetalfred_mcp.server"],
"env": {
"MEETALFRED_API_KEY": "your-api-key-here",
"MEETALFRED_JWT_TOKEN": "your-jwt-token-here"
}
}
}
}
工具
Webhook API(需要 MEETALFRED_API_KEY)
| 工具 | 说明 |
|---|
get_campaigns | 按类型列出活动(活动、草稿、存档、全部) |
get_leads | 获取包含活动和人员详细信息的潜在客户 |
add_lead | 在活动中添加新的潜在客户(需要LinkedIn URL) |
get_replies | 从各个营销活动的潜在客户那里获取回复消息 |
get_connections | 使用完整的个人资料数据获取LinkedIn连接 |
get_team_members | 列出团队成员(需要团队所有者访问权限) |
get_member_connections | 在团队成员之间建立联系 |
get_last_actions | 按类型获取最近的活动(邀请、接受、消息、回复等) |
内部API-标签(需要 MEETALFRED_JWT_TOKEN)
| 工具 | 说明 |
|---|
get_all_tags | 获取所有标签(无分页) |
list_tags | 带分页和排序的列表标签 |
create_tag | 创建新标签 |
update_tag | 重命名现有标记 |
delete_tag | 删除标签 |
内部API-活动(需要 MEETALFRED_JWT_TOKEN)
| 工具 | 说明 |
|---|
list_campaigns_detailed | 列出包含完整详细信息、统计数据和筛选的活动 |
get_campaign | 获取单个活动的完整细节 |
get_campaign_counts | 按状态获取活动计数 |
get_campaigns_grouped | 按类别对所有活动进行分组 |
update_campaign | 更新活动字段(名称、状态) |
delete_campaign | 删除活动 |
pause_campaign | 暂停跑步活动 |
resume_campaign | 恢复暂停的活动 |
rename_campaign | 重命名活动 |
clone_campaign | 克隆(复制)活动 |
archive_campaign | 存档活动 |
内部API-消息传递(需要 MEETALFRED_JWT_TOKEN)
| 工具 | 说明 |
|---|
list_replies_detailed | 列出包含完整详细信息和排序的回复 |
get_conversation_messages | 在对话线程中获取消息 |
send_message | 在对话中发送消息(回复潜在客户) |
内部API-潜在客户管理(要求 MEETALFRED_JWT_TOKEN)
| 工具 | 说明 |
|---|
get_campaign_leads | 通过状态筛选列出活动中的潜在客户 |
get_lead_statuses | 获取活动的潜在客户状态计数 |
return_lead_to_campaign | 返回导致活动序列 |
add_tags_to_leads | 为一个或多个潜在客户添加标签 |
exclude_leads | 从活动中排除或取消排除潜在客户 |
内部API-帖子/社交发布(需要 MEETALFRED_JWT_TOKEN)
| 工具 | 说明 |
|---|
list_posts | 列出已安排和已发布的帖子以及参与度统计数据 |
get_post_types | 按平台(领英、脸书、Instagram、推特)获取帖子数 |
get_post | 获取单个帖子的完整详细信息(内容、状态、日程、受众) |
create_post | 创建新的计划LinkedIn帖子(设置标题、内容、时间、受众) |
update_post | 更新待定帖子的内容、标题、受众或日程安排 |
update_post_time | 将待处理的帖子重新安排到新的时间 |
archive_post | 将帖子存档 |
delete_post | 删除帖子 |
内部API-其他(要求 MEETALFRED_JWT_TOKEN)
| 工具 | 说明 |
|---|
get_current_user | 获取当前已验证用户的个人资料 |
get_unread_notification_count | 获取未读通知的计数 |
环境变量
| 变量 | 必填 | 描述 |
|---|
MEETALFRED_API_KEY | 是 | 来自“设置”>“集成”>“Webhooks”的API键 |
MEETALFRED_JWT_TOKEN | 内部API没有 | JWT令牌(启用标签、活动CRUD、消息传递、后期调度) |
MEETALFRED_BASE_URL | 否 | 覆盖白标签实例的webhook API基础URL |
MEETALFRED_API_BASE_URL | 否 | 覆盖白色标签实例的内部API基础URL |
常见工作流
回复线索
1. list_replies_detailed() → find reply with conversationUrn
2. get_conversation_messages(conversationUrn) → read conversation history
3. send_message(conversationUrn, "Your reply text")
返回活动的潜在客户
1. get_campaign_leads(campaignId, "replied") → find lead entityUrn
2. return_lead_to_campaign([entityUrn], campaignId)
安排LinkedIn帖子
1. create_post(title="Internal label", content="Post body text", scheduled_at="2026-03-15T14:00:00.000Z")
2. list_posts() → verify post was created, get post ID
3. update_post_time(postId, "2026-03-16T15:00:00.000Z") → reschedule if needed
标记活动中的线索
1. get_all_tags() → find or create tag IDs
2. get_campaign_leads(campaignId) → get entity URNs
3. add_tags_to_leads([entityUrns], [tagIds])
发展
git clone https://github.com/cphoskins/meetalfred-mcp.git
cd meetalfred-mcp
pip install -e ".[dev]"
pytest tests/
许可证
麻省理工学院