@happ-ai/platform-mcp

中文文档
0.46.1发布于 2026/11/17TypeScriptESM + CJS近 30 天下载 6280

MCP服务器将Happ平台API曝光为工具(登录,公司,助手,频道,电话)

中文使用文档
文档目录7 节
  1. *
  2. Обновления
  3. Локальная(из)
  4. 国 际
  5. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF…
  6. Что умеет MCP-сервер
  7. Разработка

@happ-ai/平台-mcp

MCP-сервер и CLI платформы Happ:даёт Claude Code (и MCP-клиенту) к к API платформы-компании-компании-ассистенты-ассистенты-чаты-чаты-чаты-звонки-звонки-звонки. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++login, (中文(简体) ), whoami————————————————————————————————————————.

*

-=YTET -伊甸园字幕组=- 翻译: именем数字 :

БинарникAPI 密码Клиент
happapi.happ.tools ( 我的掌上电脑工具
happ-devapi.dev.happ.tools (дев)dev.happ.tools (英语)
happ-mcp本地主机 : 3: 00 ( )本地主机: 4001
# прод
claude mcp add -s user happ -- npx -y @happ-ai/platform-mcp@latest

# дев
claude mcp add -s user happ-dev -- npx -y --package=@happ-ai/platform-mcp@latest happ-dev

Используй --package= (длинную): -p {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你为什么这么觉得 -- ломает claude mcp add。 。 。 .

视窗. (单位:千美元)happ-dev.cmd) (中文(简体) ) dist/index.js {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}我对你的爱很深 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}我对你的爱很深 happ-dev уходит. 说吧 -e HAPP_ENV=dev 页:1 prod | dev | local, перебивает, но, не HAPP_API_URL编号 :HAPP_CLIENT_URL:

claude mcp add -s user happ-dev -e HAPP_ENV=dev -- npx -y @happ-ai/platform-mcp@latest

{\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}(Windows {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}(Windows {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}), happ login и happ_login {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢 /cli-auth?port=… -=ytet -伊甸园字幕组=- 翻译:.

Обновления

  • MCP 时间轴: @latest =============================================================================================================================================================================================================================================================== {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
  • MCP 时间轴: @latest (старая:застревает也. 说吧 claude mcp remove happ说吧 说吧.
  • · · · CLI (单位:千美元)npm install -g) сама: npm update -g @happ-ai/platform-mcp。 。 。 .

说吧 happ_login 编号 : happ_whoami (и) happ login 编号 : happ whoami {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}####################################################################################################################################################################################################################################### 校对:Soup.

Локальная(из)

pnpm install && pnpm build
claude mcp add happ \
  -e HAPP_API_URL=http://localhost:3000/api \
  -e HAPP_CLIENT_URL=http://localhost:4001 \
  -- node /абсолютный/путь/до/platform-mcp/dist/index.js

Явные HAPP_API_URL 编号 : HAPP_CLIENT_URL {\fn华文仿宋\fs16\1cHD1D1D1}好! pnpm build克劳德 代码 ======/mcp {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}再连接一下 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢.

国 际

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢happ, (中文(简体) ), happ-dev, (中文(简体) ), happ-mcp校对:Soup

happ login    # вход через браузер, сохраняет токен в ~/.happ/credentials.json
happ whoami   # текущий пользователь (GET /auth/me)
happ logout   # удалить сохранённый токен
happ help     # справка

happ login открывает /cli-auth {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢 персональный happ_… (живёт90дней,相去相去. (原始内容存档于2019-09-29). Access keys QQ. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 ~/.happ/credentials.json {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}请说吧 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}我...

{\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得怎么样 happ login - автоматически не открывается открывается открывается.

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 happ_* # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # POST /mcp-telemetry/events {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080} - - - {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080} - - {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080} - - {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080} - {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080} -/mcp) (中文(简体) ). Отправка:недоступный也 ~/.happ/mcp-trace/ {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢.

Приватность. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢src/telemetry/redact.tsполя:поля password编号 :token编号 :apiKey编号 :secret +++++++++++++++++++++++++, happ_…, (中文(简体) ), sk-…,"熊克","QQ" Telegram/Slack) :""любого","""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" <text N chars sha256:…>。 。 。 。 。 Второй.

Отключить автоотправку: HAPP_MCP_TELEMETRY=off {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}我还不知道 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080} {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}你觉得呢 happ_store_logs продолжает.

Заголовки. # # # API # # # # # # # # API # # # # X-Happ-Mcp-Session 编号 : X-Happ-Mcp-Tool 编号 : X-Happ-Mcp-Seq и User-Agent: happ-mcp/<версия>; audit_log.metadata{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 без mCP(#############################################################################################################################################################################################################################################################.

Инструменты:

  • happ_store_logs(summary, category?, anchorTool?, lastCalls?) -=ytet -伊甸园字幕组=- 翻译: anchorTool 页:1 happ_integration_sync(原始内容存档于2018-10-21) (中文(中国大陆) ). {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你还好吧.
  • happ_trace_recent() -=ytet -伊甸园字幕组=- 翻译:.

Что умеет MCP-сервер

116国 happ_* (原始内容存档于2018-09-21). REST API:

  • Авторизация —— 说 happ_login, (中文(简体) ), happ_logout, (中文(简体) ), happ_whoami。 。 。 .
  • Компании - CRUD、QQ/QX、QX、QX( )happ_permissions_*)), персональные (доступа) (доступаhapp_access_token*) (中文(简体) ).
  • Ассистенты —— CRUD, копирование, между, папки; каталоги, и, LLM- (happ_voices_list, (中文(简体) ), happ_llm_models_list) (中文(简体) ).
  • Инструменты - CRUD(德国)happ_tool_*) (中文(简体) ).
  • База —— CRUD текстовых (中文(简体) )happ_knowledge_*) (中文(简体) ).
  • {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 - CRUD , , , , , , , , , , , , , , , , , , , happ_telephony_connect) (中文(简体) ).
  • Каналы ——виджета,Telegram-бота (по),WhatsApp;список/настройка/интеграций.
  • QQ 用户名 —— 说 happ_telegram_push_*==================================================================================================== ========================================================================================================================================================== - URL,POST QQ QQ: QQ: QQ: HTTP- QQ: QQ: QQ: QQ: QQ: QQ: заказе. url и token {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢.
  • #####Slack # ####################################################################################################################################################################################################################################################### —— 说 happ_slack_push_*: ссылка, каналы, и, всё. всё. как. как. (原始内容存档于2018-09-21). Slack QQ , QQ ,入围-webhook. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 happ_slack_push_connect_url。 。 。 .
  • Чаты - список, сообщения, назначение, назначение, вкл, вкл, вкл, (вкл, сессии, сессии, плейграунд, плейграунд, плейграунд, плейграундhapp_playground_*) (中文(简体) ).
  • Звонки - список,детали,правка,правка (редактирование/разбиение,смена),назначение.
  • Текстовые —— 说 happ_text_campaign_*{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? ++=====================================================================================================================================================================================================status=failed + 键 lastError) (中文(简体) ). 爱尔。 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
  • {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++happ_analyses_list, (中文(简体) ), happ_analysis_run), happ_activity_list) (中文(简体) ).
  • 应用函数 - интеграционный агента агента рантайме 哈普( A)happ_function_*, (中文(简体) ), happ_functions_list) :"из" ("相去相去","相去相去" ("相去相去"),"相去相去" ("相去相去相去"),"相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去. happ_functions_guide - контракт * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * happ-secret://NAME, лимиты, пример. Манифест,расширяющий也;相去相去;相去相去;相去相去;相去相去 approvalUrl {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 happ_function_secrets {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}################################### ##################################################################################################################################################################################################.
  • Тесты -================================================================================================================================================================================= =============================================================================happ_test_*) (中文(简体) ). Кейсы {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢数字 : happ_test_media_upload грузит с диска (filePath(原始内容存档于2017-09-29). ). QQ macOS (clipboard: true{\fn黑体\fs20\shad2\2ah82\3ah20\4ah33\fscx95\3ch592001\be1}你还好吧url); ; ; ; ; ; ; ; {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}LLM - \fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}我... {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢 (单位:千美元)seedMessages{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}我..daysAgo),"и","так","постоянный","пишет"等. Промпт happ_fix_flow 唵(引一)тест(引一)贺(引一)贺.

