Coderide MCP

🚀 Supercharge Your AI Assistant or IDE with CodeRide Task Management

Empower your AI coding companion with the capabilities of CodeRide! CodeRide MCP directly connects your preferred AI development tools (such as Cursor, Cline, Windsurf, and other MCP clients) to CodeRide, an AI-native task management system.

Imagine your AI not only writing code but also truly comprehending the project context, managing its own tasks, and collaborating seamlessly with you. No more endless copy - pasting or manual updates. With CodeRide MCP, your AI becomes an integral part of your CodeRide workflow.

🚀 Quick Start

Why CodeRide MCP is a Game - Changer

• Deep Project Understanding for Your AI: Provide your AI agents with rich, structured context from your CodeRide projects and tasks, enabling them to see the big picture.
• Seamless AI - Powered Task Automation: Enable AIs to directly fetch, interpret, and update tasks in CodeRide, automating routine project management.
• Bridge the Gap Between Human & AI Developers: Promote true collaboration through smoother handoffs, consistent task understanding, and aligned efforts.
• Optimized for LLM Efficiency: Compact JSON responses minimize token usage, ensuring faster and more cost - effective AI interactions.
• Secure by Design: Workspace - scoped API key authentication ensures data integrity and confines AI operations to the correct project context.
• Plug & Play Integration: Effortlessly set up with npx in any MCP - compatible environment. Connect your AI in minutes!
• Future - Proof Your Workflow: Embrace an AI - native approach to development, based on the open Model Context Protocol standard.

✨ Features

The CodeRide MCP server equips your AI with the following capabilities:

• Task Retrieval: Fetch specific tasks by their unique number.
• Task Updates: Modify task descriptions and statuses.
• Prompt Access: Obtain tailored prompts and instructions for specific tasks.
• Project Details: Retrieve information about projects by their slug.
• Project Knowledge Management: Update a project's knowledge graph and architecture diagrams.
• Project Initiation: Get the first task of a project to start work.

📦 Installation

Installing via Smithery

To automatically install the Coderide MCP Server for Claude Desktop via Smithery:

npx -y @smithery/cli install @PixdataOrg/coderide --client claude

Prerequisites:

1. Node.js and npm: Ensure Node.js (which includes npm) is installed. npx comes with npm.
2. CodeRide Account & API Key: This MCP server is for registered CodeRide users. You need an active CodeRide account and an API key, which can be obtained from your workspace settings on app.coderide.ai.

