JSM Assets MCP Server

# Quick Start Guide Get up and running with JSM Assets MCP in under 5 minutes! ## 🚀 For Claude Desktop Users ### 1. Download & Install ```bash # Download the .dxt file (or build it) npm run build:dxt # Double-click jsm-assets-mcp.dxt # Click "Install" in Claude Desktop ``` ### 2. Configure Fill in the GUI form with: - **Workspace ID**: Your JSM workspace UUID - **Auth Token**: `Basic ` + base64(email:api_token) - **Base URL**: (leave default unless custom instance) ### 3. Test Ask Claude: *"What object schemas are available in this JSM workspace?"* --- ## ⚡ For Claude Code Users ### 1. Build & Configure ```bash # Build the project npm run build # Add to Claude Code claude mcp add jsm-assets \ -e JSM_WORKSPACE_ID="your-workspace-id" \ -e JSM_AUTH_TOKEN="Basic your-encoded-token" \ -- node /path/to/jsm-assets-mcp/dist/index.js ``` ### 2. Test Ask Claude: *"Search for Installation Package assets that start with IASM"* --- ## 🛠️ For Traditional Setup ### 1. Install & Build ```bash git clone <repo-url> cd jsm-assets-mcp npm install npm run build ``` ### 2. Configure Environment ```bash cp .env.example .env # Edit .env with your credentials ``` ### 3. Add to Claude Desktop Edit `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "jsm-assets": { "command": "node", "args": ["/full/path/to/jsm-assets-mcp/dist/index.js"], "env": { "JSM_WORKSPACE_ID": "your-workspace-id", "JSM_AUTH_TOKEN": "Basic your-encoded-token" } } } } ``` ### 4. Test Restart Claude Desktop and ask: *"Get all object types for schema ID 1"* --- ## 🔑 Getting Your Credentials ### Workspace ID - Go to your JSM Assets instance - Copy the UUID from the URL or admin settings - Example: `e15ec40f-3efb-44b0-a2a5-218bea7aa637` ### Authentication Token ```bash # 1. Create API token at: https://id.atlassian.com/manage-profile/security/api-tokens # 2. Encode email:token echo -n "your-email@domain.com:your-api-token" | base64 # 3. Add "Basic " prefix # Result: Basic eW91ci1lbWFpbEBkb21haW4uY29tOkFUQVRUM3hGZkdGMDdyUDYuLi4... ``` --- ## ✨ New Features to Test ### Automatic Pagination Ask Claude: *"Get ALL Hardware assets with automatic pagination"* - Retrieves complete datasets across multiple pages - Safe limits prevent runaway requests - Clear feedback about pages fetched ### Robust Search Ask Claude: *"Search for child objects of Infrastructure type"* - Uses reliable pagination logic - Doesn't miss data due to API metadata issues - Backward compatible with single-page requests --- ## 🔍 Example Queries - *"What object schemas are available?"* - *"Search for all Installation Package assets"* - *"Find child objects of Hardware type with key prefix HW"* - *"Get attributes for object type ID 10"* - *"Search assets created between 2023-01-01 and 2023-12-31"* --- ## 🆘 Troubleshooting **Server not found?** - Check your installation method-specific setup - Verify credentials are correct - For Claude Code: Run `claude mcp list` to see configured servers **No results?** - Verify workspace ID is correct - Check object type names exist in your workspace - Try broader search criteria **Authentication errors?** - Verify token is properly base64 encoded - Ensure you have JSM Assets read permissions - Check token hasn't expired **Need more help?** - See detailed docs: [INSTALLATION.md](./INSTALLATION.md) - Test examples: [test-examples.md](./test-examples.md) - DXT guide: [DXT-README.md](./DXT-README.md) 🎉 **Happy searching!**