Pushizo

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:

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

After publication · Yayından sonra:

# 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 zaman	Kimlik
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ömmek	PUSHIZO_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:

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 desteklemeyen istemcilerde Authorization: Bearer hs_live_… başlığıyla kapsamlı bir API anahtarı verilebilir:

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)

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şkeni	Zorunlu	Açıklama
PUSHIZO_API_KEY	evet	hs_live_… API anahtarı. Okuma için segments:read, analytics:read; taslak araçları için ayrıca mcp:write.
PUSHIZO_API_URL	hayır	API 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_ID	hayır	Araç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\):

{
  "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ür	Gerekli kapsam
list_segments, get_segment	okuma	segments:read
list_campaigns, get_campaign, list_campaign_messages	okuma	analytics:read
get_analytics_summary, list_templates	okuma	analytics:read
list_messages, get_message	okuma	analytics:read veya notifications:write
create_campaign_draft	onaylı mod — yazma	mcp:write
create_segment_draft	onaylı mod — yazma	mcp: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

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

• Guide · Rehber: docs.pushizo.com/docs/integrations/mcp
• API reference & OpenAPI · API referansı ve OpenAPI: docs.pushizo.com/docs/api · pushizo-openapi
• Bugs & ideas · Hata ve öneri: Issues
• Security · Güvenlik: please do not open public issues; email [email protected] · herkese açık issue açmayın, bu adrese yazın.
• Help · Destek: [email protected]

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.