@feedbacked/mcp-server

A Model Context Protocol (MCP) server that enables Claude Desktop to create forms on Feedbacked Form through natural language interactions.

Installation

Install the package globally:

npm install -g @feedbacked/mcp-server

Setup

1. Get Your API Key

1. Visit Feedbacked Form
2. Sign up or log in to your account
3. Go to Settings → API Keys
4. Create a new API key with appropriate permissions
5. Copy the generated API key### 2. Configure Claude Desktop

Add the MCP server to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "feedbacked-form-creator": {
      "command": "feedbacked-mcp",
      "env": {
        "FEEDBACKED_API_KEY": "your-api-key-here",
        "FEEDBACKED_API_URL": "https://www.feedbackedform.com/api/proxy/mcp",
        "FEEDBACKED_CLIENT_URL": "https://www.feedbackedform.com"
      }
    }
  }
}

3. Restart Claude Desktop

After updating the configuration, restart Claude Desktop for the changes to take effect.

Usage

Once configured, you can ask Claude to create forms using natural language:

"Create a contact form with name, email, and message fields"

Claude will create the form and provide you with both the edit link and public sharing link.

Environment Variables

• FEEDBACKED_API_KEY (required): Your API key from Feedbacked Form
• FEEDBACKED_API_URL (optional): API endpoint (defaults to https://www.feedbackedform.com/api/proxy/mcp)
• FEEDBACKED_CLIENT_URL (optional): Client URL (defaults to https://www.feedbackedform.com)

Features

• 🔐 Secure API Key Authentication - Uses user-generated API keys
• 📝 Rich Form Fields - Support for text, email, number, textarea, select, radio, checkbox, and date fields
• ✅ Field Validation - Required fields, placeholder text, and options for select/radio fields
• 🛡️ Scoped Permissions - API keys are scoped to specific actions
• 📊 Usage Tracking - Track when API keys are used
• 🔄 Natural Language - Create forms through conversational prompts

Supported Field Types

• Text input
• Email input
• Number input
• Textarea
• Select dropdown
• Radio buttons
• Checkboxes
• Date picker
• File upload

Support

For issues or questions, please visit Feedbacked Form or contact support.

License

MIT

• PUT /api/forms/:id - Update form (supports X-API-Key header)
• DELETE /api/forms/:id - Delete form (supports X-API-Key header)

MCP Tools

create_form

Creates a new form with specified fields.

Required Parameters:

• title: Form title
• apiKey: Your Feedbacked API key (fbk_xxxxx...)
• fields: Array of form fields

Field Properties:

• name: Unique field name (slug)
• type: Field type (text, email, number, textarea, select, radio, checkbox, date)
• label: Display label
• required: Whether field is required (default: false)
• placeholder: Placeholder text (optional)
• options: Options for select/radio fields (required for those types)

get_api_key_info

Provides information on how to generate an API key.

Examples

Simple Contact Form

{
  "title": "Contact Form",
  "apiKey": "fbk_your_api_key_here",
  "fields": [
    {
      "name": "name",
      "type": "text", 
      "label": "Full Name",
      "required": true
    },
    {
      "name": "email",
      "type": "email",
      "label": "Email Address", 
      "required": true
    },
    {
      "name": "message",
      "type": "textarea",
      "label": "Message",
      "required": true,
      "placeholder": "Tell us how we can help..."
    }
  ]
}

Survey Form with Options

{
  "title": "Customer Feedback Survey",
  "description": "Help us improve our service",
  "apiKey": "fbk_your_api_key_here",
  "fields": [
    {
      "name": "satisfaction",
      "type": "radio",
      "label": "Overall Satisfaction",
      "required": true,
      "options": ["Very Satisfied", "Satisfied", "Neutral", "Dissatisfied", "Very Dissatisfied"]
    },
    {
      "name": "recommend",
      "type": "select", 
      "label": "Likelihood to Recommend",
      "required": true,
      "options": ["10 - Extremely Likely", "9", "8", "7", "6", "5", "4", "3", "2", "1", "0 - Not at all Likely"]
    },
    {
      "name": "feedback",
      "type": "textarea",
      "label": "Additional Feedback",
      "required": false,
      "placeholder": "Any additional comments..."
    }
  ]
}

Security Features

• ✅ No User Impersonation - API keys are tied to the generating user's account
• ✅ Scoped Permissions - Keys only have access to form operations
• ✅ Secure Storage - API keys are hashed and salted in database
• ✅ Key Management - Users can revoke keys anytime
• ✅ Usage Tracking - Last used timestamps for monitoring
• ✅ Rate Limiting - Inherits your existing API rate limits

Development

Run MCP Server in Development

cd mcp-server
pnpm dev

Run Full Stack

# Terminal 1: Start API server
cd server
pnpm dev

# Terminal 2: Start client
cd client  
pnpm dev

# Terminal 3: Start MCP server
cd mcp-server
pnpm dev

Troubleshooting

Common Issues

1. "Invalid API key format"

   • Ensure API key starts with fbk_
   • Generate new key from settings page

2. "Authentication required"

   • Check API key is included in request
   • Verify key hasn't been revoked

3. "Form limit reached"

   • API keys inherit user's form limits
   • Authenticated users have higher limits than guests

4. "Failed to create form"

   • Check server logs for detailed error
   • Verify API server is running on correct port

Debugging

Enable debug logging:

DEBUG=mcp:* node dist/server.js

Check API key in database:

SELECT * FROM api_keys WHERE user_id = 'your_user_id';

License

MIT