Чего не : QQ: QQ: QQ: QQ: QQ: QQ: QQ: QQ: QQ: QQ: QQ: QQ: QQ: QX: QQ: QQ: QQ: QQ: QQ: QQ: QQQ: QQQ: QQ: QQQ: : QQQ: : QQQ: : QQQ: : QQQQ: : QQQ: : QQQQQ: : QQQQ: : QQM: ;QMMM.),QX: OAuth/QR: QR: (QQQQM: : ).

Разработка

pnpm install
pnpm dev        # запуск из исходников (tsx)
pnpm typecheck
pnpm build      # tsc → dist/

\\ npm — GitHub 动作(release-workflow): пуш в в в с с с с с с с с с с с с с с с с.

版本与发布记录

@happ-ai/platform-mcp 共发布 91 个版本,首次发布于 2026/07/06;过去 12 个月发布了 91 个版本。

版本发布日期距今
0.46.1latest2026/11/17今天
0.46.02026/11/16今天
0.45.02026/11/115 天前
0.44.02026/11/115 天前
0.43.02026/11/106 天前
0.42.02026/11/0511 天前

关于 @happ-ai/platform-mcp 的常见问题

@happ-ai/platform-mcp 是什么?

MCP服务器将Happ平台API曝光为工具(登录,公司,助手,频道,电话)

如何安装 @happ-ai/platform-mcp?

在项目目录运行 npm install @happ-ai/platform-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 happ、happ-dev、happ-mcp,可以用 npx happ 直接运行。

@happ-ai/platform-mcp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@happ-ai/platform-mcp 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@happ-ai/platform-mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@happ-ai/platform-mcp 可以商用吗?

@happ-ai/platform-mcp 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@happ-ai/platform-mcp 的下载量有多少?

根据 npm 官方下载统计,@happ-ai/platform-mcp 在 2026/10/17 – 2026/11/15 这 30 天内被下载 6,280 次,日均约 209 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@happ-ai/platform-mcp 还在维护吗?

最新版本 0.46.1 发布于 2026/11/17(今天);至今共发布 91 个版本,其中过去 12 个月发布了 91 个;首次发布于 2026/07/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。