Pushizo

com.pushizo由 pushizo.com 发布官方发布者v0.1.0更新于 Oct 29, 2026

Push, email, SMS, in-app and journeys. 54 tools: reads and drafts; only test sends.

已验证Streamable HTTP可网页运行沟通与协作数据与分析商业与电商

概览

AI 生成的概览

Pushizo MCP 服务器让助手读取推送、邮件、短信和应用内消息的营销活动、分群、旅程与分析数据，并创建草稿活动与草稿分群。

可以做什么
  • 列出并查看分群，预览或估算受众规模，查找包含或排除某分群的活动
  • 读取活动、活动消息、模板与模板版本，并用 Liquid 变量渲染模板
  • 查看自动化旅程、旅程运行记录与各节点统计
  • 搜索用户并读取其标签、属性、订阅与偏好，以及消息分类和事件定义
  • 获取分析数据：KPI 概览、活动与变体统计、消息、订阅、事件与转化报告、漏斗、留存队列及组织用量
  • 创建草稿活动与草稿分群（写入工具，需明确确认）
适用场景
适合让助手回答关于 Pushizo 消息表现、受众和旅程的问题，或准备草稿活动与分群以便在 Pushizo 后台审核。若需要助手真正发送、定时、发布或删除内容则不适合，因为本服务器没有这些工具。
运行要求
可使用远程端点（OAuth 2.1 浏览器授权，或以 Bearer 方式提供带权限的 API 密钥），也可通过 stdio 运行本地 npm 包。本地运行需要 Node.js 和 PUSHIZO_API_KEY 环境变量，可选 PUSHIZO_API_URL 与 PUSHIZO_APP_ID。读取工具需要 segments:read、analytics:read 或 users:read 权限，草稿工具还需 mcp:write。
安装前请注意
API 密钥是正式凭据（hs_live_ 前缀），其权限范围决定助手能访问什么，admin 权限会开放全部工具。草稿工具会在你的 Pushizo 账户中写入记录，只有确实需要时才授予 mcp:write。用户搜索与用户查询会返回个人数据，应只请求必要内容。服务器不提供发送、定时或删除工具，测试发送仅发往测试设备。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Pushizo，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.pushizo%2Fmcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

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

README

[Pushizo]

[Docs] [API reference] [License: MIT]

English · Türkçe

English

Pushizo MCP server — Model Context Protocol server for Pushizo. AI clients such as Claude, Cursor and VS Code can read segments, campaigns, messages, templates and analytics, and create draft campaigns and segments with explicit approval. There are no send, schedule or delete tools. The remote server works without installation (OAuth 2.1); the local server runs over stdio.

Status: Publishing to npm is in progress.
Durum: npm yayını hazırlanıyor.

Install from GitHub until then · O zamana kadar GitHub'dan kurulum:

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

After publication · Yayından sonra:

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

The detailed guide below is in Turkish; code samples are language-neutral. Full documentation: docs.pushizo.com/docs/integrations/mcp · API reference: docs.pushizo.com/docs/api.

Türkçe

Pushizo MCP sunucusu

Pushizo için Model Context Protocol (MCP) sunucusu. Claude, Cursor, VS Code gibi yapay zekâ istemcileri segment, kampanya, mesaj, şablon ve analitik verisini okuyabilir; onaylı modda yalnızca taslak kampanya ve segment oluşturabilir. Gönderim, zamanlama ve silme aracı yoktur; taslaklar panelden gözden geçirilip gönderilir.

Araçlar yalnızca Pushizo public REST API'sini çağırır: yetki (API anahtarı kapsamları), IP izin listesi ve kiracı izolasyonu her çağrıda public API ile birebir aynıdır. Ayrıntılı rehber: docs.pushizo.com/docs/integrations/mcp.

