feat: implement skills system for grouping and managing tools

.gitignore

@@ -64,3 +64,4 @@ coverage
 
 # Generated files
 packages/mcp-server/src/toolDefinitions.json
+packages/mcp-server/src/skillDefinitions.json

docs/testing-remote.md

@@ -232,7 +232,7 @@ The web UI provides a chat interface for testing the MCP server.
 **1. Authentication:**
 - Click "Connect to Sentry"
 - Authorize the application
-- Grant permissions (select scopes)
+- Grant permissions (select skills)
 
 **2. Basic Queries:**
 - "Who am I?" - Test authentication
@@ -292,14 +292,14 @@ Opens at `http://localhost:6274`
 - Redirected back to Inspector
 
 **3. Test Tools:**
-- Click "List Tools" - Verify 19-20 tools appear
+- Click "List Tools" - Verify tools appear
 - Test individual tools with parameters
 - View responses and errors
 
 ### Inspector Testing Patterns
 
 **Basic verification:**
-1. List tools → Verify count and names
+1. List tools → Verify expected tools available
 2. Call `whoami` → Verify authentication
 3. Call `find_organizations` → Verify data access
 
@@ -348,19 +348,19 @@ ls -la ~/.sentry-mcp-tokens.json
 pnpm -w run cli "list organizations"
 ```
 
-### 2. Test Scope Permissions
+### 2. Test Skills Permissions
 
-**In Sentry OAuth approval screen, test:**
-- Minimal scopes (org:read only)
-- Standard scopes (org:read, project:read, event:read)
-- Write scopes (add event:write, project:write)
+**In OAuth approval screen, test:**
+- Minimal skills (inspect, docs only)
+- Default skills (inspect, seer, docs)
+- All skills (inspect, seer, docs, triage, project-management)
 
-**Verify tools filtered by scopes:**
+**Verify tools filtered by skills:**
 ```bash
-# Read-only: should have ~15 tools
+# With inspect, docs only: no write tools
 pnpm -w run cli "list tools" | grep "create_"
 
-# With write: should have 19-20 tools
+# With all skills: includes write tools
 # Should see: create_project, create_team, update_issue, etc.
 ```
 
@@ -470,21 +470,21 @@ cat packages/mcp-cloudflare/.env | grep SENTRY_CLIENT
 
 ### "Permission denied" errors
 
-**Cause:** Insufficient scopes granted during OAuth.
+**Cause:** Insufficient skills granted during OAuth.
 
 **Solution:**
 ```bash
-# Force re-authorization with more scopes
+# Force re-authorization with more skills
 rm ~/.sentry-mcp-tokens.json
 pnpm -w run cli "who am I?"
 
-# In OAuth approval screen, select all needed permissions
+# In OAuth approval screen, select all needed skills
 ```
 
 ### "Tool not found" errors
 
 **Causes:**
-1. Tool filtered by scopes
+1. Tool filtered by skills
 2. Build issue
 3. Server version mismatch
 
@@ -493,8 +493,8 @@ pnpm -w run cli "who am I?"
 # Check tool list
 pnpm -w run cli "list tools" | jq '.tools[] | .name'
 
-# Verify scopes include required permissions
-# Example: create_project requires project:write scope
+# Verify skills include required permissions
+# Example: create_project requires project-management skill
 
 # Rebuild and restart
 pnpm -w run build && pnpm dev

docs/testing-stdio.md

@@ -182,7 +182,7 @@ This opens the MCP Inspector at `http://localhost:6274`
 ### 3. Test Tools Interactively
 
 **Basic workflow:**
-1. **List Tools** - Verify all expected tools appear (should see 19-20 tools)
+1. **List Tools** - Verify expected tools appear
 2. **Call a tool** - Start with `whoami` (no parameters required)
 3. **Test with parameters** - Try `find_organizations()`
 4. **Test complex operations** - Try `search_events(naturalLanguageQuery="errors in the last hour")`
@@ -379,9 +379,8 @@ Add to `.vscode/settings.json`:
 # Host configuration
 --host=sentry.example.com         # Self-hosted Sentry (hostname only)
 
-# Scope management
---scopes=org:read,event:read      # Override default scopes (replaces all)
---add-scopes=event:write          # Add to default scopes (keeps defaults)
+# Skills management
+--skills=inspect,docs,triage      # Limit to specific skills (default: all available)
 
 # AI features (optional)
 --openai-base-url=URL             # Custom OpenAI endpoint
@@ -407,9 +406,8 @@ SENTRY_ACCESS_TOKEN=your-token
 # Host (self-hosted only)
 SENTRY_HOST=sentry.example.com
 
-# Scopes
-MCP_SCOPES=org:read,event:read           # Override (replaces defaults)
-MCP_ADD_SCOPES=event:write               # Add (keeps defaults)
+# Skills
+MCP_SKILLS=inspect,docs,triage           # Limit to specific skills
 
 # AI features
 OPENAI_API_KEY=your-key                  # For search_events/search_issues
@@ -449,17 +447,17 @@ node dist/index.js \
   --host=sentry.local.dev
 ```
 
-### 3. Test Scope Permissions
+### 3. Test Skills
 
 ```bash
-# Test read-only (default)
+# Test with all skills (default)
 pnpm start --access-token=TOKEN
 
-# Test with write permissions
-pnpm start --access-token=TOKEN --add-scopes=event:write,project:write
+# Test with specific skills only
+pnpm start --access-token=TOKEN --skills=inspect,docs
 
-# Test minimal permissions
-pnpm start --access-token=TOKEN --scopes=org:read,project:read
+# Test read-only skills
+pnpm start --access-token=TOKEN --skills=inspect,seer,docs
 ```
 
 ### 4. Test AI-Powered Tools