Flightdeck MCP Server

A Model Context Protocol server that gives AI clients (Claude Code/Desktop, Cursor, …) first-class access to a Flightdeck instance — listing and creating projects, work items, cycles, modules and comments.

It's a thin client over Flightdeck's public REST API (/api/v1): it speaks MCP over stdio to the AI client and HTTPS to your Flightdeck install, using a personal access token. It never touches the app internals — the public API is its entire surface.

Prerequisites

• Node.js ≥ 18

• A Flightdeck install with the public API enabled (FD-21+)

• A personal access token: in Flightdeck, go to Settings → API tokens, create one, and copy the fd_pat_… value (shown only once). The token is scoped to a single workspace and acts as you.

Related MCP server: Webvizio MCP Server

Configuration

Two environment variables:

Use with Claude Code

claude mcp add flightdeck \
  --env FLIGHTDECK_BASE_URL=https://flightdeck.example.com \
  --env FLIGHTDECK_API_TOKEN=fd_pat_xxxxxxxx \
  -- npx -y @cruglobal/flightdeck-mcp-server

Use with Claude Desktop / Cursor

Add to your MCP config (claude_desktop_config.json or .cursor/mcp.json):

{
  "mcpServers": {
    "flightdeck": {
      "command": "npx",
      "args": ["-y", "@cruglobal/flightdeck-mcp-server"],
      "env": {
        "FLIGHTDECK_BASE_URL": "https://flightdeck.example.com",
        "FLIGHTDECK_API_TOKEN": "fd_pat_xxxxxxxx"
      }
    }
  }
}

Tools

List tools accept page and per_page (max 100).

Writes are tenant-safe on the server: any referenced state, cycle, parent or label must belong to the work item's own project, and assignees must be members of the workspace — otherwise the API rejects the request.

Development

npm install
npm run build      # compile TypeScript to dist/
npm run watch      # recompile on change
FLIGHTDECK_BASE_URL=… FLIGHTDECK_API_TOKEN=… npm start

License

MIT