@contextful-com/contextful-mcp-darwin-arm64 0.1.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/README.md +76 -0
- package/bin/contextful-mcp +4 -0
- package/package.json +19 -0
package/README.md
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# Contextful
|
|
2
|
+
|
|
3
|
+
Connect Claude Code or Codex to your Contextful Hub. The installer sets up the
|
|
4
|
+
local MCP server, hooks, and skills, and guides you through account connection.
|
|
5
|
+
Your Hub runs separately in the cloud or on your own infrastructure.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
Run this from your project, using the Hub URL provided by your dashboard:
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
npx @contextful-com/contextful-mcp@latest install --hub https://YOUR-HUB
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Follow the browser sign-in and choose your agent when prompted. The installer
|
|
16
|
+
discovers the Hub endpoints and your organizations. It reuses a saved or sole
|
|
17
|
+
organization; otherwise, choose an organization by name. It asks before uploading
|
|
18
|
+
committed repository history. Private prompt history and usage are opt-in.
|
|
19
|
+
|
|
20
|
+
To choose an agent explicitly, add `--client codex` or `--client claude`.
|
|
21
|
+
|
|
22
|
+
## Ask your agent to install
|
|
23
|
+
|
|
24
|
+
Copy this prompt and replace the Hub URL:
|
|
25
|
+
|
|
26
|
+
> Install Contextful for this project using https://YOUR-HUB and the official
|
|
27
|
+
> @contextful-com/contextful-mcp npm package. Use the current agent, or ask whether
|
|
28
|
+
> I want Codex or Claude Code. Guide me through browser sign-in and complete the
|
|
29
|
+
> MCP, hooks, and skills installation. Ask before uploading repository history.
|
|
30
|
+
|
|
31
|
+
Instructions for the installing agent:
|
|
32
|
+
|
|
33
|
+
- Run the package's `install --hub <URL>` command from the project and supply
|
|
34
|
+
`--client codex` or `--client claude`. Use `--scope repo --project .` for this
|
|
35
|
+
project, and `--json --no-open --no-wait --no-history` to handle progress and
|
|
36
|
+
keep private history local. If no project is available, ask which folder to use.
|
|
37
|
+
- `npx -y` accepts npm's package download prompt. The install command's `--yes`
|
|
38
|
+
separately approves committed-history upload; use it only after user approval.
|
|
39
|
+
- Show `authorization_required`'s link and code immediately, and keep the process
|
|
40
|
+
running while the user signs in. Do not request passwords or read stored tokens.
|
|
41
|
+
- On `organization_required`, ask the user to choose from the returned names;
|
|
42
|
+
supply the selected ID internally when resuming. On `consent_required`, obtain
|
|
43
|
+
approval for the stated Hub and upload, then resume with the returned arguments.
|
|
44
|
+
Prefix returned `contextful-mcp` commands with this npm package when needed.
|
|
45
|
+
- After `complete`, report the installed agent and required activation actions.
|
|
46
|
+
Hub training may still be running. Do not report pending training as ready, or
|
|
47
|
+
bypass the agent's hook trust. Rerun the same install command to resume failures.
|
|
48
|
+
|
|
49
|
+
## Requirements
|
|
50
|
+
|
|
51
|
+
- Node.js 24 or newer and npm to run the npm launcher.
|
|
52
|
+
- A supported Claude Code or Codex installation. The installer checks its version.
|
|
53
|
+
- macOS ARM64/x64, Linux ARM64/x64 with glibc, or Windows x64.
|
|
54
|
+
|
|
55
|
+
npm installs the matching prebuilt binary. No compiler or Bun installation is
|
|
56
|
+
needed. Installed plugins keep their own executable, so they continue working
|
|
57
|
+
independently of npm's cache and without Node or Bun on their runtime path.
|
|
58
|
+
|
|
59
|
+
## Update or uninstall
|
|
60
|
+
|
|
61
|
+
Rerun the install command with `@latest` to update your integration. To select a
|
|
62
|
+
specific release, replace `latest` with its version.
|
|
63
|
+
|
|
64
|
+
```sh
|
|
65
|
+
npx @contextful-com/contextful-mcp@latest uninstall
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
For a persistent command on your PATH:
|
|
69
|
+
|
|
70
|
+
```sh
|
|
71
|
+
npm install -g @contextful-com/contextful-mcp
|
|
72
|
+
contextful-mcp install --hub https://YOUR-HUB
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Removing the global npm package removes the launcher. Use `contextful-mcp uninstall`
|
|
76
|
+
to remove the installed agent integration.
|
package/package.json
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@contextful-com/contextful-mcp-darwin-arm64",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"license": "UNLICENSED",
|
|
5
|
+
"publishConfig": {
|
|
6
|
+
"access": "public",
|
|
7
|
+
"registry": "https://registry.npmjs.org/"
|
|
8
|
+
},
|
|
9
|
+
"description": "Contextful standalone executable for darwin-arm64",
|
|
10
|
+
"os": [
|
|
11
|
+
"darwin"
|
|
12
|
+
],
|
|
13
|
+
"cpu": [
|
|
14
|
+
"arm64"
|
|
15
|
+
],
|
|
16
|
+
"files": [
|
|
17
|
+
"bin"
|
|
18
|
+
]
|
|
19
|
+
}
|