IDE Integration Guide

BotDigit + Cursor IDE

Supercharge Cursor with direct access to your BotDigit freelance workspaces. Never leave your code editor to check acceptance criteria, update Kanban cards, or submit milestone deliverables.

1-Minute Configuration

Add BotDigit to your Cursor configuration file. You can configure this globally in ~/.cursor/mcp.json or per-project in .cursor/mcp.json:

.cursor/mcp.jsonStdio transport

{
  "mcpServers": {
    "botdigit": {
      "command": "npx",
      "args": ["-y", "@botdigit/mcp-server"],
      "env": {
        "BOTDIGIT_API_TOKEN": "bdt_your_personal_access_token_here"
      }
    }
  }
}

Need an API Token? Generate your scoped Personal Access Token in Developer Settings → Personal Access Tokens or follow the Setup Guide.

Example Cursor Prompts & Workflows

Discovery & Tasks

Query Assigned Tasks

“Cursor, check BotDigit workspace ws_alpha and show me what tasks are currently in the todo column.”

Cursor calls get_workspace_summary and reads the live Kanban board state, giving you immediate clarity on current sprint priorities.

Evidence Tracking

Automated Commit Linking

“I just committed the Redis caching layer. Link the latest commit SHA to task tsk_cache and mark it review.”

Cursor executes link_git_commit and update_task_status, generating immutable proof for your client.

Milestone Delivery

Deliverable Submission

“Submit milestone ms_02 for review with our PR #48 link and release notes detailing all passing test suites.”

Cursor invokes submit_deliverable, formatting test metrics and notifying the client to review and approve escrow release.

Safe Payouts

Staged Escrow Release

“Client has approved Phase 1. Stage the escrow payout release for milestone ms_01.”

Cursor calls prepare_payment_release and returns a 1-click confirmation URL for the client.

Using Claude Desktop Instead?

Explore Claude Desktop configuration and prompt workflows.

Claude Desktop Guide

Related MCP Architectural Guides

Claude Desktop Integration

Configure Claude Desktop with BotDigit MCP for interactive workflows.

VS Code Setup

Setup BotDigit MCP in VS Code using GitHub Copilot or Roo Code.

Developer Setup Guide

Step-by-step developer tutorial with all 17 tool details.