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.

Configuration

Two environment variables:

Variable	Required	Example
FLIGHTDECK_BASE_URL	yes	https://flightdeck.example.com
FLIGHTDECK_API_TOKEN	yes	fd_pat_xxxxxxxx…

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

Tool	Description
get_me	Who/what the token maps to (user, workspace, token). Health check.
list_projects	List projects in the workspace.
get_project	Retrieve a project by id.
list_work_items	List a project's work items (summary shape).
get_work_item	Retrieve a work item by id (full shape).
create_work_item	Create a work item in a project (title required).
update_work_item	Update a work item; only supplied fields change.
delete_work_item	Delete a work item by id.
list_cycles	List a project's cycles.
get_cycle	Retrieve a cycle by id.
list_modules	List a project's modules.
get_module	Retrieve a module by id.
list_comments	List a work item's comments.
create_comment	Add a comment to a work item.

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