@stubbedev/atlassian-mcp 0.0.1 → 0.0.2

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 +23 -10
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -101,14 +101,16 @@ Config is resolved in this order: `--config <path>` CLI arg → `ATLASSIAN_MCP_C
101
101
 
102
102
  ### 2. Connect to your AI tool
103
103
 
104
- No cloning or building required — just point your tool at `npx @stubbedev/atlassian-mcp@latest` and it will install and run automatically. Add `--prefer-online` to make `npx` check npm for updates on each run.
104
+ No cloning or building required — just point your tool at `npx @stubbedev/atlassian-mcp@latest` and it will install and run automatically.
105
+
106
+ > Note: `--prefer-online` can break MCP startup in some clients. Keep the command simple and use the update steps below when you want to refresh.
105
107
 
106
108
  ---
107
109
 
108
110
  #### Claude Code
109
111
 
110
112
  ```bash
111
- claude mcp add atlassian -- npx --prefer-online -y @stubbedev/atlassian-mcp@latest --config ~/.atlassian-mcp.json
113
+ claude mcp add atlassian -- npx -y @stubbedev/atlassian-mcp@latest --config ~/.atlassian-mcp.json
112
114
  ```
113
115
 
114
116
  ---
@@ -122,7 +124,7 @@ Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project-only):
122
124
  "mcpServers": {
123
125
  "atlassian": {
124
126
  "command": "npx",
125
- "args": ["--prefer-online", "-y", "@stubbedev/atlassian-mcp@latest", "--config", "/Users/you/.atlassian-mcp.json"]
127
+ "args": ["-y", "@stubbedev/atlassian-mcp@latest", "--config", "/Users/you/.atlassian-mcp.json"]
126
128
  }
127
129
  }
128
130
  }
@@ -139,7 +141,7 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
139
141
  "mcpServers": {
140
142
  "atlassian": {
141
143
  "command": "npx",
142
- "args": ["--prefer-online", "-y", "@stubbedev/atlassian-mcp@latest", "--config", "/Users/you/.atlassian-mcp.json"]
144
+ "args": ["-y", "@stubbedev/atlassian-mcp@latest", "--config", "/Users/you/.atlassian-mcp.json"]
143
145
  }
144
146
  }
145
147
  }
@@ -157,7 +159,7 @@ Add to `~/.config/zed/settings.json`:
157
159
  "atlassian": {
158
160
  "command": {
159
161
  "path": "npx",
160
- "args": ["--prefer-online", "-y", "@stubbedev/atlassian-mcp@latest", "--config", "/home/you/.atlassian-mcp.json"]
162
+ "args": ["-y", "@stubbedev/atlassian-mcp@latest", "--config", "/home/you/.atlassian-mcp.json"]
161
163
  }
162
164
  }
163
165
  }
@@ -176,7 +178,7 @@ Add to `opencode.json` in your project root (or `~/.config/opencode/opencode.jso
176
178
  "mcp": {
177
179
  "atlassian": {
178
180
  "type": "local",
179
- "command": ["npx", "--prefer-online", "-y", "@stubbedev/atlassian-mcp@latest", "--config", "/home/you/.atlassian-mcp.json"]
181
+ "command": ["npx", "-y", "@stubbedev/atlassian-mcp@latest", "--config", "/home/you/.atlassian-mcp.json"]
180
182
  }
181
183
  }
182
184
  }
@@ -193,7 +195,6 @@ mcpServers:
193
195
  atlassian:
194
196
  command: npx
195
197
  args:
196
- - --prefer-online
197
198
  - -y
198
199
  - @stubbedev/atlassian-mcp@latest
199
200
  - --config
@@ -204,7 +205,17 @@ mcpServers:
204
205
 
205
206
  #### Any other MCP-compatible tool
206
207
 
207
- Most tools that support MCP accept the same JSON format. Use `npx` as the command with `["--prefer-online", "-y", "@stubbedev/atlassian-mcp@latest", "--config", "/path/to/config.json"]` as the args.
208
+ Most tools that support MCP accept the same JSON format. Use `npx` as the command with `["-y", "@stubbedev/atlassian-mcp@latest", "--config", "/path/to/config.json"]` as the args.
209
+
210
+ ### Updating existing installs
211
+
212
+ If your MCP client is already configured and you want the newest package version:
213
+
214
+ ```bash
215
+ npx clear-npx-cache
216
+ ```
217
+
218
+ Then restart your MCP client.
208
219
 
209
220
  ---
210
221
 
@@ -231,9 +242,11 @@ Automatic publish is configured in `.github/workflows/publish.yml`:
231
242
  - Push a tag like `v1.0.1` to publish from CI
232
243
  - Or run the workflow manually via **Actions → Publish Package**
233
244
 
234
- Required repository secret:
245
+ - The workflow is configured for npm Trusted Publisher (OIDC), so no `NPM_TOKEN` secret is required
246
+
247
+ Required npm setup (one-time):
235
248
 
236
- - `NPM_TOKEN` (npm automation token with publish rights for `@stubbedev`)
249
+ - In npm package settings, add this GitHub repo/workflow as a Trusted Publisher
237
250
 
238
251
  Manual publish from local machine:
239
252
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@stubbedev/atlassian-mcp",
3
- "version": "0.0.1",
3
+ "version": "0.0.2",
4
4
  "description": "MCP server for self-hosted Jira and Bitbucket",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",