Atune MCP Server

An MCP (Model Context Protocol) server for the Atune feedback management platform. This server allows AI assistants to interact with Atune's API through a standardized interface.

Features

• Complete Atune API Integration: Access all feedback management features
• Type-Safe Operations: Built with TypeScript and Zod validation
• MCP Standard Compliance: Works with Claude Desktop and other MCP-compatible clients
• NPX Support: Easy installation and execution via npx
• SSE Support: Real-time communication capabilities
• Resource Management: Access configuration and status information

Installation

Via NPX (Recommended)

npx atune-mcp-server

Via NPM Global Install

npm install -g atune-mcp-server
atune-mcp-server

Via NPM

npm install atune-mcp-server

Local Development

git clone https://github.com/bryancat/atune-mcp-server.git
cd atune-mcp-server
npm install
npm run build
npm start

Configuration

Claude Desktop Integration

Add the following to your Claude Desktop configuration file:

Location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration (NPX - Recommended):

{
  "mcpServers": {
    "atune": {
      "command": "npx",
      "args": ["atune-mcp-server"],
      "env": {
        "ATUNE_API_KEY": "ffk_your_api_key_here",
        "ATUNE_BASE_URL": "http://localhost:3000",
        "ATUNE_TIMEOUT": "30000"
      }
    }
  }
}

Alternative Configuration (Local Installation):

{
  "mcpServers": {
    "atune": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "ATUNE_API_KEY": "ffk_your_api_key_here",
        "ATUNE_BASE_URL": "https://your-atune-instance.com"
      }
    }
  }
}

Environment Variables

| Variable | Description | Required | Default | |----------|-------------|----------|---------| | ATUNE_API_KEY | Your Atune API key | Yes | - | | ATUNE_BASE_URL | Base URL of your Atune instance | No | https://your-atune-instance.com | | ATUNE_TIMEOUT | Request timeout in milliseconds | No | 30000 |

Available Tools

Configuration

• configure_api: Set up API connection with credentials

Feedback Management

• get_feedback: List feedback with filtering and pagination
• get_feedback_detail: Get detailed feedback information
• create_feedback: Create new feedback items
• reply_feedback: Reply to existing feedback

Project Management

• get_projects: List projects
• get_project_feedback_links: Get feedback links for a project

Analytics & Monitoring

• get_analytics: Get analytics overview
• health_check: Check API connection status

Usage Examples

1. Configure API Connection

Please configure the Atune API with:
- API Key: atune_your_api_key_here
- Base URL: https://your-instance.atune.com

2. List Recent Feedback

Show me the latest feedback items with high priority

3. Create New Feedback

Create a new bug report:
- Title: "Login page not loading"
- Content: "Users report that the login page shows a blank screen on mobile devices"
- Type: BUG
- Priority: HIGH

4. Reply to Feedback

Reply to feedback ID "fb_123" with: "Thank you for reporting this issue. We're investigating and will update you soon."

Resources

The server provides access to the following resources:

• atune://status: Current API connection status
• atune://config: Current configuration (sanitized)

API Compatibility

This MCP server is compatible with:

• Atune API v1
• All feedback management endpoints
• Project management features
• Analytics and reporting

Error Handling

The server provides comprehensive error handling for:

• Invalid API keys
• Network connectivity issues
• Malformed requests
• Rate limiting
• Server errors

Development

Building

npm run build

Development Mode

npm run dev

Testing

npm test

Security

• API keys are never logged or exposed
• All requests use HTTPS
• Sensitive data is sanitized in responses
• Rate limiting is respected

Support

For issues and questions:

1. Check the Atune API Documentation
2. Review the MCP Server Guide
3. Contact your Atune administrator

License

MIT License - see LICENSE file for details