@se-studio/skills 1.0.5 → 1.0.6
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/CHANGELOG.md +6 -0
- package/package.json +1 -1
- package/skills/contentful-cms-setup/SKILL.md +91 -0
package/CHANGELOG.md
CHANGED
package/package.json
CHANGED
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "contentful-cms:setup"
|
|
3
|
+
description: "Guide a user through installing and configuring the cms-edit MCP server for Claude Desktop."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Skill: cms-edit Setup
|
|
7
|
+
|
|
8
|
+
Use this skill when the user wants to install or configure the `cms-edit` MCP server so Claude Desktop can read and edit Contentful content.
|
|
9
|
+
|
|
10
|
+
## Overview
|
|
11
|
+
|
|
12
|
+
The setup wizard handles everything automatically:
|
|
13
|
+
- Collects the Contentful Management Token
|
|
14
|
+
- Discovers spaces and environments via the Contentful API
|
|
15
|
+
- Writes `~/.contentful-cms.json`
|
|
16
|
+
- Updates the Claude Desktop config to register the `cms-edit` MCP server
|
|
17
|
+
|
|
18
|
+
## Prerequisites
|
|
19
|
+
|
|
20
|
+
The user needs:
|
|
21
|
+
1. **Node.js** installed (LTS version from [nodejs.org](https://nodejs.org))
|
|
22
|
+
2. **A Contentful Management Token** — see Step 1 below
|
|
23
|
+
|
|
24
|
+
## Step 1: Get a Management Token
|
|
25
|
+
|
|
26
|
+
Tell the user:
|
|
27
|
+
|
|
28
|
+
> To get your Contentful Management Token:
|
|
29
|
+
> 1. Log in to [contentful.com](https://app.contentful.com)
|
|
30
|
+
> 2. Go to **Settings → API keys**
|
|
31
|
+
> 3. Click the **Content management tokens** tab
|
|
32
|
+
> 4. Click **Generate personal token**, name it `Claude Desktop`, and click **Generate**
|
|
33
|
+
> 5. Copy the token — you won't see it again
|
|
34
|
+
|
|
35
|
+
Ask them to confirm they have the token before continuing.
|
|
36
|
+
|
|
37
|
+
## Step 2: Run the Setup Wizard
|
|
38
|
+
|
|
39
|
+
Tell the user to open a terminal and run:
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npx @se-studio/contentful-cms@latest setup
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Walk them through what each prompt means:
|
|
46
|
+
|
|
47
|
+
| Prompt | What to enter |
|
|
48
|
+
|--------|--------------|
|
|
49
|
+
| **Contentful Management Token** | The token they just copied (input will be hidden) |
|
|
50
|
+
| **Which Contentful space?** | Only appears if the token has multiple spaces — pick the one they want to connect |
|
|
51
|
+
| **Which environment?** | Auto-selects `master`; only asks if no `master` environment exists |
|
|
52
|
+
| **Short name for this project** | A slug like `my-project` or `om1` — used as the key in the config file |
|
|
53
|
+
| **Staging site URL** | Optional — their Vercel preview URL (e.g. `https://my-project.vercel.app`) |
|
|
54
|
+
| **Vercel bypass token** | Optional — only if their staging site has deployment protection |
|
|
55
|
+
|
|
56
|
+
## Step 3: Restart Claude Desktop
|
|
57
|
+
|
|
58
|
+
After the wizard completes, tell the user:
|
|
59
|
+
|
|
60
|
+
> Fully quit Claude Desktop and reopen it.
|
|
61
|
+
> - **Mac:** Right-click the Dock icon → **Quit** (closing the window isn't enough)
|
|
62
|
+
> - **Windows/Linux:** Close and reopen from the Start menu
|
|
63
|
+
|
|
64
|
+
## Step 4: Verify
|
|
65
|
+
|
|
66
|
+
Once they've reopened Claude Desktop, verify the setup worked by using the `cms_edit` tool:
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
cms_edit ["open", "/"]
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
If it returns a page structure, setup is complete. If it errors, see Troubleshooting below.
|
|
73
|
+
|
|
74
|
+
## Troubleshooting
|
|
75
|
+
|
|
76
|
+
**"Invalid management token"**
|
|
77
|
+
→ The token may have been copied incorrectly or already expired. Generate a new one in Contentful and run the wizard again.
|
|
78
|
+
|
|
79
|
+
**"No spaces found"**
|
|
80
|
+
→ The token doesn't have access to any spaces. Check Contentful's token permissions — it needs at least read access to one space.
|
|
81
|
+
|
|
82
|
+
**`cms_edit` tool not available after restart**
|
|
83
|
+
→ Check the Claude Desktop config was written correctly:
|
|
84
|
+
- Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
85
|
+
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
86
|
+
- Linux: `~/.config/Claude/claude_desktop_config.json`
|
|
87
|
+
|
|
88
|
+
It should contain an `mcpServers.cms-edit` entry. If missing, run the wizard again.
|
|
89
|
+
|
|
90
|
+
**Adding another space**
|
|
91
|
+
→ Run `npx @se-studio/contentful-cms@latest setup` again — it merges the new space into the existing config.
|