101 lines
2.4 KiB
Markdown
101 lines
2.4 KiB
Markdown
---
|
|
description: Verify MCP server installation and configuration status
|
|
---
|
|
|
|
# MCP Server Verification
|
|
|
|
You are now in **MCP Verification Mode**. Your goal is to check the status of MCP servers and guide the user through any necessary setup.
|
|
|
|
## Verification Steps
|
|
|
|
### 1. Check Prerequisites
|
|
|
|
```bash
|
|
# Check if uvx is available
|
|
uvx --version
|
|
|
|
# Check if the plugin's MCP server configuration exists
|
|
cat ~/.claude/settings.local.json | grep -A 5 "airis-mcp-gateway" || echo "Not found in user settings"
|
|
```
|
|
|
|
### 2. Check MCP Server Status
|
|
|
|
Use the Bash tool to check:
|
|
```bash
|
|
# List configured MCP servers
|
|
claude mcp list
|
|
|
|
# Test AIRIS MCP Gateway connection (if available)
|
|
claude mcp get airis-mcp-gateway
|
|
```
|
|
|
|
### 3. Report Status
|
|
|
|
Provide a clear status report:
|
|
|
|
**✅ Working**:
|
|
- List MCP servers that are properly configured and responding
|
|
- Confirm which tools are available
|
|
|
|
**⚠️ Needs Attention**:
|
|
- Missing prerequisites (e.g., uvx not installed)
|
|
- MCP servers configured but not responding
|
|
- Missing optional API keys
|
|
|
|
**❌ Not Configured**:
|
|
- MCP servers that should be available but aren't configured
|
|
|
|
### 4. Provide Guidance
|
|
|
|
For any issues found, provide specific commands to fix them:
|
|
|
|
**Missing uvx**:
|
|
```bash
|
|
# Install uv (includes uvx)
|
|
pip install uv
|
|
# or
|
|
brew install uv
|
|
```
|
|
|
|
**Plugin MCP Not Starting**:
|
|
```bash
|
|
# Check plugin is installed
|
|
/plugin list
|
|
|
|
# Reinstall plugin if needed
|
|
/plugin update sc@superclaude-official
|
|
```
|
|
|
|
**Missing API Keys** (optional):
|
|
```bash
|
|
# Add to your shell profile (~/.zshrc, ~/.bashrc, etc.)
|
|
export TAVILY_API_KEY="your-key-here"
|
|
export TWENTYFIRST_API_KEY="your-key-here"
|
|
```
|
|
|
|
### 5. Troubleshooting
|
|
|
|
If AIRIS MCP Gateway is not working:
|
|
|
|
1. **Check logs**: Look for error messages in Claude Code output
|
|
2. **Test uvx directly**:
|
|
```bash
|
|
uvx --from git+https://github.com/agiletec-inc/airis-mcp-gateway airis-mcp-gateway --help
|
|
```
|
|
3. **Verify network access**: Ensure you can access GitHub
|
|
4. **Check Claude Code version**: MCP server support requires recent version
|
|
|
|
## Summary Format
|
|
|
|
Present findings in a clear table:
|
|
|
|
| MCP Server | Status | Tools Available | Action Needed |
|
|
|------------|--------|-----------------|---------------|
|
|
| AIRIS MCP Gateway | ✅ Working | 10 tools | None |
|
|
| AIRIS MCP Gateway | ⚠️ Partial | Limited | Install uvx |
|
|
| AIRIS MCP Gateway | ❌ Not Found | None | Check plugin |
|
|
|
|
## Exit
|
|
|
|
After providing the status report and any necessary guidance, exit verification mode.
|