@pushizo/mcp-server 0.1.0 → 0.2.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 +21 -21
- package/README.md +174 -185
- package/dist/kit.d.ts +5 -2
- package/dist/kit.d.ts.map +1 -1
- package/dist/kit.js +27 -7
- package/dist/kit.js.map +1 -1
- package/dist/server.d.ts +9 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +56 -45
- package/dist/server.js.map +1 -1
- package/dist/stdio.js +0 -0
- package/dist/tools-insights.d.ts +10 -0
- package/dist/tools-insights.d.ts.map +1 -0
- package/dist/tools-insights.js +207 -0
- package/dist/tools-insights.js.map +1 -0
- package/package.json +60 -60
- package/server.json +3 -3
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,174 @@
|
|
|
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
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
{
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
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
|
+
73 araç. Ayrıntılı liste `docs/guides/mcp.md` içindedir. Özet:
|
|
123
|
+
|
|
124
|
+
| Araç | Tür | Gerekli kapsam |
|
|
125
|
+
|---|---|---|
|
|
126
|
+
| `list_segments`, `get_segment`, `preview_segment`, `estimate_segment`, `list_segment_campaigns` | okuma | `segments:read` |
|
|
127
|
+
| Kampanya, şablon, journey, analitik, in-app, web büyüme ve gelen kutusu okuma araçları | okuma | `analytics:read` |
|
|
128
|
+
| RFM, öngörü, karar ajanı, kanal skoru, özellik bayrağı, rapor, yol analizi, katalog ve öneri, bölge araçları | okuma | `analytics:read` |
|
|
129
|
+
| `list_messages`, `get_message` | okuma | `analytics:read` veya `notifications:write` |
|
|
130
|
+
| `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` |
|
|
131
|
+
| `create_campaign_draft`, `create_segment_draft`, `create_template_draft`, `create_journey_draft`, `create_in_app_draft` | onaylı mod — taslak | `mcp:write` |
|
|
132
|
+
| `send_test_notification` | onaylı mod — yalnız test cihazı | `mcp:write` |
|
|
133
|
+
|
|
134
|
+
`admin` kapsamı tüm araçları açar. Taslak araçları gönderim, zamanlama ve yayın yapmaz (kampanya ve journey/in-app
|
|
135
|
+
`draft`, şablon ve kampanyaya `mcp` etiketi, segment dinamik). `send_test_notification` gerçek kitleye gidemez.
|
|
136
|
+
Asistandan çağırmadan önce kullanıcının açık onayı istenir.
|
|
137
|
+
|
|
138
|
+
## Kütüphane olarak
|
|
139
|
+
|
|
140
|
+
```ts
|
|
141
|
+
import { createFetchApi, createPushizoMcpServer } from '@pushizo/mcp-server';
|
|
142
|
+
|
|
143
|
+
const server = createPushizoMcpServer({
|
|
144
|
+
api: createFetchApi({ baseUrl: 'https://api.pushizo.com', apiKey: process.env.PUSHIZO_API_KEY! }),
|
|
145
|
+
defaultAppId: process.env.PUSHIZO_APP_ID,
|
|
146
|
+
});
|
|
147
|
+
// server.connect(<MCP taşıması>)
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
## Geliştirme
|
|
151
|
+
|
|
152
|
+
Paket Pushizo ana deposunda geliştirilir ve test edilir; bu depo her sürümde oradan otomatik yansıtılır. Kullanmak
|
|
153
|
+
için npm paketini (`@pushizo/mcp-server`) ya da uzak sunucuyu tercih edin.
|
|
154
|
+
|
|
155
|
+
<!-- pushizo:footer -->
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## Support · Destek
|
|
159
|
+
|
|
160
|
+
- **Guide · Rehber:** [docs.pushizo.com/docs/integrations/mcp](https://docs.pushizo.com/docs/integrations/mcp)
|
|
161
|
+
- **API reference & OpenAPI · API referansı ve OpenAPI:** [docs.pushizo.com/docs/api](https://docs.pushizo.com/docs/api) ·
|
|
162
|
+
[pushizo-openapi](https://github.com/pushizo/pushizo-openapi)
|
|
163
|
+
- **Bugs & ideas · Hata ve öneri:** [Issues](https://github.com/pushizo/pushizo-mcp/issues)
|
|
164
|
+
- **Security · Güvenlik:** please do not open public issues; email [security@pushizo.com](mailto:security@pushizo.com) ·
|
|
165
|
+
herkese açık issue açmayın, bu adrese yazın.
|
|
166
|
+
- **Help · Destek:** [support@pushizo.com](mailto:support@pushizo.com)
|
|
167
|
+
|
|
168
|
+
This repository is mirrored automatically from the Pushizo main repository on every release. Please open an issue
|
|
169
|
+
instead of a pull request; fixes land in the main repository and ship with the next release.
|
|
170
|
+
Bu depo her sürümde Pushizo ana deposundan otomatik yansıtılır. Pull request yerine issue açın; düzeltmeler ana depoda
|
|
171
|
+
yapılır ve bir sonraki sürümle buraya gelir.
|
|
172
|
+
|
|
173
|
+
Released under the MIT License · MIT lisanslıdır — [LICENSE](https://github.com/pushizo/pushizo-mcp/blob/main/LICENSE).
|
|
174
|
+
<!-- /pushizo:footer -->
|
package/dist/kit.d.ts
CHANGED
|
@@ -25,6 +25,9 @@ export interface ToolKit {
|
|
|
25
25
|
run: (fn: () => Promise<unknown>) => Promise<CallToolResult>;
|
|
26
26
|
}
|
|
27
27
|
export declare function createToolKit(api: PushizoApi, defaultAppId?: string): ToolKit;
|
|
28
|
-
/**
|
|
29
|
-
|
|
28
|
+
/**
|
|
29
|
+
* Yol parçası (kimlik, alias değeri, olay adı) güvenli kodlama. `encodeURIComponent` noktayı kodlamaz; `.` ve `..`
|
|
30
|
+
* tek başına yol parçası olunca istek başka uca gider, bu yüzden reddedilir.
|
|
31
|
+
*/
|
|
32
|
+
export declare function seg(value: string): string;
|
|
30
33
|
//# 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;
|
|
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;AAShG,eAAO,MAAM,QAAQ,4BAAqK,CAAC;AAC3L,eAAO,MAAM,QAAQ,4BAAwF,CAAC;AAC9G,eAAO,MAAM,SAAS,4BAAoF,CAAC;AAC3G,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,gBAAwF,CAAC;AAC3H,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;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
|
@@ -6,10 +6,16 @@ export const READ = { readOnlyHint: true, destructiveHint: false, idempotentHint
|
|
|
6
6
|
export const WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
|
|
7
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
8
|
'API anahtarında `mcp:write` kapsamı olmalıdır. Çağırmadan önce kullanıcıdan açık onay alın.';
|
|
9
|
-
|
|
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 = 'Kimlik yalnızca harf, rakam, `_`, `-`, `.` ve `:` içerebilir.';
|
|
15
|
+
export const appIdArg = z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).optional().describe('App kimliği (app_…). App’e bağlı anahtarda veya varsayılan app tanımlıysa gerekmez.');
|
|
10
16
|
export const limitArg = z.number().int().min(1).max(100).optional().describe('Sayfa boyutu (varsayılan 20).');
|
|
11
17
|
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`);
|
|
18
|
+
export const idArg = (what) => z.string().min(1).max(64).regex(ID_PATTERN, ID_MESSAGE).describe(`${what} kimliği`);
|
|
13
19
|
export const fromArg = z.string().max(40).optional().describe('ISO-8601 başlangıç (ör. 2026-10-01T00:00:00Z); verilmezse rapor varsayılanı.');
|
|
14
20
|
export const toArg = z.string().max(40).optional().describe('ISO-8601 bitiş.');
|
|
15
21
|
/** Segment/arama tanımı: all/any/none koşul grupları (segment taslağıyla aynı biçim). */
|
|
@@ -27,11 +33,18 @@ export function query(params) {
|
|
|
27
33
|
export function ok(data) {
|
|
28
34
|
return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
|
|
29
35
|
}
|
|
36
|
+
/** Sık görülen durum kodları için modelin sonraki adımını belirleyen ipucu. */
|
|
37
|
+
const HTTP_HINTS = {
|
|
38
|
+
403: ' — API anahtarının kapsamlarını kontrol edin.',
|
|
39
|
+
429: ' — Hız sınırına takıldı; birkaç saniye bekleyip yeniden deneyin, art arda çağrıları azaltın.',
|
|
40
|
+
};
|
|
30
41
|
export function fail(err) {
|
|
31
42
|
const text = err instanceof PushizoApiError
|
|
32
|
-
? `${err.code} (HTTP ${err.status}): ${err.message}${err.status
|
|
43
|
+
? `${err.code} (HTTP ${err.status}): ${err.message}${HTTP_HINTS[err.status] ?? ''}`
|
|
33
44
|
: err instanceof Error
|
|
34
|
-
? err.
|
|
45
|
+
? err.name === 'TimeoutError' || err.name === 'AbortError'
|
|
46
|
+
? 'İstek zaman aşımına uğradı; daha dar bir tarih aralığı veya daha küçük `limit` ile yeniden deneyin.'
|
|
47
|
+
: err.message
|
|
35
48
|
: String(err);
|
|
36
49
|
return { isError: true, content: [{ type: 'text', text }] };
|
|
37
50
|
}
|
|
@@ -40,7 +53,7 @@ export function createToolKit(api, defaultAppId) {
|
|
|
40
53
|
const id = appId ?? defaultAppId;
|
|
41
54
|
if (!id)
|
|
42
55
|
throw new Error('app_id gerekli (anahtar organizasyon geneliyse araçta app_id verin).');
|
|
43
|
-
return
|
|
56
|
+
return seg(id);
|
|
44
57
|
}
|
|
45
58
|
async function run(fn) {
|
|
46
59
|
try {
|
|
@@ -52,6 +65,13 @@ export function createToolKit(api, defaultAppId) {
|
|
|
52
65
|
}
|
|
53
66
|
return { api, app, run };
|
|
54
67
|
}
|
|
55
|
-
/**
|
|
56
|
-
|
|
68
|
+
/**
|
|
69
|
+
* Yol parçası (kimlik, alias değeri, olay adı) güvenli kodlama. `encodeURIComponent` noktayı kodlamaz; `.` ve `..`
|
|
70
|
+
* tek başına yol parçası olunca istek başka uca gider, bu yüzden reddedilir.
|
|
71
|
+
*/
|
|
72
|
+
export function seg(value) {
|
|
73
|
+
if (value === '.' || value === '..')
|
|
74
|
+
throw new Error('Geçersiz değer: `.` ve `..` yol parçası olarak kullanılamaz.');
|
|
75
|
+
return encodeURIComponent(value);
|
|
76
|
+
}
|
|
57
77
|
//# 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":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAmB,MAAM,UAAU,CAAC;AAE5D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,IAAI,GAAoB,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAChI,4GAA4G;AAC5G,MAAM,CAAC,MAAM,KAAK,GAAoB,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAEnI,MAAM,CAAC,MAAM,UAAU,GACrB,8HAA8H;IAC9H,6FAA6F,CAAC;AAEhG,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"kit.js","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAmB,MAAM,UAAU,CAAC;AAE5D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,IAAI,GAAoB,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAChI,4GAA4G;AAC5G,MAAM,CAAC,MAAM,KAAK,GAAoB,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAEnI,MAAM,CAAC,MAAM,UAAU,GACrB,8HAA8H;IAC9H,6FAA6F,CAAC;AAEhG;;;GAGG;AACH,MAAM,UAAU,GAAG,gCAAgC,CAAC;AACpD,MAAM,UAAU,GAAG,+DAA+D,CAAC;AAEnF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC,CAAC;AAC3L,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;AAC9G,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC;AAC3G,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,UAAU,CAAC,CAAC;AAC3H,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC,CAAC;AAC9I,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAC/E,yFAAyF;AACzF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/B,QAAQ,CAAC,qIAAqI,CAAC,CAAC;AAEnJ,MAAM,UAAU,KAAK,CAAC,MAA6D;IACjF,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;YAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAClG,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,EAAE,CAAC,IAAa;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,GAA2B;IACzC,GAAG,EAAE,+CAA+C;IACpD,GAAG,EAAE,8FAA8F;CACpG,CAAC;AAEF,MAAM,UAAU,IAAI,CAAC,GAAY;IAC/B,MAAM,IAAI,GACR,GAAG,YAAY,eAAe;QAC5B,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE;QACnF,CAAC,CAAC,GAAG,YAAY,KAAK;YACpB,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;gBACxD,CAAC,CAAC,qGAAqG;gBACvG,CAAC,CAAC,GAAG,CAAC,OAAO;YACf,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC9D,CAAC;AAUD,MAAM,UAAU,aAAa,CAAC,GAAe,EAAE,YAAqB;IAClE,SAAS,GAAG,CAAC,KAAc;QACzB,MAAM,EAAE,GAAG,KAAK,IAAI,YAAY,CAAC;QACjC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QACjG,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,UAAU,GAAG,CAAC,EAA0B;QAC3C,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IACrH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}
|
package/dist/server.d.ts
CHANGED
|
@@ -1,12 +1,20 @@
|
|
|
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
|
-
|
|
4
|
+
/** `serverInfo.version`; `package.json` sürümüyle aynı olmalıdır (test zorlar). */
|
|
5
|
+
export declare const MCP_SERVER_VERSION = "0.2.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
20
|
* in-app ve web büyüme okuma araçları; kampanya/segment/şablon/journey/in-app taslağı ve test cihazlarına test gönderimi.
|
package/dist/server.d.ts.map
CHANGED
|
@@ -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;
|
|
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;AAM3C,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;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CA8J5E"}
|
package/dist/server.js
CHANGED
|
@@ -1,10 +1,16 @@
|
|
|
1
1
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
2
|
import { z } from 'zod';
|
|
3
|
-
import { READ, WRITE, WRITE_NOTE, appIdArg, createToolKit, cursorArg, limitArg, query } from './kit.js';
|
|
3
|
+
import { READ, WRITE, WRITE_NOTE, appIdArg, createToolKit, cursorArg, idArg, limitArg, query, seg } from './kit.js';
|
|
4
|
+
import { registerInsightTools } from './tools-insights.js';
|
|
4
5
|
import { registerReadTools } from './tools-read.js';
|
|
5
6
|
import { registerWriteTools } from './tools-write.js';
|
|
6
7
|
export const MCP_SERVER_NAME = 'pushizo';
|
|
7
|
-
|
|
8
|
+
/** `serverInfo.version`; `package.json` sürümüyle aynı olmalıdır (test zorlar). */
|
|
9
|
+
export const MCP_SERVER_VERSION = '0.2.0';
|
|
10
|
+
/** Yazma araçları listelensin mi: kapsam bilinmiyorsa evet, biliniyorsa `mcp:write` veya `admin` gerekir. */
|
|
11
|
+
export function canListWriteTools(scopes) {
|
|
12
|
+
return !scopes || scopes.includes('admin') || scopes.includes('mcp:write');
|
|
13
|
+
}
|
|
8
14
|
/**
|
|
9
15
|
* Pushizo MCP sunucusu (ADR-0031 §6, ADR-0043): segment, kampanya, mesaj, şablon, journey, kullanıcı, olay, analitik,
|
|
10
16
|
* in-app ve web büyüme okuma araçları; kampanya/segment/şablon/journey/in-app taslağı ve test cihazlarına test gönderimi.
|
|
@@ -19,7 +25,7 @@ export function createPushizoMcpServer(options) {
|
|
|
19
25
|
const kit = createToolKit(options.api, options.defaultAppId);
|
|
20
26
|
const { api, app, run } = kit;
|
|
21
27
|
server.registerTool('list_segments', { title: 'Segmentleri listele', description: 'App’in segmentlerini listeler (ad araması ve sayfalama). Gerekli kapsam: segments:read.', inputSchema: { app_id: appIdArg, q: z.string().max(100).optional(), limit: limitArg, cursor: cursorArg }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/segments${query({ q: a.q, limit: a.limit, cursor: a.cursor })}`)));
|
|
22
|
-
server.registerTool('get_segment', { title: 'Segment oku', description: 'Segment tanımı ve tahmini kitle boyutu. Gerekli kapsam: segments:read.', inputSchema: { app_id: appIdArg, segment_id:
|
|
28
|
+
server.registerTool('get_segment', { title: 'Segment oku', description: 'Segment tanımı ve tahmini kitle boyutu. Gerekli kapsam: segments:read.', inputSchema: { app_id: appIdArg, segment_id: idArg('Segment') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/segments/${seg(a.segment_id)}`)));
|
|
23
29
|
server.registerTool('list_campaigns', {
|
|
24
30
|
title: 'Kampanyaları listele',
|
|
25
31
|
description: 'Kampanyaları listeler (durum/tür/ad filtresi). Gerekli kapsam: analytics:read.',
|
|
@@ -32,15 +38,15 @@ export function createPushizoMcpServer(options) {
|
|
|
32
38
|
},
|
|
33
39
|
annotations: READ,
|
|
34
40
|
}, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/campaigns${query({ q: a.q, status: a.status, limit: a.limit, cursor: a.cursor })}`)));
|
|
35
|
-
server.registerTool('get_campaign', { title: 'Kampanya oku', description: 'Kampanya ayrıntısı (kitle, içerik, onay durumu, istatistik). Gerekli kapsam: analytics:read.', inputSchema: { app_id: appIdArg, campaign_id:
|
|
36
|
-
server.registerTool('list_campaign_messages', { title: 'Kampanya çalıştırmaları', description: 'Kampanyanın mesajları (her çalıştırma bir mesaj) ve sayaçları. Gerekli kapsam: analytics:read.', inputSchema: { app_id: appIdArg, campaign_id:
|
|
41
|
+
server.registerTool('get_campaign', { title: 'Kampanya oku', description: 'Kampanya ayrıntısı (kitle, içerik, onay durumu, istatistik). Gerekli kapsam: analytics:read.', inputSchema: { app_id: appIdArg, campaign_id: idArg('Kampanya') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/campaigns/${seg(a.campaign_id)}`)));
|
|
42
|
+
server.registerTool('list_campaign_messages', { title: 'Kampanya çalıştırmaları', description: 'Kampanyanın mesajları (her çalıştırma bir mesaj) ve sayaçları. Gerekli kapsam: analytics:read.', inputSchema: { app_id: appIdArg, campaign_id: idArg('Kampanya') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/campaigns/${seg(a.campaign_id)}/messages`)));
|
|
37
43
|
server.registerTool('list_messages', {
|
|
38
44
|
title: 'Mesajları listele',
|
|
39
45
|
description: 'Gönderilen mesajlar (API, kampanya, journey) ve teslim sayaçları. Gerekli kapsam: analytics:read veya notifications:write.',
|
|
40
46
|
inputSchema: { app_id: appIdArg, limit: limitArg, cursor: cursorArg },
|
|
41
47
|
annotations: READ,
|
|
42
48
|
}, async (a) => run(() => api.request('GET', `/v1/notifications${query({ app_id: decodeURIComponent(app(a.app_id)), limit: a.limit, cursor: a.cursor })}`)));
|
|
43
|
-
server.registerTool('get_message', { title: 'Mesaj oku', description: 'Mesaj durumu ve sayaçları. Gerekli kapsam: analytics:read veya notifications:write.', inputSchema: { app_id: appIdArg, message_id:
|
|
49
|
+
server.registerTool('get_message', { title: 'Mesaj oku', description: 'Mesaj durumu ve sayaçları. Gerekli kapsam: analytics:read veya notifications:write.', inputSchema: { app_id: appIdArg, message_id: idArg('Mesaj') }, annotations: READ }, async (a) => run(() => api.request('GET', `/v1/notifications/${seg(a.message_id)}${query({ app_id: decodeURIComponent(app(a.app_id)) })}`)));
|
|
44
50
|
server.registerTool('get_analytics_summary', {
|
|
45
51
|
title: 'Analitik özet',
|
|
46
52
|
description: 'Genel bakış KPI’ları: gönderim, teslim, açılma/tıklama oranları, abonelik büyümesi (son 7/30 gün veya özel aralık). Gerekli kapsam: analytics:read.',
|
|
@@ -58,46 +64,51 @@ export function createPushizoMcpServer(options) {
|
|
|
58
64
|
inputSchema: { app_id: appIdArg, q: z.string().max(100).optional(), channel: z.string().max(32).optional(), limit: limitArg, cursor: cursorArg },
|
|
59
65
|
annotations: READ,
|
|
60
66
|
}, async (a) => run(() => api.request('GET', `/v1/apps/${app(a.app_id)}/templates${query({ q: a.q, channel: a.channel, limit: a.limit, cursor: a.cursor })}`)));
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
'
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
67
|
+
const writable = canListWriteTools(options.scopes);
|
|
68
|
+
if (writable) {
|
|
69
|
+
server.registerTool('create_campaign_draft', {
|
|
70
|
+
title: 'Kampanya taslağı oluştur',
|
|
71
|
+
description: `${WRITE_NOTE} Kampanyayı \`draft\` durumunda oluşturur. Kitle segment kimlikleriyle verilir; içerik doğrudan veya template_id ile. ` +
|
|
72
|
+
'Örnek içerik: {"headings":{"tr":"Başlık"},"contents":{"tr":"Metin"}}.',
|
|
73
|
+
inputSchema: {
|
|
74
|
+
app_id: appIdArg,
|
|
75
|
+
name: z.string().min(2).max(120),
|
|
76
|
+
included_segments: z.array(z.string().min(1).max(64)).max(20).optional().describe('Dahil segmentler; boşsa tüm aboneler.'),
|
|
77
|
+
excluded_segments: z.array(z.string().min(1).max(64)).max(20).optional(),
|
|
78
|
+
channels: z.array(z.string().max(32)).max(10).optional().describe('ör. ["web_push","android_push","ios_push","email","sms"]'),
|
|
79
|
+
content: z.record(z.string(), z.unknown()).optional().describe('Mesaj içeriği (headings/contents/email_subject…).'),
|
|
80
|
+
template_id: z.string().max(64).optional(),
|
|
81
|
+
labels: z.array(z.string().min(1).max(40)).max(9).optional(),
|
|
82
|
+
},
|
|
83
|
+
annotations: WRITE,
|
|
84
|
+
}, async (a) => run(() => api.request('POST', `/v1/apps/${app(a.app_id)}/mcp/campaign-drafts`, {
|
|
85
|
+
name: a.name,
|
|
86
|
+
audience: {
|
|
87
|
+
...(a.included_segments?.length ? { segments: a.included_segments } : { all: true }),
|
|
88
|
+
...(a.excluded_segments?.length ? { exclude_segments: a.excluded_segments } : {}),
|
|
89
|
+
...(a.channels?.length ? { channels: a.channels } : {}),
|
|
90
|
+
},
|
|
91
|
+
...(a.content ? { content: a.content } : {}),
|
|
92
|
+
...(a.template_id ? { template_id: a.template_id } : {}),
|
|
93
|
+
...(a.labels ? { labels: a.labels } : {}),
|
|
94
|
+
})));
|
|
95
|
+
server.registerTool('create_segment_draft', {
|
|
96
|
+
title: 'Segment taslağı oluştur',
|
|
97
|
+
description: `${WRITE_NOTE} Dinamik segment oluşturur (kampanyada kullanılana kadar etkisi yoktur). Tanım biçimi: ` +
|
|
98
|
+
'{"all":[{"field":"tags.plan","op":"eq","value":"pro"},{"field":"last_active_at","op":"within_days","value":30}]}.',
|
|
99
|
+
inputSchema: {
|
|
100
|
+
app_id: appIdArg,
|
|
101
|
+
name: z.string().min(1).max(200),
|
|
102
|
+
description: z.string().max(500).optional(),
|
|
103
|
+
definition: z.record(z.string(), z.unknown()).describe('Segment tanımı (all/any/none koşul grupları).'),
|
|
104
|
+
},
|
|
105
|
+
annotations: WRITE,
|
|
106
|
+
}, async (a) => run(() => api.request('POST', `/v1/apps/${app(a.app_id)}/mcp/segment-drafts`, { name: a.name, ...(a.description ? { description: a.description } : {}), definition: a.definition })));
|
|
107
|
+
}
|
|
99
108
|
registerReadTools(server, kit);
|
|
100
|
-
|
|
109
|
+
registerInsightTools(server, kit);
|
|
110
|
+
if (writable)
|
|
111
|
+
registerWriteTools(server, kit);
|
|
101
112
|
return server;
|
|
102
113
|
}
|
|
103
114
|
//# sourceMappingURL=server.js.map
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AACzC,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAa1C,6GAA6G;AAC7G,MAAM,UAAU,iBAAiB,CAAC,MAAqC;IACrE,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA0B;IAC/D,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,EAAE,EACxE;QACE,YAAY,EACV,+IAA+I;YAC/I,iJAAiJ;YACjJ,gKAAgK;KACnK,CACF,CAAC;IACF,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAE9B,MAAM,CAAC,YAAY,CACjB,eAAe,EACf,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,yFAAyF,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EACrQ,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CACvI,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,aAAa,EACb,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,wEAAwE,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EACnM,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CACtG,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE;YACX,MAAM,EAAE,QAAQ;YAChB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;YACjC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC1G,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,SAAS;SAClB;QACD,WAAW,EAAE,IAAI;KAClB,EACD,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAC1J,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,8FAA8F,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAC5N,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CACxG,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB,EAAE,KAAK,EAAE,yBAAyB,EAAE,WAAW,EAAE,gGAAgG,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EACzO,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CACjH,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,4HAA4H;QACzI,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE;QACrE,WAAW,EAAE,IAAI;KAClB,EACD,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,KAAK,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CACzJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,aAAa,EACb,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,qFAAqF,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAC5M,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAC5I,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,qJAAqJ;QAClK,WAAW,EAAE;YACX,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;YACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YACpF,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SAC7D;QACD,WAAW,EAAE,IAAI;KAClB,EACD,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,sBAAsB,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAC/I,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,uEAAuE;QACpF,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE;QAChJ,WAAW,EAAE,IAAI;KAClB,EACD,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAC5J,CAAC;IAEF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;YACE,KAAK,EAAE,0BAA0B;YACjC,WAAW,EACT,GAAG,UAAU,wHAAwH;gBACrI,uEAAuE;YACzE,WAAW,EAAE;gBACX,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;gBAChC,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;gBAC1H,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;gBACxE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;gBAC7H,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;gBACnH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;gBAC1C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;aAC7D;YACD,WAAW,EAAE,KAAK;SACnB,EACD,KAAK,EAAE,CAAC,EAAE,EAAE,CACV,GAAG,CAAC,GAAG,EAAE,CACP,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,sBAAsB,EAAE;YACnE,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE;gBACR,GAAG,CAAC,CAAC,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;gBACpF,GAAG,CAAC,CAAC,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjF,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD;YACD,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC,CACH,CACJ,CAAC;QAEF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;YACE,KAAK,EAAE,yBAAyB;YAChC,WAAW,EACT,GAAG,UAAU,yFAAyF;gBACtG,mHAAmH;YACrH,WAAW,EAAE;gBACX,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;gBAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;gBAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;aACxG;YACD,WAAW,EAAE,KAAK;SACnB,EACD,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAClM,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,IAAI,QAAQ;QAAE,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
package/dist/stdio.js
CHANGED
|
File without changes
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
|
+
import { type ToolKit } from './kit.js';
|
|
3
|
+
/**
|
|
4
|
+
* İçgörü ve yapılandırma okuma araçları (plan 15 Faz 51, ADR-0076): RFM, öngörü modelleri, özellik bayrakları, yol
|
|
5
|
+
* analizi, rapor oluşturucu, karar ajanları, katalog ve öneriler, kanal skoru, bölgeler, Wallet şablonları. Hepsi
|
|
6
|
+
* mevcut public API okuma uçlarını çağırır; hesap tetikleyen, karar yazan veya kart veren uçlar bilerek yoktur.
|
|
7
|
+
* Wallet kartları (indirme bağlantısı taşır) araç olarak sunulmaz.
|
|
8
|
+
*/
|
|
9
|
+
export declare function registerInsightTools(server: McpServer, kit: ToolKit): void;
|
|
10
|
+
//# sourceMappingURL=tools-insights.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tools-insights.d.ts","sourceRoot":"","sources":["../src/tools-insights.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAA0D,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAchG;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAyR1E"}
|
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { READ, appIdArg, cursorArg, idArg, limitArg, query, seg } from './kit.js';
|
|
3
|
+
const dayArg = (what) => z
|
|
4
|
+
.string()
|
|
5
|
+
.regex(/^\d{4}-\d{2}-\d{2}$/, 'YYYY-MM-DD biçiminde gün verin.')
|
|
6
|
+
.optional()
|
|
7
|
+
.describe(what);
|
|
8
|
+
const isoArg = (what) => z.string().max(40).optional().describe(what);
|
|
9
|
+
const RFM_SEGMENTS = ['champions', 'loyal', 'potential', 'new', 'promising', 'need_attention', 'about_to_sleep', 'at_risk', 'cant_lose', 'hibernating', 'lost'];
|
|
10
|
+
const RECOMMENDATION_STRATEGIES = ['personalized', 'popular', 'trending', 'similar', 'category', 'recently_viewed', 'new_arrivals'];
|
|
11
|
+
const REPORT_SOURCES = ['deliveries', 'events', 'conversions'];
|
|
12
|
+
/**
|
|
13
|
+
* İçgörü ve yapılandırma okuma araçları (plan 15 Faz 51, ADR-0076): RFM, öngörü modelleri, özellik bayrakları, yol
|
|
14
|
+
* analizi, rapor oluşturucu, karar ajanları, katalog ve öneriler, kanal skoru, bölgeler, Wallet şablonları. Hepsi
|
|
15
|
+
* mevcut public API okuma uçlarını çağırır; hesap tetikleyen, karar yazan veya kart veren uçlar bilerek yoktur.
|
|
16
|
+
* Wallet kartları (indirme bağlantısı taşır) araç olarak sunulmaz.
|
|
17
|
+
*/
|
|
18
|
+
export function registerInsightTools(server, kit) {
|
|
19
|
+
const { api, app, run } = kit;
|
|
20
|
+
const get = (path) => run(() => api.request('GET', path));
|
|
21
|
+
const post = (path, body) => run(() => api.request('POST', path, body));
|
|
22
|
+
// ---- RFM
|
|
23
|
+
server.registerTool('get_rfm_overview', {
|
|
24
|
+
title: 'RFM özeti',
|
|
25
|
+
description: 'RFM segmentlerinin (champions, at_risk, lost…) kullanıcı sayıları, payları ve son hesap zamanı. Gerekli kapsam: analytics:read.',
|
|
26
|
+
inputSchema: { app_id: appIdArg },
|
|
27
|
+
annotations: READ,
|
|
28
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/rfm/overview`));
|
|
29
|
+
server.registerTool('get_rfm_transitions', {
|
|
30
|
+
title: 'RFM segment geçişleri',
|
|
31
|
+
description: 'İki gün arasında kullanıcıların hangi RFM segmentinden hangisine geçtiği (varsayılan son 30 gün). Gerekli kapsam: analytics:read.',
|
|
32
|
+
inputSchema: { app_id: appIdArg, from: dayArg('Başlangıç günü (YYYY-MM-DD); boşsa 30 gün önce.'), to: dayArg('Bitiş günü (YYYY-MM-DD); boşsa bugün.') },
|
|
33
|
+
annotations: READ,
|
|
34
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/rfm/transitions${query({ from: a.from, to: a.to })}`));
|
|
35
|
+
server.registerTool('list_rfm_users', {
|
|
36
|
+
title: 'RFM segmentindeki kullanıcılar',
|
|
37
|
+
description: 'Bir RFM segmentindeki kullanıcılar ve R/F/M skorları. Devamı için yanıttaki `next_cursor` değerini `cursor` olarak verin. Gerekli kapsam: users:read.',
|
|
38
|
+
inputSchema: { app_id: appIdArg, segment: z.enum(RFM_SEGMENTS).optional(), limit: limitArg, cursor: cursorArg },
|
|
39
|
+
annotations: READ,
|
|
40
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/rfm/users${query({ segment: a.segment, limit: a.limit, cursor: a.cursor })}`));
|
|
41
|
+
// ---- öngörü modelleri
|
|
42
|
+
server.registerTool('list_predictions', {
|
|
43
|
+
title: 'Öngörü modelleri',
|
|
44
|
+
description: 'Kayıp riski ve olay olasılığı modelleri: durum, kalite ölçümü ve son eğitim zamanı. Gerekli kapsam: analytics:read.',
|
|
45
|
+
inputSchema: { app_id: appIdArg },
|
|
46
|
+
annotations: READ,
|
|
47
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/predictions`));
|
|
48
|
+
server.registerTool('get_prediction', {
|
|
49
|
+
title: 'Öngörü modeli',
|
|
50
|
+
description: 'Tek modelin ayrıntısı: tanım, kalite (AUC, isabet), skor dağılımı. Gerekli kapsam: analytics:read.',
|
|
51
|
+
inputSchema: { app_id: appIdArg, prediction_id: idArg('Öngörü modeli') },
|
|
52
|
+
annotations: READ,
|
|
53
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/predictions/${seg(a.prediction_id)}`));
|
|
54
|
+
server.registerTool('list_prediction_users', {
|
|
55
|
+
title: 'Öngörü skoruna göre kullanıcılar',
|
|
56
|
+
description: 'Modelin skorladığı kullanıcılar; `bucket` ile düşük/orta/yüksek olasılık grubu seçilir. Devamı için `next_cursor`. Gerekli kapsam: users:read.',
|
|
57
|
+
inputSchema: { app_id: appIdArg, prediction_id: idArg('Öngörü modeli'), bucket: z.enum(['low', 'medium', 'high']).optional(), limit: limitArg, cursor: cursorArg },
|
|
58
|
+
annotations: READ,
|
|
59
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/predictions/${seg(a.prediction_id)}/users${query({ bucket: a.bucket, limit: a.limit, cursor: a.cursor })}`));
|
|
60
|
+
// ---- özellik bayrakları
|
|
61
|
+
server.registerTool('list_feature_flags', {
|
|
62
|
+
title: 'Özellik bayrakları',
|
|
63
|
+
description: 'Özellik bayrakları: durum, yayın yüzdesi, hedef segment ve uzaktan yapılandırma değerleri. Gerekli kapsam: analytics:read.',
|
|
64
|
+
inputSchema: { app_id: appIdArg },
|
|
65
|
+
annotations: READ,
|
|
66
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/feature-flags`));
|
|
67
|
+
server.registerTool('get_feature_flag', {
|
|
68
|
+
title: 'Özellik bayrağı',
|
|
69
|
+
description: 'Tek bayrağın ayrıntısı: kademeli yayın takvimi, hedefleme ve değerler. Gerekli kapsam: analytics:read.',
|
|
70
|
+
inputSchema: { app_id: appIdArg, flag_id: idArg('Bayrak') },
|
|
71
|
+
annotations: READ,
|
|
72
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/feature-flags/${seg(a.flag_id)}`));
|
|
73
|
+
// ---- analitik: yol analizi ve rapor oluşturucu
|
|
74
|
+
server.registerTool('run_path_analysis', {
|
|
75
|
+
title: 'Kullanıcı yol analizi',
|
|
76
|
+
description: 'Bir olaydan sonra (`after`) veya olaya gelmeden önce (`before`) kullanıcıların izlediği olay yolları ve en sık yollar. Gerekli kapsam: analytics:read.',
|
|
77
|
+
inputSchema: {
|
|
78
|
+
app_id: appIdArg,
|
|
79
|
+
event: z.string().min(1).max(100).describe('Başlangıç olayı, ör. `add_to_cart`.'),
|
|
80
|
+
direction: z.enum(['after', 'before']).optional(),
|
|
81
|
+
depth: z.number().int().min(1).max(5).optional().describe('İzlenecek adım sayısı (varsayılan 3).'),
|
|
82
|
+
top: z.number().int().min(2).max(10).optional().describe('Adım başına ayrı gösterilecek olay sayısı (varsayılan 5).'),
|
|
83
|
+
window_hours: z.number().int().min(1).max(720).optional().describe('Başlangıç olayından en fazla uzaklık (saat, varsayılan 24).'),
|
|
84
|
+
exclude: z.array(z.string().min(1).max(100)).max(20).optional().describe('Yolda sayılmayacak olaylar.'),
|
|
85
|
+
from: isoArg('ISO-8601 başlangıç.'),
|
|
86
|
+
to: isoArg('ISO-8601 bitiş.'),
|
|
87
|
+
},
|
|
88
|
+
annotations: READ,
|
|
89
|
+
}, async (a) => post(`/v1/apps/${app(a.app_id)}/analytics/paths`, {
|
|
90
|
+
event: a.event,
|
|
91
|
+
...(a.direction ? { direction: a.direction } : {}),
|
|
92
|
+
...(a.depth ? { depth: a.depth } : {}),
|
|
93
|
+
...(a.top ? { top: a.top } : {}),
|
|
94
|
+
...(a.window_hours ? { window_hours: a.window_hours } : {}),
|
|
95
|
+
...(a.exclude?.length ? { exclude: a.exclude } : {}),
|
|
96
|
+
...(a.from ? { from: a.from } : {}),
|
|
97
|
+
...(a.to ? { to: a.to } : {}),
|
|
98
|
+
}));
|
|
99
|
+
server.registerTool('run_report', {
|
|
100
|
+
title: 'Rapor çalıştır',
|
|
101
|
+
description: 'Serbest rapor: kaynak, metrik, kırılım ve filtre seçilir. Kaynaklar ve alanları — deliveries: sent, delivered, failed, opened, clicked, ' +
|
|
102
|
+
'delivery_rate, open_rate, click_rate, failure_rate; kırılım day/week/month/channel/provider/campaign/status. events: count, unique_users, ' +
|
|
103
|
+
'value_sum, value_avg; kırılım day/week/month/name/source. conversions: conversions, revenue, unique_users; kırılım day/week/month/campaign/' +
|
|
104
|
+
'event_name/kind. `days` ile `from`/`to` birlikte verilmez. Gerekli kapsam: analytics:read.',
|
|
105
|
+
inputSchema: {
|
|
106
|
+
app_id: appIdArg,
|
|
107
|
+
source: z.enum(REPORT_SOURCES),
|
|
108
|
+
metrics: z.array(z.string().min(1).max(32)).min(1).max(8),
|
|
109
|
+
dimensions: z.array(z.string().min(1).max(32)).max(2).optional(),
|
|
110
|
+
filters: z.record(z.string().max(32), z.array(z.string().min(1).max(200)).min(1).max(50)).optional().describe('ör. {"channel":["email","sms"]}'),
|
|
111
|
+
sort: z.object({ by: z.string().max(64), direction: z.enum(['asc', 'desc']).optional() }).optional(),
|
|
112
|
+
limit: z.number().int().min(1).max(1000).optional().describe('Satır sınırı (varsayılan 100).'),
|
|
113
|
+
days: z.number().int().min(1).max(730).optional().describe('Son kaç gün.'),
|
|
114
|
+
from: isoArg('ISO-8601 başlangıç.'),
|
|
115
|
+
to: isoArg('ISO-8601 bitiş.'),
|
|
116
|
+
},
|
|
117
|
+
annotations: READ,
|
|
118
|
+
}, async (a) => post(`/v1/apps/${app(a.app_id)}/analytics/reports/run`, {
|
|
119
|
+
source: a.source,
|
|
120
|
+
metrics: a.metrics,
|
|
121
|
+
...(a.dimensions?.length ? { dimensions: a.dimensions } : {}),
|
|
122
|
+
...(a.filters ? { filters: a.filters } : {}),
|
|
123
|
+
...(a.sort ? { sort: a.sort } : {}),
|
|
124
|
+
...(a.limit ? { limit: a.limit } : {}),
|
|
125
|
+
...(a.days ? { days: a.days } : {}),
|
|
126
|
+
...(a.from ? { from: a.from } : {}),
|
|
127
|
+
...(a.to ? { to: a.to } : {}),
|
|
128
|
+
format: 'json',
|
|
129
|
+
}));
|
|
130
|
+
server.registerTool('list_saved_reports', {
|
|
131
|
+
title: 'Kayıtlı raporlar',
|
|
132
|
+
description: 'Panelde kaydedilmiş rapor tanımları. Tanımı `run_report` ile çalıştırabilirsiniz. Gerekli kapsam: analytics:read.',
|
|
133
|
+
inputSchema: { app_id: appIdArg },
|
|
134
|
+
annotations: READ,
|
|
135
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/analytics/reports`));
|
|
136
|
+
server.registerTool('get_saved_report', {
|
|
137
|
+
title: 'Kayıtlı rapor',
|
|
138
|
+
description: 'Kayıtlı raporun tanımı (kaynak, metrikler, kırılımlar, filtreler). Gerekli kapsam: analytics:read.',
|
|
139
|
+
inputSchema: { app_id: appIdArg, report_id: idArg('Rapor') },
|
|
140
|
+
annotations: READ,
|
|
141
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/analytics/reports/${seg(a.report_id)}`));
|
|
142
|
+
// ---- karar ajanları
|
|
143
|
+
server.registerTool('list_decision_agents', {
|
|
144
|
+
title: 'Karar ajanları',
|
|
145
|
+
description: 'Kişi başına en iyi seçeneği öğrenen karar ajanları: durum, seçenekler ve hedef. Gerekli kapsam: analytics:read.',
|
|
146
|
+
inputSchema: { app_id: appIdArg },
|
|
147
|
+
annotations: READ,
|
|
148
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/decision-agents`));
|
|
149
|
+
server.registerTool('get_decision_agent_report', {
|
|
150
|
+
title: 'Karar ajanı raporu',
|
|
151
|
+
description: 'Ajanın seçenek başına atama ve ödül sayıları ile kontrol grubuna karşı kazancı. Gerekli kapsam: analytics:read.',
|
|
152
|
+
inputSchema: { app_id: appIdArg, agent_id: idArg('Karar ajanı') },
|
|
153
|
+
annotations: READ,
|
|
154
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/decision-agents/${seg(a.agent_id)}/report`));
|
|
155
|
+
// ---- katalog ve öneriler
|
|
156
|
+
server.registerTool('list_catalogs', {
|
|
157
|
+
title: 'Ürün katalogları',
|
|
158
|
+
description: 'Ürün katalogları (ad, para birimi, ürün sayısı). Öneri araçları için `catalog_id` buradan alınır. Gerekli kapsam: analytics:read.',
|
|
159
|
+
inputSchema: { app_id: appIdArg },
|
|
160
|
+
annotations: READ,
|
|
161
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/catalogs`));
|
|
162
|
+
server.registerTool('get_recommendations', {
|
|
163
|
+
title: 'Ürün önerileri',
|
|
164
|
+
description: 'Katalogdan ürün önerileri. Stratejiler: personalized ve recently_viewed kullanıcı ister (`user_id` ya da `external_id`, ikisi birlikte verilmez); ' +
|
|
165
|
+
'similar `item_id`, category `category` ister; popular, trending ve new_arrivals girdisizdir. Gerekli kapsam: analytics:read.',
|
|
166
|
+
inputSchema: {
|
|
167
|
+
app_id: appIdArg,
|
|
168
|
+
catalog_id: idArg('Katalog'),
|
|
169
|
+
strategy: z.enum(RECOMMENDATION_STRATEGIES),
|
|
170
|
+
limit: z.number().int().min(1).max(20).optional(),
|
|
171
|
+
user_id: z.string().max(64).optional(),
|
|
172
|
+
external_id: z.string().max(255).optional(),
|
|
173
|
+
item_id: z.string().max(128).optional(),
|
|
174
|
+
category: z.string().max(200).optional(),
|
|
175
|
+
},
|
|
176
|
+
annotations: READ,
|
|
177
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/catalogs/${seg(a.catalog_id)}/recommendations${query({
|
|
178
|
+
strategy: a.strategy,
|
|
179
|
+
limit: a.limit,
|
|
180
|
+
user_id: a.user_id,
|
|
181
|
+
external_id: a.external_id,
|
|
182
|
+
item_id: a.item_id,
|
|
183
|
+
category: a.category,
|
|
184
|
+
})}`));
|
|
185
|
+
// ---- kanal skoru
|
|
186
|
+
server.registerTool('get_channel_score_overview', {
|
|
187
|
+
title: 'En iyi kanal özeti',
|
|
188
|
+
description: 'Kullanıcıların en iyi kanala göre dağılımı (push, e-posta, SMS…) ve son hesap zamanı. Gerekli kapsam: analytics:read.',
|
|
189
|
+
inputSchema: { app_id: appIdArg },
|
|
190
|
+
annotations: READ,
|
|
191
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/channel-scores/overview`));
|
|
192
|
+
// ---- bölgeler
|
|
193
|
+
server.registerTool('list_geofences', {
|
|
194
|
+
title: 'Bölgeler (geofence)',
|
|
195
|
+
description: 'Tanımlı bölgeler: ad, merkez, yarıçap ve durum. Kullanıcı konumu içermez. Gerekli kapsam: analytics:read.',
|
|
196
|
+
inputSchema: { app_id: appIdArg },
|
|
197
|
+
annotations: READ,
|
|
198
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/geofences`));
|
|
199
|
+
// ---- Wallet
|
|
200
|
+
server.registerTool('list_wallet_templates', {
|
|
201
|
+
title: 'Wallet şablonları',
|
|
202
|
+
description: 'Apple ve Google Wallet kart şablonları (kupon, sadakat kartı, bilet) ve verilmiş kart sayıları. Kartların kendisi ve indirme bağlantıları dönmez. Gerekli kapsam: users:read.',
|
|
203
|
+
inputSchema: { app_id: appIdArg },
|
|
204
|
+
annotations: READ,
|
|
205
|
+
}, async (a) => get(`/v1/apps/${app(a.app_id)}/wallet/templates`));
|
|
206
|
+
}
|
|
207
|
+
//# sourceMappingURL=tools-insights.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tools-insights.js","sourceRoot":"","sources":["../src/tools-insights.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,60 +1,60 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@pushizo/mcp-server",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"mcpName": "com.pushizo/mcp",
|
|
5
|
-
"description": "Pushizo MCP sunucusu:
|
|
6
|
-
"license": "MIT",
|
|
7
|
-
"homepage": "https://docs.pushizo.com/docs/integrations/mcp",
|
|
8
|
-
"repository": {
|
|
9
|
-
"type": "git",
|
|
10
|
-
"url": "git+https://github.com/pushizo/pushizo-mcp.git"
|
|
11
|
-
},
|
|
12
|
-
"bugs": {
|
|
13
|
-
"url": "https://github.com/pushizo/pushizo-mcp/issues",
|
|
14
|
-
"email": "support@pushizo.com"
|
|
15
|
-
},
|
|
16
|
-
"keywords": [
|
|
17
|
-
"pushizo",
|
|
18
|
-
"mcp",
|
|
19
|
-
"model-context-protocol",
|
|
20
|
-
"claude",
|
|
21
|
-
"ai",
|
|
22
|
-
"push",
|
|
23
|
-
"notifications"
|
|
24
|
-
],
|
|
25
|
-
"publishConfig": {
|
|
26
|
-
"access": "public",
|
|
27
|
-
"provenance": true
|
|
28
|
-
},
|
|
29
|
-
"type": "module",
|
|
30
|
-
"main": "./dist/index.js",
|
|
31
|
-
"types": "./dist/index.d.ts",
|
|
32
|
-
"bin": {
|
|
33
|
-
"pushizo-mcp": "./dist/stdio.js"
|
|
34
|
-
},
|
|
35
|
-
"exports": {
|
|
36
|
-
".": {
|
|
37
|
-
"types": "./dist/index.d.ts",
|
|
38
|
-
"default": "./dist/index.js"
|
|
39
|
-
}
|
|
40
|
-
},
|
|
41
|
-
"files": [
|
|
42
|
-
"dist",
|
|
43
|
-
"README.md",
|
|
44
|
-
"server.json"
|
|
45
|
-
],
|
|
46
|
-
"scripts": {
|
|
47
|
-
"build": "tsc -p tsconfig.build.json",
|
|
48
|
-
"dev": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
|
|
49
|
-
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
50
|
-
"start": "node dist/stdio.js",
|
|
51
|
-
"clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
|
|
52
|
-
},
|
|
53
|
-
"dependencies": {
|
|
54
|
-
"@modelcontextprotocol/sdk": "~1.32.1",
|
|
55
|
-
"zod": "^4.6.5"
|
|
56
|
-
},
|
|
57
|
-
"engines": {
|
|
58
|
-
"node": ">=20"
|
|
59
|
-
}
|
|
60
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "@pushizo/mcp-server",
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"mcpName": "com.pushizo/mcp",
|
|
5
|
+
"description": "Pushizo MCP sunucusu: 73 okuma ve taslak aracı (stdio + Streamable HTTP). Test gönderimi yalnız test cihazlarına gider.",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"homepage": "https://docs.pushizo.com/docs/integrations/mcp",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/pushizo/pushizo-mcp.git"
|
|
11
|
+
},
|
|
12
|
+
"bugs": {
|
|
13
|
+
"url": "https://github.com/pushizo/pushizo-mcp/issues",
|
|
14
|
+
"email": "support@pushizo.com"
|
|
15
|
+
},
|
|
16
|
+
"keywords": [
|
|
17
|
+
"pushizo",
|
|
18
|
+
"mcp",
|
|
19
|
+
"model-context-protocol",
|
|
20
|
+
"claude",
|
|
21
|
+
"ai",
|
|
22
|
+
"push",
|
|
23
|
+
"notifications"
|
|
24
|
+
],
|
|
25
|
+
"publishConfig": {
|
|
26
|
+
"access": "public",
|
|
27
|
+
"provenance": true
|
|
28
|
+
},
|
|
29
|
+
"type": "module",
|
|
30
|
+
"main": "./dist/index.js",
|
|
31
|
+
"types": "./dist/index.d.ts",
|
|
32
|
+
"bin": {
|
|
33
|
+
"pushizo-mcp": "./dist/stdio.js"
|
|
34
|
+
},
|
|
35
|
+
"exports": {
|
|
36
|
+
".": {
|
|
37
|
+
"types": "./dist/index.d.ts",
|
|
38
|
+
"default": "./dist/index.js"
|
|
39
|
+
}
|
|
40
|
+
},
|
|
41
|
+
"files": [
|
|
42
|
+
"dist",
|
|
43
|
+
"README.md",
|
|
44
|
+
"server.json"
|
|
45
|
+
],
|
|
46
|
+
"scripts": {
|
|
47
|
+
"build": "tsc -p tsconfig.build.json",
|
|
48
|
+
"dev": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
|
|
49
|
+
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
50
|
+
"start": "node dist/stdio.js",
|
|
51
|
+
"clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
|
|
52
|
+
},
|
|
53
|
+
"dependencies": {
|
|
54
|
+
"@modelcontextprotocol/sdk": "~1.32.1",
|
|
55
|
+
"zod": "^4.6.5"
|
|
56
|
+
},
|
|
57
|
+
"engines": {
|
|
58
|
+
"node": ">=20"
|
|
59
|
+
}
|
|
60
|
+
}
|
package/server.json
CHANGED
|
@@ -2,13 +2,13 @@
|
|
|
2
2
|
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
3
|
"name": "com.pushizo/mcp",
|
|
4
4
|
"title": "Pushizo",
|
|
5
|
-
"description": "Push, email, SMS, in-app and journeys.
|
|
5
|
+
"description": "Push, email, SMS, in-app and journeys. 73 tools: reads and drafts; only test sends.",
|
|
6
6
|
"websiteUrl": "https://docs.pushizo.com/docs/integrations/mcp",
|
|
7
7
|
"repository": {
|
|
8
8
|
"url": "https://github.com/pushizo/pushizo-mcp",
|
|
9
9
|
"source": "github"
|
|
10
10
|
},
|
|
11
|
-
"version": "0.
|
|
11
|
+
"version": "0.2.0",
|
|
12
12
|
"remotes": [
|
|
13
13
|
{
|
|
14
14
|
"type": "streamable-http",
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
{
|
|
20
20
|
"registryType": "npm",
|
|
21
21
|
"identifier": "@pushizo/mcp-server",
|
|
22
|
-
"version": "0.
|
|
22
|
+
"version": "0.2.0",
|
|
23
23
|
"transport": {
|
|
24
24
|
"type": "stdio"
|
|
25
25
|
},
|