# @happ-ai/platform-mcp 中文文档

规范地址：https://npmcn.com/package/%40happ-ai/platform-mcp/

版本：0\.46\.1
npm 元数据更新时间：2026-11-17T08:31:26.054Z
中文译文更新时间：2026-11-17T09:15:26.992Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40happ-ai/platform-mcp
原文对照：https://npmcn.com/package/%40happ-ai/platform-mcp/?lang=original
项目主页：https://github.com/Happ-AI/platform-mcp#readme
源码仓库：https://github.com/Happ-AI/platform-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.9 MB，202 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：3 个
- 首次发布：2026-07-06T09:40:13.432Z
- 最新版本发布：2026-11-17T08:31:25.321Z
- 近 30 天下载量：6280（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：91（近 12 个月 91 个）

## 中文简介

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

## 安装

```sh
npm install @happ-ai/platform-mcp
```

也可以使用：`pnpm add @happ-ai/platform-mcp`、`yarn add @happ-ai/platform-mcp`、`bun add @happ-ai/platform-mcp`

## README

# @happ-ai/平台-mcp

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

## \*

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

| Бинарник | API 密码 | Клиент |
| --- | --- | --- |
| `happ` | api.happ.tools ( | 我的掌上电脑工具 |
| `happ-dev` | api.dev.happ.tools (дев) | dev.happ.tools (英语) |
| `happ-mcp` | 本地主机 : 3: 00 ( ) | 本地主机: 4001 |

```bash
# прод
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`:

```bash
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.

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

```bash
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

```bash
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: : ).

## Разработка

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

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

## 常见问题

### @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 和提交记录判断。

