@rui.branco/jira-mcp 1.0.0 → 1.0.1

package/README.md

@@ -30,51 +30,50 @@ When working on development tasks, context switching between Jira and your code
 - [Claude Code](https://claude.ai/code) CLI
 - Jira Cloud account with API access
 
-### Quick Setup
+### Step 1: Add to Claude Code
 
 ```bash
-# Clone to ~/.config (recommended)
-cd ~/.config
-git clone https://github.com/rui-branco/jira-mcp.git
-cd jira-mcp
+claude mcp add --transport stdio jira -- npx -y @rui.branco/jira-mcp
+```
 
-# Install dependencies
-npm install
+### Step 2: Configure Credentials
 
-# Run interactive setup
-node setup.js
+Run the setup to configure your Jira credentials:
+
+```bash
+npx @rui.branco/jira-mcp setup "your@email.com" "YOUR_API_TOKEN" "https://company.atlassian.net"
 ```
 
-The setup will prompt for:
+Or run interactively:
+
+```bash
+npx @rui.branco/jira-mcp setup
+```
+
+You'll need:
 1. **Jira email** - Your Atlassian account email
 2. **API token** - Generate at [Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens)
 3. **Base URL** - Your Jira instance (e.g., `https://company.atlassian.net`)
 
-### Alternative: Command-Line Setup
+### Step 3: Verify
 
-```bash
-node setup.js "your@email.com" "YOUR_API_TOKEN" "https://company.atlassian.net"
-```
+Restart Claude Code and run `/mcp` to verify the server is loaded.
 
-### Claude Code Configuration
+### Alternative: Manual Installation
 
-Add to your `~/.claude.json`:
+If you prefer to install manually:
 
-```json
-{
-  "mcpServers": {
-    "jira": {
-      "type": "stdio",
-      "command": "node",
-      "args": ["~/.config/jira-mcp/index.js"]
-    }
-  }
-}
+```bash
+git clone https://github.com/rui-branco/jira-mcp.git ~/.config/jira-mcp
+cd ~/.config/jira-mcp && npm install
+node setup.js
 ```
 
-> **Note:** If you cloned to a different location, update the path accordingly.
+Then add to Claude Code:
 
-Restart Claude Code to load the MCP server.
+```bash
+claude mcp add --transport stdio jira -- node $HOME/.config/jira-mcp/index.js
+```
 
 ## Usage
 

package/index.js

@@ -1,5 +1,11 @@
 #!/usr/bin/env node
 
+// Handle setup command
+if (process.argv[2] === "setup") {
+  require("./setup.js");
+  return;
+}
+
 const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
 const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
 const {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rui.branco/jira-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Jira MCP server for Claude Code - fetch tickets, search with JQL, and get Figma designs",
   "main": "index.js",
   "bin": {

package/setup.js

@@ -8,7 +8,10 @@ const configDir = path.join(process.env.HOME, ".config/jira-mcp");
 const configPath = path.join(configDir, "config.json");
 
 // Check for command line arguments
-const args = process.argv.slice(2);
+let args = process.argv.slice(2);
+// Skip "setup" arg if called via index.js
+if (args[0] === "setup") args = args.slice(1);
+
 if (args.length >= 3) {
   // Non-interactive mode: node setup.js <email> <token> <baseUrl>
   const [email, token, baseUrl] = args;
@@ -68,14 +71,9 @@ async function setup() {
   }
 
   console.log("\n=== Setup Complete ===");
-  console.log("\nAdd this to your Claude Code config (~/.claude.json):\n");
-  console.log(`"mcpServers": {
-  "jira": {
-    "type": "stdio",
-    "command": "node",
-    "args": ["${path.join(configDir, "server/index.js")}"]
-  }
-}`);
+  console.log("\nIf you haven't already, add to Claude Code with:\n");
+  console.log("  claude mcp add --transport stdio jira -- npx -y @rui.branco/jira-mcp");
+  console.log("\nThen restart Claude Code and run /mcp to verify.");
 
   rl.close();
 }