@pushizo/mcp-server 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Pushizo contributors
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Pushizo contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,185 +1,176 @@
1
- <!-- pushizo:header -->
2
- <p align="center">
3
- <a href="https://pushizo.com"><img src="https://raw.githubusercontent.com/pushizo/.github/main/profile/assets/mark.svg" alt="Pushizo" width="56" height="56"></a>
4
- </p>
5
- <p align="center">
6
- <a href="https://docs.pushizo.com/docs/integrations/mcp"><img src="https://img.shields.io/badge/docs-docs.pushizo.com-5b4bdb" alt="Docs"></a>
7
- <a href="https://docs.pushizo.com/docs/api"><img src="https://img.shields.io/badge/API-reference-b44fc4" alt="API reference"></a>
8
- <a href="https://github.com/pushizo/pushizo-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-16130f" alt="License: MIT"></a>
9
- </p>
10
- <p align="center"><a href="#english">English</a> · <a href="#türkçe">Türkçe</a></p>
11
-
12
- ## English
13
-
14
- **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.
15
-
16
- > **Status:** Publishing to npm is in progress.<br>
17
- > **Durum:** npm yayını hazırlanıyor.
18
-
19
- **Install from GitHub until then · O zamana kadar GitHub'dan kurulum:**
20
-
21
- ```bash
22
- npm install -g --allow-remote=root https://github.com/pushizo/pushizo-mcp/releases/download/v0.1.0/pushizo-mcp-server-0.1.0.tgz
23
- pushizo-mcp # PUSHIZO_API_KEY=hs_live_… ortamıyla / with PUSHIZO_API_KEY set
24
- ```
25
-
26
- **After publication · Yayından sonra:**
27
-
28
- ```bash
29
- # Remote server (no install)
30
- claude mcp add --transport http pushizo https://api.pushizo.com/mcp
31
-
32
- # Local server (stdio)
33
- PUSHIZO_API_KEY=hs_live_… npx -y @pushizo/mcp-server
34
- ```
35
-
36
- The detailed guide below is in Turkish; code samples are language-neutral. Full documentation:
37
- [docs.pushizo.com/docs/integrations/mcp](https://docs.pushizo.com/docs/integrations/mcp) · API reference: [docs.pushizo.com/docs/api](https://docs.pushizo.com/docs/api).
38
-
39
- ## Türkçe
40
- <!-- /pushizo:header -->
41
-
42
- # Pushizo MCP sunucusu
43
-
44
- Pushizo için [Model Context Protocol](https://modelcontextprotocol.io) (MCP) sunucusu. Claude, Cursor, VS Code gibi
45
- yapay zekâ istemcileri segment, kampanya, mesaj, şablon ve analitik verisini okuyabilir; onaylı modda yalnızca
46
- **taslak** kampanya ve segment oluşturabilir. Gönderim, zamanlama ve silme aracı yoktur; taslaklar panelden gözden
47
- geçirilip gönderilir.
48
-
49
- Araçlar yalnızca Pushizo public REST API'sini çağırır: yetki (API anahtarı kapsamları), IP izin listesi ve kiracı
50
- izolasyonu her çağrıda public API ile birebir aynıdır. Ayrıntılı rehber:
51
- [docs.pushizo.com/docs/integrations/mcp](https://docs.pushizo.com/docs/integrations/mcp).
52
-
53
- | Bağlantı | Ne zaman | Kimlik |
54
- |----------|----------|--------|
55
- | **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ı |
56
- | **Yerel sunucu** `npx -y @pushizo/mcp-server` (stdio) | Yerel çalıştırmak ya da kendi kodunuza gömmek | `PUSHIZO_API_KEY` |
57
-
58
- ## Uzak sunucu (kurulumsuz)
59
-
60
- **Claude.ai / Claude Desktop:** Settings → Connectors → **Add custom connector** → URL: `https://api.pushizo.com/mcp`.
61
- Claude tarayıcıda Pushizo yetkilendirme ekranını açar; onayladığınız organizasyon, app ve kapsamlarla çalışır.
62
-
63
- **Claude Code:**
64
-
65
- ```bash
66
- claude mcp add --transport http pushizo https://api.pushizo.com/mcp
67
- ```
68
-
69
- **Cursor** (`~/.cursor/mcp.json`):
70
-
71
- ```json
72
- {
73
- "mcpServers": {
74
- "pushizo": { "url": "https://api.pushizo.com/mcp" }
75
- }
76
- }
77
- ```
78
-
79
- **VS Code** (`.vscode/mcp.json`):
80
-
81
- ```json
82
- {
83
- "servers": {
84
- "pushizo": { "type": "http", "url": "https://api.pushizo.com/mcp" }
85
- }
86
- }
87
- ```
88
-
89
- OAuth desteklemeyen istemcilerde `Authorization: Bearer hs_live_…` başlığıyla kapsamlı bir API anahtarı verilebilir:
90
-
91
- ```bash
92
- 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"}'
93
- ```
94
-
95
- ## Yerel sunucu (stdio)
96
-
97
- ```bash
98
- PUSHIZO_API_KEY=hs_live_… npx -y @pushizo/mcp-server
99
- ```
100
-
101
- Paket `pushizo-mcp` komutunu da sağlar (`npm install -g @pushizo/mcp-server` sonrası `pushizo-mcp`).
102
-
103
- | Ortam değişkeni | Zorunlu | Açıklama |
104
- |---|---|---|
105
- | `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`. |
106
- | `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. |
107
- | `PUSHIZO_APP_ID` | hayır | Araçta `app_id` verilmezse kullanılacak app. App'e bağlı anahtarda gerekmez. |
108
-
109
- stdout yalnızca MCP iletileri içindir; tanılama ve hata metinleri stderr'e yazılır. Anahtar eksikse veya adres
110
- geçersizse süreç 1 koduyla çıkar.
111
-
112
- ## Claude Desktop
113
-
114
- `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\Claude\`):
115
-
116
- ```json
117
- {
118
- "mcpServers": {
119
- "pushizo": {
120
- "command": "npx",
121
- "args": ["-y", "@pushizo/mcp-server"],
122
- "env": {
123
- "PUSHIZO_API_KEY": "hs_live_…",
124
- "PUSHIZO_API_URL": "https://api.pushizo.com",
125
- "PUSHIZO_APP_ID": "app_…"
126
- }
127
- }
128
- }
129
- }
130
- ```
131
-
132
- ## Araçlar
133
-
134
- 54 araç. Ayrıntılı liste `docs/guides/mcp.md` içindedir. Özet:
135
-
136
- | Araç | Tür | Gerekli kapsam |
137
- |---|---|---|
138
- | `list_segments`, `get_segment`, `preview_segment`, `estimate_segment`, `list_segment_campaigns` | okuma | `segments:read` |
139
- | Kampanya, şablon, journey, analitik, in-app, web büyüme ve gelen kutusu okuma araçları | okuma | `analytics:read` |
140
- | `list_messages`, `get_message` | okuma | `analytics:read` veya `notifications:write` |
141
- | `get_app`, `search_users`, `get_user`, `get_user_journeys`, `get_user_preferences`, `list_categories` | okuma | `users:read` |
142
- | `create_campaign_draft`, `create_segment_draft`, `create_template_draft`, `create_journey_draft`, `create_in_app_draft` | onaylı mod — taslak | `mcp:write` |
143
- | `send_test_notification` | onaylı mod — yalnız test cihazı | `mcp:write` |
144
-
145
- `admin` kapsamı tüm araçları açar. Taslak araçları gönderim, zamanlama ve yayın yapmaz (kampanya ve journey/in-app
146
- `draft`, şablon ve kampanyaya `mcp` etiketi, segment dinamik). `send_test_notification` gerçek kitleye gidemez.
147
- Asistandan çağırmadan önce kullanıcının açık onayı istenir.
148
-
149
- ## Kütüphane olarak
150
-
151
- ```ts
152
- import { createFetchApi, createPushizoMcpServer } from '@pushizo/mcp-server';
153
-
154
- const server = createPushizoMcpServer({
155
- api: createFetchApi({ baseUrl: 'https://api.pushizo.com', apiKey: process.env.PUSHIZO_API_KEY! }),
156
- defaultAppId: process.env.PUSHIZO_APP_ID,
157
- });
158
- // server.connect(<MCP taşıması>)
159
- ```
160
-
161
- ## Geliştirme
162
-
163
- Paket Pushizo ana deposunda geliştirilir ve test edilir; bu depo her sürümde oradan otomatik yansıtılır. Kullanmak
164
- için npm paketini (`@pushizo/mcp-server`) ya da uzak sunucuyu tercih edin.
165
-
166
- <!-- pushizo:footer -->
167
- ---
168
-
169
- ## Support · Destek
170
-
171
- - **Guide · Rehber:** [docs.pushizo.com/docs/integrations/mcp](https://docs.pushizo.com/docs/integrations/mcp)
172
- - **API reference & OpenAPI · API referansı ve OpenAPI:** [docs.pushizo.com/docs/api](https://docs.pushizo.com/docs/api) ·
173
- [pushizo-openapi](https://github.com/pushizo/pushizo-openapi)
174
- - **Bugs & ideas · Hata ve öneri:** [Issues](https://github.com/pushizo/pushizo-mcp/issues)
175
- - **Security · Güvenlik:** please do not open public issues; email [security@pushizo.com](mailto:security@pushizo.com) ·
176
- herkese açık issue açmayın, bu adrese yazın.
177
- - **Help · Destek:** [support@pushizo.com](mailto:support@pushizo.com)
178
-
179
- This repository is mirrored automatically from the Pushizo main repository on every release. Please open an issue
180
- instead of a pull request; fixes land in the main repository and ship with the next release.
181
- Bu depo her sürümde Pushizo ana deposundan otomatik yansıtılır. Pull request yerine issue açın; düzeltmeler ana depoda
182
- yapılır ve bir sonraki sürümle buraya gelir.
183
-
184
- Released under the MIT License · MIT lisanslıdır — [LICENSE](https://github.com/pushizo/pushizo-mcp/blob/main/LICENSE).
185
- <!-- /pushizo:footer -->
1
+ <!-- pushizo:header -->
2
+ <p align="center">
3
+ <a href="https://pushizo.com"><img src="https://raw.githubusercontent.com/pushizo/.github/main/profile/assets/mark.svg" alt="Pushizo" width="56" height="56"></a>
4
+ </p>
5
+ <p align="center">
6
+ <a href="https://docs.pushizo.com/docs/integrations/mcp"><img src="https://img.shields.io/badge/docs-docs.pushizo.com-5b4bdb" alt="Docs"></a>
7
+ <a href="https://docs.pushizo.com/docs/api"><img src="https://img.shields.io/badge/API-reference-b44fc4" alt="API reference"></a>
8
+ <a href="https://github.com/pushizo/pushizo-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-16130f" alt="License: MIT"></a>
9
+ </p>
10
+ <p align="center"><a href="#english">English</a> · <a href="#türkçe">Türkçe</a></p>
11
+
12
+ ## English
13
+
14
+ **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.
15
+
16
+ ```bash
17
+ # Remote server (no install)
18
+ claude mcp add --transport http pushizo https://api.pushizo.com/mcp
19
+
20
+ # Local server (stdio)
21
+ PUSHIZO_API_KEY=hs_live_… npx -y @pushizo/mcp-server
22
+ ```
23
+
24
+ The detailed guide below is in Turkish; code samples are language-neutral. Full documentation:
25
+ [docs.pushizo.com/docs/integrations/mcp](https://docs.pushizo.com/docs/integrations/mcp) · API reference: [docs.pushizo.com/docs/api](https://docs.pushizo.com/docs/api).
26
+
27
+ ## Türkçe
28
+ <!-- /pushizo:header -->
29
+
30
+ # Pushizo MCP sunucusu
31
+
32
+ Pushizo için [Model Context Protocol](https://modelcontextprotocol.io) (MCP) sunucusu. Claude, Cursor, VS Code gibi
33
+ yapay zekâ istemcileri segment, kampanya, mesaj, şablon ve analitik verisini okuyabilir; onaylı modda yalnızca
34
+ **taslak** kampanya ve segment oluşturabilir. Gönderim, zamanlama ve silme aracı yoktur; taslaklar panelden gözden
35
+ geçirilip gönderilir.
36
+
37
+ Araçlar yalnızca Pushizo public REST API'sini çağırır: yetki (API anahtarı kapsamları), IP izin listesi ve kiracı
38
+ izolasyonu her çağrıda public API ile birebir aynıdır. Ayrıntılı rehber:
39
+ [docs.pushizo.com/docs/integrations/mcp](https://docs.pushizo.com/docs/integrations/mcp).
40
+
41
+ | Bağlantı | Ne zaman | Kimlik |
42
+ |----------|----------|--------|
43
+ | **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ı |
44
+ | **Yerel sunucu** `npx -y @pushizo/mcp-server` (stdio) | Yerel çalıştırmak ya da kendi kodunuza gömmek | `PUSHIZO_API_KEY` |
45
+
46
+ ## Uzak sunucu (kurulumsuz)
47
+
48
+ **Claude.ai / Claude Desktop:** Settings → Connectors → **Add custom connector** → URL: `https://api.pushizo.com/mcp`.
49
+ Claude tarayıcıda Pushizo yetkilendirme ekranını açar; onayladığınız organizasyon, app ve kapsamlarla çalışır.
50
+
51
+ **Claude Code:**
52
+
53
+ ```bash
54
+ claude mcp add --transport http pushizo https://api.pushizo.com/mcp
55
+ ```
56
+
57
+ **Cursor** (`~/.cursor/mcp.json`):
58
+
59
+ ```json
60
+ {
61
+ "mcpServers": {
62
+ "pushizo": { "url": "https://api.pushizo.com/mcp" }
63
+ }
64
+ }
65
+ ```
66
+
67
+ **VS Code** (`.vscode/mcp.json`):
68
+
69
+ ```json
70
+ {
71
+ "servers": {
72
+ "pushizo": { "type": "http", "url": "https://api.pushizo.com/mcp" }
73
+ }
74
+ }
75
+ ```
76
+
77
+ OAuth desteklemeyen istemcilerde `Authorization: Bearer hs_live_…` başlığıyla kapsamlı bir API anahtarı verilebilir:
78
+
79
+ ```bash
80
+ 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"}'
81
+ ```
82
+
83
+ ## Yerel sunucu (stdio)
84
+
85
+ ```bash
86
+ PUSHIZO_API_KEY=hs_live_… npx -y @pushizo/mcp-server
87
+ ```
88
+
89
+ Paket `pushizo-mcp` komutunu da sağlar (`npm install -g @pushizo/mcp-server` sonrası `pushizo-mcp`).
90
+
91
+ | Ortam değişkeni | Zorunlu | Açıklama |
92
+ |---|---|---|
93
+ | `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`. |
94
+ | `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. |
95
+ | `PUSHIZO_APP_ID` | hayır | Araçta `app_id` verilmezse kullanılacak app. App'e bağlı anahtarda gerekmez. |
96
+
97
+ stdout yalnızca MCP iletileri içindir; tanılama ve hata metinleri stderr'e yazılır. Anahtar eksikse veya adres
98
+ geçersizse süreç 1 koduyla çıkar.
99
+
100
+ ## Claude Desktop
101
+
102
+ `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\Claude\`):
103
+
104
+ ```json
105
+ {
106
+ "mcpServers": {
107
+ "pushizo": {
108
+ "command": "npx",
109
+ "args": ["-y", "@pushizo/mcp-server"],
110
+ "env": {
111
+ "PUSHIZO_API_KEY": "hs_live_…",
112
+ "PUSHIZO_API_URL": "https://api.pushizo.com",
113
+ "PUSHIZO_APP_ID": "app_…"
114
+ }
115
+ }
116
+ }
117
+ }
118
+ ```
119
+
120
+ ## Araçlar
121
+
122
+ 228 araç (218 okuma, 9 taslak, test gönderimi); public API'deki her okuma ucunun bir aracı vardır. Ayrıntılı liste
123
+ `docs/guides/mcp.md` içindedir. Özet:
124
+
125
+ | Araç | Tür | Gerekli kapsam |
126
+ |---|---|---|
127
+ | `list_segments`, `get_segment`, `preview_segment`, `estimate_segment`, `list_segment_campaigns` | okuma | `segments:read` |
128
+ | Kampanya, şablon, journey, analitik, in-app, web büyüme ve gelen kutusu okuma araçları | okuma | `analytics:read` |
129
+ | RFM, öngörü, karar ajanı, kanal skoru, özellik bayrağı, rapor, yol analizi, katalog ve öneri, bölge araçları | okuma | `analytics:read` |
130
+ | `list_messages`, `get_message` | okuma | `analytics:read` veya `notifications:write` |
131
+ | `get_app`, `search_users`, `get_user`, `get_user_journeys`, `get_user_preferences`, `list_categories`, `list_rfm_users`, `list_prediction_users`, `list_wallet_templates` | okuma | `users:read` |
132
+ | Şirket, ilgi etiketleri, SQL sorgu (`run_sql_query`, yalnız SELECT), veri boru hattı, ambar segmenti, konuşma ve AI ajanı, özel AI ajanları, web kişiselleştirme, site içi arama, reklam, kaldırma ve Android teslimat raporu okuma araçları | okuma | `users:read`, `analytics:read`, `segments:read` veya `admin` (araca göre) |
133
+ | `create_campaign_draft`, `create_segment_draft`, `create_template_draft`, `create_journey_draft`, `create_in_app_draft`, `create_web_campaign_draft`, `create_web_personalization_draft`, `create_survey_draft`, `create_landing_page_draft` | onaylı mod — taslak | `mcp:write` |
134
+ | `send_test_notification` | onaylı mod — yalnız test cihazı | `mcp:write` |
135
+
136
+ `admin` kapsamı tüm araçları açar. Taslak araçları gönderim, zamanlama ve yayın yapmaz (kampanya, journey, in-app, web kampanyası, web kişiselleştirme, anket ve landing
137
+ `draft`, şablon ve kampanyaya `mcp` etiketi, segment dinamik). `send_test_notification` gerçek kitleye gidemez.
138
+ Asistandan çağırmadan önce kullanıcının açık onayı istenir.
139
+
140
+ ## Kütüphane olarak
141
+
142
+ ```ts
143
+ import { createFetchApi, createPushizoMcpServer } from '@pushizo/mcp-server';
144
+
145
+ const server = createPushizoMcpServer({
146
+ api: createFetchApi({ baseUrl: 'https://api.pushizo.com', apiKey: process.env.PUSHIZO_API_KEY! }),
147
+ defaultAppId: process.env.PUSHIZO_APP_ID,
148
+ });
149
+ // server.connect(<MCP taşıması>)
150
+ ```
151
+
152
+ ## Geliştirme
153
+
154
+ Paket Pushizo ana deposunda geliştirilir ve test edilir; bu depo her sürümde oradan otomatik yansıtılır. Kullanmak
155
+ için npm paketini (`@pushizo/mcp-server`) ya da uzak sunucuyu tercih edin.
156
+
157
+ <!-- pushizo:footer -->
158
+ ---
159
+
160
+ ## Support · Destek
161
+
162
+ - **Guide · Rehber:** [docs.pushizo.com/docs/integrations/mcp](https://docs.pushizo.com/docs/integrations/mcp)
163
+ - **API reference & OpenAPI · API referansı ve OpenAPI:** [docs.pushizo.com/docs/api](https://docs.pushizo.com/docs/api) ·
164
+ [pushizo-openapi](https://github.com/pushizo/pushizo-openapi)
165
+ - **Bugs & ideas · Hata ve öneri:** [Issues](https://github.com/pushizo/pushizo-mcp/issues)
166
+ - **Security · Güvenlik:** please do not open public issues; email [security@pushizo.com](mailto:security@pushizo.com) ·
167
+ herkese açık issue açmayın, bu adrese yazın.
168
+ - **Help · Destek:** [support@pushizo.com](mailto:support@pushizo.com)
169
+
170
+ This repository is mirrored automatically from the Pushizo main repository on every release. Please open an issue
171
+ instead of a pull request; fixes land in the main repository and ship with the next release.
172
+ Bu depo her sürümde Pushizo ana deposundan otomatik yansıtılır. Pull request yerine issue açın; düzeltmeler ana depoda
173
+ yapılır ve bir sonraki sürümle buraya gelir.
174
+
175
+ Released under the MIT License · MIT lisanslıdır — [LICENSE](https://github.com/pushizo/pushizo-mcp/blob/main/LICENSE).
176
+ <!-- /pushizo:footer -->
package/dist/kit.d.ts CHANGED
@@ -12,6 +12,12 @@ export declare const cursorArg: z.ZodOptional<z.ZodString>;
12
12
  export declare const idArg: (what: string) => z.ZodString;
13
13
  export declare const fromArg: z.ZodOptional<z.ZodString>;
14
14
  export declare const toArg: z.ZodOptional<z.ZodString>;
15
+ /** Kullanıcıyı kimlik etiketiyle seçen ortak argümanlar (`/users/by/{label}/{value}` uçları). */
16
+ export declare const aliasArgs: {
17
+ label: z.ZodString;
18
+ value: z.ZodString;
19
+ };
20
+ export declare const compareArg: z.ZodOptional<z.ZodBoolean>;
15
21
  /** Segment/arama tanımı: all/any/none koşul grupları (segment taslağıyla aynı biçim). */
16
22
  export declare const definitionArg: z.ZodRecord<z.ZodString, z.ZodUnknown>;
17
23
  export declare function query(params: Record<string, string | number | boolean | undefined>): string;
@@ -25,6 +31,9 @@ export interface ToolKit {
25
31
  run: (fn: () => Promise<unknown>) => Promise<CallToolResult>;
26
32
  }
27
33
  export declare function createToolKit(api: PushizoApi, defaultAppId?: string): ToolKit;
28
- /** Yol parçası (kimlik, alias değeri) güvenli kodlama. */
29
- export declare const seg: (value: string) => string;
34
+ /**
35
+ * Yol parçası (kimlik, alias değeri, olay adı) güvenli kodlama. `encodeURIComponent` noktayı kodlamaz; `.` ve `..`
36
+ * tek başına yol parçası olunca istek başka uca gider, bu yüzden reddedilir.
37
+ */
38
+ export declare function seg(value: string): string;
30
39
  //# sourceMappingURL=kit.d.ts.map
package/dist/kit.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,IAAI,EAAE,eAA4G,CAAC;AAChI,4GAA4G;AAC5G,eAAO,MAAM,KAAK,EAAE,eAA8G,CAAC;AAEnI,eAAO,MAAM,UAAU,QAEwE,CAAC;AAEhG,eAAO,MAAM,QAAQ,4BAAuI,CAAC;AAC7J,eAAO,MAAM,QAAQ,4BAAwF,CAAC;AAC9G,eAAO,MAAM,SAAS,4BAAoF,CAAC;AAC3G,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,gBAA0D,CAAC;AAC7F,eAAO,MAAM,OAAO,4BAAyH,CAAC;AAC9I,eAAO,MAAM,KAAK,4BAA4D,CAAC;AAC/E,yFAAyF;AACzF,eAAO,MAAM,aAAa,wCAEwH,CAAC;AAEnJ,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,MAAM,CAK3F;AAED,wBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAEhD;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAQjD;AAED,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,UAAU,CAAC;IAChB,mEAAmE;IACnE,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAc7E;AAED,0DAA0D;AAC1D,eAAO,MAAM,GAAG,GAAI,OAAO,MAAM,KAAG,MAAmC,CAAC"}
1
+ {"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,IAAI,EAAE,eAA4G,CAAC;AAChI,4GAA4G;AAC5G,eAAO,MAAM,KAAK,EAAE,eAA8G,CAAC;AAEnI,eAAO,MAAM,UAAU,QAE4E,CAAC;AASpG,eAAO,MAAM,QAAQ,4BAAwK,CAAC;AAC9L,eAAO,MAAM,QAAQ,4BAAkF,CAAC;AACxG,eAAO,MAAM,SAAS,4BAAiG,CAAC;AACxH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,gBAAmF,CAAC;AACtH,eAAO,MAAM,OAAO,4BAAwH,CAAC;AAC7I,eAAO,MAAM,KAAK,4BAA0D,CAAC;AAC7E,iGAAiG;AACjG,eAAO,MAAM,SAAS;;;CAGrB,CAAC;AACF,eAAO,MAAM,UAAU,6BAAuG,CAAC;AAC/H,yFAAyF;AACzF,eAAO,MAAM,aAAa,wCAEiI,CAAC;AAE5J,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,MAAM,CAK3F;AAED,wBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAEhD;AAQD,wBAAgB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAUjD;AAED,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,UAAU,CAAC;IAChB,mEAAmE;IACnE,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAc7E;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzC"}
package/dist/kit.js CHANGED
@@ -4,18 +4,30 @@ import { PushizoApiError } from './api.js';
4
4
  export const READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
5
5
  /** Yazma araçları: yalnızca taslak oluşturur (gönderim/silme yok), sunucuda `mcp:write` kapsamı zorunlu. */
6
6
  export const WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
7
- export const WRITE_NOTE = '[Onaylı mod — yazma] Bu araç Pushizo’da kayıt oluşturur. Yalnızca TASLAK oluşturur, hiçbir mesaj göndermez veya zamanlamaz; ' +
8
- 'API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın.';
9
- export const appIdArg = z.string().min(1).max(64).optional().describe('App kimliği (app_…). App’e bağlı anahtarda veya varsayılan app tanımlıysa gerekmez.');
10
- export const limitArg = z.number().int().min(1).max(100).optional().describe('Sayfa boyutu (varsayılan 20).');
11
- export const cursorArg = z.string().max(500).optional().describe('Önceki yanıttaki `next_cursor` değeri.');
12
- export const idArg = (what) => z.string().min(1).max(64).describe(`${what} kimliği`);
13
- export const fromArg = z.string().max(40).optional().describe('ISO-8601 başlangıç (ör. 2026-10-01T00:00:00Z); verilmezse rapor varsayılanı.');
14
- export const toArg = z.string().max(40).optional().describe('ISO-8601 bitiş.');
7
+ export const WRITE_NOTE = '[Approved mode — write] This tool creates a record in Pushizo. It only creates a DRAFT and never sends or schedules a message; ' +
8
+ 'the API key needs the `mcp:write` scope. Get explicit approval from the user before calling it.';
9
+ /**
10
+ * Kimlikler URL yoluna yazılır: `.` ve `..` WHATWG URL çözümlemesinde başka uca kayar, `/` yolu böler. Desen bunları
11
+ * dışarıda bırakır (ADR-0076 §5).
12
+ */
13
+ const ID_PATTERN = /^(?!\.{1,2}$)[A-Za-z0-9_.:-]+$/;
14
+ const ID_MESSAGE = 'ID may only contain letters, digits, `_`, `-`, `.` and `:`.';
15
+ export const appIdArg = z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).optional().describe('App ID (app_…). Not needed with an app-scoped key or when a default app is configured.');
16
+ export const limitArg = z.number().int().min(1).max(100).optional().describe('Page size (default 20).');
17
+ export const cursorArg = z.string().max(500).optional().describe('The `next_cursor` value from the previous response.');
18
+ export const idArg = (what) => z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).describe(`${what} ID`);
19
+ export const fromArg = z.string().max(40).optional().describe('ISO-8601 start (e.g. 2026-10-01T00:00:00Z); defaults to the report default.');
20
+ export const toArg = z.string().max(40).optional().describe('ISO-8601 end.');
21
+ /** Kullanıcıyı kimlik etiketiyle seçen ortak argümanlar (`/users/by/{label}/{value}` uçları). */
22
+ export const aliasArgs = {
23
+ label: z.string().min(1).max(64).describe('Identity label: `external_id`, `pushizo_id` or a defined alias (e.g. `crm_id`).'),
24
+ value: z.string().min(1).max(255).describe('Value for the label (e.g. the external_id value).'),
25
+ };
26
+ export const compareArg = z.boolean().optional().describe('true: adds a comparison with the previous period of equal length.');
15
27
  /** Segment/arama tanımı: all/any/none koşul grupları (segment taslağıyla aynı biçim). */
16
28
  export const definitionArg = z
17
29
  .record(z.string(), z.unknown())
18
- .describe('Koşul tanımı, ör. {"all":[{"field":"tags.plan","op":"eq","value":"pro"},{"field":"last_active_at","op":"within_days","value":30}]}.');
30
+ .describe('Condition definition, e.g. {"all":[{"field":"tags.plan","op":"eq","value":"pro"},{"field":"last_active_at","op":"within_days","value":30}]}.');
19
31
  export function query(params) {
20
32
  const q = new URLSearchParams();
21
33
  for (const [k, v] of Object.entries(params))
@@ -27,11 +39,18 @@ export function query(params) {
27
39
  export function ok(data) {
28
40
  return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
29
41
  }
42
+ /** Sık görülen durum kodları için modelin sonraki adımını belirleyen ipucu. */
43
+ const HTTP_HINTS = {
44
+ 403: ' — Check the API key scopes.',
45
+ 429: ' — Rate limited; wait a few seconds and retry, and reduce back-to-back calls.',
46
+ };
30
47
  export function fail(err) {
31
48
  const text = err instanceof PushizoApiError
32
- ? `${err.code} (HTTP ${err.status}): ${err.message}${err.status === 403 ? ' — API anahtarının kapsamlarını kontrol edin.' : ''}`
49
+ ? `${err.code} (HTTP ${err.status}): ${err.message}${HTTP_HINTS[err.status] ?? ''}`
33
50
  : err instanceof Error
34
- ? err.message
51
+ ? err.name === 'TimeoutError' || err.name === 'AbortError'
52
+ ? 'Request timed out; retry with a narrower date range or a smaller `limit`.'
53
+ : err.message
35
54
  : String(err);
36
55
  return { isError: true, content: [{ type: 'text', text }] };
37
56
  }
@@ -39,8 +58,8 @@ export function createToolKit(api, defaultAppId) {
39
58
  function app(appId) {
40
59
  const id = appId ?? defaultAppId;
41
60
  if (!id)
42
- throw new Error('app_id gerekli (anahtar organizasyon geneliyse araçta app_id verin).');
43
- return encodeURIComponent(id);
61
+ throw new Error('app_id is required (pass app_id in the tool call when the key is organization-wide).');
62
+ return seg(id);
44
63
  }
45
64
  async function run(fn) {
46
65
  try {
@@ -52,6 +71,13 @@ export function createToolKit(api, defaultAppId) {
52
71
  }
53
72
  return { api, app, run };
54
73
  }
55
- /** Yol parçası (kimlik, alias değeri) güvenli kodlama. */
56
- export const seg = (value) => encodeURIComponent(value);
74
+ /**
75
+ * Yol parçası (kimlik, alias değeri, olay adı) güvenli kodlama. `encodeURIComponent` noktayı kodlamaz; `.` ve `..`
76
+ * tek başına yol parçası olunca istek başka uca gider, bu yüzden reddedilir.
77
+ */
78
+ export function seg(value) {
79
+ if (value === '.' || value === '..')
80
+ throw new Error('Invalid value: `.` and `..` cannot be used as path segments.');
81
+ return encodeURIComponent(value);
82
+ }
57
83
  //# sourceMappingURL=kit.js.map
package/dist/kit.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"kit.js","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"kit.js","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"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"}
package/dist/server.d.ts CHANGED
@@ -1,15 +1,25 @@
1
1
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
2
  import type { PushizoApi } from './api.js';
3
3
  export declare const MCP_SERVER_NAME = "pushizo";
4
- export declare const MCP_SERVER_VERSION = "1.1.0";
4
+ /** `serverInfo.version`; `package.json` sürümüyle aynı olmalıdır (test zorlar). */
5
+ export declare const MCP_SERVER_VERSION = "0.3.0";
5
6
  export interface PushizoMcpOptions {
6
7
  api: PushizoApi;
7
8
  /** Araçta `app_id` verilmezse kullanılan app (app'e bağlı anahtarda anahtarın app'i). */
8
9
  defaultAppId?: string;
10
+ /**
11
+ * Anahtarın kapsamları biliniyorsa (HTTP taşıma): yazma araçları yalnızca `mcp:write` veya `admin` varken listelenir.
12
+ * Verilmezse (stdio) tüm araçlar listelenir; yetki her çağrıda yine sunucuda denetlenir.
13
+ */
14
+ scopes?: readonly string[];
9
15
  }
16
+ /** Yazma araçları listelensin mi: kapsam bilinmiyorsa evet, biliniyorsa `mcp:write` veya `admin` gerekir. */
17
+ export declare function canListWriteTools(scopes: readonly string[] | undefined): boolean;
10
18
  /**
11
19
  * Pushizo MCP sunucusu (ADR-0031 §6, ADR-0043): segment, kampanya, mesaj, şablon, journey, kullanıcı, olay, analitik,
12
- * in-app ve web büyüme okuma araçları; kampanya/segment/şablon/journey/in-app taslağı ve test cihazlarına test gönderimi.
20
+ * in-app ve web büyüme okuma araçları; veri (şirket, SQL, boru hattı, ambar) ve etkileşim (konuşma, AI ajanı, site
21
+ * araması, reklam) okuma araçları; kampanya/segment/şablon/journey/in-app/web kampanyası/web kişiselleştirme/anket/
22
+ * landing taslağı ve test cihazlarına test gönderimi.
13
23
  * Taşıma bağımsızdır (stdio, Streamable HTTP, testte in-memory).
14
24
  */
15
25
  export declare function createPushizoMcpServer(options: PushizoMcpOptions): McpServer;
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAK3C,eAAO,MAAM,eAAe,YAAY,CAAC;AACzC,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,UAAU,CAAC;IAChB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CA0J5E"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAS3C,eAAO,MAAM,eAAe,YAAY,CAAC;AACzC,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,UAAU,CAAC;IAChB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,6GAA6G;AAC7G,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAEhF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAiK5E"}