@rockhopper-co/mcp-server 2.1.86 → 2.1.87-staging.0e88293

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.
Files changed (2) hide show
  1. package/README.md +40 -17
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -54,9 +54,19 @@ npx @rockhopper-co/mcp-server
54
54
 
55
55
  ### 2. Configure your AI tool
56
56
 
57
- #### Claude Desktop / Claude Code
57
+ #### Claude Code
58
58
 
59
- Add to your MCP config (`~/.claude/mcp.json` or Claude Desktop settings):
59
+ Run once:
60
+
61
+ ```bash
62
+ claude mcp add --env ROCKHOPPER_API_URL=https://api.rockhopper.co --transport stdio rockhopper -- npx -y @rockhopper-co/mcp-server
63
+ ```
64
+
65
+ Or add the JSON block from the Claude Desktop section below to `.mcp.json` at your project root. Claude Code keeps servers added with `claude mcp add` in `~/.claude.json` ([Claude Code MCP docs](https://code.claude.com/docs/en/mcp)).
66
+
67
+ #### Claude Desktop
68
+
69
+ Add to `claude_desktop_config.json` (Settings → Developer → Edit Config):
60
70
 
61
71
  ```json
62
72
  {
@@ -138,14 +148,26 @@ npm run generate:postman
138
148
 
139
149
  | Tool | Description |
140
150
  |------|-------------|
141
- | `list_files` | List enrolled Excel files with optional search filter |
151
+ | `list_files` | List the files tracked in Rockhopper — Excel workbooks and Google Sheets — with optional search filter |
142
152
  | `get_file_versions` | Get version history for a specific file |
143
153
  | `get_file_comments` | Get comments and threaded discussions on a file |
144
154
  | `get_reviews` | Get review requests for a version or file |
145
155
  | `get_cell_history` | Get change history for a specific cell across versions |
146
156
  | `search_files` | Search files **already enrolled** in Rockhopper, by name |
147
157
  | `search_drive_files` | Find a workbook in the user's own OneDrive / SharePoint, including files Rockhopper has never seen; returns candidates to confirm with the user before `enroll_file` |
148
- | `get_unattributed_changes` | Get pending cell changes not yet committed to a version |
158
+ | `get_unattributed_changes` | Get the changes made since the last saved version (cells, paragraphs or shapes) |
159
+ | `list_unenrolled_files` | List files Rockhopper has seen for the user that are not enrolled yet |
160
+
161
+ ## Account Link Tools
162
+
163
+ | Tool | Description |
164
+ |------|-------------|
165
+ | `connect_microsoft` | Start connecting the user's Microsoft account; returns a sign-in link the user opens |
166
+ | `microsoft_link_status` | Check whether a Microsoft account is connected and which one |
167
+ | `disconnect_microsoft` | Remove the stored Microsoft connection (requires an interactive login, not a PAT) |
168
+ | `connect_google` | Start connecting the user's Google account; returns a sign-in link the user opens |
169
+ | `google_link_status` | Check whether a Google account is connected and which one |
170
+ | `disconnect_google` | Remove the stored Google connection (requires an interactive login, not a PAT) |
149
171
 
150
172
  ## Available Resources
151
173
 
@@ -170,19 +192,20 @@ npm run generate:postman
170
192
  | `unresolved-comments` | List all unresolved comments on a file for follow-up |
171
193
  | `file-overview` | Comprehensive overview: versions, comments, reviews, and changes |
172
194
 
173
- ## Write Tools (requires `read-write` scope)
174
-
175
- | Tool | Description |
176
- |------|-------------|
177
- | `create_version` | Commit uncommitted changes as a new semver version (major/minor/patch) |
178
- | `discard_changes` | Discard all uncommitted changes, revert to latest committed version |
179
- | `add_comment` | Add a comment to an enrolled file (optionally at a cell) |
180
- | `reply_to_comment` | Reply to an existing comment thread |
181
- | `resolve_comment` | Mark a comment as resolved (author only) |
182
- | `create_review_request` | Request a review on a file version |
183
- | `approve_review` | Approve a review request (assigned reviewer only) |
184
- | `cancel_review` | Cancel a pending review request (requester only) |
185
- | `update_file_description` | Update the display name of an enrolled file |
195
+ ## Write Tools (each requires its write capability)
196
+
197
+ | Tool | Capability | Description |
198
+ |------|------------|-------------|
199
+ | `add_comment` | `comments:write` | Add a comment to an enrolled file (optionally at a cell, paragraph or shape) |
200
+ | `reply_to_comment` | `comments:write` | Reply to an existing comment thread |
201
+ | `resolve_comment` | `comments:write` | Mark a comment as resolved (author only) |
202
+ | `create_review_request` | `reviews:write` | Request a review on a file version |
203
+ | `approve_review` | `reviews:write` | Approve a review request (assigned reviewer only) |
204
+ | `cancel_review` | `reviews:write` | Cancel a pending review request (requester only) |
205
+ | `create_version` | `versions:write` | Commit uncommitted changes as a new semver version (major/minor/patch) |
206
+ | `discard_changes` | `versions:write` | Discard all uncommitted changes, revert to latest committed version |
207
+ | `rename_file` | `files:write` | Rename an enrolled file (its display name across Rockhopper) |
208
+ | `enroll_file` | `files:write` | Add a file to Rockhopper from its SharePoint, OneDrive, Google Sheets or Google Drive link |
186
209
 
187
210
  ## Identifiers
188
211
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rockhopper-co/mcp-server",
3
- "version": "2.1.86",
3
+ "version": "2.1.87-staging.0e88293",
4
4
  "description": "Rockhopper MCP server — expose file metadata, versions, reviews, and comments to AI tools",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",