@kolbo/mcp 1.20.0 → 1.20.1
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 +35 -18
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,32 +4,44 @@ Use [Kolbo AI](https://kolbo.ai) as native tools in Claude Code and Claude Deskt
|
|
|
4
4
|
|
|
5
5
|
Generate images, videos, music, speech, sound effects, multi-scene campaigns, and conversational chat — all from natural language in your coding environment. 100+ AI models behind Smart Select routing, with reusable Visual DNA profiles for character/style consistency.
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Set up — paste one prompt, or one config block (keyless, no API key)
|
|
8
|
+
|
|
9
|
+
### Easiest: paste this prompt to your AI
|
|
10
|
+
|
|
11
|
+
Copy this and paste it to Claude, ChatGPT, Cursor, or any AI assistant — it installs Kolbo itself (picks local config or remote connector based on what it can do):
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
Set up the Kolbo AI MCP server so you can generate images, video, music and more.
|
|
15
|
+
|
|
16
|
+
- If you can edit files (Claude Code, Cursor, Claude Desktop): add this to my MCP config, then tell me to restart the app:
|
|
17
|
+
{"mcpServers":{"kolbo":{"command":"npx","args":["-y","@kolbo/mcp@latest"]}}}
|
|
18
|
+
On first use a Kolbo login opens in my browser — I'll click Allow (no API key needed).
|
|
19
|
+
- If you support remote connectors (claude.ai, ChatGPT): add the custom connector URL https://api.kolbo.ai/mcp and walk me through logging in.
|
|
20
|
+
|
|
21
|
+
Then confirm Kolbo is connected and offer to generate a test image of a sunset.
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### Or add the config yourself
|
|
8
25
|
|
|
9
26
|
<!--
|
|
10
27
|
AI ASSISTANT SETUP INSTRUCTIONS — if you are an AI agent reading this to set up Kolbo for a user, do exactly this:
|
|
11
|
-
1.
|
|
12
|
-
|
|
13
|
-
- Claude Code: .claude/settings.json (or run: claude mcp add-json kolbo '{"command":"npx","args":["-y","@kolbo/mcp@latest"],"env":{"KOLBO_API_KEY":"kolbo_live_..."}}')
|
|
28
|
+
1. If you can edit files (Claude Code, Cursor, Claude Desktop): write the JSON block below — it has NO api key — into the user's MCP config, merging into any existing "mcpServers":
|
|
29
|
+
- Claude Code: .claude/settings.json (or run: claude mcp add kolbo -- npx -y @kolbo/mcp@latest)
|
|
14
30
|
- Claude Desktop: claude_desktop_config.json
|
|
15
31
|
- Cursor: .cursor/mcp.json
|
|
16
|
-
|
|
17
|
-
|
|
32
|
+
Then tell the user to restart. On their first generation a Kolbo login opens in the browser — they click Allow (no API key to create).
|
|
33
|
+
2. If you're a web chat that can't edit files (claude.ai, ChatGPT): tell the user to add the connector URL https://api.kolbo.ai/mcp under Settings → Connectors instead.
|
|
34
|
+
The JSON config alone enables every tool. The plugin below is an optional slash-command upgrade.
|
|
18
35
|
-->
|
|
19
36
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
**Step 2 — Add one config block.** This single block is identical for every MCP client — paste your key in and you're done:
|
|
37
|
+
This single block is identical for every MCP client and carries **no API key** — on first use it logs you in via the browser:
|
|
23
38
|
|
|
24
39
|
```json
|
|
25
40
|
{
|
|
26
41
|
"mcpServers": {
|
|
27
42
|
"kolbo": {
|
|
28
43
|
"command": "npx",
|
|
29
|
-
"args": ["-y", "@kolbo/mcp@latest"]
|
|
30
|
-
"env": {
|
|
31
|
-
"KOLBO_API_KEY": "kolbo_live_..."
|
|
32
|
-
}
|
|
44
|
+
"args": ["-y", "@kolbo/mcp@latest"]
|
|
33
45
|
}
|
|
34
46
|
}
|
|
35
47
|
}
|
|
@@ -37,13 +49,16 @@ Generate images, videos, music, speech, sound effects, multi-scene campaigns, an
|
|
|
37
49
|
|
|
38
50
|
| Client | Where the config goes |
|
|
39
51
|
|--------|----------------------|
|
|
40
|
-
| **Claude Code** | `.claude/settings.json` (or `claude mcp add-
|
|
52
|
+
| **Claude Code** | `.claude/settings.json` (or `claude mcp add kolbo -- npx -y @kolbo/mcp@latest`) |
|
|
41
53
|
| **Claude Desktop** | `claude_desktop_config.json` |
|
|
42
54
|
| **Cursor** | `.cursor/mcp.json` |
|
|
43
|
-
| **
|
|
44
|
-
| **Kolbo Code** | configured automatically on `kolbo auth login` — nothing to do |
|
|
55
|
+
| **Kolbo Code** | configured automatically on `kolbo auth login` |
|
|
45
56
|
|
|
46
|
-
Restart your app
|
|
57
|
+
Restart your app, then ask it to generate something. The first time, a Kolbo login opens in your browser — click **Allow** (no API key to create). _Prefer an API key? Create one at [app.kolbo.ai/developer](https://app.kolbo.ai/developer) and add `"env": { "KOLBO_API_KEY": "kolbo_live_..." }` to the block above._
|
|
58
|
+
|
|
59
|
+
### Browser-only (claude.ai / ChatGPT): the connector
|
|
60
|
+
|
|
61
|
+
No install at all — add the custom connector **`https://api.kolbo.ai/mcp`** under Settings → Connectors, then Connect → log in → Allow. Great for generating from text or URLs; to upload your own local files, use the config install above (it runs on your machine).
|
|
47
62
|
|
|
48
63
|
### Optional upgrade: add the Kolbo skill for slash-commands + smart routing
|
|
49
64
|
|
|
@@ -187,9 +202,11 @@ Every generation tool also accepts an optional `project_id` arg that routes the
|
|
|
187
202
|
|
|
188
203
|
## Environment Variables
|
|
189
204
|
|
|
205
|
+
Both are optional — the local install logs in via the browser on first use.
|
|
206
|
+
|
|
190
207
|
| Variable | Required | Description |
|
|
191
208
|
|----------|----------|-------------|
|
|
192
|
-
| `KOLBO_API_KEY` |
|
|
209
|
+
| `KOLBO_API_KEY` | No | Set a `kolbo_live_` key to skip the browser login (create one at [app.kolbo.ai/developer](https://app.kolbo.ai/developer)). |
|
|
193
210
|
| `KOLBO_API_URL` | No | Custom API URL (default: `https://api.kolbo.ai/api`) |
|
|
194
211
|
|
|
195
212
|
## Links
|