Backendless Console SDK MCP Server

![NPM Version](https://www.npmjs.com/package/backendless-console-sdk-mcp-server) ![MIT licensed](./LICENSE)

A Model Context Protocol (MCP) server that provides AI assistants with programmatic access to Backendless administration and developer APIs.

Backendless MCP enables AI assistants to directly manage your Backendless applications through natural language:

Create a new table called "Products" with columns: name (string), price (number), and inStock (boolean)

List all users who registered in the last 7 days

Your AI assistant can now:

1️⃣ Manage databases, users, files, etc.
2️⃣ Query data and perform operations
3️⃣ All without leaving your development environment

🚀 What is this for?

This MCP server enables AI assistants (like Claude, ChatGPT, Cursor, etc.) to interact with your Backendless applications through the Backendless Console SDK. It exposes a comprehensive set of tools for managing databases, users, API services, cloud code, and other Backendless resources directly from your AI-powered development environment.

Key benefits:

Direct Backendless integration: Access all Backendless admin APIs through natural language
Dynamic tool loading: Tools are automatically generated from the Backendless Console SDK
Secure authentication: Supports OAuth2 authentication
Flexible usage: Use hosted endpoints

✨ Features

Comprehensive API coverage: Automatically exposes all available Backendless Console SDK methods as MCP tools
Session management: Maintains authenticated sessions with Backendless servers
OAuth2 authentication method:
Multi-cluster support: Connect to US, EU, local, or Backendless PRO clusters
Hosted: Use Backendless-provided MCP endpoints (zero setup)

📋 Prerequisites

Backendless account with API access

📦 Installation

Note: Installation is not required if you're using the Backendless hosted MCP endpoints.

🛠️ Usage

Backendless Hosted MCP (Easiest - Recommended)

Each Backendless cluster provides a hosted MCP server endpoint. This is the easiest way to get started - no installation or server setup required!

Available endpoints:

US Cluster: https://develop.backendless.com/mcp
EU Cluster: https://eu-develop.backendless.com/mcp

<details> <summary>Install in Cursor</summary>

Go to: Settings → Cursor Settings → MCP → Add new global MCP server

Cursor Hosted Connection

{
  "mcp": {
    "servers": {
      "backendless": {
        "type": "http",
        "url": "https://develop.backendless.com/mcp"
      }
    }
  }
}

Cursor Local Connection

</details>

<details> <summary>Install in Claude Code</summary>

Claude Code Hosted Connection

Run this command:

claude mcp add --transport http backendless https://develop.backendless.com/mcp

</details>

<details> <summary>Install in VS Code</summary>

Add to your VS Code MCP settings. See VS Code MCP docs for more info.

VS Code Hosted Connection

{
  "mcp": {
    "servers": {
      "backendless": {
        "type": "http",
        "url": "https://develop.backendless.com/mcp"
      }
    }
  }
}

</details>

<details> <summary>Install in Windsurf</summary>

Add to your Windsurf MCP configuration. See Windsurf MCP docs for more info.

Windsurf Hosted Connection

{
  "mcpServers": {
    "backendless": {
      "serverUrl": "https://develop.backendless.com/mcp"
    }
  }
}

</details>

<details> <summary>Install in Cline</summary>

You can easily install Backendless through the Cline MCP Server configuration:

Open Cline
Click the hamburger menu icon (☰) to enter the MCP Servers section
Choose Remote Servers tab
Click the Edit Configuration button
Add backendless to mcpServers:

Cline Hosted Connection

{
  "mcpServers": {
    "backendless": {
      "url": "https://develop.backendless.com/mcp",
      "type": "streamableHttp"
    }
  }
}

</details>

<details> <summary>Install in Roo Code</summary>

Add this to your Roo Code MCP configuration file. See Roo Code MCP docs for more info.

Roo Code Hosted Connection

{
  "mcpServers": {
    "backendless": {
      "type": "streamable-http",
      "url": "https://develop.backendless.com/mcp"
    }
  }
}

</details>

<details> <summary>Install in Claude Desktop</summary>

Hosted Connection

Open Claude Desktop and navigate to Settings > Connectors > Add Custom Connector. Enter the name as Backendless and the remote MCP server URL as https://develop.backendless.com/mcp.

</details>

<details> <summary>Install in Opencode</summary>

Add this to your Opencode configuration file. See Opencode MCP docs for more info.

Opencode Hosted Connection

{
  "mcp": {
    "backendless": {
      "type": "remote",
      "url": "https://develop.backendless.com/mcp",
      "enabled": true
    }
  }
}

</details>

<details> <summary>Install in Qodo Gen</summary>

See Qodo Gen docs for more details.

Open Qodo Gen chat panel in VSCode or IntelliJ
Click Connect more tools
Click + Add new MCP
Add the following configuration:

Qodo Gen Hosted Connection

{
  "mcpServers": {
    "backendless": {
      "url": "https://develop.backendless.com/mcp"
    }
  }
}

</details>

<details> <summary>Install in Trae</summary>

Use the Add manually feature and fill in the JSON configuration information for that MCP server. For more details, visit the Trae documentation.

Trae Hosted Connection

{
  "mcpServers": {
    "backendless": {
      "url": "https://develop.backendless.com/mcp"
    }
  }
}

</details>

<details> <summary>Testing with MCP Inspector</summary>

Start your server and test with the MCP Inspector:

# Start the server
BACKENDLESS_HOST=us PORT=3003 npm run start:http

# In another terminal, run the inspector
npx @modelcontextprotocol/inspector

Configure the inspector:

Transport Type: Streamable HTTP
URL: http://localhost:3003/mcp

</details>

🔨 Available Tools

Tools are dynamically loaded from the Backendless Console SDK definitions. The available tools include operations for:

Data Management: Create, read, update, delete tables and records
User Management: User registration, authentication, role management
API Services: Manage and invoke custom API services
Cloud Code: Deploy and manage server-side business logic
Files: File upload, download, and management
Messaging: Push notifications and email management
Geolocation: Location-based services
And more: All Backendless Console SDK capabilities

Special Tools

getSDKInfo: Get current SDK session information and status

🔐 Authentication

For Hosted & Self-Hosted HTTP Mode

The server supports OAuth2 authentication method:

OAuth2 Bearer Token: Use standard OAuth2 Bearer authentication `` Authorization: Bearer YOUR_TOKEN ``

When authentication fails, the server responds with a 401 status and WWW-Authenticate header pointing to the OAuth2 discovery endpoints.

🏗️ Architecture

┌─────────────────┐
│  AI Assistant   │
│ (Claude, etc.)  │
└────────┬────────┘
         │ MCP Protocol
         │ (HTTP)
         ▼
┌─────────────────┐
│   MCP Server    │
│  (This Package) │
└────────┬────────┘
         │ Backendless Console SDK
         ▼
┌─────────────────┐
│   Backendless   │
│     Cluster     │
└─────────────────┘

🚨 Troubleshooting

<details> <summary>Connection Issues</summary>

Symptom: Cannot connect to Backendless cluster

Solutions:

Check your network connection and firewall settings
For hosted endpoints, ensure you can access https://develop.backendless.com or https://eu-develop.backendless.com in your browser

</details>

<details> <summary>Tool Not Found Errors</summary>

Symptom: "Tool not found" errors when trying to use specific operations

Solutions:

Use getSDKInfo to check available methods
Ensure you're using the latest version of the MCP server
Check the Backendless Console SDK version being used

</details>

<details> <summary>Port Already in Use</summary>

Symptom: "EADDRINUSE" error when starting HTTP server

Solutions:

Change the PORT environment variable to an available port
Check if another process is using port 3003: lsof -i :3003 (Unix/Mac) or netstat -ano | findstr :3003 (Windows)
Kill the process using the port or choose a different port

</details>

🔗 Links

📄 License

MIT

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

💬 Support

For issues related to:

This MCP server or Backendless platform: Backendless Support
MCP protocol: MCP Documentation

Backendless Console SDK MCP Server