npm package: @mdapp/mcp-client
Description: MCP proxy client for MDApp Documentation Manager
Author: MDApp
Latest version: 1.0.0
Deprecated: Package renamed to @taskly-run/mcp-client. Please update your installation.

# @mdapp/mcp-client

MCP proxy client for MDApp Documentation Manager. Connect your IDE (Amazon Q, Cursor, Claude Desktop) to your MDApp workspace.

## Installation

```bash
npm install -g @mdapp/mcp-client
```

## Setup

### 1. Get Your API Key

1. Visit [https://md.qdox.online/settings](https://md.qdox.online/settings)
2. Click "Generate New Key"
3. Copy your API key (shown only once!)

### 2. Configure Your IDE

#### Amazon Q

Edit `%USERPROFILE%\.aws\amazonq\mcp.json` (Windows) or `~/.aws/amazonq/mcp.json` (Mac/Linux):

```json
{
  "mcpServers": {
    "mdapp": {
      "command": "mdapp-mcp",
      "env": {
        "MDAPP_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

#### Cursor

Edit `%APPDATA%\Cursor\User\globalStorage\mcp.json` (Windows) or `~/Library/Application Support/Cursor/User/globalStorage/mcp.json` (Mac):

```json
{
  "mcpServers": {
    "mdapp": {
      "command": "mdapp-mcp",
      "env": {
        "MDAPP_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

#### Claude Desktop

Edit `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac):

```json
{
  "mcpServers": {
    "mdapp": {
      "command": "mdapp-mcp",
      "env": {
        "MDAPP_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### 3. Restart Your IDE

Completely restart your IDE to load the new MCP configuration.

## Usage

### Amazon Q

```
@mdapp list my workspaces
@mdapp search for "authentication"
@mdapp create document "API Guide" in workspace 1, category 2
@mdapp get document 5
```

### Cursor

```
@mdapp list workspaces
@mdapp semantic search "React hooks"
```

### Claude Desktop

```
Use the mdapp tool to list workspaces
Use the mdapp tool to search documents
```

## Available Commands

- `list_workspaces` - List all your workspaces
- `get_workspace` - Get workspace details
- `create_workspace` - Create new workspace
- `list_categories` - List categories in workspace
- `create_category` - Create new category
- `list_documents` - List documents
- `get_document` - Get document content
- `create_document` - Create new document
- `update_document` - Update document
- `search_documents` - Keyword search
- `semantic_search` - AI-powered search
- `hybrid_search` - Combined search
- And 20+ more tools...

## Troubleshooting

### "MDAPP_API_KEY environment variable is required"

Make sure you've added your API key to the MCP config file.

### "API error: 401 Unauthorized"

Your API key is invalid or expired. Generate a new one at https://md.qdox.online/settings

### MCP not showing in IDE

1. Check config file exists and has correct JSON syntax
2. Verify `mdapp-mcp` is installed: `mdapp-mcp --version`
3. Restart IDE completely
4. Check IDE logs for errors

### Connection timeout

Check your internet connection and verify https://md.qdox.online is accessible.

## Support

- Documentation: https://docs.md.qdox.online
- Issues: https://github.com/mdapp/mcp-client/issues
- Email: support@qdox.online