@mybe/contensa-mcp 1.0.0 → 1.0.2
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/README.md +63 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -14,11 +14,19 @@ MCP (Model Context Protocol) server for Contensa CMS. This enables AI assistants
|
|
|
14
14
|
|
|
15
15
|
## Installation
|
|
16
16
|
|
|
17
|
+
Install globally to use with MCP clients like Cursor or Claude Desktop:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npm install -g @mybe/contensa-mcp
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Or use directly with npx (no installation needed):
|
|
24
|
+
|
|
17
25
|
```bash
|
|
18
|
-
|
|
26
|
+
npx @mybe/contensa-mcp
|
|
19
27
|
```
|
|
20
28
|
|
|
21
|
-
|
|
29
|
+
**For development** (if using the monorepo):
|
|
22
30
|
|
|
23
31
|
```bash
|
|
24
32
|
cd packages/mcp-server
|
|
@@ -32,6 +40,22 @@ npm run build
|
|
|
32
40
|
|
|
33
41
|
Add to your Cursor MCP settings (`~/.cursor/mcp.json` or workspace `.cursor/mcp.json`):
|
|
34
42
|
|
|
43
|
+
```json
|
|
44
|
+
{
|
|
45
|
+
"mcpServers": {
|
|
46
|
+
"contensa": {
|
|
47
|
+
"command": "contensa-mcp",
|
|
48
|
+
"env": {
|
|
49
|
+
"CONTENSA_API_KEY": "your-api-key-here",
|
|
50
|
+
"CONTENSA_USER_ID": "your-user-id-here",
|
|
51
|
+
"CONTENSA_PROJECT_ID": "your-default-project-id"
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
**Alternative** (if not installed globally, use npx):
|
|
35
59
|
```json
|
|
36
60
|
{
|
|
37
61
|
"mcpServers": {
|
|
@@ -40,6 +64,7 @@ Add to your Cursor MCP settings (`~/.cursor/mcp.json` or workspace `.cursor/mcp.
|
|
|
40
64
|
"args": ["@mybe/contensa-mcp"],
|
|
41
65
|
"env": {
|
|
42
66
|
"CONTENSA_API_KEY": "your-api-key-here",
|
|
67
|
+
"CONTENSA_USER_ID": "your-user-id-here",
|
|
43
68
|
"CONTENSA_PROJECT_ID": "your-default-project-id"
|
|
44
69
|
}
|
|
45
70
|
}
|
|
@@ -57,6 +82,7 @@ Or if running from the monorepo:
|
|
|
57
82
|
"args": ["/path/to/mybe-cms/packages/mcp-server/dist/cli.js"],
|
|
58
83
|
"env": {
|
|
59
84
|
"CONTENSA_API_KEY": "your-api-key-here",
|
|
85
|
+
"CONTENSA_USER_ID": "your-user-id-here",
|
|
60
86
|
"CONTENSA_PROJECT_ID": "your-default-project-id"
|
|
61
87
|
}
|
|
62
88
|
}
|
|
@@ -68,6 +94,22 @@ Or if running from the monorepo:
|
|
|
68
94
|
|
|
69
95
|
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
|
|
70
96
|
|
|
97
|
+
```json
|
|
98
|
+
{
|
|
99
|
+
"mcpServers": {
|
|
100
|
+
"contensa": {
|
|
101
|
+
"command": "contensa-mcp",
|
|
102
|
+
"env": {
|
|
103
|
+
"CONTENSA_API_KEY": "your-api-key-here",
|
|
104
|
+
"CONTENSA_USER_ID": "your-user-id-here",
|
|
105
|
+
"CONTENSA_PROJECT_ID": "your-default-project-id"
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
**Alternative** (if not installed globally, use npx):
|
|
71
113
|
```json
|
|
72
114
|
{
|
|
73
115
|
"mcpServers": {
|
|
@@ -76,6 +118,7 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
|
|
|
76
118
|
"args": ["@mybe/contensa-mcp"],
|
|
77
119
|
"env": {
|
|
78
120
|
"CONTENSA_API_KEY": "your-api-key-here",
|
|
121
|
+
"CONTENSA_USER_ID": "your-user-id-here",
|
|
79
122
|
"CONTENSA_PROJECT_ID": "your-default-project-id"
|
|
80
123
|
}
|
|
81
124
|
}
|
|
@@ -88,8 +131,9 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
|
|
|
88
131
|
| Variable | Required | Description |
|
|
89
132
|
|----------|----------|-------------|
|
|
90
133
|
| `CONTENSA_API_KEY` | Yes | Your Contensa API key |
|
|
91
|
-
| `
|
|
134
|
+
| `CONTENSA_USER_ID` | Yes | Your user ID (required for creating/updating content) |
|
|
92
135
|
| `CONTENSA_PROJECT_ID` | No | Default project ID |
|
|
136
|
+
| `CONTENSA_BASE_URL` | No | Custom API base URL (defaults to Contensa production API or localhost in dev) |
|
|
93
137
|
|
|
94
138
|
### API Base URL
|
|
95
139
|
|
|
@@ -108,6 +152,7 @@ You can override the default by setting `CONTENSA_BASE_URL` for custom API endpo
|
|
|
108
152
|
"args": ["./packages/mcp-server/dist/cli.js"],
|
|
109
153
|
"env": {
|
|
110
154
|
"CONTENSA_API_KEY": "your-api-key",
|
|
155
|
+
"CONTENSA_USER_ID": "your-user-id",
|
|
111
156
|
"CONTENSA_BASE_URL": "https://your-custom-api.com/api/v1"
|
|
112
157
|
}
|
|
113
158
|
}
|
|
@@ -720,12 +765,25 @@ Example response:
|
|
|
720
765
|
}
|
|
721
766
|
```
|
|
722
767
|
|
|
723
|
-
## Getting Your API Key
|
|
768
|
+
## Getting Your API Key and User ID
|
|
769
|
+
|
|
770
|
+
### API Key
|
|
724
771
|
|
|
725
772
|
1. Log in to your Contensa dashboard
|
|
726
773
|
2. Go to Settings → API Keys
|
|
727
774
|
3. Generate a new API key
|
|
728
|
-
4. Copy the key and add it to your MCP configuration
|
|
775
|
+
4. Copy the key and add it to your MCP configuration as `CONTENSA_API_KEY`
|
|
776
|
+
|
|
777
|
+
### User ID
|
|
778
|
+
|
|
779
|
+
Your User ID is required for creating and updating content. To find it:
|
|
780
|
+
|
|
781
|
+
1. Log in to your Contensa dashboard
|
|
782
|
+
2. Go to Settings → Profile or Account Settings
|
|
783
|
+
3. Your User ID will be displayed in your profile information
|
|
784
|
+
4. Copy the User ID and add it to your MCP configuration as `CONTENSA_USER_ID`
|
|
785
|
+
|
|
786
|
+
**Note**: The User ID is a UUID that uniquely identifies your account. It's required for all write operations (creating/updating content, content types, fields, etc.).
|
|
729
787
|
|
|
730
788
|
## Development
|
|
731
789
|
|
package/package.json
CHANGED