HalloFelix von InsurMagic

HalloFelix von InsurMagic – MCP 服务

面向 HalloFelix von InsurMagic 的官方 Model Context Protocol 服务。HalloFelix 是为德国、奥地利和瑞士的保险经纪人提供的 AI 电话和 WhatsApp 助手。

将 Claude、ChatGPT、Cursor、VS Code 或任何 MCP 客户端连接到你的 HalloFelix 账户，让你的 AI Agent 使用 HalloFelix 网页应用提供的所有功能：通话、电子邮件及其任务、客户（备注、电话号码、客户记忆）、外呼活动、语音、电子邮件和 WhatsApp 助手、Vorgänge（任务类型）、日历和预约类型、公司设置、知识文档、统计数据以及整个 WhatsApp 收件箱。

服务 URL： https://app.hallofelix.de/api/mcp（远程，Streamable HTTP）

身份验证

• OAuth（推荐）： 支持连接器的客户端（Claude.ai、Claude Desktop、ChatGPT、Cursor、VS Code）只需填写 URL。使用 HalloFelix 账户登录并授权访问（仅限账户管理员）。
• API 令牌： 将令牌作为 Authorization: Bearer <api_access_token> 发送。在 HalloFelix 应用的 集成 → API 中创建令牌。

设置

Claude.ai / Claude Desktop

设置 → 连接器 → 添加自定义连接器 → URL https://app.hallofelix.de/api/mcp → 连接。

ChatGPT

设置 → 应用和连接器 → 高级 → 启用 开发者模式 → 创建 → URL https://app.hallofelix.de/api/mcp，身份验证选择 OAuth。

Claude Code

claude mcp add --transport http hallofelix https://app.hallofelix.de/api/mcp

然后运行 /mcp 登录。若使用令牌：追加 --header "Authorization: Bearer <api_access_token>"。

Cursor

或在 ~/.cursor/mcp.json 中添加：

{ "mcpServers": { "hallofelix": { "url": "https://app.hallofelix.de/api/mcp" } } }

VS Code（GitHub Copilot）

在 VS Code 中安装

或运行 code --add-mcp '{"name":"hallofelix","type":"http","url":"https://app.hallofelix.de/api/mcp"}'

Windsurf

~/.codeium/windsurf/mcp_config.json：

{ "mcpServers": { "hallofelix": { "serverUrl": "https://app.hallofelix.de/api/mcp" } } }

OpenAI Codex CLI

codex mcp add hallofelix --url https://app.hallofelix.de/api/mcp
codex mcp login hallofelix

Gemini CLI

~/.gemini/settings.json：

{ "mcpServers": { "hallofelix": { "httpUrl": "https://app.hallofelix.de/api/mcp" } } }

任何仅支持 stdio 的客户端

{
  "mcpServers": {
    "hallofelix": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.hallofelix.de/api/mcp"]
    }
  }
}

工具

