@pushizo/mcp-server

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; kullanıcı araçları için users:read; taslak ve test gönderimi için 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

54 araç. Ayrıntılı liste docs/guides/mcp.md içindedir. Özet:

Araç	Tür	Gerekli kapsam
list_segments, get_segment, preview_segment, estimate_segment, list_segment_campaigns	okuma	segments:read
Kampanya, şablon, journey, analitik, in-app, web büyüme ve gelen kutusu okuma araçları	okuma	analytics:read
list_messages, get_message	okuma	analytics:read veya notifications:write
get_app, search_users, get_user, get_user_journeys, get_user_preferences, list_categories	okuma	users:read
create_campaign_draft, create_segment_draft, create_template_draft, create_journey_draft, create_in_app_draft	onaylı mod — taslak	mcp:write
send_test_notification	onaylı mod — yalnız test cihazı	mcp:write

admin kapsamı tüm araçları açar. Taslak araçları gönderim, zamanlama ve yayın yapmaz (kampanya ve journey/in-app draft, şablon ve kampanyaya mcp etiketi, segment dinamik). send_test_notification gerçek kitleye gidemez. Asistandan çağırmadan önce kullanıcının açık onayı 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 [e-mail] · herkese açık issue açmayın, bu adrese yazın.
• Help · Destek: [e-mail]

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.