Pushizo

英語 · トルコ語

English

Pushizo MCP サーバー — Pushizo 用の Model Context Protocol サーバーです。Claude、Cursor、VS Code などの AI クライアントは、セグメント、キャンペーン、メッセージ、テンプレート、分析データを読み取り、明示的な承認を得て下書きのキャンペーンやセグメントを作成できます。送信、スケジュール設定、削除を行うツールはありません。リモートサーバーはインストールなしで動作し（OAuth 2.1）、ローカルサーバーは stdio 経由で動作します。

ステータス： npm への公開を進めています。
ステータス： npm への公開を準備中です。

公開までは GitHub からインストール · それまでは GitHub からインストール：

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

公開後 · 公開後：

# 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

以下の詳細ガイドはトルコ語です。コードサンプルは言語に依存しません。ドキュメント全文： docs.pushizo.com/docs/integrations/mcp · API リファレンス：docs.pushizo.com/docs/api。

Türkçe

Pushizo MCP サーバー

Pushizo 用の Model Context Protocol（MCP）サーバーです。Claude、Cursor、VS Code などの AI クライアントは、セグメント、キャンペーン、メッセージ、テンプレート、分析データを読み取ることができ、承認モードでは 下書きのキャンペーンとセグメントのみを作成できます。送信、スケジュール設定、削除を行うツールはありません。下書きはダッシュボードで確認してから 送信します。

ツールは Pushizo の公開 REST API のみを呼び出します。権限（API キーのスコープ）、IP 許可リスト、テナント分離は、すべての呼び出しで公開 API とまったく同じように適用されます。詳細ガイド： docs.pushizo.com/docs/integrations/mcp。

接続	用途	認証
リモートサーバー https://api.pushizo.com/mcp（Streamable HTTP）	インストール不要のクライアント（Claude.ai、Claude Desktop コネクター、Claude Code、Cursor、VS Code）	OAuth 2.1（ブラウザーで承認）またはスコープ付き API キー
ローカルサーバー npx -y @pushizo/mcp-server（stdio）	ローカルで実行する場合、または独自のコードに組み込む場合	PUSHIZO_API_KEY

リモートサーバー（インストール不要）

Claude.ai / Claude Desktop： Settings → Connectors → カスタムコネクターを追加 → URL：https://api.pushizo.com/mcp。 Claude はブラウザーで Pushizo の認証画面を開きます。承認した組織、アプリ、スコープで動作します。

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 に対応していないクライアントには、スコープ付き API キーを Authorization: Bearer hs_live_… ヘッダーで指定できます。

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

ローカルサーバー（stdio）

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

パッケージには pushizo-mcp コマンドも含まれます（npm install -g @pushizo/mcp-server の実行後に pushizo-mcp を使用できます）。

環境変数	必須	説明
PUSHIZO_API_KEY	はい	hs_live_… API キーです。読み取りには segments:read と analytics:read、下書きツールにはさらに mcp:write が必要です。
PUSHIZO_API_URL	いいえ	API のルート URL。デフォルトは https://api.pushizo.com です。https が必要です。ローカル開発では http://localhost:<port> または http://127.0.0.1:<port> を使用できます。
PUSHIZO_APP_ID	いいえ	ツールに app_id が指定されていない場合に使用するアプリです。アプリに紐づくキーの場合は不要です。

stdout は MCP メッセージ専用です。診断メッセージとエラーメッセージは stderr に書き込まれます。キーがない場合、または URL が無効な場合、プロセスは終了コード 1 で終了します。

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

ツール

ツール	種類	必要なスコープ
list_segments, get_segment	読み取り	segments:read
list_campaigns, get_campaign, list_campaign_messages	読み取り	analytics:read
get_analytics_summary, list_templates	読み取り	analytics:read
list_messages, get_message	読み取り	analytics:read または notifications:write
create_campaign_draft	承認モード — 書き込み	mcp:write
create_segment_draft	承認モード — 書き込み	mcp:write

admin スコープですべてのツールが有効になります。書き込みツールは下書きのみを作成します（キャンペーンは常に draft、mcp タグ付き、セグメントは動的です）。また、アシスタントは呼び出す前にユーザーから明示的な承認を得るよう求められます。

ライブラリとして

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

開発

パッケージは Pushizo のメインリポジトリで開発・テストされ、このリポジトリにはリリースごとに自動的にミラーされます。利用するには、npm パッケージ（@pushizo/mcp-server）またはリモートサーバーをご利用ください。

---

サポート

• ガイド： docs.pushizo.com/docs/integrations/mcp
• API リファレンスと OpenAPI： docs.pushizo.com/docs/api · pushizo-openapi
• バグとアイデア： Issues
• セキュリティ： 公開の issue は作成せず、[email protected] までメールでご連絡ください。
• お問い合わせ： [email protected]

このリポジトリは、リリースごとに Pushizo のメインリポジトリから自動的にミラーされます。プルリクエストではなく issue を作成してください。修正はメインリポジトリに反映され、次のリリースでこちらにも反映されます。

MIT ライセンスの下で公開されています — LICENSE。