@rallycry/conveyor-agent 10.13.72 → 11.0.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.
@@ -0,0 +1,43 @@
1
+ # Conveyor MCP Setup
2
+
3
+ Use this when Conveyor MCP tools are missing, stale, or unauthenticated.
4
+
5
+ ## Preferred install path
6
+
7
+ Ask the user to open Conveyor, choose the target project, then go to
8
+ **Settings → User Settings** (`/projects/<project>/user-settings`). The
9
+ **Connect Claude Code** section generates the exact install command / MCP JSON
10
+ for their account and project — use that, not Project Settings and not the
11
+ MCP Tools reference page.
12
+
13
+ ## Manual repair (Claude Code)
14
+
15
+ ```bash
16
+ claude mcp remove conveyor -s local 2>/dev/null;
17
+ claude mcp add conveyor -s local \
18
+ -e CONVEYOR_API_URL=<api-url> \
19
+ -e CONVEYOR_USER_TOKEN=<user-token> \
20
+ -e CONVEYOR_PROJECT_ID=<project-id> \
21
+ -- npx -y @rallycry/conveyor-mcp@latest
22
+ ```
23
+
24
+ - Run from the repo folder; `-s local` scopes the server there.
25
+ - The `remove` prefix makes token rotation idempotent.
26
+ - Keep `@latest`; avoid unbuilt local packages.
27
+ - `CONVEYOR_API_URL` and `CONVEYOR_USER_TOKEN` are required;
28
+ `CONVEYOR_PROJECT_ID` sets the default project (omit it to pass `projectId`
29
+ per call).
30
+ - Non-Claude MCP hosts use the same command/env/package shape in their own
31
+ config format.
32
+
33
+ After install, restart or reload MCP servers, then verify with
34
+ `mcp__conveyor__get_connection_context` or `mcp__conveyor__list_tasks`.
35
+
36
+ ## Auth failure vs permission failure
37
+
38
+ - Expired/invalid token → tools error with authentication failures; re-run
39
+ the connect flow above to mint a fresh token.
40
+ - "Insufficient permissions" on a call that should work → check the
41
+ `projectId` first (a typo produces this exact error), then ask a project
42
+ admin about your role: mutations (tasks, builds, PRs) need Moderate access
43
+ or higher.