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 [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.