BağlantıNe zamanKimlik
Uzak sunucu https://api.pushizo.com/mcp (Streamable HTTP)Kurulum istemeyen istemciler (Claude.ai, Claude Desktop bağlayıcısı, Claude Code, Cursor, VS Code)OAuth 2.1 (tarayıcıda onay) ya da kapsamlı API anahtarı
Yerel sunucu npx -y @pushizo/mcp-server (stdio)Yerel çalıştırmak ya da kendi kodunuza gömmekPUSHIZO_API_KEY

Uzak sunucu (kurulumsuz)

Claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → URL: https://api.pushizo.com/mcp. Claude tarayıcıda Pushizo yetkilendirme ekranını açar; onayladığınız organizasyon, app ve kapsamlarla çalışır.

Claude Code:

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

Cursor (~/.cursor/mcp.json):

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

VS Code (.vscode/mcp.json):

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

OAuth desteklemeyen istemcilerde Authorization: Bearer hs_live_… başlığıyla kapsamlı bir API anahtarı verilebilir:

bash
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"}'

Yerel sunucu (stdio)

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

Paket pushizo-mcp komutunu da sağlar (npm install -g @pushizo/mcp-server sonrası pushizo-mcp).

Ortam değişkeniZorunluAçıklama
PUSHIZO_API_KEYeveths_live_… API anahtarı. Okuma için segments:read, analytics:read; taslak araçları için ayrıca mcp:write.
PUSHIZO_API_URLhayırAPI kök adresi; varsayılan https://api.pushizo.com. https olmalı; yerel geliştirmede http://localhost:<port> veya http://127.0.0.1:<port> kabul edilir.
PUSHIZO_APP_IDhayırAraçta app_id verilmezse kullanılacak app. App'e bağlı anahtarda gerekmez.

stdout yalnızca MCP iletileri içindir; tanılama ve hata metinleri stderr'e yazılır. Anahtar eksikse veya adres geçersizse süreç 1 koduyla çıkar.

Claude Desktop

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

json
{  "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_…"      }    }  }}

Araçlar

AraçTürGerekli kapsam
list_segments, get_segmentokumasegments:read
list_campaigns, get_campaign, list_campaign_messagesokumaanalytics:read
get_analytics_summary, list_templatesokumaanalytics:read
list_messages, get_messageokumaanalytics:read veya notifications:write
create_campaign_draftonaylı mod — yazmamcp:write
create_segment_draftonaylı mod — yazmamcp:write

admin kapsamı tüm araçları açar. Yazma araçları yalnızca taslak oluşturur (kampanya her zaman draft, mcp etiketiyle; segment dinamik) ve asistandan çağırmadan önce kullanıcının açık onayını alması istenir.

Kütüphane olarak

ts
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ı>)

Geliştirme

Paket Pushizo ana deposunda geliştirilir ve test edilir; bu depo her sürümde oradan otomatik yansıtılır. Kullanmak için npm paketini (@pushizo/mcp-server) ya da uzak sunucuyu tercih edin.

Support · Destek

This repository is mirrored automatically from the Pushizo main repository on every release. Please open an issue instead of a pull request; fixes land in the main repository and ship with the next release. Bu depo her sürümde Pushizo ana deposundan otomatik yansıtılır. Pull request yerine issue açın; düzeltmeler ana depoda yapılır ve bir sonraki sürümle buraya gelir.

Released under the MIT License · MIT lisanslıdır — LICENSE.

来源：README.md，提交 894f02f

工具

54

list_segments

Segmentleri listele

App’in segmentlerini listeler (ad araması ve sayfalama). Gerekli kapsam: segments:read.

输入参数qlimitapp_idcursor

get_segment

Segment oku

Segment tanımı ve tahmini kitle boyutu. Gerekli kapsam: segments:read.

输入参数app_idsegment_id必填

list_campaigns

Kampanyaları listele

Kampanyaları listeler (durum/tür/ad filtresi). Gerekli kapsam: analytics:read.

输入参数qlimitapp_idcursorstatus

get_campaign

Kampanya oku

Kampanya ayrıntısı (kitle, içerik, onay durumu, istatistik). Gerekli kapsam: analytics:read.

输入参数app_idcampaign_id必填

