Pushizo

英语 · 土耳其语

英语

Pushizo MCP 服务 — 用于 Pushizo 的 Model Context Protocol 服务。Claude、Cursor 和 VS Code 等 AI 客户端可以读取细分群体、营销活动、消息、模板和分析数据，并在明确批准后创建营销活动和细分群体草稿。没有发送、安排或删除工具。远程服务无需安装即可使用（OAuth 2.1）；本地服务通过 stdio 运行。

状态： 正在发布到 npm。
状态： 正在准备发布到 npm。

在此期间从 GitHub 安装：

npm install -g --allow-remote=root https://github.com/pushizo/pushizo-mcp/releases/download/v0.1.0/pushizo-mcp-server-0.1.0.tgz
pushizo-mcp   # PUSHIZO_API_KEY=hs_live_… ortamıyla / with PUSHIZO_API_KEY set

发布后：

# Remote server (no install)
claude mcp add --transport http pushizo https://api.pushizo.com/mcp

# Local server (stdio)
PUSHIZO_API_KEY=hs_live_… npx -y @pushizo/mcp-server

下面的详细指南使用土耳其语编写；代码示例与语言无关。完整文档： docs.pushizo.com/docs/integrations/mcp · API 参考：docs.pushizo.com/docs/api。

土耳其语

Pushizo MCP 服务

Pushizo 的 Model Context Protocol（MCP）服务。Claude、Cursor、VS Code 等 AI 客户端可以读取细分群体、营销活动、消息、模板和分析数据；在批准模式下，只能创建草稿营销活动和细分群体。没有发送、安排和删除工具；草稿需在控制面板中审核后发送。

工具只会调用 Pushizo 公共 REST API：每次调用的权限（API 密钥范围）、IP 允许列表和租户隔离都与公共 API 完全一致。详细指南： docs.pushizo.com/docs/integrations/mcp。

连接方式	适用场景	身份验证
远程服务 https://api.pushizo.com/mcp（Streamable HTTP）	无需安装的客户端（Claude.ai、Claude Desktop 连接器、Claude Code、Cursor、VS Code）	OAuth 2.1（在浏览器中批准）或具有相应范围的 API 密钥
本地服务 npx -y @pushizo/mcp-server（stdio）	在本地运行或嵌入自己的代码	PUSHIZO_API_KEY

远程服务（无需安装）

Claude.ai / Claude Desktop： Settings → Connectors → Add custom connector → URL：https://api.pushizo.com/mcp。 Claude 会在浏览器中打开 Pushizo 授权页面；服务将使用你批准的组织、应用和范围。

Claude Code：

claude mcp add --transport http pushizo https://api.pushizo.com/mcp

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "pushizo": { "url": "https://api.pushizo.com/mcp" }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "pushizo": { "type": "http", "url": "https://api.pushizo.com/mcp" }
  }
}

对于不支持 OAuth 的客户端，可以通过 Authorization: Bearer hs_live_… 标头提供具有相应范围的 API 密钥：

curl -s -X POST https://api.pushizo.com/mcp   -H "Authorization: Bearer $PUSHIZO_API_KEY"   -H 'content-type: application/json'   -H 'accept: application/json, text/event-stream'   -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

本地服务（stdio）

PUSHIZO_API_KEY=hs_live_… npx -y @pushizo/mcp-server

软件包还提供 pushizo-mcp 命令（执行 npm install -g @pushizo/mcp-server 后即可使用 pushizo-mcp）。

环境变量	必填	说明
PUSHIZO_API_KEY	是	hs_live_… API 密钥。读取需要 segments:read、analytics:read；草稿工具还需要 mcp:write。
PUSHIZO_API_URL	否	API 根地址；默认值为 https://api.pushizo.com。必须使用 https；本地开发时可使用 http://localhost:<port> 或 http://127.0.0.1:<port>。
PUSHIZO_APP_ID	否	未在工具中提供 app_id 时使用的应用。使用与应用绑定的密钥时无需设置。

stdout 仅用于 MCP 消息；诊断信息和错误文本会写入 stderr。若缺少密钥或地址无效，进程将以代码 1 退出。

Claude Desktop

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "pushizo": {
      "command": "npx",
      "args": ["-y", "@pushizo/mcp-server"],
      "env": {
        "PUSHIZO_API_KEY": "hs_live_…",
        "PUSHIZO_API_URL": "https://api.pushizo.com",
        "PUSHIZO_APP_ID": "app_…"
      }
    }
  }
}

工具

工具	类型	所需范围
list_segments, get_segment	读取	segments:read
list_campaigns, get_campaign, list_campaign_messages	读取	analytics:read
get_analytics_summary, list_templates	读取	analytics:read
list_messages, get_message	读取	analytics:read 或 notifications:write
create_campaign_draft	需审批模式 — 写入	mcp:write
create_segment_draft	需审批模式 — 写入	mcp:write

admin 范围会启用所有工具。写入工具只会创建草稿（营销活动始终为 draft，并带有 mcp 标签；细分受众为动态），并要求助手在调用前获得用户的明确批准。

作为库使用

import { createFetchApi, createPushizoMcpServer } from '@pushizo/mcp-server';

const server = createPushizoMcpServer({
  api: createFetchApi({ baseUrl: 'https://api.pushizo.com', apiKey: process.env.PUSHIZO_API_KEY! }),
  defaultAppId: process.env.PUSHIZO_APP_ID,
});
// server.connect(<MCP taşıması>)

开发

此软件包在 Pushizo 主仓库中开发和测试；每次发布时都会自动同步到此仓库。使用时， 请选用 npm 软件包（@pushizo/mcp-server）或远程服务。

---

支持

• 指南： docs.pushizo.com/docs/integrations/mcp
• API 参考和 OpenAPI： docs.pushizo.com/docs/api · pushizo-openapi
• Bug 和建议： Issues
• 安全： 请勿提交公开 issue；请发送邮件至 [email protected] · 不要提交公开 issue，请发送邮件至此地址。
• 帮助： [email protected]

此仓库每次发布时都会从 Pushizo 主仓库自动同步。请提交 issue，而非 pull request；修复会在主仓库中完成， 并随下一次发布一并提供。 此仓库每次发布时都会从 Pushizo 主仓库自动同步。请提交 issue，而非 pull request；修复会在主仓库中完成， 并随下一次发布一并提供。

基于 MIT License 发布 · 采用 MIT 许可 — LICENSE。