MCP Configuration: Add the following configuration to your MCP client (e.g., Claude Desktop's claude_desktop_config.json, Cursor, Cline, Windsurf, VS Code settings, etc.):

{
  "mcpServers": {
    "coderide": {
      "command": "npx",
      "args": [
        "-y",
        "@coderide/mcp"
      ],
      "env": {
        "CODERIDE_API_KEY": "YOUR_CODERIDE_API_KEY_HERE"
      }
    }
  }
}

Important:

• Replace "YOUR_CODERIDE_API_KEY_HERE" with your actual CodeRide API key.

Once configured, your MCP client will automatically start and connect to the CodeRide MCP server, making its tools available to your AI for interacting with your projects and tasks on CodeRide.

💻 Usage Examples

Basic Usage

The CodeRide MCP provides several useful tools. Here are some basic usage examples:

get_task

Retrieves detailed information about a specific task by its number (e.g., "TCA - 3").

{
  "number": "task-number (e.g., 'TCA-3')",
  "status": "to-do|in-progress|completed", // Optional: filter by status
}

Example Use Case:

• User Prompt: "Hey AI, what are the details for task APP - 101?"
• AI Action: Calls get_task with arguments: { "number": "APP-101" }.
• Outcome: AI receives the title, description, status, priority, and other context for task APP - 101.

update_task

Updates an existing task's description, status, or other mutable fields.

{
  "number": "task-number-identifier",
  "description": "updated-task-description", // Optional
  "status": "to-do|in-progress|completed"   // Optional
}

Example Use Case:

• User Prompt: "AI, please mark task BUG - 42 as 'completed' and add a note: 'Fixed the off - by - one error.'"
• AI Action: Calls update_task with arguments: { "number": "BUG-42", "status": "completed", "description": "Fixed the off-by-one error." }.
• Outcome: Task BUG - 42 is updated in CodeRide.

Advanced Usage

get_prompt

Retrieves the specific prompt or instructions tailored for an AI agent to work on a given task.

{
  "number": "task-number (e.g., 'TCA-3')"
}

Example Use Case:

• User Prompt: "AI, I'm ready to start on task ETF - 7. What's the main objective?"
• AI Action: Calls get_prompt with arguments: { "slug": "ETF", "number": "ETF-7" }.
• Outcome: AI receives the specific, actionable prompt for FEAT - 7, enabling it to begin work with clear direction.

get_project

Retrieves details about a specific project using its slug.

{
  "slug": "project-slug (e.g., 'TCA')",
  "name": "optional-project-name" // Can also retrieve by name
}

Example Use Case:

• User Prompt: "AI, can you give me an overview of the 'Omega Initiative' project?"
• AI Action: Calls get_project with arguments: { "slug": "omega-initiative" }.
• Outcome: AI receives the project's name, description, and potentially links to its knowledge base or diagrams.

update_project

Updates a project's high - level information, such as its knowledge graph or system architecture diagram.

{
  "slug": "project-slug-identifier",
  "project_knowledge": { /* JSON object representing the knowledge graph */ }, // Optional
  "project_diagram": "/* Mermaid diagram string or similar */"             // Optional
}

Example Use Case:

• User Prompt: "AI, I've updated the user authentication flow. Please update the project diagram for project 'APB'."
• AI Action: (After generating/receiving the new diagram) Calls update_project with arguments: { "slug": "APB", "project_diagram": "/* new mermaid diagram */" }.
• Outcome: The 'AlphaProject' in CodeRide now has the updated architecture diagram.

start_project

Retrieves the first or next recommended task for a given project, allowing an AI to begin work.

{
  "slug": "project-slug (e.g., 'TCA')"
}

Example Use Case:

• User Prompt: "AI, let's get started on the 'MobileAppV2' project. What's the first task?"
• AI Action: Calls start_project with arguments: { "slug": "MBC" }.
• Outcome: AI receives details for the initial task in the 'MBC' project, ready to begin.

🔧 Technical Details

• Workspace - Centered Authentication: API keys are tied to specific workspaces. All operations are automatically scoped, simplifying requests and enhancing security. No need to pass workspaceId!
• User - Friendly Identifiers: Interact with tasks and projects using human - readable numbers (e.g., "TCA - 3") and slugs (e.g., "TCA") instead of internal UUIDs.
• Optimized Responses: All tools return compact JSON, minimizing token usage for LLM communication.
• Robust API Interaction: Uses the official CodeRide API (https://api.coderide.ai by default) for all operations.

📚 Documentation

About CodeRide

CodeRide is where AI and human developers unite to build better software, faster.

It's more than just task management; it's an AI - native platform built from the ground up to support the unique workflows of AI - assisted software development. CodeRide provides the essential structured context, project knowledge, and external memory that AI agents need to understand complex projects, contribute meaningfully, and collaborate effectively with their human counterparts.

Transform your development process with a tool that truly understands the synergy between human ingenuity and artificial intelligence.

Discover the future of software development at coderide.ai.

🤝 Contributing

Contributions are welcome! Please feel free to submit issues, fork the repository, and create pull requests.

📄 License

All rights reserved. See the LICENSE file for details.

🤗 Support & Community

• Have questions or need help with @coderide/mcp? Open an issue on our GitHub repository.
• Want to learn more about CodeRide? Visit coderide.ai or join our community (Link to community forum/Discord if available).