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 分