工具	功能	访问权限
list_calls	列出 HalloFelix 语音 AI 处理的电话（呼入和呼出），包括转录文本、摘要、提取的数据点和任务（状态及其控制面板标签、受指派人姓名、任务类型）	read
get_call	完整的通话记录：转录文本、摘要、摘要数据点、客户、营销活动和助手	read
update_call	为通话评分并设置其任务：状态、受指派人（按团队成员 ID、姓名或电子邮件）和任务类型（Vorgang，按 ID 或名称）	write, destructive
bulk_update_call_status	一次设置最多 1000 通话的任务状态	write, destructive
delete_call	永久删除通话及其录音、转录文本、任务和备注	write, destructive
start_outbound_call	发起真实电话：AI 通话助手立即拨打客户的主要号码（或在 scheduled_at 指定的时间拨打）	write
list_call_notes	列出通话任务的内部备注，按时间从新到旧排序	read
add_call_note	为通话任务添加内部备注	write
list_emails	列出 HalloFelix 电子邮件助手处理的电子邮件，按时间从新到旧排序，包括摘要、客户和任务（状态及其控制面板标签、受指派人姓名、任务类型）	read
get_email	完整的电子邮件记录：发件人、收件人、主题、正文、摘要、客户和任务	read
update_email	为电子邮件评分并设置其任务：状态、受指派人（按团队成员 ID、姓名或电子邮件）和任务类型（Vorgang，按 ID 或名称）	write, destructive
list_email_notes	列出电子邮件任务的内部备注，按时间从新到旧排序	read
add_email_note	为电子邮件任务添加内部备注	write
update_note	修改通话、电子邮件或客户备注的文本	write, destructive
delete_note	永久删除通话、电子邮件或客户备注	write, destructive
list_customers	列出客户（AI 致电或聊天的联系人），包括电话号码（类型及其控制面板标签）、通话处理方式（Anrufbehandlung，含标签）、通话次数和最近通话时间	read
get_customer	完整的客户记录	read
create_customer	创建客户	write
import_customers	一次调用最多创建 500 位客户	write
update_customer	编辑客户：姓名、电子邮件、语言、外部 ID、通话处理方式和 WhatsApp AI 排除设置	write, destructive
delete_customer	永久删除客户及其电话号码、备注、预约和记忆	write, destructive
add_customer_phone_number	为客户添加电话号码	write
update_customer_phone_number	将客户的电话号码设为主要号码（is_primary: true），和／或设置其类型	write, destructive
delete_customer_phone_number	删除客户的一个电话号码（不能删除客户的最后一个号码）	write, destructive
list_customer_notes	列出客户的内部备注，按时间从新到旧排序	read
add_customer_note	为客户添加内部备注	write
get_customer_memory	查看 AI 对客户的记忆（车辆、地址、偏好、联系时间段、备注），以及每条信息的来源和状态	read
add_customer_memory_fact	添加 AI 应记住的客户信息	write
update_customer_memory_fact	更正一条信息（value），或拒绝该信息（status "rejected"，也会隐藏 CRM 信息）	write, destructive
delete_customer_memory_fact	永久删除一条记忆信息（CRM 信息无法删除，只能拒绝）	write, destructive
list_campaigns	列出呼出电话营销活动，包括状态（及其控制面板标签）、成功率和接听率	read
get_campaign	完整的营销活动记录及计算得出的统计数据	read
create_campaign	创建呼出电话营销活动	write
start_campaign	启动或恢复营销活动：AI 开始呼叫客户	write
set_campaign_status	更改营销活动运行状态	write, destructive
update_campaign	编辑草稿营销活动（名称、助手、第一句话、目标、尝试次数、重试间隔、客户、时间安排、营业时间；customer_ids 会替换客户列表），和／或归档或取消归档任意营销活动	write, destructive
delete_campaign	永久删除营销活动（其通话记录会保留，但不再关联该营销活动）	write, destructive
list_call_assistants	列出语音 AI 电话助手（ID、名称、电话号码、语音 ID 和名称、用量）	read
get_call_assistant	通话助手的完整可编辑配置（问候语、语音、路由、短信／电子邮件、预约、营业时间、Vorgänge，……）	read
update_call_assistant	更改正在使用的通话助手设置	write, destructive
list_voices	列出通话助手可使用的语音，内容与控制面板中显示的一致：ID（存储的 call_voice 值）、名称、性别、说明、是否推荐或新添加，以及试听录音 URL	read
list_whatsapp_assistants	列出 WhatsApp AI 助手	read
get_whatsapp_assistant	WhatsApp AI 助手的完整可编辑配置，并在 AI 日程、Vorgänge 和转接目标的值旁显示其控制面板名称和 ID	read
update_whatsapp_assistant	更改正在使用的 WhatsApp 助手设置	write, destructive
create_call_assistant	创建新的通话助手	write
list_email_assistants	列出电子邮件 AI 助手（ID、名称、用量）	read
get_email_assistant	电子邮件助手的名称、指令和 Vorgänge（task_type_ids，以及含名称的 task_types）	read
create_email_assistant	使用账户默认的 Vorgänge 创建电子邮件助手	write
update_email_assistant	更改电子邮件助手	write, destructive
create_whatsapp_assistant	创建 WhatsApp 助手（计入助手数量上限）	write
delete_whatsapp_assistant	永久删除 WhatsApp 助手及其快捷语、文档和规则；使用该助手的号码在设置其他助手之前不会收到 AI 回复	write, destructive
list_whatsapp_macro_runs	列出已停止且需要人工处理的 WhatsApp 助手快捷语运行记录：状态为 unknown（文档可能已送达，也可能未送达）或 failed_terminal（文档未送达）	read
resolve_whatsapp_macro_run	手动关闭快捷语运行记录（状态为 resolved_manually）；不会发送任何内容	write
retry_whatsapp_macro_run	再次通过 WhatsApp 向客户发送快捷语运行记录中的文档	write
test_whatsapp_assistant	向 WhatsApp 助手发送测试消息并返回模拟回复（或它将触发的快捷语）	write
list_users	列出可分配 WhatsApp 聊天的团队成员，包括 ID、姓名和电子邮件（ID 即聊天的 assigned_user_id）	read
get_member_limit	账户订阅中的成员上限、计费成员数量，以及是否可以再邀请一位成员	read
invite_team_member	将人员添加到账户并向其发送邀请电子邮件（新用户会收到登录链接）	write
remove_team_member	从账户中移除成员：该成员将失去访问权限，其在此账户中的个人数据（推送订阅、已读状态、语音片段、Keasy 连接）将被删除，分配给该成员的 WhatsApp 聊天将变为未分配状态	write, destructive
list_whatsapp_accounts	列出已连接的 WhatsApp 企业号码（收件箱）及其收件箱设置	read
get_whatsapp_account	查看一个已连接的 WhatsApp 企业号码及其收件箱设置（AI、已读回执、自动消息、营业时间、AI 日程、助手），并显示已读回执和 AI 日程的控制面板标签以及助手名称	read
list_whatsapp_conversations	列出 WhatsApp 聊天及其标签、客户、分配信息（用户 ID 和姓名）、状态及其收件箱标签（Offen、Erledigt、KI deaktiviert）和最新消息	read
get_whatsapp_conversation	查看一个 WhatsApp 聊天及其标签、客户、分配信息（用户 ID 和姓名）、状态及其收件箱标签和最新消息	read
update_whatsapp_conversation	关闭（Erledigt）或重新打开聊天、暂缓处理、分配聊天（assigned_user_id = 按用户 ID、全名、名字或电子邮件指定的团队成员；null 会将聊天交还给 AI）、设置伙伴控制、为客户暂停 AI、标记为已读／未读、为联系人命名、关联客户，或设置 AI 读取的联系人备注	write, destructive
list_whatsapp_messages	列出 WhatsApp 聊天消息，按时间从旧到新排序	read
send_whatsapp_message	代表企业向现有 WhatsApp 聊天发送消息：文本、回复按钮（1–3 个，标题最多 20 个字符）、列表（1–10 行）或模板	write
start_whatsapp_conversation	向电话号码发送已获批准的模板；如有需要，会创建联系人和聊天（新聊天始终需要使用模板）	write
list_whatsapp_notes	列出 WhatsApp 聊天的团队内部备注（绝不会发送给客户）	read
add_whatsapp_note	为 WhatsApp 聊天添加团队内部备注	write
add_whatsapp_voice_note	为 WhatsApp 聊天添加内部语音备注：从公开的 HTTPS URL 下载 WebM 或 Ogg 录音（最大 10 MB，最长 5 分钟）并保存和转录，转录文本将成为备注内容	write
list_whatsapp_labels	列出账户的所有 WhatsApp 聊天标签	read
add_whatsapp_conversation_labels	为聊天添加标签并保留现有标签	write
set_whatsapp_conversation_labels	替换聊天的所有标签（空列表会移除全部标签）	write, destructive
list_whatsapp_templates	列出 WhatsApp 号码的消息模板及其 Meta 实时审核状态	read
get_whatsapp_template	查看一个模板及其当前 Meta 审核状态	read
create_whatsapp_template	创建模板并提交至 Meta 审核；状态为 approved 后即可发送	write
list_task_types	列出助手可识别并归档的任务类型（"Vorgänge"）：自定义任务类型和 HalloFelix 基础模板，包括名称、说明、指令、表情符号、启用状态以及是否可编辑（必须先解除关联基础模板才能编辑）	read
get_task_type	查看一个任务类型（Vorgang）及其指令和标记	read
create_task_type	创建自定义任务类型（Vorgang）	write
update_task_type	更改任务类型：名称、说明、指令、表情符号（仅限自定义或已解除关联的任务类型），和／或启用状态	write, destructive
detach_task_type	将启用的 HalloFelix 基础模板转换为自定义可编辑副本（" (Individuell)"），由该副本接管其助手；基础模板将停用	write
delete_task_type	删除自定义或已解除关联的任务类型，并将其从所有助手中移除	write, destructive
list_appointment_types	列出通话和 WhatsApp 助手可以预约的预约类型（Termintypen），包括时长、缓冲时间以及使用条件	read
create_appointment_type	将预约类型添加到一个且仅一个通话或 WhatsApp 助手	write
update_appointment_type	更改预约类型	write, destructive
delete_appointment_type	删除预约类型；助手将无法再预约此类型	write, destructive
list_calendars	列出助手会检查并用于预约的已连接日历（Google、Microsoft、iCloud，……）	read
get_calendar	查看一个已连接日历及 HalloFelix 在其中创建的预约	read
update_calendar	在 HalloFelix 中重命名已连接的日历	write, destructive
delete_calendar	断开日历连接：助手将停止检查该日历和在其中预约；若没有其他日历使用该服务商连接，则会撤销连接（重新连接需要使用控制面板）	write, destructive
list_calendar_events	列出已连接日历在 from 到 to 之间的忙碌时段（ISO-8601，最多 92 天，最多 200 个事件）	read
book_calendar_appointment	在企业实际连接的日历中预约（若时段已被占用，则返回 409 slot_taken）	write
get_account	助手使用的公司资料和地点、录音设置（save_audio_recording、recording_retention_days）以及客户记忆开关	read
update_account	更改公司设置	write, destructive
get_crm_ai_access	查看 WhatsApp AI 是否可以在已连接的 CRM 中查询客户数据、可查询的数据类别（合同、损害、Vorgänge、主数据、健康线）以及 CRM 连接	read
update_crm_ai_access	更改 AI 对 CRM 数据的访问权限	write, destructive
list_documents	列出助手用于回答问题的知识文档（PDF/DOCX）及其状态（processing、done、failed）	read
delete_document	删除知识文档；助手将不再依据该文档回答问题	write, destructive
upload_document	添加助手用于回答问题的知识文档：从公开的 HTTPS URL 下载最大 1 MB 的 PDF 或 Word（.docx）文件	write
get_assistant_voice_intro	查看通话助手是否播放录制的问候语来代替语音播报的第一句话，以及文件名和有效期为 60 分钟的播放链接	read
upload_assistant_voice_intro	设置或替换通话助手在通话开始时播放的录制问候语（MP3、WAV 或 WebM，最大 2 MB）；文件从公开的 HTTPS URL 下载	write, destructive
delete_assistant_voice_intro	删除通话助手的录制问候语；助手将恢复语音播报原有的第一句话	write, destructive
get_campaign_voice_intro	查看营销活动的通话是否以录制的第一句话开场，以及文件名和有效期为 60 分钟的播放链接	read
upload_campaign_voice_intro	设置或替换营销活动通话的录制开场白（MP3、WAV 或 WebM，最大 2 MB）；文件从公开的 HTTPS URL 下载	write, destructive
delete_campaign_voice_intro	删除营销活动的录制开场白；其通话将恢复使用原有的文字开场白	write, destructive
add_whatsapp_pdf_template	为 WhatsApp 助手添加 PDF（最大 16 MB，从公开的 HTTPS URL 下载）	write
delete_whatsapp_pdf_template	从 WhatsApp 助手中移除 PDF 并删除已存储的文件	write, destructive
set_whatsapp_template_header_media	为 WhatsApp 模板设置或替换默认页眉文件，支持图片、视频或文档页眉；发送模板时若未附带自己的文件则会使用此文件：JPEG/PNG 最大 5 MB，MP4/3GPP 最大 16 MB，或 PDF 最大 16 MB；文件从公开的 HTTPS URL 下载	write, destructive
delete_whatsapp_template_header_media	移除 WhatsApp 模板的默认页眉文件；发送模板时必须附带自己的文件	write, destructive
get_insights	指定日期范围的控制面板 KPI（默认：过去 30 天），与之前的时间段对比：通话、通话时长和分钟数、电子邮件、WhatsApp 消息（全部／AI）、每日图表、未处理事项、公司数据和 Vorgang 分布	read
get_crm_connection	查看 CRM（Professional Works、blau direkt、arisecur、VEMA 或 JDC / iCRM）是否已连接到账户、上次同步联系人的时间以及登录是否失败	read
search_crm_contacts	按姓名、电子邮件或电话搜索 HalloFelix 从已连接 CRM 同步的联系人，最相关的结果优先	read
get_crm_contact	查看一位已同步的 CRM 联系人及从 CRM 实时读取的详细信息：称谓、地址、生日、电话号码、电子邮件、状态	read
list_crm_archive_destinations	实时读取联系人在 CRM 中的合同、损害和 Vorgänge；其 ID 是通话、聊天和文档的归档目标	read
list_crm_contact_files	实时读取 CRM 中联系人 Kundenakte 内的文档	read
upload_crm_document	将文件（最大 10 MB，从公开的 HTTPS URL 下载）上传到已连接的 CRM：存入联系人 Kundenakte，和／或关联到其合同、损害或 Vorgänge	write
list_customer_crm_contact_matches	列出与 HalloFelix 客户共享电话号码或电子邮件的已同步 CRM 联系人，以及该客户当前关联的联系人	read
link_customer_crm_contact	将客户关联到已同步的 CRM 联系人：客户的姓名、电话号码和电子邮件将被联系人的信息覆盖；账户中其他电话号码与该联系人相同的客户将合并到此客户（其通话、聊天和备注将迁移至此客户，然后被删除）	write, destructive
archive_call_in_crm	将通话转录文本保存为 PDF 到已连接的 CRM：存入联系人 Kundenakte，和／或关联到合同、损害或 Vorgänge	write, destructive
archive_whatsapp_chat_in_crm	将 WhatsApp 聊天中选定的消息和备注保存为一个 PDF 到已连接的 CRM：存入联系人 Kundenakte，和／或关联到合同、损害或 Vorgänge	write
upload_whatsapp_files_to_crm	将 WhatsApp 聊天中发送或接收的文件（照片、PDF，……）上传到已连接的 CRM：存入联系人 Kundenakte，和／或关联到合同、损害或 Vorgänge	write
get_webhook	查看是否已配置 API webhook 目标及其 SHA-256 指纹（绝不返回 URL 本身）	read
set_webhook	设置 API webhook URL（公开的 HTTPS）	write, destructive
get_call_enrichment	查看是否已配置通话前信息补充 URL 及其 SHA-256 指纹（绝不返回 URL 本身）	read
set_call_enrichment	设置或移除（null）通话前信息补充 URL（公开的 HTTPS）	write, destructive
update_whatsapp_account	更改 WhatsApp 号码的收件箱设置；只修改传入的字段	write, destructive
list_whatsapp_template_folders	列出 WhatsApp 号码的模板文件夹及其中的模板	read
create_whatsapp_template_folder	创建模板文件夹（仅存在于 HalloFelix，不存在于 Meta）	write
rename_whatsapp_template_folder	重命名模板文件夹	write, destructive
delete_whatsapp_template_folder	删除模板文件夹；其中的模板将移回默认文件夹（模板本身会保留）	write, destructive
move_whatsapp_template_to_folder	将模板归入同一 WhatsApp 号码的某个文件夹	write, destructive
list_whatsapp_ai_exclusions	列出 WhatsApp AI 永远不会回复的客户；其聊天会转交给团队	read
set_whatsapp_ai_exclusion	excluded=true：AI 停止回复此客户的所有聊天并由团队接管；false：此客户的聊天将交还给 AI	write, destructive
open_whatsapp_conversation	在一个 WhatsApp 号码上查找或创建与某电话号码的聊天，不发送任何内容	write
delete_whatsapp_conversation	为整个团队永久删除聊天及其所有消息、备注和文件	write, destructive
search_whatsapp_messages	搜索所有 WhatsApp 聊天（包括已归档聊天）的消息，按时间从新到旧排序：文本、说明文字和语音转录文本	read
react_to_whatsapp_message	使用客户能立即看到的表情符号回应客户消息（emoji 为 null 时会移除回应）	write
retry_whatsapp_message	在失败后的 24 小时内，将发送失败的外发文本消息或模板作为新消息重新发送给客户	write
list_scheduled_whatsapp_messages	列出已安排发送到聊天但尚未发送的模板，按发送时间从近到远排序	read
schedule_whatsapp_template	安排在未来某个时间向聊天发送已获批准的模板	write
cancel_scheduled_whatsapp_message	在模板发送前取消已安排的发送	write, destructive
send_whatsapp_media	从公开 URL 向聊天发送图片、视频、文档或音频（须在 24 小时窗口内，且受 WhatsApp 文件大小限制）	write
list_whatsapp_media	列出聊天文件（包括收发方向），按时间从新到旧排序，每页 50 个	read
create_whatsapp_label	创建聊天标签（每个账户最多 20 个）	write
update_whatsapp_label	重命名或更改标签颜色	write, destructive
delete_whatsapp_label	删除标签；该标签将从所有使用它的聊天中消失	write, destructive
remove_whatsapp_conversation_label	从聊天中移除一个标签并保留其他标签	write, destructive

备注

• 自由格式的 WhatsApp 消息仅在客户发送上一条消息后的 24 小时内有效；超出此时限时，请发送已批准的模板。
• 通话录音链接经过签名，有效期为 60 分钟。
• 完整的 REST API 和 webhook 参考文档：https://app.hallofelix.de/docs/external-api.md

支持

[email protected] · hallofelix.de · InsurMagic GmbH