list_campaign_messages

Kampanya çalıştırmaları

Kampanyanın mesajları (her çalıştırma bir mesaj) ve sayaçları. Gerekli kapsam: analytics:read.

输入参数app_idcampaign_id必填

list_messages

Mesajları listele

Gönderilen mesajlar (API, kampanya, journey) ve teslim sayaçları. Gerekli kapsam: analytics:read veya notifications:write.

输入参数limitapp_idcursor

get_message

Mesaj oku

Mesaj durumu ve sayaçları. Gerekli kapsam: analytics:read veya notifications:write.

输入参数app_idmessage_id必填

get_analytics_summary

Analitik özet

Genel bakış KPI’ları: gönderim, teslim, açılma/tıklama oranları, abonelik büyümesi (son 7/30 gün veya özel aralık). Gerekli kapsam: analytics:read.

输入参数tofromrangeapp_id

list_templates

Şablonları listele

Mesaj şablonları (kanal/ad filtresi). Gerekli kapsam: analytics:read.

输入参数qlimitapp_idcursorchannel

create_campaign_draft

Kampanya taslağı oluştur

[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın. Kampanyayı `draft` durumunda oluşturur. Kitle segment kimlikleriyle verilir; içerik doğrudan veya template_id ile. Örnek içerik: {"headings":{"tr":"Başlık"},"contents":{"tr":"Metin"}}.

输入参数name必填app_idlabelscontentchannelstemplate_idexcluded_segmentsincluded_segments

create_segment_draft

Segment taslağı oluştur

[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın. Dinamik segment oluşturur (kampanyada kullanılana kadar etkisi yoktur). Tanım biçimi: {"all":[{"field":"tags.plan","op":"eq","value":"pro"},{"field":"last_active_at","op":"within_days","value":30}]}.

输入参数name必填app_iddefinition必填description

get_app

App bilgisi

App ayarları: ad, platformlar, varsayılan dil, saat dilimi. Gerekli kapsam: users:read.

输入参数app_id

get_organization_usage

Organizasyon kullanımı

Plan kotaları, bu ayki kullanım ve aşım tahmini (yalnızca organizasyon geneli anahtar). Gerekli kapsam: analytics:read.

输入参数days

preview_segment

Segment önizleme

Kaydedilmemiş bir tanımın kitle sayısı ve örnek kullanıcıları (segment oluşturmadan). Gerekli kapsam: segments:read.

输入参数limitapp_iddefinition必填

estimate_segment

Segment kitle tahmini

Kayıtlı segmentin güncel kitle ve kanal bazında abonelik tahmini. Gerekli kapsam: segments:read.

输入参数app_idsegment_id必填

list_segment_campaigns

Segmenti kullanan kampanyalar

Segmenti dahil veya hariç tutan kampanyalar. Gerekli kapsam: segments:read.

输入参数app_idsegment_id必填

get_campaign_stats

Kampanya istatistikleri

Gönderim, teslim, açılma, tıklama, dönüşüm ve kanal kırılımı. Gerekli kapsam: analytics:read.

输入参数app_idcampaign_id必填

get_campaign_variant_stats

A/B varyant istatistikleri

Kampanya varyantlarının metrikleri ve anlamlılık (z-testi) sonucu. Gerekli kapsam: analytics:read.

输入参数app_idcampaign_id必填

get_template

Şablon oku

Şablon içeriği (dillere göre başlık/metin, e-posta, SMS…). Gerekli kapsam: analytics:read.

输入参数app_idtemplate_id必填

get_template_stats

Şablon performansı

Şablonu kullanan mesajların toplu metrikleri. Gerekli kapsam: analytics:read.

输入参数app_idtemplate_id必填

list_template_versions

Şablon sürümleri

Şablonun kayıtlı sürüm geçmişi. Gerekli kapsam: analytics:read.

输入参数app_idtemplate_id必填

render_template

Şablon önizleme

Şablonu Liquid değişkenleriyle işler (gönderim yapmaz): örnek kullanıcı tag/özellikleri ve dil ile son hali. Gerekli kapsam: analytics:read.

输入参数userapp_idchannellanguagecustom_datatemplate_id必填

list_journeys

Journey’leri listele

Otomasyon akışları (durum ve ad filtresi). Gerekli kapsam: analytics:read.

输入参数qlimitapp_idcursorstatus

get_journey

Journey oku

Journey grafiği (düğümler, kenarlar), giriş/çıkış kuralları ve yayın durumu. Gerekli kapsam: analytics:read.

输入参数app_idjourney_id必填

get_journey_stats

Journey istatistikleri

Düğüm bazında giriş/çıkış, bekleyen, hedefe ulaşan ve mesaj metrikleri. Gerekli kapsam: analytics:read.

输入参数app_idversionjourney_id必填all_versions

list_journey_runs

Journey çalıştırmaları

Kullanıcı bazında journey çalıştırmaları (durum, kullanıcı, sürüm filtresi). Gerekli kapsam: analytics:read.

输入参数limitapp_idcursorstatususer_idversionjourney_id必填

get_journey_run

Journey çalıştırması

Tek çalıştırmanın adım adım zaman çizelgesi. Gerekli kapsam: analytics:read.

输入参数app_idrun_id必填journey_id必填

search_users

Kullanıcı ara

Koşullara uyan kullanıcılar (segment tanımıyla aynı biçim; sayfalı). Kişisel veri içerir, yalnızca gereken kadar isteyin. Gerekli kapsam: users:read.

输入参数limitapp_idcursordefinition必填

get_user

Kullanıcı oku

Kullanıcının kimlikleri, tag’leri, özellikleri ve abonelikleri. Gerekli kapsam: users:read.

输入参数label必填value必填app_id

get_user_journeys

Kullanıcının journey’leri

Kullanıcının içinde bulunduğu ve tamamladığı journey çalıştırmaları. Gerekli kapsam: users:read.

输入参数label必填value必填app_id

get_user_preferences

Kullanıcı tercihleri

Kategori ve kanal bazında abonelik tercihleri. Gerekli kapsam: users:read.

输入参数label必填value必填app_id

list_categories

Mesaj kategorileri

Tercih merkezindeki mesaj kategorileri (varsayılan açık/kapalı, kanallar). Gerekli kapsam: users:read.

输入参数app_id

list_event_definitions

Özel olaylar

App’te görülen özel olay adları, sayıları ve özellik şemaları. Gerekli kapsam: analytics:read.

输入参数limitapp_idcursor

get_event_definition

Olay tanımı

Tek olayın özellikleri, ilk/son görülme ve hacmi. Gerekli kapsam: analytics:read.

输入参数name必填app_id

get_message_report

Teslimat raporu

Gönderim/teslim/açılma/tıklama/başarısızlık; güne, kanala veya kampanyaya göre. Gerekli kapsam: analytics:read.

输入参数tofromapp_idcomparegroup_by

get_subscription_report

Abonelik raporu

Kanal bazında yeni, iptal ve net abonelik eğilimi. Gerekli kapsam: analytics:read.

输入参数tofromapp_idcompare

get_event_report

Olay raporu

Özel olay hacmi; güne veya olay adına göre. Gerekli kapsam: analytics:read.

输入参数tofromnameapp_idcomparegroup_by

get_conversion_report

Dönüşüm raporu

Mesajlara atfedilen dönüşümler ve gelir (kanallar arası son temas). Gerekli kapsam: analytics:read.

输入参数tofromapp_idcomparecampaign_id

run_funnel

Funnel analizi

Sıralı olay adımlarında dönüşüm ve kayıp (2–8 adım, adımlar arası en çok `window_hours`). Gerekli kapsam: analytics:read.

输入参数tofromsteps必填app_idcomparewindow_hours

get_retention_report

Elde tutma (retention)

Haftalık kohort elde tutma tablosu. Gerekli kapsam: analytics:read.

输入参数weeksapp_id

get_engagement_heatmap

Etkileşim ısı haritası

Gün × saat açılma/tıklama yoğunluğu (en iyi gönderim zamanı için). Gerekli kapsam: analytics:read.

输入参数tofromapp_id

get_provider_report

Sağlayıcı raporu

APNs/FCM/HMS/e-posta/SMS sağlayıcı başarı ve hata kodu dağılımı. Gerekli kapsam: analytics:read.

输入参数tofromapp_id

list_in_app_messages

In-app mesajlar

In-app mesajlar (durum filtresi) ve gösterim/tıklama sayaçları. Gerekli kapsam: analytics:read.

输入参数limitapp_idcursorstatus

get_in_app_message

In-app mesaj oku

Tetikler, görünüm, kitle, sıklık ve istatistikler. Gerekli kapsam: analytics:read.

输入参数app_idmessage_id必填

list_web_campaigns

Web kampanyaları

Pop-up, banner ve slide-in kampanyaları. Gerekli kapsam: analytics:read.

输入参数limitapp_idcursorstatus

get_web_campaign_report

Web kampanyası raporu

Gösterim, tıklama, kapatma ve dönüşüm. Gerekli kapsam: analytics:read.

输入参数daysapp_idcampaign_id必填

list_forms

Formlar

Web formları ve gönderim sayıları. Gerekli kapsam: analytics:read.

输入参数limitapp_idcursorstatus

list_surveys

Anketler

Anketler ve NPS. Gerekli kapsam: analytics:read.

输入参数limitapp_idcursorstatus

get_survey_report

Anket raporu

Soru bazında yanıt dağılımı ve NPS skoru. Gerekli kapsam: analytics:read.

输入参数daysapp_idsurvey_id必填

get_inbox_metrics

Gelen kutusu metrikleri

Canlı sohbet ve birleşik gelen kutusu: konuşma hacmi, ilk yanıt ve çözüm süreleri. Gerekli kapsam: analytics:read.

输入参数tofromapp_idchannel

create_template_draft

Şablon oluştur

[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın. Yeniden kullanılabilir mesaj şablonu oluşturur (tek başına gönderilmez; `mcp` etiketi eklenir). Örnek içerik: {"headings":{"tr":"Sepetiniz sizi bekliyor"},"contents":{"tr":"{{ first_name | default: \"Merhaba\" }}, ürünleriniz hâlâ sepette."}}.

输入参数name必填tagsapp_idchannelcontent必填

create_journey_draft

Journey taslağı oluştur

[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın. Otomasyon akışını `draft` olarak oluşturur; yayımlamaz. Grafik verilmezse boş taslak açılır ve dashboard düzenleyicisinde tamamlanır. Grafik biçimi get_journey çıktısındaki `graph` ile aynıdır (nodes + edges; giriş düğümü segment veya olay).

输入参数name必填graphapp_idsettingsdescription

create_in_app_draft

In-app mesaj taslağı oluştur

[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın. In-app mesajı `draft` olarak oluşturur; etkinleştirmez. Örnek: triggers [{"kind":"session_start"}] (diğerleri: session_duration, event, screen, trigger), display {"layout":"modal","blocks":[{"type":"title","text":{"tr":"Yeni özellik"}},{"type":"body","text":{"tr":"Hemen deneyin"}},{"type":"button","id":"ok","text":{"tr":"Tamam"},"action":{"type":"dismiss"}}]}.

输入参数name必填app_iddisplay必填audienceprioritytriggers必填frequency

send_test_notification

Test cihazlarına test gönder

[Onaylı mod — test gönderimi] App’in TEST CİHAZLARINA gerçek bir test push’u gönderir (gerçek kitleye asla). `subscription_ids` verilirse hepsi test cihazı olmalıdır. API anahtarında `mcp:write` kapsamı olmalıdır; çağırmadan önce kullanıcıdan açık onay alın.

输入参数urldataapp_idcontents必填headingssubscription_ids

版本历史

1
  1. v0.1.0最新Oct 22, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分